# francoyudica/genart architecture

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

- Interactive diagram: https://gitdiagram.com/francoyudica/genart
- Repository: https://github.com/francoyudica/genart

## Overview

##### Main Components Overview
The system can be divided into these major components:

a) Core Generation System
- Image Generation Engine
- Individual Generator System
- Renderer System
- Metrics and Fitness Calculation
- Animation System

b) UI System
- Generation Interface
- Settings Management
- Animation Controls
- File Management

##### Detailed Component Breakdown

Frontend Layer:

- UI System       |

- Image Generation UI   |
- Animator UI           |
- Settings UI           |
- Error/Notification UI |

Core Processing Layer:

- Generation System         |

- Image Generator                 |
- Individual Generator            |
- Genetic Algorithm           |
- Hill Climbing               |
- Best of Random              |
- Fitness Calculator             |
- Metrics (MSE, Delta E, etc.)   |

Rendering Layer:

- Renderer System     |

- Sprite Batch          |
- Texture Management    |
- Shader Processing     |

Animation Layer:

- Animation System    |

- Animation Strategies  |
- Video Recording      |
- Frame Management     |

##### Data Flow Connections

- User Input → UI System → Generation System
- Generation System ↔ Renderer System
- Generation System → Animation System
- Renderer System → UI Display
- Settings System → All Components

##### Technical Details

Annotations for:
- Godot 4.3 integration points
- Compute shader utilization
- Threading model (current single-threaded with planned multi-threading)
- Memory management for image processing
- Performance optimization points

## Diagram (Mermaid)

```mermaid
graph TB
    %% Style Definitions
    classDef ui fill:#3498db,stroke:#2980b9,color:white
    classDef core fill:#2ecc71,stroke:#27ae60,color:white
    classDef render fill:#e67e22,stroke:#d35400,color:white
    classDef animation fill:#9b59b6,stroke:#8e44ad,color:white
    classDef utility fill:#95a5a6,stroke:#7f8c8d,color:white

    subgraph Frontend
        UI["UI System"]
        GenUI["Generation Interface"]:::ui
        AnimUI["Animator UI"]:::ui
        SetUI["Settings UI"]:::ui
        ErrUI["Error/Notification UI"]:::ui
        
        UI --> GenUI
        UI --> AnimUI
        UI --> SetUI
        UI --> ErrUI
    end

    subgraph Core
        GenSys["Image Generation Engine"]:::core
        IndGen["Individual Generator System"]:::core
        FitCalc["Fitness Calculator"]:::core
        Metrics["Metrics System"]:::core
        
        subgraph Algorithms
            GA["Genetic Algorithm"]:::core
            HC["Hill Climbing"]:::core
            RND["Best of Random"]:::core
        end
        
        IndGen --> GA
        IndGen --> HC
        IndGen --> RND
        
        GenSys --> IndGen
        GenSys --> FitCalc
        FitCalc --> Metrics
    end

    subgraph Rendering
        RenSys["Renderer System"]:::render
        SpriteBatch["Sprite Batch"]:::render
        TexMgmt["Texture Management"]:::render
        ShaderProc["Shader Processing"]:::render
        
        RenSys --> SpriteBatch
        RenSys --> TexMgmt
        RenSys --> ShaderProc
    end

    subgraph Animation
        AnimSys["Animation System"]:::animation
        AnimStrat["Animation Strategies"]:::animation
        VidRec["Video Recording"]:::animation
        FrameMgmt["Frame Management"]:::animation
        
        AnimSys --> AnimStrat
        AnimSys --> VidRec
        AnimSys --> FrameMgmt
    end

    %% Inter-system connections
    GenUI --> GenSys
    AnimUI --> AnimSys
    GenSys <--> RenSys
    GenSys --> AnimSys
    RenSys --> UI
    SetUI --> GenSys
    SetUI --> RenSys
    SetUI --> AnimSys

    %% Click events
    click GenSys "https://github.com/FrancoYudica/Genart/blob/main/code/genart/generation/image_generation/image_generator.gd"
    click IndGen "https://github.com/FrancoYudica/Genart/tree/main/code/genart/generation/individual_generator/"
    click RenSys "https://github.com/FrancoYudica/Genart/tree/main/code/genart/renderer/"
    click Metrics "https://github.com/FrancoYudica/Genart/tree/main/code/genart/generation/metric/"
    click AnimSys "https://github.com/FrancoYudica/Genart/tree/main/code/genart/animation/"
    click GenUI "https://github.com/FrancoYudica/Genart/tree/main/code/genart/UI/generation/"
    click SetUI "https://github.com/FrancoYudica/Genart/tree/main/code/genart/UI/settings/"
    click AnimUI "https://github.com/FrancoYudica/Genart/tree/main/code/genart/UI/animator/"
    click ErrUI "https://github.com/FrancoYudica/Genart/tree/main/code/genart/UI/notification_panels/"
    click GA "https://github.com/FrancoYudica/Genart/tree/main/code/genart/generation/individual_generator/genetic/"
    click HC "https://github.com/FrancoYudica/Genart/tree/main/code/genart/generation/individual_generator/hill_climbing/"
    click RND "https://github.com/FrancoYudica/Genart/tree/main/code/genart/generation/individual_generator/best_of_random/"
    click SpriteBatch "https://github.com/FrancoYudica/Genart/blob/main/code/genart/renderer/sprite_batch.gd"
    click TexMgmt "https://github.com/FrancoYudica/Genart/blob/main/code/genart/renderer/texture_manager.gd"
    click ShaderProc "https://github.com/FrancoYudica/Genart/tree/main/code/genart/shaders/"
    click AnimStrat "https://github.com/FrancoYudica/Genart/tree/main/code/genart/animation/animator_strategy/"
    click VidRec "https://github.com/FrancoYudica/Genart/tree/main/code/genart/animation/animation_video_recorder/"
    click FrameMgmt "https://github.com/FrancoYudica/Genart/tree/main/code/genart/generation/frame_saver/"

    %% Legend
    subgraph Legend
        UI_L["UI Component"]:::ui
        Core_L["Core Component"]:::core
        Render_L["Rendering Component"]:::render
        Anim_L["Animation Component"]:::animation
        Util_L["Utility Component"]:::utility
    end
```
