# rajorshidas/ramenshop architecture

> Architecture diagram of the GitHub repository rajorshidas/ramenshop, 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/rajorshidas/ramenshop
- Repository: https://github.com/rajorshidas/ramenshop

## Overview

3D Ramen Shop is an interactive OpenGL scene with an optional cooking game. The main loop accepts camera, scene, and game input, updates animation and gameplay, then renders the shop and applies optional visual effects. The graph separates scene content, rendering support, and gameplay. Relationships are limited to calls shown in excerpts, source-index references, or README descriptions; some implementation details were not sampled, so uncertain links are omitted.

Main entry points: [`RamenShop/scene.cpp`](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/scene.cpp) (Scene Renderer), [`RamenShop/main.cpp`](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/main.cpp) (App Loop), [`RamenShop/game.cpp`](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/game.cpp) (Cooking Game), [`RamenShop/shadowmap.cpp`](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/shadowmap.cpp) (Soft Shadows)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["App Loop<br/>[main.cpp]"]
  node_camera["Camera Controls<br/>[camera.cpp]"]
  node_objects["Object Editing<br/>[objects.cpp]"]
end

subgraph group_world["Shop World"]
  node_scene["Scene Renderer<br/>[scene.cpp]"]
  node_exterior["Shop and Outdoors<br/>[exterior.cpp]"]
end

subgraph group_render["Rendering"]
  node_lighting["Lighting<br/>[lighting.cpp]"]
  node_shader["Phong Shader<br/>[shader.cpp]"]
  node_shadow["Soft Shadows<br/>[shadowmap.cpp]"]
  node_refraction["Glass Refraction<br/>[refraction.cpp]"]
  node_rtworld["Ray Scene<br/>[rtscene.cpp]"]
  node_rtcore["Ray Tracer<br/>[rtcore.cpp]"]
  node_rtpass["Ray Composite<br/>[rtpass.cpp]"]
end

subgraph group_gameplay["Cooking Game"]
  node_game["Cooking Game<br/>[game.cpp]"]
end

subgraph group_assets["Scene Assets"]
  node_furniture["Furniture<br/>[furniture.cpp]"]
  node_food["Food Models<br/>[food.cpp]"]
  node_decorations["Decorations<br/>[decorations.cpp]"]
  node_geometry["Geometry Primitives<br/>[shapes.cpp]"]
  node_textures["Procedural Textures<br/>[texture.cpp]"]
end

node_user(("Player"))

node_user -->|"controls"| node_main
node_main -->|"handles input"| node_camera
node_main -->|"draws scene"| node_scene
node_main -->|"updates lights"| node_lighting
node_main -->|"renders shadows"| node_shadow
node_main -->|"draws glass"| node_refraction
node_main -->|"renders rays"| node_rtpass
node_main -->|"updates game"| node_game
node_main -->|"draws HUD"| node_game
node_camera -->|"uses scene state"| node_scene
node_scene -->|"draws environment"| node_exterior
node_scene -->|"draws furnishings"| node_furniture
node_scene -->|"draws food"| node_food
node_scene -->|"draws decor"| node_decorations
node_furniture -->|"applies transforms"| node_objects
node_exterior -->|"uses primitives"| node_geometry
node_food -->|"uses primitives"| node_geometry
node_geometry -->|"uses textures"| node_textures
node_scene -->|"sets light scope"| node_lighting
node_shadow -->|"draws casters"| node_scene
node_shadow -->|"supplies shadow map"| node_shader
node_refraction -->|"captures backdrop"| node_scene
node_rtpass -->|"builds ray scene"| node_rtworld
node_rtpass -->|"traces pixels"| node_rtcore
node_rtworld -->|"rebuilds shop"| node_scene
node_game -->|"uses player view"| node_camera
node_game -->|"uses ramen models"| node_food

click node_main "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/main.cpp"
click node_camera "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/camera.cpp"
click node_objects "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/objects.cpp"
click node_scene "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/scene.cpp"
click node_exterior "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/exterior.cpp"
click node_furniture "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/furniture.cpp"
click node_food "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/food.cpp"
click node_decorations "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/decorations.cpp"
click node_geometry "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/shapes.cpp"
click node_textures "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/texture.cpp"
click node_lighting "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/lighting.cpp"
click node_shader "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/shader.cpp"
click node_shadow "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/shadowmap.cpp"
click node_refraction "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/refraction.cpp"
click node_rtworld "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/rtscene.cpp"
click node_rtcore "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/rtcore.cpp"
click node_rtpass "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/rtpass.cpp"
click node_game "https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/game.cpp"

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,node_camera,node_objects toneBlue
class node_scene,node_exterior toneAmber
class node_lighting,node_shader,node_shadow,node_refraction,node_rtworld,node_rtcore,node_rtpass toneMint
class node_game toneRose
class node_furniture,node_food,node_decorations,node_geometry,node_textures,node_user toneIndigo
```

## Components

### Application

- [App Loop](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/main.cpp): `RamenShop/main.cpp`
- [Camera Controls](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/camera.cpp): `RamenShop/camera.cpp`
- [Object Editing](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/objects.cpp): `RamenShop/objects.cpp`

### Shop World

- [Scene Renderer](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/scene.cpp): `RamenShop/scene.cpp`
- [Shop and Outdoors](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/exterior.cpp): `RamenShop/exterior.cpp`

### Rendering

- [Lighting](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/lighting.cpp): `RamenShop/lighting.cpp`
- [Phong Shader](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/shader.cpp): `RamenShop/shader.cpp`
- [Soft Shadows](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/shadowmap.cpp): `RamenShop/shadowmap.cpp`
- [Glass Refraction](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/refraction.cpp): `RamenShop/refraction.cpp`
- [Ray Scene](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/rtscene.cpp): `RamenShop/rtscene.cpp`
- [Ray Tracer](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/rtcore.cpp): `RamenShop/rtcore.cpp`
- [Ray Composite](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/rtpass.cpp): `RamenShop/rtpass.cpp`

### Cooking Game

- [Cooking Game](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/game.cpp): `RamenShop/game.cpp`

### Scene Assets

- [Furniture](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/furniture.cpp): `RamenShop/furniture.cpp`
- [Food Models](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/food.cpp): `RamenShop/food.cpp`
- [Decorations](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/decorations.cpp): `RamenShop/decorations.cpp`
- [Geometry Primitives](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/shapes.cpp): `RamenShop/shapes.cpp`
- [Procedural Textures](https://github.com/rajorshidas/ramenshop/blob/master/RamenShop/texture.cpp): `RamenShop/texture.cpp`

### Other components

- **Player**

## Connections

- Player → App Loop: controls (evidence: `README.md`)
- App Loop → Camera Controls: handles input (evidence: `RamenShop/main.cpp`)
- App Loop → Scene Renderer: draws scene (evidence: `RamenShop/main.cpp`)
- App Loop → Lighting: updates lights (evidence: `RamenShop/main.cpp`)
- App Loop → Soft Shadows: renders shadows (evidence: `RamenShop/main.cpp`)
- App Loop → Glass Refraction: draws glass (evidence: `RamenShop/main.cpp`)
- App Loop → Ray Composite: renders rays (evidence: `RamenShop/main.cpp`)
- App Loop → Cooking Game: updates game (evidence: `RamenShop/main.cpp`)
- App Loop → Cooking Game: draws HUD (evidence: `RamenShop/main.cpp`)
- Camera Controls → Scene Renderer: uses scene state (evidence: `RamenShop/camera.cpp`)
- Scene Renderer → Shop and Outdoors: draws environment (evidence: `RamenShop/scene.cpp`)
- Scene Renderer → Furniture: draws furnishings (evidence: `RamenShop/scene.cpp`)
- Scene Renderer → Food Models: draws food (evidence: `RamenShop/scene.cpp`)
- Scene Renderer → Decorations: draws decor (evidence: `RamenShop/scene.cpp`)
- Furniture → Object Editing: applies transforms (evidence: `RamenShop/furniture.cpp`)
- Shop and Outdoors → Geometry Primitives: uses primitives (evidence: `RamenShop/exterior.cpp`)
- Food Models → Geometry Primitives: uses primitives (evidence: `RamenShop/food.cpp`)
- Geometry Primitives → Procedural Textures: uses textures
- Scene Renderer → Lighting: sets light scope (evidence: `RamenShop/scene.cpp`)
- Soft Shadows → Scene Renderer: draws casters (evidence: `RamenShop/shadowmap.cpp`)
- Soft Shadows → Phong Shader: supplies shadow map (evidence: `RamenShop/shadowmap.cpp`)
- Glass Refraction → Scene Renderer: captures backdrop (evidence: `RamenShop/refraction.cpp`)
- Ray Composite → Ray Scene: builds ray scene (evidence: `RamenShop/rtpass.cpp`)
- Ray Composite → Ray Tracer: traces pixels (evidence: `RamenShop/rtpass.cpp`)
- Ray Scene → Scene Renderer: rebuilds shop (evidence: `RamenShop/rtscene.cpp`)
- Cooking Game → Camera Controls: uses player view (evidence: `RamenShop/game.cpp`)
- Cooking Game → Food Models: uses ramen models (evidence: `RamenShop/game.cpp`)
