How electro-corp/grss works
GRSS is a wxWidgets desktop application for simulating and visualizing a relativistic multi-mass environment. Users enter through the application frame, where environment controls support mass management and physics ticking, while rendering controls configure the view; the physics engine advances masses and checks collisions, and the rendering engine draws scene objects. The README documents UI, physics, and custom rendering as the product’s main capabilities. Source excerpts establish only some wiring, so uncertain UI-to-engine and universe coordination links are omitted.
Main entry points: Physics.cpp Physics engine · TopPanel.cpp Tool pages · Rendering.cpp Rendering engine · main.cpp Application entry
Components 23
Desktop interface
- Application entry
GRSS/interface/main.cpp - Main frame
GRSS/interface/FrameMain.cpp - Tool pages
GRSS/interface/TopPanel.cpp - Environment controls
GRSS/interface/EnvironmentPage.cpp - Rendering controls
GRSS/interface/RenderingPage.cpp - Properties panel
GRSS/interface/PropertiesPanel.cpp - Add mass dialog
GRSS/interface/AddMassDialog.cpp - System dialog
GRSS/interface/SystemDialog.cpp - Sidebar
GRSS/interface/SideBar.cpp
Simulation state
- Simulation state
GRSS/common/Universe.cpp - Connection manager
GRSS/common/Connections.cpp - Logging
GRSS/common/aixlog.hpp
Physics computation
- Mass model
GRSS/physics/source/Mass.cpp - Physics engine
GRSS/physics/source/Physics.cpp - File utility
GRSS/common/Utility.h - Newton kernel
GRSS/kernels/newton.cl - Mass kernels
GRSS/kernels/test.cl
Scene rendering
- OpenGL panel
GRSS/interface/OpenGLPanel.cpp - Rendering engine
GRSS/rendering/source/Rendering.cpp - Renderable object
GRSS/rendering/source/Object.cpp
Other components
- User
- OpenCL runtime
- OpenGL
Connections 10
- User → Application entry: starts
GRSS/interface/main.cpp - Application entry → Main frame: creates
GRSS/interface/main.cpp - Tool pages → Environment controls: hosts
- Tool pages → Rendering controls: hosts
- Physics engine → File utility: loads kernels with
GRSS/physics/source/Physics.cpp - Physics engine → Newton kernel: loads
GRSS/physics/source/Physics.cpp - Physics engine → Mass kernels: loads
GRSS/physics/source/Physics.cpp - Physics engine → OpenCL runtime: dispatches kernels
GRSS/physics/source/Physics.cpp - Rendering engine → Renderable object: renders
GRSS/rendering/source/Rendering.cpp - Rendering engine → OpenGL: draws with
GRSS/rendering/source/Rendering.cpp