# sudharsanzen/akame architecture

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

- Interactive diagram: https://gitdiagram.com/sudharsanzen/akame
- Repository: https://github.com/sudharsanzen/akame

## Overview

Akame is an OpenGL graphics framework and an in-progress game engine/editor. The documented runtime workflow is to initialize a window and scene, create ECS entities with renderable or lighting components, then render the scene in the application loop. The graph also preserves documented editor, animation, physics, scripting, serialization, and custom-rendering capabilities. Some subsystem links are dashed because their implementations were not excerpted; the graph does not infer calls from names alone.

Main entry points: [`AkameCore/Source Files/Rendering/System/RenderingSystem.cpp`](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/System/RenderingSystem.cpp) (Rendering system), [`tools/AkameExporter/ExporterUI.cpp`](https://github.com/sudharsanzen/akame/blob/main/tools/AkameExporter/ExporterUI.cpp) (Akame exporter), [`AkameCore/Source Files/Core/Scene.cpp`](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Scene.cpp) (Scene runtime), [`AkameCore/Source Files/Core/Editor/EditorUI.cpp`](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Editor/EditorUI.cpp) (Editor UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and ECS"]
  node_window["Window and input<br/>[Window.cpp]"]
  node_scene["Scene runtime<br/>[Scene.cpp]"]
  node_ecs["Entity component system<br/>[ECS.h]"]
  node_components["Entity components<br/>[Components.cpp]"]
end

subgraph group_render["Graphics and Animation"]
  node_render_system["Rendering system"]
  node_pipelines["Render pipelines"]
  node_shaders["Shaders and materials<br/>[Shader.cpp]"]
  node_camera["Camera<br/>[Camera.cpp]"]
  node_lighting["Lighting and shadows<br/>[LightSystem.cpp]"]
  node_animation["Skeletal animation"]
  node_skinned["Skinned rendering"]
end

subgraph group_editor["Editor and Content"]
  node_editor["Editor UI<br/>[EditorUI.cpp]"]
  node_inspector["Entity inspector"]
  node_hierarchy["Scene hierarchy"]
  node_content["Content browser<br/>[ContentBrowser.cpp]"]
  node_exporter["Akame exporter<br/>[ExporterUI.cpp]"]
end

subgraph group_domain["Game Systems"]
  node_physics["Physics system"]
  node_scripting["Behavior scripting"]
  node_serialization["Scene serialization"]
  node_reflection["Reflection metadata<br/>[ReflectionMeta.cpp]"]
end

node_developer(("Application developer"))
node_opengl{{"OpenGL"}}
node_user(("Player"))

node_developer -->|"initializes"| node_window
node_developer -->|"creates scene"| node_scene
node_scene -->|"creates entities"| node_ecs
node_developer -->|"adds components"| node_components
node_scene -->|"renders scene"| node_render_system
node_render_system -.->|"uses pipeline"| node_pipelines
node_render_system -->|"renders from"| node_camera
node_render_system -->|"uses lighting"| node_lighting
node_pipelines -->|"sets uniforms"| node_shaders
node_animation -->|"updates bones"| node_components
node_skinned -->|"reads pose"| node_animation
node_skinned -->|"reads light data"| node_lighting
node_render_system -.->|"renders via"| node_opengl
node_user -.->|"provides input"| node_window
node_editor -.->|"provides window"| node_inspector
node_editor -.->|"provides window"| node_hierarchy
node_editor -.->|"provides browser"| node_content
node_editor -.->|"edits scene"| node_scene
node_exporter -->|"uses"| node_inspector
node_exporter -->|"uses"| node_hierarchy
node_exporter -->|"uses"| node_render_system
node_exporter -->|"uses"| node_lighting
node_exporter -->|"exports models"| node_serialization
node_scene -.->|"serializes scene"| node_serialization
node_inspector -.->|"inspects properties"| node_reflection
node_ecs -.->|"supports physics"| node_physics
node_ecs -.->|"supports behaviors"| node_scripting

click node_window "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Window.cpp"
click node_scene "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Scene.cpp"
click node_ecs "https://github.com/sudharsanzen/akame/blob/main/ECS/HeaderFiles/ECS.h"
click node_components "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Components/Components.cpp"
click node_render_system "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/System/RenderingSystem.cpp"
click node_pipelines "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/System/BuiltInShaderPipelines/DeferredPipeline.cpp"
click node_shaders "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/Shader.cpp"
click node_camera "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/Camera.cpp"
click node_lighting "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/System/LightSystem.cpp"
click node_animation "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Animation/AnimationControllerSystem.cpp"
click node_skinned "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Animation/SkinnedRendererPipeline.cpp"
click node_physics "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Physics/System/RigidBodySystem.cpp"
click node_scripting "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Scripting/BehaviourSystem.cpp"
click node_serialization "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/SceneSerialization.cpp"
click node_reflection "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Reflection/ReflectionMeta.cpp"
click node_editor "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Editor/EditorUI.cpp"
click node_inspector "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Editor/InspectorWindow.cpp"
click node_hierarchy "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Editor/SceneHierarchyWindow.cpp"
click node_content "https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Editor/ContentBrowser.cpp"
click node_exporter "https://github.com/sudharsanzen/akame/blob/main/tools/AkameExporter/ExporterUI.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_window,node_scene,node_ecs,node_components toneBlue
class node_render_system,node_pipelines,node_shaders,node_camera,node_lighting,node_animation,node_skinned toneAmber
class node_editor,node_inspector,node_hierarchy,node_content,node_exporter toneMint
class node_physics,node_scripting,node_serialization,node_reflection toneRose
class node_developer,node_opengl,node_user toneIndigo
```

## Components

### Runtime and ECS

- [Window and input](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Window.cpp): `AkameCore/Source Files/Core/Window.cpp`
- [Scene runtime](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Scene.cpp): `AkameCore/Source Files/Core/Scene.cpp`
- [Entity component system](https://github.com/sudharsanzen/akame/blob/main/ECS/HeaderFiles/ECS.h): `ECS/HeaderFiles/ECS.h`
- [Entity components](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Components/Components.cpp): `AkameCore/Source Files/Components/Components.cpp`

### Graphics and Animation

- [Rendering system](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/System/RenderingSystem.cpp): `AkameCore/Source Files/Rendering/System/RenderingSystem.cpp`
- [Render pipelines](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/System/BuiltInShaderPipelines/DeferredPipeline.cpp): `AkameCore/Source Files/Rendering/System/BuiltInShaderPipelines/DeferredPipeline.cpp`
- [Shaders and materials](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/Shader.cpp): `AkameCore/Source Files/Rendering/Shader.cpp`
- [Camera](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/Camera.cpp): `AkameCore/Source Files/Rendering/Camera.cpp`
- [Lighting and shadows](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Rendering/System/LightSystem.cpp): `AkameCore/Source Files/Rendering/System/LightSystem.cpp`
- [Skeletal animation](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Animation/AnimationControllerSystem.cpp): `AkameCore/Source Files/Animation/AnimationControllerSystem.cpp`
- [Skinned rendering](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Animation/SkinnedRendererPipeline.cpp): `AkameCore/Source Files/Animation/SkinnedRendererPipeline.cpp`

### Editor and Content

- [Editor UI](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Editor/EditorUI.cpp): `AkameCore/Source Files/Core/Editor/EditorUI.cpp`
- [Entity inspector](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Editor/InspectorWindow.cpp): `AkameCore/Source Files/Core/Editor/InspectorWindow.cpp`
- [Scene hierarchy](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Editor/SceneHierarchyWindow.cpp): `AkameCore/Source Files/Core/Editor/SceneHierarchyWindow.cpp`
- [Content browser](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Editor/ContentBrowser.cpp): `AkameCore/Source Files/Core/Editor/ContentBrowser.cpp`
- [Akame exporter](https://github.com/sudharsanzen/akame/blob/main/tools/AkameExporter/ExporterUI.cpp): `tools/AkameExporter/ExporterUI.cpp`

### Game Systems

- [Physics system](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Physics/System/RigidBodySystem.cpp): `AkameCore/Source Files/Physics/System/RigidBodySystem.cpp`
- [Behavior scripting](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Scripting/BehaviourSystem.cpp): `AkameCore/Source Files/Scripting/BehaviourSystem.cpp`
- [Scene serialization](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/SceneSerialization.cpp): `AkameCore/Source Files/Core/SceneSerialization.cpp`
- [Reflection metadata](https://github.com/sudharsanzen/akame/blob/main/AkameCore/Source%20Files/Core/Reflection/ReflectionMeta.cpp): `AkameCore/Source Files/Core/Reflection/ReflectionMeta.cpp`

### Other components

- **Application developer**
- **OpenGL**
- **Player**

## Connections

- Application developer → Window and input: initializes
- Application developer → Scene runtime: creates scene
- Scene runtime → Entity component system: creates entities
- Application developer → Entity components: adds components
- Scene runtime → Rendering system: renders scene
- Rendering system → Render pipelines: uses pipeline
- Rendering system → Camera: renders from
- Rendering system → Lighting and shadows: uses lighting
- Render pipelines → Shaders and materials: sets uniforms (evidence: `AkameCore/Source Files/Rendering/System/BuiltInShaderPipelines/DeferredPipeline.cpp`)
- Skeletal animation → Entity components: updates bones (evidence: `AkameCore/Source Files/Animation/AnimationControllerSystem.cpp`)
- Skinned rendering → Skeletal animation: reads pose (evidence: `AkameCore/Source Files/Animation/SkinnedRendererPipeline.cpp`)
- Skinned rendering → Lighting and shadows: reads light data (evidence: `AkameCore/Source Files/Animation/SkinnedRendererPipeline.cpp`)
- Rendering system → OpenGL: renders via
- Player → Window and input: provides input
- Editor UI → Entity inspector: provides window
- Editor UI → Scene hierarchy: provides window
- Editor UI → Content browser: provides browser
- Editor UI → Scene runtime: edits scene
- Akame exporter → Entity inspector: uses (evidence: `tools/AkameExporter/ExporterUI.cpp`)
- Akame exporter → Scene hierarchy: uses (evidence: `tools/AkameExporter/ExporterUI.cpp`)
- Akame exporter → Rendering system: uses (evidence: `tools/AkameExporter/ExporterUI.cpp`)
- Akame exporter → Lighting and shadows: uses (evidence: `tools/AkameExporter/ExporterUI.cpp`)
- Akame exporter → Scene serialization: exports models (evidence: `tools/AkameExporter/ExporterUI.cpp`)
- Scene runtime → Scene serialization: serializes scene
- Entity inspector → Reflection metadata: inspects properties
- Entity component system → Physics system: supports physics
- Entity component system → Behavior scripting: supports behaviors
