# damian0815/candide architecture

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

- Interactive diagram: https://gitdiagram.com/damian0815/candide
- Repository: https://github.com/damian0815/candide

## Overview

Candide is a desktop interface for editing the Candide-3 face template. The user workflow is to adjust face shape and animation units, view the face alongside reference imagery and a loaded 3D mesh, then save project state or bake the mesh and textures. The graph separates the interface, face/scene domain, mesh processing, and rendering/export support. Relationships follow the README and shown source/index references; unsampled implementation details are not assumed.

Main entry points: [`src/CDScene.cpp`](https://github.com/damian0815/candide/blob/master/src/CDScene.cpp) (3D scene), [`src/CDFaceData.cpp`](https://github.com/damian0815/candide/blob/master/src/CDFaceData.cpp) (Face units), [`src/CDApp.cpp`](https://github.com/damian0815/candide/blob/master/src/CDApp.cpp) (Application state), [`src/CDFaceWindow.cpp`](https://github.com/damian0815/candide/blob/master/src/CDFaceWindow.cpp) (Face view)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_interface["Desktop interface"]
  node_entry["Application entry<br/>[main.cpp]"]
  node_app["Application state<br/>[CDApp.cpp]"]
  node_window["Editor window<br/>[CDWindow.cpp]"]
  node_face_view["Face view<br/>[CDFaceWindow.cpp]"]
  node_test_window["Deformer test view"]
end

subgraph group_face_scene["Face and scene"]
  node_face_data["Face units<br/>[CDFaceData.cpp]"]
  node_scene["3D scene<br/>[CDScene.cpp]"]
end

subgraph group_mesh_processing["Mesh processing"]
  node_mesh["Mesh model<br/>[CDMesh.cpp]"]
  node_mesh_mapper["Control mesh mapping<br/>[CDMeshMapper.cpp]"]
  node_mean_deformer["Mean-value deformation"]
  node_face_deformer["Face-data deformation"]
  node_assimp["3D model loader<br/>[CDAssimpLoader.cpp]"]
  node_obj_writer["OBJ writer"]
end

subgraph group_render_export["Rendering and export"]
  node_image_loader["Image loader<br/>[CDImageLoader.cpp]"]
  node_fbo["Framebuffer<br/>[CDFBO.cpp]"]
  node_texture_baker["Texture baking<br/>[CDTextureBaker.cpp]"]
  node_json["JSON support<br/>[picojson.h]"]
  node_utilities["Serialization utilities<br/>[CDUtilities.cpp]"]
end

node_user(("Editor"))

node_user -.->|"starts"| node_entry
node_entry -->|"creates"| node_app
node_app -->|"owns UI"| node_window
node_window -.->|"hosts views"| node_face_view
node_face_view -->|"reads units"| node_face_data
node_face_view -->|"loads image"| node_image_loader
node_face_view -->|"draws scene"| node_scene
node_app -->|"owns state"| node_face_data
node_app -->|"owns scene"| node_scene
node_face_data -->|"maps control mesh"| node_mesh_mapper
node_face_data -->|"loads template"| node_assimp
node_scene -->|"loads background"| node_assimp
node_scene -->|"reads control mesh"| node_face_data
node_scene -->|"bakes deformation"| node_mean_deformer
node_scene -->|"bakes textures"| node_texture_baker
node_scene -->|"writes baked mesh"| node_obj_writer
node_scene -->|"transforms mesh"| node_mesh
node_mean_deformer -->|"deforms mesh"| node_mesh
node_face_deformer -->|"uses algorithm"| node_mean_deformer
node_face_deformer -->|"reads face units"| node_face_data
node_texture_baker -->|"renders to"| node_fbo
node_texture_baker -->|"loads images"| node_image_loader
node_app -->|"opens test view"| node_test_window
node_window -.->|"serializes state"| node_json
node_face_data -.->|"serializes units"| node_json
node_scene -->|"encodes transforms"| node_utilities
node_test_window -->|"loads test model"| node_assimp
node_test_window -->|"exports mesh"| node_obj_writer

click node_entry "https://github.com/damian0815/candide/blob/master/src/main.cpp"
click node_app "https://github.com/damian0815/candide/blob/master/src/CDApp.cpp"
click node_window "https://github.com/damian0815/candide/blob/master/src/CDWindow.cpp"
click node_face_view "https://github.com/damian0815/candide/blob/master/src/CDFaceWindow.cpp"
click node_face_data "https://github.com/damian0815/candide/blob/master/src/CDFaceData.cpp"
click node_scene "https://github.com/damian0815/candide/blob/master/src/CDScene.cpp"
click node_mesh "https://github.com/damian0815/candide/blob/master/src/CDMesh.cpp"
click node_mesh_mapper "https://github.com/damian0815/candide/blob/master/src/CDMeshMapper.cpp"
click node_mean_deformer "https://github.com/damian0815/candide/blob/master/src/CDMeanValueMeshDeformer.cpp"
click node_face_deformer "https://github.com/damian0815/candide/blob/master/src/CDMeshDeformerFromFaceData.cpp"
click node_assimp "https://github.com/damian0815/candide/blob/master/src/CDAssimpLoader.cpp"
click node_obj_writer "https://github.com/damian0815/candide/blob/master/src/CDMeshObjWriter.cpp"
click node_image_loader "https://github.com/damian0815/candide/blob/master/src/CDImageLoader.cpp"
click node_fbo "https://github.com/damian0815/candide/blob/master/src/CDFBO.cpp"
click node_texture_baker "https://github.com/damian0815/candide/blob/master/src/CDTextureBaker.cpp"
click node_json "https://github.com/damian0815/candide/blob/master/src/picojson.h"
click node_utilities "https://github.com/damian0815/candide/blob/master/src/CDUtilities.cpp"
click node_test_window "https://github.com/damian0815/candide/blob/master/src/CDMVMDTestWindow.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_entry,node_app,node_window,node_face_view,node_test_window toneBlue
class node_face_data,node_scene toneAmber
class node_mesh,node_mesh_mapper,node_mean_deformer,node_face_deformer,node_assimp,node_obj_writer toneMint
class node_image_loader,node_fbo,node_texture_baker,node_json,node_utilities toneRose
class node_user toneIndigo
```

## Components

### Desktop interface

- [Application entry](https://github.com/damian0815/candide/blob/master/src/main.cpp): `src/main.cpp`
- [Application state](https://github.com/damian0815/candide/blob/master/src/CDApp.cpp): `src/CDApp.cpp`
- [Editor window](https://github.com/damian0815/candide/blob/master/src/CDWindow.cpp): `src/CDWindow.cpp`
- [Face view](https://github.com/damian0815/candide/blob/master/src/CDFaceWindow.cpp): `src/CDFaceWindow.cpp`
- [Deformer test view](https://github.com/damian0815/candide/blob/master/src/CDMVMDTestWindow.cpp): `src/CDMVMDTestWindow.cpp`

### Face and scene

- [Face units](https://github.com/damian0815/candide/blob/master/src/CDFaceData.cpp): `src/CDFaceData.cpp`
- [3D scene](https://github.com/damian0815/candide/blob/master/src/CDScene.cpp): `src/CDScene.cpp`

### Mesh processing

- [Mesh model](https://github.com/damian0815/candide/blob/master/src/CDMesh.cpp): `src/CDMesh.cpp`
- [Control mesh mapping](https://github.com/damian0815/candide/blob/master/src/CDMeshMapper.cpp): `src/CDMeshMapper.cpp`
- [Mean-value deformation](https://github.com/damian0815/candide/blob/master/src/CDMeanValueMeshDeformer.cpp): `src/CDMeanValueMeshDeformer.cpp`
- [Face-data deformation](https://github.com/damian0815/candide/blob/master/src/CDMeshDeformerFromFaceData.cpp): `src/CDMeshDeformerFromFaceData.cpp`
- [3D model loader](https://github.com/damian0815/candide/blob/master/src/CDAssimpLoader.cpp): `src/CDAssimpLoader.cpp`
- [OBJ writer](https://github.com/damian0815/candide/blob/master/src/CDMeshObjWriter.cpp): `src/CDMeshObjWriter.cpp`

### Rendering and export

- [Image loader](https://github.com/damian0815/candide/blob/master/src/CDImageLoader.cpp): `src/CDImageLoader.cpp`
- [Framebuffer](https://github.com/damian0815/candide/blob/master/src/CDFBO.cpp): `src/CDFBO.cpp`
- [Texture baking](https://github.com/damian0815/candide/blob/master/src/CDTextureBaker.cpp): `src/CDTextureBaker.cpp`
- [JSON support](https://github.com/damian0815/candide/blob/master/src/picojson.h): `src/picojson.h`
- [Serialization utilities](https://github.com/damian0815/candide/blob/master/src/CDUtilities.cpp): `src/CDUtilities.cpp`

### Other components

- **Editor**

## Connections

- Editor → Application entry: starts
- Application entry → Application state: creates (evidence: `src/main.cpp`)
- Application state → Editor window: owns UI (evidence: `src/CDApp.cpp`)
- Editor window → Face view: hosts views
- Face view → Face units: reads units (evidence: `src/CDFaceWindow.cpp`)
- Face view → Image loader: loads image (evidence: `src/CDFaceWindow.cpp`)
- Face view → 3D scene: draws scene (evidence: `src/CDFaceWindow.cpp`)
- Application state → Face units: owns state
- Application state → 3D scene: owns scene
- Face units → Control mesh mapping: maps control mesh
- Face units → 3D model loader: loads template (evidence: `src/CDFaceData.cpp`)
- 3D scene → 3D model loader: loads background (evidence: `src/CDScene.cpp`)
- 3D scene → Face units: reads control mesh (evidence: `src/CDScene.cpp`)
- 3D scene → Mean-value deformation: bakes deformation (evidence: `src/CDScene.cpp`)
- 3D scene → Texture baking: bakes textures (evidence: `src/CDScene.cpp`)
- 3D scene → OBJ writer: writes baked mesh (evidence: `src/CDScene.cpp`)
- 3D scene → Mesh model: transforms mesh (evidence: `src/CDScene.cpp`)
- Mean-value deformation → Mesh model: deforms mesh
- Face-data deformation → Mean-value deformation: uses algorithm
- Face-data deformation → Face units: reads face units
- Texture baking → Framebuffer: renders to (evidence: `src/CDTextureBaker.cpp`)
- Texture baking → Image loader: loads images (evidence: `src/CDTextureBaker.cpp`)
- Application state → Deformer test view: opens test view (evidence: `src/CDApp.cpp`)
- Editor window → JSON support: serializes state
- Face units → JSON support: serializes units
- 3D scene → Serialization utilities: encodes transforms (evidence: `src/CDScene.cpp`)
- Deformer test view → 3D model loader: loads test model (evidence: `src/CDMVMDTestWindow.cpp`)
- Deformer test view → OBJ writer: exports mesh (evidence: `src/CDMVMDTestWindow.cpp`)
