How librologica/3dvibe64 works
3Dvibe64 is a source SDK for generating Commodore 64 graphics and runtime applications. The principal workflow is a developer supplying scene or render settings to a mode-specific builder, which validates/configures the request and emits native code; optional runtime-scene and animation compilers extend that workflow. The graph preserves the documented modes 1–8, distance fade, AnimatedMesh, and RuntimeScene. Several gameplay subsystems are represented at their exact directories because their implementation files were not sampled; their internal connections are therefore omitted.
Main entry points: mode8/build.py Mode 8 Builder · q8/build.py Q8 Adapter · runtime_scene.py Runtime Scene Compiler · runtime_support_native.py Native Runtime Support
Components 34
Mode Builders
- Mode 7 Builder
work/mode7.py - LegacyPlus Renderer
work/legacy_plus_exact.py - Mode 7 Geometry
work/legacy_mode7_parent_exact.py
Q8 Rendering
- Q8 Adapter
work/q8/build.py - Continuous Geometry
work/q8/src/continuous.py - Assembly Emitter
work/q8/src/emit.py - Code Allocation
work/q8/src/allocation.py - Normalized Geometry
work/q8/src/normalized.py - Normalized Modes
work/q8/src/nf_modes.py - Perspective Mapping
work/q8/src/perspective.py - Texture Edges
work/q8/src/texture_edges.py - Texture Rendering
work/q8/src/texture.py - Camera Setup
work/q8/src/camera.py - Screen Operations
work/q8/src/screen.py - Exact Projection
work/q8/src/perspective_exact.py
Mode 8
- Mode 8 Builder
work/mode8/build.py - Scene Contract
work/mode8/contract.py - Navigation Model
work/mode8/navigation.py - Wall Events
work/mode8/walls.py - Map Model
work/mode8/model.py
Runtime Capabilities
- Distance Fade
work/distance_fade.py - Animated Mesh Compiler
work/animated_mesh.py - Runtime Scene Compiler
work/runtime_scene.py - Native Runtime Support
work/runtime_support_native.py - Runtime Contacts
work/runtime_contacts.py
Gameplay Extensions
- Scene Dynamics
extensions/gameplay/dynamics.py - Level Data
extensions/gameplay/level - Materials
extensions/gameplay/materials - Entities
extensions/gameplay/entities - Visibility
extensions/gameplay/visibility - Billboards
extensions/gameplay/billboards - Controlled Motion
extensions/gameplay/motion - World Groups
extensions/gameplay/world
Other components
- SDK User
Connections 38
- SDK User → Mode 7 Builder: configures
README.md - SDK User → Mode 8 Builder: supplies scene
work/mode8/build.py - SDK User → Q8 Adapter: selects precision
work/q8/build.py - SDK User → Runtime Scene Compiler: provides scene
README.md - SDK User → Animated Mesh Compiler: provides animation
README.md - Mode 8 Builder → Scene Contract: validates with
work/mode8/build.py - Mode 8 Builder → Navigation Model: simulates with
work/mode8/build.py - Mode 8 Builder → Wall Events: uses
work/mode8/build.py - Mode 8 Builder → Map Model: uses
work/mode8/build.py - Scene Contract → Map Model: checks model
work/mode8/contract.py - Navigation Model → Map Model: reads topology
work/mode8/navigation.py - Q8 Adapter → Continuous Geometry: selects adapter
work/q8/build.py - Q8 Adapter → Assembly Emitter: uses
work/q8/build.py - Q8 Adapter → Camera Setup: uses
work/q8/build.py - Q8 Adapter → Texture Rendering: uses
work/q8/build.py - Continuous Geometry → Assembly Emitter: imports helpers
work/q8/src/continuous.py - Continuous Geometry → Screen Operations: uses screen ABI
work/q8/src/continuous.py - Assembly Emitter → Code Allocation: allocates through
work/q8/src/emit.py - Normalized Geometry → Normalized Modes: extends modes
work/q8/src/normalized.py - Normalized Modes → Normalized Geometry: imports geometry
work/q8/src/nf_modes.py - Texture Rendering → Texture Edges: uses
work/q8/src/texture.py - Perspective Mapping → Texture Edges: uses
work/q8/src/perspective.py - Runtime Scene Compiler → Animated Mesh Compiler: integrates
work/runtime_scene.py - Runtime Scene Compiler → LegacyPlus Renderer: patches renderer
work/runtime_scene.py - Runtime Scene Compiler → Native Runtime Support: emits support
work/runtime_scene.py - Runtime Scene Compiler → Scene Dynamics: uses contracts
work/runtime_scene.py - Native Runtime Support → LegacyPlus Renderer: extends renderer
work/runtime_support_native.py - Native Runtime Support → Animated Mesh Compiler: supports
work/runtime_support_native.py - Native Runtime Support → Runtime Contacts: uses
work/runtime_support_native.py - Mode 7 Builder → Mode 7 Geometry: uses geometry
- Mode 8 Builder → Distance Fade: offers fade
work/mode8/build.py - SDK User → Level Data: configures
README.md - SDK User → Materials: configures
README.md - SDK User → Entities: configures
README.md - SDK User → Visibility: configures
README.md - SDK User → Billboards: configures
README.md - SDK User → Controlled Motion: configures
README.md - SDK User → World Groups: configures
README.md