# miltonneal54/gerbervs architecture

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

- Interactive diagram: https://gitdiagram.com/miltonneal54/gerbervs
- Repository: https://github.com/miltonneal54/gerbervs

## Overview

##### Project type and purpose
- This is a Windows desktop application written in C# using WinForms.
- It consists of two main deliverables:
a. GerberView.exe – a graphical viewer/editor for Gerber (RS-274X) and NC drill files.
b. LibGerberVS.dll – a core parsing and rendering library based on Gerbv.

##### File structure
Top-level:
- GerberView/ – WinForms solution containing:
– Multiple Form*.cs files (Form1, DrillStatsFrm, LayerEditForm, etc.)
– Project.cs, ProjectFile.cs – orchestration of .gpf XML project files.
– Program.cs – application entry point.
– bin/, obj/ – build artifacts and debug/release outputs.
– gerberview.iss – Inno Setup installer script.
- LibGerberVS/ – core library solution:
– Gerber*.cs, Drill*.cs, Export*.cs, GerberProject.cs, etc.
– Implements parsing, data model, statistics, export (PNG, NC drill, RS-274X).
– bin/, obj/ – build artifacts.
- LibGerberVS.sln & GerberView.sln – Visual Studio solution files.
- README.*, LICENSE – supporting documentation.

##### Extract README insights
- Core library parses Gerber RS-274X & Ecelon drill, supports legacy commands.
- Projects (.gpf) are XML wrappers over multiple layers.
- Printing with preview, exporting to PNG.
- Acknowledges use of underlying Gerbv library.

##### Derive the architectural components
a. Presentation Layer (WinForms GUI – GerberView.exe)
- MainForms & Dialogs (Form1, LayerEditForm, DrillStatsFrm, SelectionPropertiesForm, etc.)
- Custom UI Controls (FileListBox, RulerControl, CustomColorDialog, MyListBox)
- Resource Manager (Bitmaps/, Resources/)
- Installer script (gerberview.iss)
b. Application Layer
- Project Manager (Project.cs, ProjectFile.cs) – loads/saves .gpf XML project files.
- Command Controllers – handle File→Open, Save, Print, Export commands.
c. Core Library Layer (LibGerberVS.dll)
- Parsers (GerberLineReader, GerberInstruction, Drill, DrillStats, etc.)
- Data Model (GerberProject, GerberNet, GerberSelection, DrillState)
- Exporters (ExportRS274X, ExportNCDrill, ExportProjectAsPNG)
- Utilities (BoundingBox, GerberStats, GerberImage)
d. External Interactions
- File System – reading .gbr/.drl files, writing .gpf, PNG, RS-274X, drill files
- Printing subsystem – .NET PrintDocument and PrintPreview
- Underlying Gerbv Library (at compile time integration)

##### Relationships and dataflows
- User launches GerberView.exe (Presentation) → Program.cs sets up main Form.
- User issues “Open Gerber/Drill file” → Presentation invokes Project Manager → Core Library parser loads file → Data Model is populated.
- Save Project → Application Layer serializes Data Model to XML via ProjectFile.cs.
- Export → Presentation calls Core Library Exporters → writes out to PNG/RS-274X/NC drill.
- Print → Presentation pipes Data Model to Print subsystem for preview and printer.

##### Architectural patterns
- Layered architecture (Presentation → Application → Core Library).
- Model-View pattern: Core Library holds the model, WinForms are the view/controllers.
- Single library module facilitates reuse (can be decoupled from GUI).
- XML-based project persistence.

##### Essential elements to capture
- Clear labels: e.g., “GerberView.exe (WinForms)”, “LibGerberVS.dll (Parser & Model)”.
- Data flows for Open, Render, Edit, Save, Export, Print.
- XML project serialization.
- Exporters vs. Parsing modules distinctions.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer (WinForms GUI)" 
        direction TB
        Program["Program.cs\n(Entry Point)"]:::gui
        MainForm["Form1\n(Main Form)"]:::gui
        LayerEdit["LayerEditForm\n(Dialog)"]:::gui
        DrillStats["DrillStatsFrm\n(Dialog)"]:::gui
        SelectionProps["SelectionPropertiesForm\n(Dialog)"]:::gui
        StatsView["GerberStatsForm\n(View)"]:::gui
        UIAssets["Bitmaps/ and Resources/\n(UI Assets)"]:::gui
        Installer["gerberview.iss\n(Installer Script)"]:::gui
    end

    %% Application Layer
    subgraph "Application Layer (Project Manager & Controllers)"
        direction TB
        ProjectOrch["Project.cs\n(Orchestration)"]:::app
        ProjectFile["ProjectFile.cs\n(XML Persistence)"]:::app
    end

    %% Core Library Layer
    subgraph "Core Library Layer (LibGerberVS.dll)" 
        direction TB
        subgraph Parsers
            direction TB
            GLR["GerberLineReader.cs"]:::core
            GI["GerberInstruction.cs"]:::core
            Drill["Drill.cs"]:::core
            DrillState["DrillState.cs"]:::core
            DrillStatsCore["DrillStats.cs"]:::core
        end
        subgraph DataModel
            direction TB
            GP["GerberProject.cs"]:::core
            GN["GerberNet.cs"]:::core
            GS["GerberSelection.cs"]:::core
            GSt["GerberState.cs"]:::core
            GStats["GerberStats.cs"]:::core
        end
        subgraph Utilities
            direction TB
            Draw["GerberDraw.cs"]:::core
            Image["GerberImage.cs"]:::core
            BB["BoundingBox.cs"]:::core
            CS["CircleSegment.cs"]:::core
        end
        subgraph Exporters
            direction TB
            ERS["ExportRS274X.cs"]:::core
            ENC["ExportNCDrill.cs"]:::core
            EPNG["ExportProjectAsPNG.cs"]:::core
        end
    end

    %% External Systems
    FileSystem["File System\n(.gbr/.drl/.gpf/.png)"]:::external
    PrintSub["Print Subsystem\n(.NET PrintDocument)"]:::external
    GerbvLib["Gerbv Library\n(Compile-time)"]:::external

    %% Relationships
    Program -->|"launches"| MainForm
    MainForm -->|"Open Command"| ProjectOrch
    ProjectOrch -->|"uses parser"| GLR
    GLR --> GI
    GI --> GP
    Drill --> GP
    DrillState --> GP
    DrillStatsCore --> GP
    GP -->|"model returned"| MainForm
    MainForm -->|"render via GDI+"| Draw
    MainForm -->|"change visibility/color"| GS
    MainForm -->|"Save Project"| ProjectFile
    ProjectFile --> FileSystem
    MainForm -->|"Export PNG/RS-274X/Drill"| ERS
    MainForm --> ENC
    MainForm --> EPNG
    MainForm --> PrintSub
    ProjectOrch --> FileSystem
    ProjectOrch --> GerbvLib

    %% Click Events
    click Program "https://github.com/miltonneal54/gerbervs/blob/master/GerberView/Program.cs"
    click MainForm "https://github.com/miltonneal54/gerbervs/blob/master/GerberView/Form1.cs"
    click LayerEdit "https://github.com/miltonneal54/gerbervs/blob/master/GerberView/LayerEditForm.cs"
    click DrillStats "https://github.com/miltonneal54/gerbervs/blob/master/GerberView/DrillStatsFrm.cs"
    click SelectionProps "https://github.com/miltonneal54/gerbervs/blob/master/GerberView/SelectionPropertiesForm.cs"
    click StatsView "https://github.com/miltonneal54/gerbervs/blob/master/GerberView/GerberStatsForm.cs"
    click UIAssets "https://github.com/miltonneal54/gerbervs/tree/master/GerberView/Bitmaps/"
    click UIAssets "https://github.com/miltonneal54/gerbervs/tree/master/GerberView/Resources/"
    click Installer "https://github.com/miltonneal54/gerbervs/blob/master/GerberView/gerberview.iss"
    click ProjectOrch "https://github.com/miltonneal54/gerbervs/blob/master/GerberView/Project.cs"
    click ProjectFile "https://github.com/miltonneal54/gerbervs/blob/master/GerberView/ProjectFile.cs"
    click GLR "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/GerberLineReader.cs"
    click GI "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/GerberInstruction.cs"
    click Drill "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/Drill.cs"
    click DrillState "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/DrillState.cs"
    click DrillStatsCore "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/DrillStats.cs"
    click GP "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/GerberProject.cs"
    click GN "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/GerberNet.cs"
    click GS "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/GerberSelection.cs"
    click GSt "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/GerberState.cs"
    click GStats "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/GerberStats.cs"
    click Draw "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/GerberDraw.cs"
    click Image "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/GerberImage.cs"
    click BB "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/BoundingBox.cs"
    click CS "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/CircleSegment.cs"
    click ERS "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/ExportRS274X.cs"
    click ENC "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/ExportNCDrill.cs"
    click EPNG "https://github.com/miltonneal54/gerbervs/blob/master/LibGerberVS/ExportProjectAsPNG.cs"

    %% Styles
    classDef gui fill:#cce5ff,stroke:#004085
    classDef app fill:#fff3cd,stroke:#856404
    classDef core fill:#d4edda,stroke:#155724
    classDef external fill:#e2e3e5,stroke:#6c757d.executor
```
