# syafiqkarmen/3dgameproto architecture

> Architecture diagram of the GitHub repository syafiqkarmen/3dgameproto, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-27). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/syafiqkarmen/3dgameproto
- Repository: https://github.com/syafiqkarmen/3dgameproto

## Overview

3DGameProto is a WIP C++ prototype presented as an engine/game for realistic armor simulation, but the sampled runtime implements only SDL video startup, window creation, quit-event handling, and shutdown. README-level armor simulation and Vulkan capabilities are aspirations, not evidenced runtime subsystems; the file tree contains no corresponding application modules. The graph therefore stays limited to the implemented user-to-window lifecycle. SDL3 headers are bundled dependencies, not application features.

Main entry points: [`src/Main.cpp`](https://github.com/syafiqkarmen/3dgameproto/blob/main/src/Main.cpp) (SDL app entry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_entry["SDL app entry<br/>[Main.cpp]"]
  node_window["Application window<br/>[Main.cpp]"]
  node_events["Quit event loop<br/>[Main.cpp]"]
end

node_user(("User"))
node_sdl["SDL3 runtime"]
node_display["Desktop display"]

node_user -->|"launches"| node_entry
node_entry -->|"initializes video"| node_sdl
node_entry -->|"creates window"| node_window
node_entry -->|"polls events"| node_events
node_sdl -->|"provides window API"| node_window
node_sdl -->|"provides events"| node_events
node_window -->|"opens on"| node_display
node_events -->|"quit ends loop"| node_entry

click node_entry "https://github.com/syafiqkarmen/3dgameproto/blob/main/src/Main.cpp"
click node_window "https://github.com/syafiqkarmen/3dgameproto/blob/main/src/Main.cpp"
click node_events "https://github.com/syafiqkarmen/3dgameproto/blob/main/src/Main.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_entry,node_window,node_events,node_user toneBlue
class node_sdl,node_display toneIndigo
```

## Components

### Application runtime

- [SDL app entry](https://github.com/syafiqkarmen/3dgameproto/blob/main/src/Main.cpp): `src/Main.cpp`
- [Application window](https://github.com/syafiqkarmen/3dgameproto/blob/main/src/Main.cpp): `src/Main.cpp`
- [Quit event loop](https://github.com/syafiqkarmen/3dgameproto/blob/main/src/Main.cpp): `src/Main.cpp`

### Other components

- **User**
- **SDL3 runtime**
- **Desktop display**

## Connections

- User → SDL app entry: launches
- SDL app entry → SDL3 runtime: initializes video
- SDL app entry → Application window: creates window
- SDL app entry → Quit event loop: polls events
- SDL3 runtime → Application window: provides window API
- SDL3 runtime → Quit event loop: provides events
- Application window → Desktop display: opens on
- Quit event loop → SDL app entry: quit ends loop