# bentobaux/directx-graphics-samples architecture

> Architecture diagram of the GitHub repository bentobaux/directx-graphics-samples, 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/bentobaux/directx-graphics-samples
- Repository: https://github.com/bentobaux/directx-graphics-samples

## Overview

DirectX-Graphics-Samples is a collection of Direct3D 12 samples and reusable graphics libraries, with MiniEngine as its reusable engine starter kit. A representative user workflow is operating MiniEngine’s ModelViewer: the application uses model rendering, camera and input support, graphics resources, and rendering effects to display a scene. The graph also preserves the separately documented affinity, raytracing fallback, and residency libraries. Relationships are limited to README statements and references in the supplied SOURCE INDEX; unsampled implementation details are not asserted.

Main entry points: [`MiniEngine/ModelViewer/ModelViewer.cpp`](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/ModelViewer/ModelViewer.cpp) (Model Viewer), [`MiniEngine/Core/CommandContext.h`](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/CommandContext.h) (Command Context), [`MiniEngine/Model/LightManager.cpp`](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Model/LightManager.cpp) (Lighting), [`MiniEngine/Core/EngineProfiling.cpp`](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/EngineProfiling.cpp) (CPU/GPU Profiling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mini["MiniEngine"]
  node_viewer["Model Viewer<br/>[ModelViewer.cpp]"]
  node_model["Model Rendering<br/>[Renderer.cpp]"]
  node_camera["Camera<br/>[Camera.h]"]
  node_input["Input<br/>[GameInput.h]"]
  node_commands["Command Context<br/>[CommandContext.h]"]
  node_resources["GPU Resources<br/>[BufferManager.h]"]
  node_pipeline["Pipeline State<br/>[PipelineState.h]"]
  node_rootsig["Root Signatures<br/>[RootSignature.h]"]
  node_lighting["Lighting<br/>[LightManager.cpp]"]
  node_effects["Render Effects<br/>[PostEffects.h]"]
  node_text["Text Rendering<br/>[TextRenderer.h]"]
  node_profiling["CPU/GPU Profiling"]
  node_tuning["User Tuning<br/>[EngineTuning.cpp]"]
end

subgraph group_affinity["Multi-GPU Affinity"]
  node_affinityapi["Affinity API<br/>[d3dx12affinity.h]"]
  node_affinityps["Affinity Pipeline State"]
end

subgraph group_ray["Raytracing Fallback"]
  node_fallback["Fallback Layer<br/>[FallbackLayer.cpp]"]
end

subgraph group_residency["Residency Library"]
  node_residencylib["Residency Starter<br/>[d3dx12Residency.h]"]
end

node_user(("Viewer User"))

node_user -.->|"operates"| node_viewer
node_viewer -->|"uses"| node_model
node_viewer -->|"uses"| node_camera
node_viewer -->|"uses"| node_input
node_viewer -->|"uses"| node_commands
node_viewer -->|"uses"| node_resources
node_viewer -->|"uses"| node_effects
node_viewer -->|"uses"| node_text
node_commands -->|"references"| node_pipeline
node_commands -->|"references"| node_rootsig
node_resources -->|"references"| node_commands
node_lighting -->|"uses"| node_commands
node_lighting -->|"uses"| node_camera
node_lighting -->|"uses"| node_resources
node_profiling -->|"uses"| node_commands
node_profiling -->|"renders with"| node_text
node_profiling -->|"reads"| node_input
node_tuning -->|"reads"| node_input
node_tuning -->|"renders with"| node_text
node_affinityapi -->|"declares"| node_affinityps

click node_viewer "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/ModelViewer/ModelViewer.cpp"
click node_model "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Model/Renderer.cpp"
click node_camera "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/Camera.h"
click node_input "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/GameInput.h"
click node_commands "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/CommandContext.h"
click node_resources "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/BufferManager.h"
click node_pipeline "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/PipelineState.h"
click node_rootsig "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/RootSignature.h"
click node_lighting "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Model/LightManager.cpp"
click node_effects "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/PostEffects.h"
click node_text "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/TextRenderer.h"
click node_profiling "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/EngineProfiling.cpp"
click node_tuning "https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/EngineTuning.cpp"
click node_affinityapi "https://github.com/bentobaux/directx-graphics-samples/blob/master/Libraries/D3DX12AffinityLayer/Desktop/d3dx12affinity.h"
click node_affinityps "https://github.com/bentobaux/directx-graphics-samples/blob/master/Libraries/D3DX12AffinityLayer/Desktop/CD3DX12AffinityPipelineState.cpp"
click node_fallback "https://github.com/bentobaux/directx-graphics-samples/blob/master/Libraries/D3D12RaytracingFallback/src/FallbackLayer.cpp"
click node_residencylib "https://github.com/bentobaux/directx-graphics-samples/blob/master/Libraries/D3DX12Residency/d3dx12Residency.h"

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_viewer,node_model,node_camera,node_input,node_commands,node_resources,node_pipeline,node_rootsig,node_lighting,node_effects,node_text,node_profiling,node_tuning,node_user toneBlue
class node_affinityapi,node_affinityps toneAmber
class node_fallback toneMint
class node_residencylib toneRose
```

## Components

### MiniEngine

- [Model Viewer](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/ModelViewer/ModelViewer.cpp): `MiniEngine/ModelViewer/ModelViewer.cpp`
- [Model Rendering](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Model/Renderer.cpp): `MiniEngine/Model/Renderer.cpp`
- [Camera](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/Camera.h): `MiniEngine/Core/Camera.h`
- [Input](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/GameInput.h): `MiniEngine/Core/GameInput.h`
- [Command Context](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/CommandContext.h): `MiniEngine/Core/CommandContext.h`
- [GPU Resources](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/BufferManager.h): `MiniEngine/Core/BufferManager.h`
- [Pipeline State](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/PipelineState.h): `MiniEngine/Core/PipelineState.h`
- [Root Signatures](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/RootSignature.h): `MiniEngine/Core/RootSignature.h`
- [Lighting](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Model/LightManager.cpp): `MiniEngine/Model/LightManager.cpp`
- [Render Effects](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/PostEffects.h): `MiniEngine/Core/PostEffects.h`
- [Text Rendering](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/TextRenderer.h): `MiniEngine/Core/TextRenderer.h`
- [CPU/GPU Profiling](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/EngineProfiling.cpp): `MiniEngine/Core/EngineProfiling.cpp`
- [User Tuning](https://github.com/bentobaux/directx-graphics-samples/blob/master/MiniEngine/Core/EngineTuning.cpp): `MiniEngine/Core/EngineTuning.cpp`

### Multi-GPU Affinity

- [Affinity API](https://github.com/bentobaux/directx-graphics-samples/blob/master/Libraries/D3DX12AffinityLayer/Desktop/d3dx12affinity.h): `Libraries/D3DX12AffinityLayer/Desktop/d3dx12affinity.h`
- [Affinity Pipeline State](https://github.com/bentobaux/directx-graphics-samples/blob/master/Libraries/D3DX12AffinityLayer/Desktop/CD3DX12AffinityPipelineState.cpp): `Libraries/D3DX12AffinityLayer/Desktop/CD3DX12AffinityPipelineState.cpp`

### Raytracing Fallback

- [Fallback Layer](https://github.com/bentobaux/directx-graphics-samples/blob/master/Libraries/D3D12RaytracingFallback/src/FallbackLayer.cpp): `Libraries/D3D12RaytracingFallback/src/FallbackLayer.cpp`

### Residency Library

- [Residency Starter](https://github.com/bentobaux/directx-graphics-samples/blob/master/Libraries/D3DX12Residency/d3dx12Residency.h): `Libraries/D3DX12Residency/d3dx12Residency.h`

### Other components

- **Viewer User**

## Connections

- Viewer User → Model Viewer: operates
- Model Viewer → Model Rendering: uses (evidence: `MiniEngine/ModelViewer/ModelViewer.cpp`)
- Model Viewer → Camera: uses (evidence: `MiniEngine/ModelViewer/ModelViewer.cpp`)
- Model Viewer → Input: uses (evidence: `MiniEngine/ModelViewer/ModelViewer.cpp`)
- Model Viewer → Command Context: uses (evidence: `MiniEngine/ModelViewer/ModelViewer.cpp`)
- Model Viewer → GPU Resources: uses (evidence: `MiniEngine/ModelViewer/ModelViewer.cpp`)
- Model Viewer → Render Effects: uses (evidence: `MiniEngine/ModelViewer/ModelViewer.cpp`)
- Model Viewer → Text Rendering: uses (evidence: `MiniEngine/ModelViewer/ModelViewer.cpp`)
- Command Context → Pipeline State: references (evidence: `MiniEngine/Core/CommandContext.h`)
- Command Context → Root Signatures: references (evidence: `MiniEngine/Core/CommandContext.h`)
- GPU Resources → Command Context: references (evidence: `MiniEngine/Core/BufferManager.h`)
- Lighting → Command Context: uses (evidence: `MiniEngine/Model/LightManager.cpp`)
- Lighting → Camera: uses (evidence: `MiniEngine/Model/LightManager.cpp`)
- Lighting → GPU Resources: uses (evidence: `MiniEngine/Model/LightManager.cpp`)
- CPU/GPU Profiling → Command Context: uses (evidence: `MiniEngine/Core/EngineProfiling.cpp`)
- CPU/GPU Profiling → Text Rendering: renders with (evidence: `MiniEngine/Core/EngineProfiling.cpp`)
- CPU/GPU Profiling → Input: reads (evidence: `MiniEngine/Core/EngineProfiling.cpp`)
- User Tuning → Input: reads (evidence: `MiniEngine/Core/EngineTuning.cpp`)
- User Tuning → Text Rendering: renders with (evidence: `MiniEngine/Core/EngineTuning.cpp`)
- Affinity API → Affinity Pipeline State: declares (evidence: `Libraries/D3DX12AffinityLayer/Desktop/d3dx12affinity.h`)
