# bubblebrainbb/awesome-fable-5.2 architecture

> Architecture diagram of the GitHub repository bubblebrainbb/awesome-fable-5.2, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bubblebrainbb/awesome-fable-5.2
- Repository: https://github.com/bubblebrainbb/awesome-fable-5.2

## Overview

Awesome Fable 5.2 is a collection of four code-generated visual works: three rendered films with synthesized sound and one still image. Their common user-to-result workflow is to build a procedural scene, render frames or an image, and (for films) produce audio and assemble the result. The graph preserves the distinct terrain, flora, animation, and sound stages described in the README. Relationships are limited to documented capabilities and visible source references; unsampled implementation details are not inferred.

Main entry points: [`mountain-hike/src/scene.h`](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/scene.h) (Hike scene), [`afternoon-light/src/main.cpp`](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/afternoon-light/src/main.cpp) (Path tracer), [`cat-garden/src/world3.h`](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/world3.h) (Garden world), [`afternoon-light/src/scene.h`](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/afternoon-light/src/scene.h) (Room scene)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_afternoon["Afternoon Light"]
  node_af_main["Path tracer<br/>[main.cpp]"]
  node_af_scene["Room scene<br/>[scene.h]"]
  node_af_geom["Mesh and BVH<br/>[geom.h]"]
  node_af_image["Rendered image"]
end

subgraph group_cat["Cat Garden"]
  node_cat_world["Garden world<br/>[world3.h]"]
  node_cat_plants["Procedural plants<br/>[plants.h]"]
  node_cat_geom["Scene geometry<br/>[geom.h]"]
  node_cat_anim["Cat and creatures<br/>[cat.h]"]
  node_cat_render["Film renderer<br/>[render_all.py]"]
  node_cat_audio["Synthesized audio<br/>[audio.py]"]
  node_cat_film["Rendered film"]
end

subgraph group_deep["Deep Dive"]
  node_deep_world["Reef world<br/>[world.h]"]
  node_deep_sim["Dive simulation<br/>[sim.h]"]
  node_deep_water["Water effects<br/>[water.h]"]
  node_deep_render["Ray marcher"]
  node_deep_audio["Synthesized audio<br/>[audio.py]"]
  node_deep_film["Rendered film"]
end

subgraph group_mountain["Mountain Hike"]
  node_mh_terrain["Terrain model<br/>[terrain.h]"]
  node_mh_generation["Terrain growth<br/>[terrain_gen.cpp]"]
  node_mh_flora["Instanced flora<br/>[flora.h]"]
  node_mh_scene["Hike scene<br/>[scene.h]"]
  node_mh_audio["Music and ambience<br/>[synth.py]"]
  node_mh_narration["Narration<br/>[narration.py]"]
  node_mh_film["Rendered film"]
end

node_user(("Work author"))
node_tts["Text-to-speech service"]

node_user -.->|"runs render"| node_af_main
node_af_main -->|"traces scene"| node_af_scene
node_af_scene -->|"uses geometry"| node_af_geom
node_af_main -->|"writes image"| node_af_image
node_user -.->|"renders film"| node_cat_render
node_cat_world -->|"uses generators"| node_cat_plants
node_cat_world -->|"builds geometry"| node_cat_geom
node_cat_anim -->|"reads garden state"| node_cat_world
node_cat_render -.->|"produces film"| node_cat_film
node_cat_audio -.->|"provides soundtrack"| node_cat_film
node_user -.->|"renders film"| node_deep_render
node_deep_sim -->|"uses reef world"| node_deep_world
node_deep_water -->|"uses terrain"| node_deep_world
node_deep_render -.->|"produces film"| node_deep_film
node_deep_audio -.->|"provides soundtrack"| node_deep_film
node_user -.->|"renders film"| node_mh_scene
node_mh_generation -.->|"generates terrain"| node_mh_terrain
node_mh_scene -->|"uses terrain"| node_mh_terrain
node_mh_scene -->|"uses flora"| node_mh_flora
node_mh_audio -.->|"provides soundtrack"| node_mh_film
node_mh_narration -.->|"requests speech"| node_tts
node_mh_scene -.->|"produces film"| node_mh_film
node_tts -.->|"supplies narration"| node_mh_film

click node_af_main "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/afternoon-light/src/main.cpp"
click node_af_scene "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/afternoon-light/src/scene.h"
click node_af_geom "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/afternoon-light/src/geom.h"
click node_cat_world "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/world3.h"
click node_cat_plants "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/plants.h"
click node_cat_geom "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/geom.h"
click node_cat_anim "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/cat.h"
click node_cat_render "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/render_all.py"
click node_cat_audio "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/audio.py"
click node_deep_world "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/deep-dive/src/world.h"
click node_deep_sim "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/deep-dive/src/sim.h"
click node_deep_water "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/deep-dive/src/water.h"
click node_deep_render "https://github.com/bubblebrainbb/awesome-fable-5.2/tree/main/deep-dive/src"
click node_deep_audio "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/deep-dive/audio.py"
click node_mh_terrain "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/terrain.h"
click node_mh_generation "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/terrain_gen.cpp"
click node_mh_flora "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/flora.h"
click node_mh_scene "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/scene.h"
click node_mh_audio "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/audio/synth.py"
click node_mh_narration "https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/audio/narration.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_af_main,node_af_scene,node_af_geom,node_af_image toneBlue
class node_cat_world,node_cat_plants,node_cat_geom,node_cat_anim,node_cat_render,node_cat_audio,node_cat_film toneAmber
class node_deep_world,node_deep_sim,node_deep_water,node_deep_render,node_deep_audio,node_deep_film toneMint
class node_mh_terrain,node_mh_generation,node_mh_flora,node_mh_scene,node_mh_audio,node_mh_narration,node_mh_film toneRose
class node_user,node_tts toneIndigo
```

## Components

### Afternoon Light

- [Path tracer](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/afternoon-light/src/main.cpp): `afternoon-light/src/main.cpp`
- [Room scene](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/afternoon-light/src/scene.h): `afternoon-light/src/scene.h`
- [Mesh and BVH](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/afternoon-light/src/geom.h): `afternoon-light/src/geom.h`
- **Rendered image**

### Cat Garden

- [Garden world](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/world3.h): `cat-garden/src/world3.h`
- [Procedural plants](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/plants.h): `cat-garden/src/plants.h`
- [Scene geometry](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/geom.h): `cat-garden/src/geom.h`
- [Cat and creatures](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/cat.h): `cat-garden/src/cat.h`
- [Film renderer](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/render_all.py): `cat-garden/src/render_all.py`
- [Synthesized audio](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/cat-garden/src/audio.py): `cat-garden/src/audio.py`
- **Rendered film**

### Deep Dive

- [Reef world](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/deep-dive/src/world.h): `deep-dive/src/world.h`
- [Dive simulation](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/deep-dive/src/sim.h): `deep-dive/src/sim.h`
- [Water effects](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/deep-dive/src/water.h): `deep-dive/src/water.h`
- [Ray marcher](https://github.com/bubblebrainbb/awesome-fable-5.2/tree/main/deep-dive/src): `deep-dive/src`
- [Synthesized audio](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/deep-dive/audio.py): `deep-dive/audio.py`
- **Rendered film**

### Mountain Hike

- [Terrain model](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/terrain.h): `mountain-hike/src/terrain.h`
- [Terrain growth](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/terrain_gen.cpp): `mountain-hike/src/terrain_gen.cpp`
- [Instanced flora](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/flora.h): `mountain-hike/src/flora.h`
- [Hike scene](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/scene.h): `mountain-hike/src/scene.h`
- [Music and ambience](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/audio/synth.py): `mountain-hike/src/audio/synth.py`
- [Narration](https://github.com/bubblebrainbb/awesome-fable-5.2/blob/main/mountain-hike/src/audio/narration.py): `mountain-hike/src/audio/narration.py`
- **Rendered film**

### Other components

- **Work author**
- **Text-to-speech service**

## Connections

- Work author → Path tracer: runs render
- Path tracer → Room scene: traces scene (evidence: `afternoon-light/src/main.cpp`)
- Room scene → Mesh and BVH: uses geometry (evidence: `afternoon-light/src/scene.h`)
- Path tracer → Rendered image: writes image (evidence: `afternoon-light/src/main.cpp`)
- Work author → Film renderer: renders film
- Garden world → Procedural plants: uses generators
- Garden world → Scene geometry: builds geometry
- Cat and creatures → Garden world: reads garden state (evidence: `cat-garden/src/cat.h`)
- Film renderer → Rendered film: produces film
- Synthesized audio → Rendered film: provides soundtrack
- Work author → Ray marcher: renders film
- Dive simulation → Reef world: uses reef world (evidence: `deep-dive/src/sim.h`)
- Water effects → Reef world: uses terrain (evidence: `deep-dive/src/water.h`)
- Ray marcher → Rendered film: produces film
- Synthesized audio → Rendered film: provides soundtrack
- Work author → Hike scene: renders film
- Terrain growth → Terrain model: generates terrain
- Hike scene → Terrain model: uses terrain (evidence: `mountain-hike/src/terrain.h`)
- Hike scene → Instanced flora: uses flora (evidence: `mountain-hike/src/scene.h`)
- Music and ambience → Rendered film: provides soundtrack
- Narration → Text-to-speech service: requests speech
- Hike scene → Rendered film: produces film
- Text-to-speech service → Rendered film: supplies narration
