# zecruel/cadzinho architecture

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

- Interactive diagram: https://gitdiagram.com/zecruel/cadzinho
- Repository: https://github.com/zecruel/cadzinho

## Overview

##### Main System Components

a) User Interface Layer
- GUI components (based on /src/gui*.c files)
- Toolbox, file operations, and drawing tools interfaces
- Nuklear UI framework integration (nuklear.h)

b) Core CAD Engine Layer
- Drawing and Geometry Processing (/src/dxf*.c files)
- Math Operations (/src/dxf_math.c)
- Entity Management (/src/dxf_ent.c)
- Graphics Rendering (/src/draw_gl.c, /src/graph.c)

c) File Operations Layer
- DXF File Handling (Import/Export)
- Multiple Export Formats (PDF, SVG, PS, images)
- G-code and HPGL Export capabilities

d) Extension System
- Scripting Engine (Lua-based, /script directory)
- Plugin Architecture
- Custom Tools Support

##### Connection Flows

Key interactions:
**User Interface Layer**
- ↕
**Core CAD Engine**
- ↕
**File Operations Layer**
- ↕
**Storage/Export Formats**

##### Important Details

a) External Dependencies:
- OpenGL for rendering
- SQLite for data management
- Lua for scripting
- STB libraries for image handling
- Nuklear for UI

b) File Format Support:
- DXF (primary format)
- Export formats (PDF, SVG, PS, images)
- G-code and HPGL export

c) Cross-Platform Support:
- Platform-specific components (Windows, Linux, macOS, Web/Emscripten)

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef ui fill:#FF9900,stroke:#333,stroke-width:2px
    classDef core fill:#3498DB,stroke:#333,stroke-width:2px
    classDef file fill:#2ECC71,stroke:#333,stroke-width:2px
    classDef ext fill:#9B59B6,stroke:#333,stroke-width:2px
    classDef platform fill:#95A5A6,stroke:#333,stroke-width:2px
    classDef storage fill:#E74C3C,stroke:#333,stroke-width:2px

    %% User Interface Layer
    subgraph UI
        NuklearUI["Nuklear UI Framework"]:::ui
        click NuklearUI "https://github.com/zecruel/CadZinho/blob/opengl/src/nuklear.h"
        GUI["GUI Core"]:::ui
        click GUI "https://github.com/zecruel/CadZinho/blob/opengl/src/gui.c"
        
        subgraph Tools
            Toolbox["Toolbox"]:::ui
            click Toolbox "https://github.com/zecruel/CadZinho/blob/opengl/src/gui_toolbox.c"
            FileOps["File Operations"]:::ui
            click FileOps "https://github.com/zecruel/CadZinho/blob/opengl/src/gui_file.c"
            ExportOps["Export Operations"]:::ui
            click ExportOps "https://github.com/zecruel/CadZinho/blob/opengl/src/gui_export.c"
            PluginUI["Plugin Interface"]:::ui
            click PluginUI "https://github.com/zecruel/CadZinho/blob/opengl/src/gui_plugins.c"
        end

        subgraph DrawingTools
            LineTool["Line Tool"]:::ui
            click LineTool "https://github.com/zecruel/CadZinho/blob/opengl/src/gui_line.c"
            CircleTool["Circle Tool"]:::ui
            click CircleTool "https://github.com/zecruel/CadZinho/blob/opengl/src/gui_circle.c"
            RectTool["Rectangle Tool"]:::ui
            click RectTool "https://github.com/zecruel/CadZinho/blob/opengl/src/gui_rect.c"
            PLineTool["Polyline Tool"]:::ui
            click PLineTool "https://github.com/zecruel/CadZinho/blob/opengl/src/gui_pline.c"
            SplineTool["Spline Tool"]:::ui
            click SplineTool "https://github.com/zecruel/CadZinho/blob/opengl/src/gui_spline.c"
        end
    end

    %% Core CAD Engine Layer
    subgraph CoreEngine
        MathOps["Math Operations"]:::core
        click MathOps "https://github.com/zecruel/CadZinho/blob/opengl/src/dxf_math.c"
        EntityMgmt["Entity Management"]:::core
        click EntityMgmt "https://github.com/zecruel/CadZinho/blob/opengl/src/dxf_ent.c"
        Graphics["Graphics Rendering"]:::core
        click Graphics "https://github.com/zecruel/CadZinho/blob/opengl/src/draw_gl.c"
        GraphProc["Graphics Processing"]:::core
        click GraphProc "https://github.com/zecruel/CadZinho/blob/opengl/src/graph.c"

        subgraph EntityOps
            Create["Entity Creation"]:::core
            click Create "https://github.com/zecruel/CadZinho/blob/opengl/src/dxf_create.c"
            Edit["Entity Editing"]:::core
            click Edit "https://github.com/zecruel/CadZinho/blob/opengl/src/dxf_edit.c"
            Copy["Entity Copying"]:::core
            click Copy "https://github.com/zecruel/CadZinho/blob/opengl/src/dxf_copy.c"
        end
    end

    %% File Operations Layer
    subgraph FileSystem
        DXFCore["DXF Core"]:::file
        click DXFCore "https://github.com/zecruel/CadZinho/blob/opengl/src/dxf.c"
        ExportFuncs["Export Functions"]:::file
        click ExportFuncs "https://github.com/zecruel/CadZinho/blob/opengl/src/dxf_export.c"
        Printing["Printing System"]:::file
        click Printing "https://github.com/zecruel/CadZinho/blob/opengl/src/dxf_print.c"
        PDFGen["PDF Generation"]:::file
        click PDFGen "https://github.com/zecruel/CadZinho/blob/opengl/src/pdfgen.c"
    end

    %% Extension System
    subgraph Extensions
        ScriptEngine["Script Engine"]:::ext
        click ScriptEngine "https://github.com/zecruel/CadZinho/blob/opengl/src/script.c"
        LuaScripts["Lua Scripts"]:::ext
        click LuaScripts "https://github.com/zecruel/CadZinho/tree/opengl//script"
        I18n["Internationalization"]:::ext
        click I18n "https://github.com/zecruel/CadZinho/tree/opengl//lang"
    end

    %% Platform Support
    subgraph Platforms
        Windows["Windows"]:::platform
        click Windows "https://github.com/zecruel/CadZinho/tree/opengl//windows"
        Linux["Linux"]:::platform
        click Linux "https://github.com/zecruel/CadZinho/tree/opengl//linux"
        MacOS["MacOS"]:::platform
        click MacOS "https://github.com/zecruel/CadZinho/tree/opengl//macos"
        Web["Web/Emscripten"]:::platform
        click Web "https://github.com/zecruel/CadZinho/tree/opengl//emscripten"
    end

    %% Connections
    NuklearUI --> GUI
    GUI --> Tools
    GUI --> DrawingTools
    CoreEngine --> FileSystem
    FileSystem --> Extensions
    CoreEngine --> Extensions
    GUI --> CoreEngine

    %% Legend
    subgraph Legend
        UI_L["UI Components"]:::ui
        Core_L["Core Components"]:::core
        File_L["File Operations"]:::file
        Ext_L["Extensions"]:::ext
        Platform_L["Platforms"]:::platform
    end
```
