# tixl3d/tixl architecture

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

## Overview

TiXL is a real-time motion-graphics and animation toolkit. Artists build procedural content in a graph, combine it with keyframe animation and parameter automation, then render visuals with optional audio-reactive behavior and external control inputs. The graph separates the editor, composition/operator runtime, rendering and shader infrastructure, and audio and output capabilities. Source excerpts show operator evaluation, settings persistence, graphics abstraction, and audio engine behavior; other capability links are included only where the README or source index supports them.

Main entry points: [`Core/Operator/Slots/InputSlot.cs`](https://github.com/tixl3d/tixl/blob/main/Core/Operator/Slots/InputSlot.cs) (Input slots), [`Editor/Program.cs`](https://github.com/tixl3d/tixl/blob/main/Editor/Program.cs) (TiXL editor), [`Editor/Gui/Graph/Window/GraphWindow.cs`](https://github.com/tixl3d/tixl/blob/main/Editor/Gui/Graph/Window/GraphWindow.cs) (Graph editing), [`Core/Operator/Instance.cs`](https://github.com/tixl3d/tixl/blob/main/Core/Operator/Instance.cs) (Operator instances)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Composition authoring"]
  node_editor["TiXL editor<br/>[Program.cs]"]
  node_graph_ui["Graph editing<br/>[GraphWindow.cs]"]
  node_combine["Combine symbols<br/>[Combine.cs]"]
  node_animation["Keyframe animation<br/>[Playback.cs]"]
  node_composition["Composition settings"]
  node_settings[("User settings<br/>[Settings.cs]")]
end

subgraph group_runtime["Composition runtime"]
  node_operator_instance["Operator instances<br/>[Instance.cs]"]
  node_evaluation["Evaluation context"]
  node_input_slot["Input slots<br/>[InputSlot.cs]"]
  node_slot["Output slots<br/>[Slot.cs]"]
  node_value_operator["Value operator<br/>[Value.cs]"]
  node_add_operator["Add operator<br/>[Add.cs]"]
end

subgraph group_graphics["Graphics and rendering"]
  node_pixel_shader["Pixel shader operator<br/>[PixelShader.cs]"]
  node_vertex_shader["Vertex shader operator<br/>[VertexShader.cs]"]
  node_resource_manager["Graphics resources"]
  node_graphics_device["Graphics device<br/>[Device.cs]"]
end

subgraph group_media["Audio and media"]
  node_audio_engine["Audio engine<br/>[AudioEngine.cs]"]
  node_native_audio["Native audio engine"]
  node_video_playback["Video playback"]
end

subgraph group_integration["Output and inputs"]
  node_output_setup["Projection setup<br/>[Setup.cs]"]
  node_output_compositor["Output compositor"]
  node_midi["MIDI connections"]
  node_osc["OSC connections"]
end

node_artist(("Artist"))

node_artist -->|"creates content"| node_editor
node_editor -.->|"opens graph"| node_graph_ui
node_graph_ui -.->|"edits composition"| node_operator_instance
node_artist -->|"edits keyframes"| node_animation
node_artist -->|"sets parameters"| node_composition
node_editor -->|"loads settings"| node_settings
node_graph_ui -.->|"combines operators"| node_combine
node_combine -->|"modifies symbols"| node_operator_instance
node_operator_instance -.->|"evaluates"| node_evaluation
node_evaluation -.->|"evaluates inputs"| node_input_slot
node_input_slot -.->|"updates outputs"| node_slot
node_value_operator -->|"reads value"| node_input_slot
node_value_operator -->|"writes result"| node_slot
node_add_operator -->|"reads operands"| node_input_slot
node_add_operator -->|"writes sum"| node_slot
node_artist -->|"authors shaders"| node_pixel_shader
node_artist -->|"authors shaders"| node_vertex_shader
node_pixel_shader -.->|"provides shader"| node_resource_manager
node_vertex_shader -.->|"provides shader"| node_resource_manager
node_resource_manager -->|"creates resources"| node_graphics_device
node_artist -->|"creates audio-reactive content"| node_audio_engine
node_audio_engine -->|"uses native engine"| node_native_audio
node_artist -.->|"uses video media"| node_video_playback
node_artist -.->|"configures projection"| node_output_setup
node_output_setup -.->|"configures output"| node_output_compositor
node_artist -->|"connects controllers"| node_midi
node_artist -->|"connects sensors"| node_osc

click node_editor "https://github.com/tixl3d/tixl/blob/main/Editor/Program.cs"
click node_graph_ui "https://github.com/tixl3d/tixl/blob/main/Editor/Gui/Graph/Window/GraphWindow.cs"
click node_combine "https://github.com/tixl3d/tixl/blob/main/Editor/UiModel/Modification/Combine.cs"
click node_animation "https://github.com/tixl3d/tixl/blob/main/Core/Animation/Playback.cs"
click node_composition "https://github.com/tixl3d/tixl/blob/main/Core/Settings/CompositionSettings.cs"
click node_settings "https://github.com/tixl3d/tixl/blob/main/Core/IO/Settings.cs"
click node_operator_instance "https://github.com/tixl3d/tixl/blob/main/Core/Operator/Instance.cs"
click node_evaluation "https://github.com/tixl3d/tixl/blob/main/Core/Operator/EvaluationContext.cs"
click node_input_slot "https://github.com/tixl3d/tixl/blob/main/Core/Operator/Slots/InputSlot.cs"
click node_slot "https://github.com/tixl3d/tixl/blob/main/Core/Operator/Slots/Slot.cs"
click node_value_operator "https://github.com/tixl3d/tixl/blob/main/Operators/TypeOperators/Symbols/Values/Value.cs"
click node_add_operator "https://github.com/tixl3d/tixl/blob/main/Operators/Lib/Symbols/numbers/float/basic/Add.cs"
click node_pixel_shader "https://github.com/tixl3d/tixl/blob/main/Operators/TypeOperators/Symbols/Gfx/PixelShader.cs"
click node_vertex_shader "https://github.com/tixl3d/tixl/blob/main/Operators/TypeOperators/Symbols/Gfx/VertexShader.cs"
click node_resource_manager "https://github.com/tixl3d/tixl/blob/main/Core/Resource/ResourceManager.Graphics.cs"
click node_graphics_device "https://github.com/tixl3d/tixl/blob/main/Graphics.Compat/Device.cs"
click node_audio_engine "https://github.com/tixl3d/tixl/blob/main/Core/Audio/AudioEngine.cs"
click node_native_audio "https://github.com/tixl3d/tixl/blob/main/Core/Audio/Native/NativeAudioEngine.cs"
click node_video_playback "https://github.com/tixl3d/tixl/blob/main/VideoServices/VideoPlaybackEngine.cs"
click node_output_setup "https://github.com/tixl3d/tixl/blob/main/Core/Output/Setup.cs"
click node_output_compositor "https://github.com/tixl3d/tixl/blob/main/Core/Output/Rendering/OutputCompositor.cs"
click node_midi "https://github.com/tixl3d/tixl/blob/main/IoServices/Midi/MidiConnectionManager.cs"
click node_osc "https://github.com/tixl3d/tixl/blob/main/IoServices/OscConnectionManager.cs"

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,node_graph_ui,node_combine,node_animation,node_composition,node_settings toneBlue
class node_operator_instance,node_evaluation,node_input_slot,node_slot,node_value_operator,node_add_operator toneAmber
class node_pixel_shader,node_vertex_shader,node_resource_manager,node_graphics_device toneMint
class node_audio_engine,node_native_audio,node_video_playback toneRose
class node_output_setup,node_output_compositor,node_midi,node_osc,node_artist toneIndigo
```

## Components

### Composition authoring

- [TiXL editor](https://github.com/tixl3d/tixl/blob/main/Editor/Program.cs): `Editor/Program.cs`
- [Graph editing](https://github.com/tixl3d/tixl/blob/main/Editor/Gui/Graph/Window/GraphWindow.cs): `Editor/Gui/Graph/Window/GraphWindow.cs`
- [Combine symbols](https://github.com/tixl3d/tixl/blob/main/Editor/UiModel/Modification/Combine.cs): `Editor/UiModel/Modification/Combine.cs`
- [Keyframe animation](https://github.com/tixl3d/tixl/blob/main/Core/Animation/Playback.cs): `Core/Animation/Playback.cs`
- [Composition settings](https://github.com/tixl3d/tixl/blob/main/Core/Settings/CompositionSettings.cs): `Core/Settings/CompositionSettings.cs`
- [User settings](https://github.com/tixl3d/tixl/blob/main/Core/IO/Settings.cs): `Core/IO/Settings.cs`

### Composition runtime

- [Operator instances](https://github.com/tixl3d/tixl/blob/main/Core/Operator/Instance.cs): `Core/Operator/Instance.cs`
- [Evaluation context](https://github.com/tixl3d/tixl/blob/main/Core/Operator/EvaluationContext.cs): `Core/Operator/EvaluationContext.cs`
- [Input slots](https://github.com/tixl3d/tixl/blob/main/Core/Operator/Slots/InputSlot.cs): `Core/Operator/Slots/InputSlot.cs`
- [Output slots](https://github.com/tixl3d/tixl/blob/main/Core/Operator/Slots/Slot.cs): `Core/Operator/Slots/Slot.cs`
- [Value operator](https://github.com/tixl3d/tixl/blob/main/Operators/TypeOperators/Symbols/Values/Value.cs): `Operators/TypeOperators/Symbols/Values/Value.cs`
- [Add operator](https://github.com/tixl3d/tixl/blob/main/Operators/Lib/Symbols/numbers/float/basic/Add.cs): `Operators/Lib/Symbols/numbers/float/basic/Add.cs`

### Graphics and rendering

- [Pixel shader operator](https://github.com/tixl3d/tixl/blob/main/Operators/TypeOperators/Symbols/Gfx/PixelShader.cs): `Operators/TypeOperators/Symbols/Gfx/PixelShader.cs`
- [Vertex shader operator](https://github.com/tixl3d/tixl/blob/main/Operators/TypeOperators/Symbols/Gfx/VertexShader.cs): `Operators/TypeOperators/Symbols/Gfx/VertexShader.cs`
- [Graphics resources](https://github.com/tixl3d/tixl/blob/main/Core/Resource/ResourceManager.Graphics.cs): `Core/Resource/ResourceManager.Graphics.cs`
- [Graphics device](https://github.com/tixl3d/tixl/blob/main/Graphics.Compat/Device.cs): `Graphics.Compat/Device.cs`

### Audio and media

- [Audio engine](https://github.com/tixl3d/tixl/blob/main/Core/Audio/AudioEngine.cs): `Core/Audio/AudioEngine.cs`
- [Native audio engine](https://github.com/tixl3d/tixl/blob/main/Core/Audio/Native/NativeAudioEngine.cs): `Core/Audio/Native/NativeAudioEngine.cs`
- [Video playback](https://github.com/tixl3d/tixl/blob/main/VideoServices/VideoPlaybackEngine.cs): `VideoServices/VideoPlaybackEngine.cs`

### Output and inputs

- [Projection setup](https://github.com/tixl3d/tixl/blob/main/Core/Output/Setup.cs): `Core/Output/Setup.cs`
- [Output compositor](https://github.com/tixl3d/tixl/blob/main/Core/Output/Rendering/OutputCompositor.cs): `Core/Output/Rendering/OutputCompositor.cs`
- [MIDI connections](https://github.com/tixl3d/tixl/blob/main/IoServices/Midi/MidiConnectionManager.cs): `IoServices/Midi/MidiConnectionManager.cs`
- [OSC connections](https://github.com/tixl3d/tixl/blob/main/IoServices/OscConnectionManager.cs): `IoServices/OscConnectionManager.cs`

### Other components

- **Artist**

## Connections

- Artist → TiXL editor: creates content (evidence: `README.md`)
- TiXL editor → Graph editing: opens graph
- Graph editing → Operator instances: edits composition
- Artist → Keyframe animation: edits keyframes (evidence: `README.md`)
- Artist → Composition settings: sets parameters (evidence: `README.md`)
- TiXL editor → User settings: loads settings (evidence: `Editor/Program.cs`)
- Graph editing → Combine symbols: combines operators
- Combine symbols → Operator instances: modifies symbols (evidence: `Editor/UiModel/Modification/Combine.cs`)
- Operator instances → Evaluation context: evaluates
- Evaluation context → Input slots: evaluates inputs
- Input slots → Output slots: updates outputs
- Value operator → Input slots: reads value (evidence: `Operators/TypeOperators/Symbols/Values/Value.cs`)
- Value operator → Output slots: writes result (evidence: `Operators/TypeOperators/Symbols/Values/Value.cs`)
- Add operator → Input slots: reads operands (evidence: `Operators/Lib/Symbols/numbers/float/basic/Add.cs`)
- Add operator → Output slots: writes sum (evidence: `Operators/Lib/Symbols/numbers/float/basic/Add.cs`)
- Artist → Pixel shader operator: authors shaders (evidence: `README.md`)
- Artist → Vertex shader operator: authors shaders (evidence: `README.md`)
- Pixel shader operator → Graphics resources: provides shader
- Vertex shader operator → Graphics resources: provides shader
- Graphics resources → Graphics device: creates resources (evidence: `Core/Resource/ResourceManager.Graphics.cs`)
- Artist → Audio engine: creates audio-reactive content (evidence: `README.md`)
- Audio engine → Native audio engine: uses native engine (evidence: `Core/Audio/AudioEngine.cs`)
- Artist → Video playback: uses video media
- Artist → Projection setup: configures projection
- Projection setup → Output compositor: configures output
- Artist → MIDI connections: connects controllers (evidence: `README.md`)
- Artist → OSC connections: connects sensors (evidence: `README.md`)
