# programier/trinex-engine architecture

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

- Interactive diagram: https://gitdiagram.com/programier/trinex-engine
- Repository: https://github.com/programier/trinex-engine

## Overview

Trinex Engine is a cross-platform game engine, with an optional editor and an embedded AngelScript integration. The intended workflow is an application or user entering the engine, which runs its loop and exposes rendering and scripting capabilities; the editor tree also shows material and pipeline editing. The sampled evidence identifies these subsystems but rarely shows their runtime wiring, so uncertain relationships are omitted or marked dashed with no evidence path. Third-party libraries and build infrastructure are not mapped as product components.

Main entry points: [`editor/src/UI/client.cpp`](https://github.com/programier/trinex-engine/blob/main/editor/src/UI/client.cpp) (Editor UI), [`src/Graphics/pipeline.cpp`](https://github.com/programier/trinex-engine/blob/main/src/Graphics/pipeline.cpp) (Pipeline API), [`libs/angelscript/source/as_scriptengine.cpp`](https://github.com/programier/trinex-engine/blob/main/libs/angelscript/source/as_scriptengine.cpp) (AngelScript Runtime), [`src/Core/engine_loop.cpp`](https://github.com/programier/trinex-engine/blob/main/src/Core/engine_loop.cpp) (Engine Loop)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Engine Runtime"]
  node_loop["Engine Loop<br/>[engine_loop.cpp]"]
  node_base["Engine Core<br/>[base_engine.cpp]"]
  node_default_client["Default Client<br/>[default_client.cpp]"]
end

subgraph group_render["Rendering"]
  node_render_pipelines["Render Pipelines<br/>[pipelines.cpp]"]
  node_pipeline_api["Pipeline API<br/>[pipeline.cpp]"]
  node_pipeline_library["Pipeline Library"]
  node_vulkan["Vulkan Backend"]
  node_d3d12["D3D12 Backend<br/>[dx12_pipeline.cpp]"]
end

subgraph group_scripting["Scripting"]
  node_script_api["Script Engine API<br/>[script_engine.cpp]"]
  node_angel_runtime["AngelScript Runtime"]
  node_script_modules["Script Modules<br/>[as_module.h]"]
  node_script_builder["Script Builder<br/>[as_builder.h]"]
end

subgraph group_editor["Editor"]
  node_editor_engine["Editor Engine<br/>[engine.cpp]"]
  node_editor_ui["Editor UI<br/>[client.cpp]"]
  node_material_editor["Material Editor"]
  node_pipeline_editor["Pipeline Editor"]
  node_editor_pipelines["Editor Pipelines"]
  node_texture_editor["Texture Editor"]
  node_mesh_editor["Static Mesh Editor"]
end

node_app(("Application"))

node_app -.->|"starts"| node_loop
node_loop -.->|"runs"| node_base
node_base -.->|"provides"| node_default_client
node_default_client -.->|"uses"| node_render_pipelines
node_render_pipelines -.->|"uses"| node_pipeline_api
node_pipeline_api -.->|"resolves"| node_pipeline_library
node_pipeline_api -.->|"dispatches"| node_vulkan
node_pipeline_api -.->|"dispatches"| node_d3d12
node_app -.->|"uses"| node_script_api
node_script_api -->|"creates"| node_angel_runtime
node_angel_runtime -->|"uses"| node_script_modules
node_angel_runtime -->|"uses"| node_script_builder
node_app -.->|"opens"| node_editor_engine
node_editor_engine -.->|"uses"| node_editor_ui
node_editor_ui -.->|"hosts"| node_material_editor
node_editor_ui -.->|"hosts"| node_pipeline_editor
node_pipeline_editor -.->|"edits"| node_editor_pipelines
node_editor_ui -.->|"hosts"| node_texture_editor
node_editor_ui -.->|"hosts"| node_mesh_editor

click node_loop "https://github.com/programier/trinex-engine/blob/main/src/Core/engine_loop.cpp"
click node_base "https://github.com/programier/trinex-engine/blob/main/src/Core/base_engine.cpp"
click node_default_client "https://github.com/programier/trinex-engine/blob/main/src/Engine/default_client.cpp"
click node_render_pipelines "https://github.com/programier/trinex-engine/blob/main/src/Engine/Render/pipelines.cpp"
click node_pipeline_api "https://github.com/programier/trinex-engine/blob/main/src/Graphics/pipeline.cpp"
click node_pipeline_library "https://github.com/programier/trinex-engine/blob/main/src/Graphics/pipeline_library.cpp"
click node_vulkan "https://github.com/programier/trinex-engine/blob/main/src/RHI/Vulkan/src/vulkan_pipeline.cpp"
click node_d3d12 "https://github.com/programier/trinex-engine/blob/main/src/RHI/D3D12/src/dx12_pipeline.cpp"
click node_script_api "https://github.com/programier/trinex-engine/blob/main/src/ScriptEngine/script_engine.cpp"
click node_angel_runtime "https://github.com/programier/trinex-engine/blob/main/libs/angelscript/source/as_scriptengine.cpp"
click node_script_modules "https://github.com/programier/trinex-engine/blob/main/libs/angelscript/source/as_module.h"
click node_script_builder "https://github.com/programier/trinex-engine/blob/main/libs/angelscript/source/as_builder.h"
click node_editor_engine "https://github.com/programier/trinex-engine/blob/main/editor/src/Editor/engine.cpp"
click node_editor_ui "https://github.com/programier/trinex-engine/blob/main/editor/src/UI/client.cpp"
click node_material_editor "https://github.com/programier/trinex-engine/blob/main/editor/src/Clients/materials/visual_material_client.cpp"
click node_pipeline_editor "https://github.com/programier/trinex-engine/blob/main/editor/src/Clients/pipeline_editor_client.cpp"
click node_editor_pipelines "https://github.com/programier/trinex-engine/blob/main/editor/src/Graphics/editor_pipelines.cpp"
click node_texture_editor "https://github.com/programier/trinex-engine/blob/main/editor/include/Clients/texture_editor_client.hpp"
click node_mesh_editor "https://github.com/programier/trinex-engine/blob/main/editor/include/Clients/static_mesh_client.hpp"

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_loop,node_base,node_default_client toneBlue
class node_render_pipelines,node_pipeline_api,node_pipeline_library,node_vulkan,node_d3d12 toneAmber
class node_script_api,node_angel_runtime,node_script_modules,node_script_builder toneMint
class node_editor_engine,node_editor_ui,node_material_editor,node_pipeline_editor,node_editor_pipelines,node_texture_editor,node_mesh_editor toneRose
class node_app toneIndigo
```

## Components

### Engine Runtime

- [Engine Loop](https://github.com/programier/trinex-engine/blob/main/src/Core/engine_loop.cpp): `src/Core/engine_loop.cpp`
- [Engine Core](https://github.com/programier/trinex-engine/blob/main/src/Core/base_engine.cpp): `src/Core/base_engine.cpp`
- [Default Client](https://github.com/programier/trinex-engine/blob/main/src/Engine/default_client.cpp): `src/Engine/default_client.cpp`

### Rendering

- [Render Pipelines](https://github.com/programier/trinex-engine/blob/main/src/Engine/Render/pipelines.cpp): `src/Engine/Render/pipelines.cpp`
- [Pipeline API](https://github.com/programier/trinex-engine/blob/main/src/Graphics/pipeline.cpp): `src/Graphics/pipeline.cpp`
- [Pipeline Library](https://github.com/programier/trinex-engine/blob/main/src/Graphics/pipeline_library.cpp): `src/Graphics/pipeline_library.cpp`
- [Vulkan Backend](https://github.com/programier/trinex-engine/blob/main/src/RHI/Vulkan/src/vulkan_pipeline.cpp): `src/RHI/Vulkan/src/vulkan_pipeline.cpp`
- [D3D12 Backend](https://github.com/programier/trinex-engine/blob/main/src/RHI/D3D12/src/dx12_pipeline.cpp): `src/RHI/D3D12/src/dx12_pipeline.cpp`

### Scripting

- [Script Engine API](https://github.com/programier/trinex-engine/blob/main/src/ScriptEngine/script_engine.cpp): `src/ScriptEngine/script_engine.cpp`
- [AngelScript Runtime](https://github.com/programier/trinex-engine/blob/main/libs/angelscript/source/as_scriptengine.cpp): `libs/angelscript/source/as_scriptengine.cpp`
- [Script Modules](https://github.com/programier/trinex-engine/blob/main/libs/angelscript/source/as_module.h): `libs/angelscript/source/as_module.h`
- [Script Builder](https://github.com/programier/trinex-engine/blob/main/libs/angelscript/source/as_builder.h): `libs/angelscript/source/as_builder.h`

### Editor

- [Editor Engine](https://github.com/programier/trinex-engine/blob/main/editor/src/Editor/engine.cpp): `editor/src/Editor/engine.cpp`
- [Editor UI](https://github.com/programier/trinex-engine/blob/main/editor/src/UI/client.cpp): `editor/src/UI/client.cpp`
- [Material Editor](https://github.com/programier/trinex-engine/blob/main/editor/src/Clients/materials/visual_material_client.cpp): `editor/src/Clients/materials/visual_material_client.cpp`
- [Pipeline Editor](https://github.com/programier/trinex-engine/blob/main/editor/src/Clients/pipeline_editor_client.cpp): `editor/src/Clients/pipeline_editor_client.cpp`
- [Editor Pipelines](https://github.com/programier/trinex-engine/blob/main/editor/src/Graphics/editor_pipelines.cpp): `editor/src/Graphics/editor_pipelines.cpp`
- [Texture Editor](https://github.com/programier/trinex-engine/blob/main/editor/include/Clients/texture_editor_client.hpp): `editor/include/Clients/texture_editor_client.hpp`
- [Static Mesh Editor](https://github.com/programier/trinex-engine/blob/main/editor/include/Clients/static_mesh_client.hpp): `editor/include/Clients/static_mesh_client.hpp`

### Other components

- **Application**

## Connections

- Application → Engine Loop: starts
- Engine Loop → Engine Core: runs
- Engine Core → Default Client: provides
- Default Client → Render Pipelines: uses
- Render Pipelines → Pipeline API: uses
- Pipeline API → Pipeline Library: resolves
- Pipeline API → Vulkan Backend: dispatches
- Pipeline API → D3D12 Backend: dispatches
- Application → Script Engine API: uses
- Script Engine API → AngelScript Runtime: creates (evidence: `src/ScriptEngine/script_engine.cpp`)
- AngelScript Runtime → Script Modules: uses (evidence: `libs/angelscript/source/as_scriptengine.cpp`)
- AngelScript Runtime → Script Builder: uses (evidence: `libs/angelscript/source/as_scriptengine.cpp`)
- Application → Editor Engine: opens
- Editor Engine → Editor UI: uses
- Editor UI → Material Editor: hosts
- Editor UI → Pipeline Editor: hosts
- Pipeline Editor → Editor Pipelines: edits
- Editor UI → Texture Editor: hosts
- Editor UI → Static Mesh Editor: hosts
