How xwellauss/starlight works
Starlight is a C graphics framework for desktop, web, and Android. Its central runtime workflow initializes platform/window state and optional UI, networking, and audio, then polls input, updates the active scene, renders, and swaps buffers. The framework also exposes ECS, camera, resource-loading, and networking capabilities. The sandbox demonstrates scene registration and selection. Edges follow shown engine calls, scene registration, and UI-backend dependencies; several capability nodes are grounded in the README and file tree, but their internal wiring was not sampled.
Main entry points: engine.c Engine loop · main.c Sandbox entry · network.c Network facade · scene_manager.c Scene manager
Components 26
Runtime and scenes
- Sandbox entry
sandbox/src/main.c - Scene registry
sandbox/src/scenes.h - Engine loop
src/starlight/core/engine.c - Scene manager
src/starlight/core/scene/scene_manager.c - Entity components
src/starlight/core/ecs.c - Camera
src/starlight/core/camera.c - Window and platform
src/starlight/core/window/window.c
Graphics and resources
- Renderer
src/starlight/core/renderer/renderer.c - Shaders
src/starlight/core/renderer/shader.c - Textures
src/starlight/core/renderer/texture.c - Vertex buffers
src/starlight/core/renderer/vertex_buffer.c - Model loading
src/starlight/core/resources/model_loader.c - glTF parsing
src/starlight/core/resources/gltf.c - Texture atlases
src/starlight/core/resources/texture_atlas.c - Font atlas
src/starlight/core/resources/font_atlas.c
UI and input
- Input handling
src/starlight/core/window/input.c - UI system
src/starlight/core/ui/ui.c - UI renderer
src/starlight/core/ui/backend.c - UI styling
src/starlight/core/ui/style.c - Text input
src/starlight/core/ui/text_input.c
Audio and networking
- Audio
src/starlight/audio/audio.c - Network facade
src/starlight/network/network.c - Network client
src/starlight/network/client.c - Network server
src/starlight/network/server.c - Serialization
src/starlight/network/serialize.c
Other components
- Application developer
Connections 18
- Application developer → Sandbox entry: runs
sandbox/src/main.c - Sandbox entry → Engine loop: initializes
sandbox/src/main.c - Sandbox entry → Scene registry: registers scenes
sandbox/src/main.c - Scene registry → Scene manager: registers scenes
sandbox/src/scenes.h - Sandbox entry → Scene manager: selects scene
sandbox/src/main.c - Engine loop → Window and platform: initializes and polls
src/starlight/core/engine.c - Engine loop → Input handling: processes UI input
src/starlight/core/engine.c - Engine loop → Scene manager: dispatches scene
src/starlight/core/engine.c - Engine loop → Renderer: clears buffer
src/starlight/core/engine.c - Engine loop → UI system: updates and renders
src/starlight/core/engine.c - Engine loop → Entity components: initializes and destroys
src/starlight/core/engine.c - Engine loop → Network facade: optionally initializes
src/starlight/core/engine.c - Engine loop → Audio: optionally initializes
src/starlight/core/engine.c - UI renderer → Renderer: draws through
src/starlight/core/ui/backend.c - UI renderer → Font atlas: uses glyph atlas
src/starlight/core/ui/backend.c - Model loading → glTF parsing
- Network facade → Network client
- Network facade → Network server