# ershany/arcane-engine architecture

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

- Interactive diagram: https://gitdiagram.com/ershany/arcane-engine
- Repository: https://github.com/ershany/arcane-engine

## Overview

Arcane is a real-time game engine with an editor/testbed. Its principal workflow is to author or inspect scene content, supply camera and lighting state, and render the scene using the engine’s rendering features. The graph preserves major README capabilities as distinct runtime subsystems; only relationships visible in sampled source or explicitly documented in the README are asserted. Several editor and render-pass connections remain unverified because their implementation files were not sampled.

Main entry points: [`Arcane/src/Arcane/Graphics/Renderer/Renderer.cpp`](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Renderer/Renderer.cpp) (Render pipeline), [`Arcane/src/Arcane/Scene/Scene.cpp`](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Scene/Scene.cpp) (Entity-component scene), [`Arcane/src/Arcane/Graphics/Lights/LightManager.cpp`](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Lights/LightManager.cpp) (Lights and shadows), [`Arcane/src/Arcane/Graphics/Water/WaterManager.cpp`](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Water/WaterManager.cpp) (Water simulation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editor["Editor and input"]
  node_editor_app["Editor application<br/>[EditorLayer.cpp]"]
  node_scene_panel["Scene panel<br/>[ScenePanel.cpp]"]
  node_inspector["Inspector panel<br/>[InspectorPanel.cpp]"]
  node_viewport["Editor viewport<br/>[EditorViewport.cpp]"]
  node_input["Input manager<br/>[InputManager.cpp]"]
end

subgraph group_runtime["Engine runtime"]
  node_camera["Camera controller"]
  node_application["Application loop<br/>[Application.cpp]"]
end

subgraph group_rendering["Rendering systems"]
  node_lighting["Lights and shadows<br/>[LightManager.cpp]"]
  node_probes["IBL probes<br/>[ProbeManager.cpp]"]
  node_volumetrics["Volumetric clouds"]
  node_water["Water simulation<br/>[WaterManager.cpp]"]
  node_renderer["Render pipeline<br/>[Renderer.cpp]"]
end

subgraph group_content["Scene and assets"]
  node_scene["Entity-component scene<br/>[Scene.cpp]"]
  node_assets["Asset manager<br/>[AssetManager.cpp]"]
  node_models["Model and mesh loading<br/>[Model.cpp]"]
  node_animation["Animation clips<br/>[AnimationClip.cpp]"]
  node_terrain["Terrain<br/>[Terrain.cpp]"]
end

node_developer(("Developer"))

node_developer -.->|"authors with"| node_editor_app
node_camera -->|"reads controls"| node_input
node_input -->|"provides input"| node_camera
node_lighting -->|"queries entities"| node_scene
node_water -->|"queries entities"| node_scene
node_assets -->|"loads models"| node_models
node_renderer -.->|"uses lighting"| node_lighting
node_renderer -.->|"uses probes"| node_probes
node_renderer -.->|"renders clouds"| node_volumetrics
node_renderer -.->|"renders water"| node_water
node_scene_panel -.->|"edits scene"| node_scene
node_inspector -.->|"edits components"| node_scene
node_viewport -.->|"shows scene"| node_renderer
node_scene -.->|"supports animation"| node_animation
node_scene -.->|"supports terrain"| node_terrain
node_renderer -.->|"supports forward and deferred"| node_lighting
node_renderer -.->|"supports IBL"| node_probes
node_renderer -.->|"supports clouds"| node_volumetrics
node_renderer -.->|"supports water"| node_water

click node_editor_app "https://github.com/ershany/arcane-engine/blob/master/Arcane%20Editor/src/EditorLayer.cpp"
click node_scene_panel "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Editor/ScenePanel.cpp"
click node_inspector "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Editor/InspectorPanel.cpp"
click node_viewport "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Editor/EditorViewport.cpp"
click node_input "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Input/InputManager.cpp"
click node_camera "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Camera/CameraController.cpp"
click node_application "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Core/Application.cpp"
click node_scene "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Scene/Scene.cpp"
click node_assets "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Util/Loaders/AssetManager.cpp"
click node_models "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Mesh/Model.cpp"
click node_lighting "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Lights/LightManager.cpp"
click node_probes "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/IBL/ProbeManager.cpp"
click node_volumetrics "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Volumetric/VolumetricManager.cpp"
click node_water "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Water/WaterManager.cpp"
click node_renderer "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Renderer/Renderer.cpp"
click node_animation "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Animation/AnimationClip.cpp"
click node_terrain "https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Terrain/Terrain.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_editor_app,node_scene_panel,node_inspector,node_viewport,node_input toneBlue
class node_camera,node_application toneAmber
class node_lighting,node_probes,node_volumetrics,node_water,node_renderer toneMint
class node_scene,node_assets,node_models,node_animation,node_terrain toneRose
class node_developer toneIndigo
```

## Components

### Editor and input

- [Editor application](https://github.com/ershany/arcane-engine/blob/master/Arcane%20Editor/src/EditorLayer.cpp): `Arcane Editor/src/EditorLayer.cpp`
- [Scene panel](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Editor/ScenePanel.cpp): `Arcane/src/Arcane/Editor/ScenePanel.cpp`
- [Inspector panel](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Editor/InspectorPanel.cpp): `Arcane/src/Arcane/Editor/InspectorPanel.cpp`
- [Editor viewport](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Editor/EditorViewport.cpp): `Arcane/src/Arcane/Editor/EditorViewport.cpp`
- [Input manager](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Input/InputManager.cpp): `Arcane/src/Arcane/Input/InputManager.cpp`

### Engine runtime

- [Camera controller](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Camera/CameraController.cpp): `Arcane/src/Arcane/Graphics/Camera/CameraController.cpp`
- [Application loop](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Core/Application.cpp): `Arcane/src/Arcane/Core/Application.cpp`

### Rendering systems

- [Lights and shadows](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Lights/LightManager.cpp): `Arcane/src/Arcane/Graphics/Lights/LightManager.cpp`
- [IBL probes](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/IBL/ProbeManager.cpp): `Arcane/src/Arcane/Graphics/IBL/ProbeManager.cpp`
- [Volumetric clouds](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Volumetric/VolumetricManager.cpp): `Arcane/src/Arcane/Graphics/Volumetric/VolumetricManager.cpp`
- [Water simulation](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Water/WaterManager.cpp): `Arcane/src/Arcane/Graphics/Water/WaterManager.cpp`
- [Render pipeline](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Renderer/Renderer.cpp): `Arcane/src/Arcane/Graphics/Renderer/Renderer.cpp`

### Scene and assets

- [Entity-component scene](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Scene/Scene.cpp): `Arcane/src/Arcane/Scene/Scene.cpp`
- [Asset manager](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Util/Loaders/AssetManager.cpp): `Arcane/src/Arcane/Util/Loaders/AssetManager.cpp`
- [Model and mesh loading](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Graphics/Mesh/Model.cpp): `Arcane/src/Arcane/Graphics/Mesh/Model.cpp`
- [Animation clips](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Animation/AnimationClip.cpp): `Arcane/src/Arcane/Animation/AnimationClip.cpp`
- [Terrain](https://github.com/ershany/arcane-engine/blob/master/Arcane/src/Arcane/Terrain/Terrain.cpp): `Arcane/src/Arcane/Terrain/Terrain.cpp`

### Other components

- **Developer**

## Connections

- Developer → Editor application: authors with
- Camera controller → Input manager: reads controls (evidence: `Arcane/src/Arcane/Graphics/Camera/CameraController.cpp`)
- Input manager → Camera controller: provides input (evidence: `Arcane/src/Arcane/Graphics/Camera/CameraController.cpp`)
- Lights and shadows → Entity-component scene: queries entities (evidence: `Arcane/src/Arcane/Graphics/Lights/LightManager.cpp`)
- Water simulation → Entity-component scene: queries entities (evidence: `Arcane/src/Arcane/Graphics/Water/WaterManager.cpp`)
- Asset manager → Model and mesh loading: loads models (evidence: `Arcane/src/Arcane/Util/Loaders/AssetManager.cpp`)
- Render pipeline → Lights and shadows: uses lighting
- Render pipeline → IBL probes: uses probes
- Render pipeline → Volumetric clouds: renders clouds
- Render pipeline → Water simulation: renders water
- Scene panel → Entity-component scene: edits scene
- Inspector panel → Entity-component scene: edits components
- Editor viewport → Render pipeline: shows scene
- Entity-component scene → Animation clips: supports animation
- Entity-component scene → Terrain: supports terrain
- Render pipeline → Lights and shadows: supports forward and deferred
- Render pipeline → IBL probes: supports IBL
- Render pipeline → Volumetric clouds: supports clouds
- Render pipeline → Water simulation: supports water
