# baukewestendorp/radiant architecture

> Architecture diagram of the GitHub repository baukewestendorp/radiant, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/baukewestendorp/radiant
- Repository: https://github.com/baukewestendorp/radiant

## Overview

##### Main Components Structure

a. Core Components (Top Level):
- Radiant (Main Application)
- DMX Control Layer
- Management
- Flow System (Node-based Effects)
- UI Framework

##### Component Relationships

a. Frontend Layer:
- Main window, editors, and asset selectors
- Use rounded rectangles for UI components

b. Control Layer:
- Show file management
- Asset management (cues, effects, groups)
- Patch system

c. DMX Communication Layer:
- DMX Universe management
- Art-Net protocol support
- Output handling

d. Flow System:
- Graph-based effect system
- Node management
- GPUI integration

##### Specific Implementation Details

Key architectural elements:

a. Data Flow:
- File → Show Management → DMX Output
- User Interface → Flow System → DMX Control
- Asset Management → Show Control → Output

b. Key Subsystems:
- Workspace management
- Effect graph editor
- Sequence editor
- DMX protocol handlers

##### Important Architectural Notes

- The modular crate structure
- Clear separation between UI, show control, and DMX layers
- The central role of the Flow system for effects
- Asset management integration

##### External Interfaces

Highlight:
- DMX output protocols (Art-Net)
- File I/O
- Asset management system
- User interface entry points

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Main
        App["Main Application"]
        click App "https://github.com/BaukeWestendorp/radiant/blob/main/crates/radiant/src/app.rs"
    end

    subgraph "UI Layer"
        MainWindow["Main Window"]
        EffectEditor["Effect Graph Editor"]
        SeqEditor["Sequence Editor"]
        AssetSelector["Asset Selector"]
        InputComp["Input Components"]

        click MainWindow "https://github.com/BaukeWestendorp/radiant/blob/main/crates/radiant/src/workspace/main_window.rs"
        click EffectEditor "https://github.com/BaukeWestendorp/radiant/blob/main/crates/radiant/src/workspace/frame/effect_graph_editor.rs"
        click SeqEditor "https://github.com/BaukeWestendorp/radiant/tree/main/crates/radiant/src/workspace/frame/sequence_editor/"
        click AssetSelector "https://github.com/BaukeWestendorp/radiant/blob/main/crates/radiant/src/ui/asset_selector.rs"
        click InputComp "https://github.com/BaukeWestendorp/radiant/tree/main/crates/ui/src/input/"
    end

    subgraph "Show Management"
        ShowFile["Show File Management"]
        PatchSys["Patch System"]
        AssetMgmt["Asset Management"]
        DMXProto["DMX Protocols"]

        click ShowFile "https://github.com/BaukeWestendorp/radiant/tree/main/crates/show/src/showfile/"
        click PatchSys "https://github.com/BaukeWestendorp/radiant/blob/main/crates/show/src/patch.rs"
        click AssetMgmt "https://github.com/BaukeWestendorp/radiant/tree/main/crates/show/src/assets/"
        click DMXProto "https://github.com/BaukeWestendorp/radiant/blob/main/crates/show/src/dmx_protocols.rs"
    end

    subgraph "Flow System"
        GraphImpl["Graph Implementation"]
        NodeSys["Node System"]
        GraphUI["Graph UI"]
        EffectGraphAssets["Effect Graph Assets"]

        click GraphImpl "https://github.com/BaukeWestendorp/radiant/blob/main/crates/flow/src/graph.rs"
        click NodeSys "https://github.com/BaukeWestendorp/radiant/blob/main/crates/flow/src/node.rs"
        click GraphUI "https://github.com/BaukeWestendorp/radiant/tree/main/crates/flow/src/gpui/"
        click EffectGraphAssets "https://github.com/BaukeWestendorp/radiant/tree/main/crates/show/src/assets/effect_graph/"
    end

    subgraph "DMX Control"
        UniverseMgmt["Universe Management"]
        DMXOutput["DMX Output"]
        ArtNet["Art-Net Protocol"]

        click UniverseMgmt "https://github.com/BaukeWestendorp/radiant/blob/main/crates/dmx/src/universe.rs"
        click DMXOutput "https://github.com/BaukeWestendorp/radiant/blob/main/crates/dmx/src/output.rs"
        click ArtNet "https://github.com/BaukeWestendorp/radiant/blob/main/crates/radiant/src/dmx_io/artnet.rs"
    end

    subgraph "Asset System"
        CoreAssets["Core Assets"]
        Cues["Cues"]
        Effects["Effects"]
        Groups["Groups"]

        click CoreAssets "https://github.com/BaukeWestendorp/radiant/tree/main/crates/show/src/assets/"
        click Cues "https://github.com/BaukeWestendorp/radiant/blob/main/crates/show/src/assets/cue.rs"
        click Effects "https://github.com/BaukeWestendorp/radiant/blob/main/crates/show/src/assets/effect.rs"
        click Groups "https://github.com/BaukeWestendorp/radiant/blob/main/crates/show/src/assets/group.rs"
    end

    subgraph "Workspace Management"
        WorkspaceCore["Workspace Core"]
        FrameSys["Frame System"]
        PoolMgmt["Pool Management"]

        click WorkspaceCore "https://github.com/BaukeWestendorp/radiant/blob/main/crates/radiant/src/workspace.rs"
        click FrameSys "https://github.com/BaukeWestendorp/radiant/tree/main/crates/radiant/src/workspace/frame/"
        click PoolMgmt "https://github.com/BaukeWestendorp/radiant/tree/main/crates/radiant/src/workspace/frame/pool/"
    end

    %% Relationships
    App --> MainWindow
    App --> WorkspaceCore
    MainWindow --> EffectEditor
    MainWindow --> SeqEditor
    MainWindow --> AssetSelector
    
    WorkspaceCore --> FrameSys
    FrameSys --> PoolMgmt
    
    ShowFile --> AssetMgmt
    AssetMgmt --> CoreAssets
    CoreAssets --> Cues
    CoreAssets --> Effects
    CoreAssets --> Groups
    
    GraphImpl --> NodeSys
    GraphImpl --> GraphUI
    GraphImpl --> EffectGraphAssets
    
    DMXProto --> UniverseMgmt
    UniverseMgmt --> DMXOutput
    DMXOutput --> ArtNet

    %% Styling
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef show fill:#2ecc71,stroke:#27ae60,color:white
    classDef flow fill:#9b59b6,stroke:#8e44ad,color:white
    classDef dmx fill:#f1c40f,stroke:#f39c12,color:black
    classDef asset fill:#e74c3c,stroke:#c0392b,color:white
    classDef workspace fill:#95a5a6,stroke:#7f8c8d,color:white
    classDef main fill:#34495e,stroke:#2c3e50,color:white

    class MainWindow,EffectEditor,SeqEditor,AssetSelector,InputComp ui
    class ShowFile,PatchSys,AssetMgmt,DMXProto show
    class GraphImpl,NodeSys,GraphUI,EffectGraphAssets flow
    class UniverseMgmt,DMXOutput,ArtNet dmx
    class CoreAssets,Cues,Effects,Groups asset
    class WorkspaceCore,FrameSys,PoolMgmt workspace
    class App main
```
