# jakemuzy/physics-engine architecture

> Architecture diagram of the GitHub repository jakemuzy/physics-engine, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jakemuzy/physics-engine
- Repository: https://github.com/jakemuzy/physics-engine

## Overview

This repository is a small OpenGL application described as an AVBD physics engine. Its visible workflow initializes a camera and window, registers keyboard actions, creates a shader and mesh, then processes input and draws each frame. The README identifies AVBD as the intended physics basis, but the sampled runtime shows no physics solver or simulation stage, so the graph focuses on the implemented viewer and its math/rendering layers. Relationships reflect shown calls and indexed references; the solver’s implementation is not evidenced.

Main entry points: [`src/main.c`](https://github.com/jakemuzy/physics-engine/blob/main/src/main.c) (Frame Loop), [`src/Mesh.c`](https://github.com/jakemuzy/physics-engine/blob/main/src/Mesh.c) (Mesh Manager), [`src/Input.c`](https://github.com/jakemuzy/physics-engine/blob/main/src/Input.c) (Input Handler), [`src/Shader.c`](https://github.com/jakemuzy/physics-engine/blob/main/src/Shader.c) (Shader Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_main["Frame Loop<br/>[main.c]"]
  node_avbd["AVBD Solver"]
end

subgraph group_controls["Window and Controls"]
  node_window["Window Manager<br/>[Window.c]"]
  node_input["Input Handler<br/>[Input.c]"]
  node_camera["Camera Controller<br/>[Camera.c]"]
end

subgraph group_render["Rendering"]
  node_shader["Shader Manager<br/>[Shader.c]"]
  node_mesh["Mesh Manager<br/>[Mesh.c]"]
  node_shader_assets["GLSL Shaders<br/>[v1.vs]"]
  node_triangle["Triangle Data<br/>[Triangle.h]"]
end

subgraph group_core["Core Utilities"]
  node_math["Vector Math<br/>[Vlm.c]"]
  node_map["Map Store<br/>[Map.c]"]
end

node_user(("User"))
node_gl["OpenGL and GLFW"]

node_user -->|"provides keys"| node_input
node_main -->|"initializes"| node_window
node_main -->|"processes"| node_input
node_main -->|"updates controls"| node_camera
node_main -->|"sets uniforms"| node_shader
node_main -->|"draws mesh"| node_mesh
node_main -->|"creates matrices"| node_math
node_main -->|"loads shaders"| node_shader_assets
node_main -->|"polls and swaps"| node_gl
node_main -.->|"would simulate"| node_avbd
node_input -->|"registers callbacks"| node_camera
node_input -->|"targets window"| node_window
node_camera -->|"builds view"| node_math
node_shader -->|"stores programs"| node_map
node_mesh -->|"uses map"| node_map
node_mesh -->|"uses vertex data"| node_triangle
node_window -->|"uses map"| node_map
node_shader -->|"compiles programs"| node_gl
node_mesh -->|"draws geometry"| node_gl

click node_main "https://github.com/jakemuzy/physics-engine/blob/main/src/main.c"
click node_window "https://github.com/jakemuzy/physics-engine/blob/main/src/Window.c"
click node_input "https://github.com/jakemuzy/physics-engine/blob/main/src/Input.c"
click node_camera "https://github.com/jakemuzy/physics-engine/blob/main/src/Camera.c"
click node_shader "https://github.com/jakemuzy/physics-engine/blob/main/src/Shader.c"
click node_mesh "https://github.com/jakemuzy/physics-engine/blob/main/src/Mesh.c"
click node_shader_assets "https://github.com/jakemuzy/physics-engine/blob/main/shaders/v1.vs"
click node_triangle "https://github.com/jakemuzy/physics-engine/blob/main/include/Triangle.h"
click node_math "https://github.com/jakemuzy/physics-engine/blob/main/src/Vlm.c"
click node_map "https://github.com/jakemuzy/physics-engine/blob/main/src/Map.c"

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_main,node_avbd,node_user toneBlue
class node_window,node_input,node_camera toneAmber
class node_shader,node_mesh,node_shader_assets,node_triangle toneMint
class node_math,node_map toneRose
class node_gl toneIndigo
```

## Components

### Application

- [Frame Loop](https://github.com/jakemuzy/physics-engine/blob/main/src/main.c): `src/main.c`
- **AVBD Solver**

### Window and Controls

- [Window Manager](https://github.com/jakemuzy/physics-engine/blob/main/src/Window.c): `src/Window.c`
- [Input Handler](https://github.com/jakemuzy/physics-engine/blob/main/src/Input.c): `src/Input.c`
- [Camera Controller](https://github.com/jakemuzy/physics-engine/blob/main/src/Camera.c): `src/Camera.c`

### Rendering

- [Shader Manager](https://github.com/jakemuzy/physics-engine/blob/main/src/Shader.c): `src/Shader.c`
- [Mesh Manager](https://github.com/jakemuzy/physics-engine/blob/main/src/Mesh.c): `src/Mesh.c`
- [GLSL Shaders](https://github.com/jakemuzy/physics-engine/blob/main/shaders/v1.vs): `shaders/v1.vs`
- [Triangle Data](https://github.com/jakemuzy/physics-engine/blob/main/include/Triangle.h): `include/Triangle.h`

### Core Utilities

- [Vector Math](https://github.com/jakemuzy/physics-engine/blob/main/src/Vlm.c): `src/Vlm.c`
- [Map Store](https://github.com/jakemuzy/physics-engine/blob/main/src/Map.c): `src/Map.c`

### Other components

- **User**
- **OpenGL and GLFW**

## Connections

- User → Input Handler: provides keys
- Frame Loop → Window Manager: initializes (evidence: `src/main.c`)
- Frame Loop → Input Handler: processes (evidence: `src/main.c`)
- Frame Loop → Camera Controller: updates controls (evidence: `src/main.c`)
- Frame Loop → Shader Manager: sets uniforms (evidence: `src/main.c`)
- Frame Loop → Mesh Manager: draws mesh (evidence: `src/main.c`)
- Frame Loop → Vector Math: creates matrices (evidence: `src/main.c`)
- Frame Loop → GLSL Shaders: loads shaders (evidence: `src/main.c`)
- Frame Loop → OpenGL and GLFW: polls and swaps (evidence: `src/main.c`)
- Frame Loop → AVBD Solver: would simulate
- Input Handler → Camera Controller: registers callbacks
- Input Handler → Window Manager: targets window
- Camera Controller → Vector Math: builds view
- Shader Manager → Map Store: stores programs (evidence: `src/Shader.c`)
- Mesh Manager → Map Store: uses map
- Mesh Manager → Triangle Data: uses vertex data
- Window Manager → Map Store: uses map
- Shader Manager → OpenGL and GLFW: compiles programs (evidence: `src/Shader.c`)
- Mesh Manager → OpenGL and GLFW: draws geometry
