# jeanphilippekernel/rendererengine architecture

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

## Overview

ZEngine is a cross-platform Vulkan 3D engine, with Tetragrama as its native scene-authoring and asset-management editor. The principal workflow is an editor user opening or changing a scene, managing project assets, then viewing the scene through the engine’s render pipeline; scene serialization and asset cooking support persistence and prepared content. The graph also shows core runtime layers and documented editor capabilities. Some subsystem links are dashed because the sampled source does not expose their callers or wiring.

Main entry points: [`Tetragrama/Panels/ZUIPanelManagerComponent.cpp`](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/ZUIPanelManagerComponent.cpp) (Docked Panels), [`Tetragrama/EditorScene.cpp`](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/EditorScene.cpp) (Scene Editing), [`ZEngine/ZEngine/Applications/AppRenderPipeline.cpp`](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Applications/AppRenderPipeline.cpp) (App Render Pipeline), [`ZEngine/ZEngine/Managers/AssetManager.cpp`](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Managers/AssetManager.cpp) (Asset Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_editor["Tetragrama Editor"]
  node_editor_ui["Editor UI<br/>[ZUILayer.cpp]"]
  node_panels["Docked Panels"]
  node_scene_edit["Scene Editing<br/>[EditorScene.cpp]"]
  node_selection["Hierarchy and Inspector<br/>[HierarchyPanel.cpp]"]
  node_viewport["Scene Viewport<br/>[ViewportPanel.cpp]"]
  node_gizmos["Scene Gizmos"]
end

subgraph group_content["Content and Scenes"]
  node_scene_io["Scene Serialization"]
  node_asset_browser["Project Browser"]
  node_importer_ui["Asset Import UI"]
  node_thumbnails["Thumbnail Service"]
  node_assets["Asset Manager<br/>[AssetManager.cpp]"]
  node_cooking["Scene Cooking<br/>[SceneCooker.cpp]"]
end

subgraph group_runtime["Engine Runtime"]
  node_ecs[("ECS Scene<br/>[Scene.cpp]")]
  node_engine["Engine Lifecycle<br/>[Engine.cpp]"]
end

subgraph group_rendering["Rendering"]
  node_app_render["App Render Pipeline"]
  node_resources["Render Resources"]
  node_renderer["Renderer Pipeline"]
end

subgraph group_platform["Platform Services"]
  node_vfs["Virtual Filesystem<br/>[VFSContext.cpp]"]
  node_input["Input Manager<br/>[InputManager.cpp]"]
  node_vulkan["Vulkan Device<br/>[VulkanDevice.cpp]"]
end

node_user(("Editor User"))

node_user -.->|"authors in"| node_editor_ui
node_editor_ui -.->|"hosts panels"| node_panels
node_panels -.->|"displays"| node_selection
node_panels -.->|"displays"| node_viewport
node_panels -.->|"displays"| node_asset_browser
node_panels -->|"hosts importer"| node_importer_ui
node_panels -->|"initializes"| node_thumbnails
node_selection -.->|"edits selection"| node_scene_edit
node_viewport -.->|"requests view"| node_app_render
node_gizmos -.->|"manipulates"| node_scene_edit
node_scene_edit -.->|"updates scene"| node_ecs
node_scene_edit -.->|"serializes scene"| node_scene_io
node_scene_io -.->|"persists data"| node_vfs
node_asset_browser -.->|"browses assets"| node_assets
node_importer_ui -.->|"requests imports"| node_assets
node_thumbnails -->|"loads asset data"| node_assets
node_assets -.->|"uses asset paths"| node_vfs
node_cooking -.->|"cooks scene data"| node_ecs
node_engine -->|"initializes context"| node_vfs
node_engine -.->|"runs rendering"| node_app_render
node_input -.->|"drives controls"| node_viewport
node_app_render -->|"prepares scene view"| node_resources
node_app_render -.->|"builds render passes"| node_renderer
node_renderer -->|"creates pipelines"| node_vulkan

click node_editor_ui "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Layers/ZUILayer.cpp"
click node_panels "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/ZUIPanelManagerComponent.cpp"
click node_scene_edit "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/EditorScene.cpp"
click node_selection "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/HierarchyPanel.cpp"
click node_viewport "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/ViewportPanel.cpp"
click node_gizmos "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Gizmo/GizmoFrameBuilder.cpp"
click node_scene_io "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Serializers/EditorSceneSerializer.cpp"
click node_asset_browser "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/ProjectViewPanel.cpp"
click node_importer_ui "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/AssetImporterPanel.cpp"
click node_thumbnails "https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Thumbnails/ThumbnailService.cpp"
click node_assets "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Managers/AssetManager.cpp"
click node_vfs "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Core/VFS/VFSContext.cpp"
click node_cooking "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Cook/SceneCooker.cpp"
click node_ecs "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/ECS/Scene.cpp"
click node_engine "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Engine.cpp"
click node_input "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Input/InputManager.cpp"
click node_app_render "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Applications/AppRenderPipeline.cpp"
click node_resources "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Rendering/RenderResourceManager.cpp"
click node_renderer "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Rendering/Renderers/Pipelines/RendererPipeline.cpp"
click node_vulkan "https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Hardwares/VulkanDevice.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_ui,node_panels,node_scene_edit,node_selection,node_viewport,node_gizmos,node_user toneBlue
class node_scene_io,node_asset_browser,node_importer_ui,node_thumbnails,node_assets,node_cooking toneAmber
class node_ecs,node_engine toneMint
class node_app_render,node_resources,node_renderer toneRose
class node_vfs,node_input,node_vulkan toneIndigo
```

## Components

### Tetragrama Editor

- [Editor UI](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Layers/ZUILayer.cpp): `Tetragrama/Layers/ZUILayer.cpp`
- [Docked Panels](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/ZUIPanelManagerComponent.cpp): `Tetragrama/Panels/ZUIPanelManagerComponent.cpp`
- [Scene Editing](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/EditorScene.cpp): `Tetragrama/EditorScene.cpp`
- [Hierarchy and Inspector](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/HierarchyPanel.cpp): `Tetragrama/Panels/HierarchyPanel.cpp`
- [Scene Viewport](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/ViewportPanel.cpp): `Tetragrama/Panels/ViewportPanel.cpp`
- [Scene Gizmos](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Gizmo/GizmoFrameBuilder.cpp): `Tetragrama/Gizmo/GizmoFrameBuilder.cpp`

### Content and Scenes

- [Scene Serialization](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Serializers/EditorSceneSerializer.cpp): `Tetragrama/Serializers/EditorSceneSerializer.cpp`
- [Project Browser](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/ProjectViewPanel.cpp): `Tetragrama/Panels/ProjectViewPanel.cpp`
- [Asset Import UI](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Panels/AssetImporterPanel.cpp): `Tetragrama/Panels/AssetImporterPanel.cpp`
- [Thumbnail Service](https://github.com/jeanphilippekernel/rendererengine/blob/develop/Tetragrama/Thumbnails/ThumbnailService.cpp): `Tetragrama/Thumbnails/ThumbnailService.cpp`
- [Asset Manager](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Managers/AssetManager.cpp): `ZEngine/ZEngine/Managers/AssetManager.cpp`
- [Scene Cooking](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Cook/SceneCooker.cpp): `ZEngine/ZEngine/Cook/SceneCooker.cpp`

### Engine Runtime

- [ECS Scene](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/ECS/Scene.cpp): `ZEngine/ZEngine/ECS/Scene.cpp`
- [Engine Lifecycle](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Engine.cpp): `ZEngine/ZEngine/Engine.cpp`

### Rendering

- [App Render Pipeline](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Applications/AppRenderPipeline.cpp): `ZEngine/ZEngine/Applications/AppRenderPipeline.cpp`
- [Render Resources](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Rendering/RenderResourceManager.cpp): `ZEngine/ZEngine/Rendering/RenderResourceManager.cpp`
- [Renderer Pipeline](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Rendering/Renderers/Pipelines/RendererPipeline.cpp): `ZEngine/ZEngine/Rendering/Renderers/Pipelines/RendererPipeline.cpp`

### Platform Services

- [Virtual Filesystem](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Core/VFS/VFSContext.cpp): `ZEngine/ZEngine/Core/VFS/VFSContext.cpp`
- [Input Manager](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Input/InputManager.cpp): `ZEngine/ZEngine/Input/InputManager.cpp`
- [Vulkan Device](https://github.com/jeanphilippekernel/rendererengine/blob/develop/ZEngine/ZEngine/Hardwares/VulkanDevice.cpp): `ZEngine/ZEngine/Hardwares/VulkanDevice.cpp`

### Other components

- **Editor User**

## Connections

- Editor User → Editor UI: authors in (evidence: `README.md`)
- Editor UI → Docked Panels: hosts panels
- Docked Panels → Hierarchy and Inspector: displays
- Docked Panels → Scene Viewport: displays
- Docked Panels → Project Browser: displays
- Docked Panels → Asset Import UI: hosts importer (evidence: `Tetragrama/Panels/ZUIPanelManagerComponent.cpp`)
- Docked Panels → Thumbnail Service: initializes (evidence: `Tetragrama/Panels/ZUIPanelManagerComponent.cpp`)
- Hierarchy and Inspector → Scene Editing: edits selection
- Scene Viewport → App Render Pipeline: requests view
- Scene Gizmos → Scene Editing: manipulates
- Scene Editing → ECS Scene: updates scene
- Scene Editing → Scene Serialization: serializes scene
- Scene Serialization → Virtual Filesystem: persists data
- Project Browser → Asset Manager: browses assets
- Asset Import UI → Asset Manager: requests imports
- Thumbnail Service → Asset Manager: loads asset data (evidence: `Tetragrama/Thumbnails/ThumbnailService.cpp`)
- Asset Manager → Virtual Filesystem: uses asset paths
- Scene Cooking → ECS Scene: cooks scene data
- Engine Lifecycle → Virtual Filesystem: initializes context (evidence: `ZEngine/ZEngine/Engine.cpp`)
- Engine Lifecycle → App Render Pipeline: runs rendering
- Input Manager → Scene Viewport: drives controls
- App Render Pipeline → Render Resources: prepares scene view (evidence: `ZEngine/ZEngine/Applications/AppRenderPipeline.cpp`)
- App Render Pipeline → Renderer Pipeline: builds render passes
- Renderer Pipeline → Vulkan Device: creates pipelines (evidence: `ZEngine/ZEngine/Rendering/Renderers/Pipelines/RendererPipeline.cpp`)
