Documentation
Everything you need to build with Lodestone.
Getting Started
Prerequisites
- CMake 3.16+
- GCC or Clang with C17 support
- GLES 2.0 development headers
- DRM/KMS development headers (libdrm)
- For RPi: ARM cross-compilation toolchain
Architecture Overview
Lodestone is organized into 8 subsystems:
Platform
DRM/KMS setup, display management, input device detection
Renderer
GLES 2.0 rendering pipeline, shaders, texture management
Scene
Entity-component system with slots, scene graph, transform hierarchy
Physics
Box2D integration for 2D physics simulation
Input
Gamepad, keyboard, and touch input handling via Linux evdev
Audio
Audio playback subsystem (planned)
Assets
Resource loading, texture loading, shader compilation
Math
Vector, matrix, quaternion math library
Building
Terminal
mkdir build && cd build
cmake ..
make -j$(nproc)
Cross-Compiling for Raspberry Pi
Terminal
mkdir build && cd build
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchains/arm-rpi.cmake ..
make -j$(nproc)
The toolchain file configures CMake to use the ARM cross-compiler and target the RPi's specific architecture and sysroot.
Subsystem Details
Detailed subsystem documentation is being written. Check the
GitHub repository. for the latest source code and inline documentation.