How orenliu/soup3d works
soup3D is a Python 3D engine built on OpenGL, intended for interactive rendering, games, visualization, and graphics work. Its documented user workflow initializes the engine in a pygame OpenGL window, creates a shader-backed face and model, displays it, then calls update in the application loop. The architecture also includes asset loading, lighting, camera control, skeletal animation, 2D overlays, off-screen render targets, and scene snapshots. Connections below follow the README workflow and sampled source references; unsampled render internals are not expanded into assumed call chains.
Main entry points: __init__.py Engine API · shader.py Shaders and Textures · scene.py Scene Snapshots · camera.py Camera
Components 15
Engine Core
- Engine API
soup3D/__init__.py - Models and Faces
soup3D/__init__.py - Render Constants
soup3D/name.py
Rendering
- Shaders and Textures
soup3D/shader.py
Assets and Math
- Asset Loading
soup3D/__init__.py - 3D Math
soup3D/s3dm.py
Output Extensions
- 2D UI
soup3D/ui.py - Render Targets
soup3D/target.py - Scene Snapshots
soup3D/scene.py
Other components
- Application
- Pygame Window
- OpenGL
Connections 23
- Application → Engine API: initializes and updates
README.md - Application → Models and Faces: creates and displays
README.md - Application → Pygame Window: creates window
README.md - Engine API → Pygame Window: uses window context
- Engine API → Camera: uses
soup3D/__init__.py - Engine API → Lighting: uses
soup3D/__init__.py - Engine API → Shaders and Textures: uses
soup3D/__init__.py - Engine API → Skeletons: uses
soup3D/__init__.py - Engine API → Asset Loading: loads and builds
soup3D/__init__.py - Models and Faces → Shaders and Textures: renders with
README.md - Shaders and Textures → OpenGL: issues rendering calls
soup3D/shader.py - Engine API → OpenGL: initializes rendering
- Camera → 3D Math: uses rotations
soup3D/camera.py - Lighting → 3D Math: uses rotations
soup3D/light.py - Skeletons → 3D Math: uses transforms
soup3D/skeleton.py - Shaders and Textures → Skeletons: skins meshes
soup3D/shader.py - Shaders and Textures → Render Targets: samples target textures
soup3D/target.py - Engine API → 2D UI: exposes
soup3D/__init__.py - Engine API → Render Targets: exposes
soup3D/__init__.py - Engine API → Scene Snapshots: exposes
soup3D/__init__.py - Scene Snapshots → Models and Faces: extracts scene state
soup3D/scene.py - Scene Snapshots → Camera: captures camera state
soup3D/scene.py - Scene Snapshots → Lighting: captures light state
soup3D/scene.py