How marcushcarter/lumen works
Lumen is a C++ game engine with an editor and game runtime. A typical editor workflow begins by selecting or creating a project, editing scene and asset documents in viewports, then running or exporting the project; the runtime loads a project and advances simulation and rendering. The tree also shows substantial animation, physics, terrain, and rendering subsystems. The excerpts confirm the application’s window/renderer setup and document lifecycle, but most domain wiring is unsampled, so those connections are marked unverified rather than asserted.
Main entry points: application.cpp Application Loop · editor_application.cpp Editor Application · document_manager.cpp Document Manager · renderer.cpp Renderer
Components 25
Editor
- Project Manager
editor/project_manager/project_manager.cpp - Editor Application
editor/application/editor_application.cpp - Document Manager
editor/documents/document_manager.cpp - Scene Editing
editor/documents/scene/scene_panel.cpp - Asset Documents
editor/documents - Preview Viewport
editor/viewport/preview_viewport.cpp - Play Session
editor/play/play_session.cpp - Project Export
editor/export/project_exporter.cpp
Application Runtime
- Game Application
game/application/game_application.cpp - Application Loop
core/application/application.cpp
Project and Content
- Project Loading
core/project/project.cpp - Scene Data
core/scene/scene_file.cpp - Terrain Source
core/terrain/terrain_source.cpp
Engine Systems
- Renderer
core/rendering/renderer.cpp - Render Graph
core/rendering/render_graph.cpp - Render Features
core/rendering/features/geometry/geometry_feature.cpp - Animation System
core/animation/pose_system.cpp - Character Dynamics
core/animation/dynamics.cpp - Physics World
core/physics/physics_world.cpp - Game Session
core/game/game_session.h
Platform Drivers
- Windows Driver
drivers/windows/window_driver_win32.cpp - Vulkan Context
drivers/vulkan/context_driver_vulkan.cpp - Vulkan Device
drivers/vulkan/device_driver_vulkan.cpp - ImGui Driver
drivers/imgui/imgui_driver.cpp
Other components
- Editor User
Connections 25
- Editor User → Project Manager: chooses project
- Project Manager → Editor Application: opens project
- Editor Application → Document Manager: manages documents
- Document Manager → Scene Editing: opens scene
- Document Manager → Asset Documents: opens assets
- Scene Editing → Preview Viewport: shows viewport
- Editor Application → Play Session: starts play session
- Editor Application → Project Export: exports project
- Game Application → Application Loop: runs
- Application Loop → Windows Driver: creates window
core/application/application.cpp - Application Loop → ImGui Driver: initializes UI
core/application/application.cpp - Application Loop → Renderer: records frames
core/application/application.cpp - Application Loop → Render Features: creates render path
- Application Loop → Project Loading: loads project
- Application Loop → Scene Data: updates scene
- Application Loop → Animation System: updates poses
- Application Loop → Game Session: ticks gameplay
- Game Session → Physics World: simulates physics
- Game Session → Character Dynamics: updates characters
- Animation System → Character Dynamics: evaluates dynamics
- Renderer → Render Graph: records passes
- Render Graph → Render Features: dispatches features
- Renderer → Vulkan Device: submits GPU work
- Vulkan Device → Vulkan Context: uses context
- Scene Data → Terrain Source: references terrain