How stasilo/retrace.gl works
Retrace.gl is a browser-based SDF sculpting and physically based path-tracing app. Users author or regenerate a declarative scene, choose rendering options, preview it in realtime or render it, and can export SDF geometry as an STL mesh. The graph preserves the documented geometry, material, texture, BVH, camera, and editor capabilities. Sampled source establishes the central store orchestration and several implementation links; other feature links are included only where the README documents them.
Main entry points: dynamic-scene/index.js Scene API · store/index.js App store · raytracer/index.js Path tracer · sdf-exporter/index.js SDF mesh export
Components 24
App interaction
- Editor UI
src/ui/index.js - Source editor
src/ui/components/editor/index.js - App store
src/store/index.js - Scene storage
src/scene-storage/index.js
Scene authoring
- Scene API
src/dtos/dynamic-scene/index.js - Scene model
src/dtos/scene/index.js - Camera
src/camera/index.js
Rendering
- BVH builder
src/bvh/index.js - BVH algorithm
src/bvh/bvh-builder/index.js - WebGL context
src/gl/index.js - Path tracer
src/raytracer/index.js - Ray-tracing shader
src/shaders/raytracer.glsl.js - Dynamic texture shader
src/shaders/dynamicTexRender.glsl.js
Geometry and assets
- SDF models
src/models/sdf-model/index.js - Mesh and volume models
src/models/obj-model/index.js - OBJ encoder
src/model-encoders/obj/index.js - Materials
src/materials/base-material/index.js - Textures
src/textures/texture/index.js - Volume textures
src/textures/volume-texture/index.js
Export
- SDF mesh export
src/sdf-exporter/index.js - Cube marching
src/cubemarch/index.js - STL exporter
src/stl-exporter/index.js - STL writer
src/stl-exporter/stl-writer.js
Other components
- Artist
Connections 26
- Artist → Editor UI: edits and controls
- Editor UI → App store: reads state
src/ui/index.js - Source editor → App store: updates scene source
src/ui/components/editor/index.js - App store → Scene API: evaluates scene
src/store/index.js - App store → Path tracer: starts render
src/store/index.js - App store → SDF mesh export: starts export
src/store/index.js - App store → Scene storage: uses storage
src/store/index.js - Scene API → Scene model: constructs scene
src/dtos/dynamic-scene/index.js - Scene API → Camera: creates camera
src/dtos/dynamic-scene/index.js - Scene API → SDF models: creates SDF geometry
src/dtos/dynamic-scene/index.js - Scene API → Mesh and volume models: creates geometry
src/dtos/dynamic-scene/index.js - Scene API → Materials: creates materials
src/dtos/dynamic-scene/index.js - Scene API → Textures: creates textures
src/dtos/dynamic-scene/index.js - Scene API → Volume textures: creates volume textures
src/dtos/dynamic-scene/index.js - Mesh and volume models → OBJ encoder: encodes OBJ
src/models/obj-model/index.js - Path tracer → BVH builder: builds acceleration data
src/raytracer/index.js - BVH builder → BVH algorithm: builds hierarchy
src/bvh/index.js - Path tracer → WebGL context: gets WebGL context
src/raytracer/index.js - Path tracer → Ray-tracing shader: creates shader
src/raytracer/index.js - Ray-tracing shader → BVH builder: uses geometry layout
src/shaders/raytracer.glsl.js - Textures → WebGL context: creates GPU texture
src/textures/texture/index.js - Textures → Dynamic texture shader: renders dynamic texture
src/textures/texture/index.js - SDF mesh export → BVH builder: builds acceleration data
src/sdf-exporter/index.js - SDF mesh export → Cube marching: marches geometry
src/sdf-exporter/index.js - SDF mesh export → STL exporter: exports mesh
src/sdf-exporter/index.js - STL exporter → STL writer: writes STL
src/stl-exporter/index.js