# xandramax/volume1 architecture

> Architecture diagram of the GitHub repository xandramax/volume1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/xandramax/volume1
- Repository: https://github.com/xandramax/volume1

## Overview

##### Architectural Components

a) User Interface Components:
- Widget (AlgomorphDisplayWidget)
- Aux Input Panel (AlgomorphAuxInputPanelWidget)
- Connection Background (ConnectionBgWidget)
- Control Elements (knobs, buttons)

b) Data Management:
- Graph Structure (GraphStructure)
- Graph Data (GraphData)
- Plugin Settings (pluginsettings)

c) Processing Core:
- Algorithm Processing
- Morphing Engine
- Routing Logic

##### Technical Details

a) Input/Output Specifications:
- 4 Operator Inputs (+/-5V)
- CV Input (+/-5V)
- Modulation Outputs
- Carrier Sum Output

b) State Management:
- 3 Algorithm States
- Morphing Parameters
- Routing Matrix

##### Implementation Details

Relationship between:
- Core Classes (Algomorph.hpp as base)
- Variant Implementations (AlgomorphLarge and AlgomorphSmall)
- Support Systems (AuxSources, Components)

- Blue: Signal processing components
- Green: User interface elements
- Yellow: Data management
- Red: Control systems

##### External Interactions

Interfaces with:
- VCV Rack API
- External Operator Modules
- Audio Output System

- All symbols used
- Signal flow types
- Component types

Remember to emphasize:

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Modules
        AP["Algomorph Pocket"]
        AA["Algomorph Advance"]
    end

    subgraph "GUI Layer"
        ADW["Display Widget"]
        AIPW["Aux Input Panel"]
        CBW["Connection Background"]
        UICOMP["UI Components"]
    end

    subgraph "Data Management Layer"
        GD["Graph Data"]
        GS["Graph Structure"]
        PS["Plugin Settings"]
    end

    subgraph "Core Processing Layer"
        ASM["Algorithm State Manager"]
        RL["Routing Logic"]
        ME["Morphing Engine"]
    end

    subgraph "Signal Flow"
        direction TB
        IN1["Operator Input 1"]
        IN2["Operator Input 2"]
        IN3["Operator Input 3"]
        IN4["Operator Input 4"]
        RM["Routing Matrix"]
        MO["Modulation Outputs"]
        CO["Carrier Output"]
    end

    %% Connections
    AP --> ADW
    AA --> ADW
    ADW --> GD
    AIPW --> GD
    CBW --> GD
    UICOMP --> ADW
    GD --> GS
    GS --> ASM
    ASM --> RL
    RL --> ME
    IN1 & IN2 & IN3 & IN4 --> RM
    RM --> MO
    RM --> CO
    ME --> RM
    PS --> GD

    %% Styling
    classDef module fill:#f9f,stroke:#333
    classDef gui fill:#a8d1f0,stroke:#333
    classDef data fill:#90EE90,stroke:#333
    classDef processing fill:#FFA500,stroke:#333
    classDef signal fill:#ddd,stroke:#333

    class AP,AA module
    class ADW,AIPW,CBW,UICOMP gui
    class GD,GS,PS data
    class ASM,RL,ME processing
    class IN1,IN2,IN3,IN4,RM,MO,CO signal

    %% Click events
    click AP "https://github.com/xandramax/Volume1/blob/v2/src/AlgomorphSmall.hpp"
    click AA "https://github.com/xandramax/Volume1/blob/v2/src/AlgomorphLarge.hpp"
    click ADW "https://github.com/xandramax/Volume1/blob/v2/src/AlgomorphDisplayWidget.hpp"
    click AIPW "https://github.com/xandramax/Volume1/blob/v2/src/AlgomorphAuxInputPanelWidget.hpp"
    click CBW "https://github.com/xandramax/Volume1/blob/v2/src/ConnectionBgWidget.hpp"
    click UICOMP "https://github.com/xandramax/Volume1/blob/v2/src/Components.hpp"
    click GD "https://github.com/xandramax/Volume1/blob/v2/src/GraphData.hpp"
    click GS "https://github.com/xandramax/Volume1/blob/v2/src/GraphStructure.hpp"
    click PS "https://github.com/xandramax/Volume1/blob/v2/src/pluginsettings.hpp"

    %% Legend
    subgraph Legend
        M1[Module]:::module
        G1[GUI Component]:::gui
        D1[Data Component]:::data
        P1[Processing Component]:::processing
        S1[Signal Component]:::signal
    end
```
