# lepetitdhomme/room_base_procedural architecture

> Architecture diagram of the GitHub repository lepetitdhomme/room_base_procedural, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lepetitdhomme/room_base_procedural
- Repository: https://github.com/lepetitdhomme/room_base_procedural

## Overview

This is an SDL dungeon-exploration game. A seeded run initializes a level, maps it to a grid, then repeatedly handles input, moves the player, and renders the scene, entities, shadows, and optional map. The architecture also includes procedural room-and-connection generation, graph/door construction, collision and lighting systems. Some generation and rendering relationships are supported only by module references in the source index, so those links are dashed rather than presented as verified calls.

Main entry points: [`src/main.c`](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/main.c) (SDL game loop), [`src/player.c`](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/player.c) (Player movement), [`src/level.c`](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/level.c) (Level generation), [`src/type.c`](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/type.c) (Tile and type rules)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game runtime"]
  node_main_loop["SDL game loop<br/>[main.c]"]
  node_input["Input handling<br/>[inputs.c]"]
end

subgraph group_generation["Dungeon generation"]
  node_level_gen["Level generation<br/>[level.c]"]
  node_room_gen["Room placement<br/>[room.c]"]
  node_mst["Room connections<br/>[kruskal.c]"]
  node_connection_data["Connection helpers<br/>[connections.c]"]
  node_graph_build["Dungeon graph<br/>[graph.c]"]
end

subgraph group_world["World and movement"]
  node_door_logic["Doors<br/>[door.c]"]
  node_grid_world["World grid<br/>[grid.c]"]
  node_player_motion["Player movement<br/>[player.c]"]
  node_collision["Collision checks<br/>[collisions.c]"]
end

subgraph group_rendering["Rendering and light"]
  node_draw_scene["Scene drawing<br/>[draw.c]"]
  node_texture_assets["Texture loading<br/>[textures.c]"]
  node_shadow["Shadow casting<br/>[shadow_casting.c]"]
  node_light_map["Room light maps<br/>[light_map.c]"]
end

subgraph group_shared["Shared utilities"]
  node_type_rules["Tile and type rules<br/>[type.c]"]
  node_tools["Geometry utilities<br/>[tools.c]"]
end

node_player_actor(("Player"))

node_player_actor -->|"provides controls"| node_input
node_main_loop -->|"initializes level"| node_level_gen
node_main_loop -->|"maps level"| node_grid_world
node_main_loop -->|"handles events"| node_input
node_main_loop -->|"updates movement"| node_player_motion
node_main_loop -->|"draws scene"| node_draw_scene
node_main_loop -->|"casts shadows"| node_shadow
node_level_gen -.->|"uses room placement"| node_room_gen
node_level_gen -.->|"builds connections"| node_mst
node_level_gen -.->|"builds graph"| node_graph_build
node_mst -.->|"uses helpers"| node_connection_data
node_graph_build -.->|"constructs doors"| node_door_logic
node_player_motion -->|"checks destination"| node_collision
node_player_motion -->|"opens doors"| node_door_logic
node_player_motion -->|"refreshes grid"| node_grid_world
node_player_motion -->|"resets room light"| node_light_map
node_player_motion -->|"tests tile types"| node_type_rules
node_draw_scene -.->|"uses textures"| node_texture_assets
node_draw_scene -.->|"uses tile rules"| node_type_rules
node_shadow -.->|"uses geometry helpers"| node_tools
node_shadow -.->|"uses tile rules"| node_type_rules
node_light_map -.->|"uses tile rules"| node_type_rules

click node_main_loop "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/main.c"
click node_level_gen "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/level.c"
click node_room_gen "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/room.c"
click node_mst "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/kruskal.c"
click node_connection_data "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/connections.c"
click node_graph_build "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/graph.c"
click node_door_logic "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/door.c"
click node_grid_world "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/grid.c"
click node_player_motion "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/player.c"
click node_collision "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/collisions.c"
click node_input "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/inputs.c"
click node_draw_scene "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/draw.c"
click node_texture_assets "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/textures.c"
click node_shadow "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/shadow_casting.c"
click node_light_map "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/light_map.c"
click node_type_rules "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/type.c"
click node_tools "https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/tools.c"

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_main_loop,node_input toneBlue
class node_level_gen,node_room_gen,node_mst,node_connection_data,node_graph_build toneAmber
class node_door_logic,node_grid_world,node_player_motion,node_collision toneMint
class node_draw_scene,node_texture_assets,node_shadow,node_light_map toneRose
class node_type_rules,node_tools,node_player_actor toneIndigo
```

## Components

### Game runtime

- [SDL game loop](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/main.c): `src/main.c`
- [Input handling](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/inputs.c): `src/inputs.c`

### Dungeon generation

- [Level generation](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/level.c): `src/level.c`
- [Room placement](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/room.c): `src/room.c`
- [Room connections](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/kruskal.c): `src/kruskal.c`
- [Connection helpers](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/connections.c): `src/connections.c`
- [Dungeon graph](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/graph.c): `src/graph.c`

### World and movement

- [Doors](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/door.c): `src/door.c`
- [World grid](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/grid.c): `src/grid.c`
- [Player movement](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/player.c): `src/player.c`
- [Collision checks](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/collisions.c): `src/collisions.c`

### Rendering and light

- [Scene drawing](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/draw.c): `src/draw.c`
- [Texture loading](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/textures.c): `src/textures.c`
- [Shadow casting](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/shadow_casting.c): `src/shadow_casting.c`
- [Room light maps](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/light_map.c): `src/light_map.c`

### Shared utilities

- [Tile and type rules](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/type.c): `src/type.c`
- [Geometry utilities](https://github.com/lepetitdhomme/room_base_procedural/blob/master/src/tools.c): `src/tools.c`

### Other components

- **Player**

## Connections

- Player → Input handling: provides controls
- SDL game loop → Level generation: initializes level (evidence: `src/main.c`)
- SDL game loop → World grid: maps level (evidence: `src/main.c`)
- SDL game loop → Input handling: handles events (evidence: `src/main.c`)
- SDL game loop → Player movement: updates movement (evidence: `src/main.c`)
- SDL game loop → Scene drawing: draws scene (evidence: `src/main.c`)
- SDL game loop → Shadow casting: casts shadows (evidence: `src/main.c`)
- Level generation → Room placement: uses room placement
- Level generation → Room connections: builds connections
- Level generation → Dungeon graph: builds graph
- Room connections → Connection helpers: uses helpers
- Dungeon graph → Doors: constructs doors
- Player movement → Collision checks: checks destination (evidence: `src/player.c`)
- Player movement → Doors: opens doors (evidence: `src/player.c`)
- Player movement → World grid: refreshes grid (evidence: `src/player.c`)
- Player movement → Room light maps: resets room light (evidence: `src/player.c`)
- Player movement → Tile and type rules: tests tile types (evidence: `src/player.c`)
- Scene drawing → Texture loading: uses textures
- Scene drawing → Tile and type rules: uses tile rules
- Shadow casting → Geometry utilities: uses geometry helpers
- Shadow casting → Tile and type rules: uses tile rules
- Room light maps → Tile and type rules: uses tile rules
