How caimeox/voxelgeometry works
Main Components
a) Core Library Components:
• Vector Engine (vector.ts)
• Geometry Generators
• Transformation System
• Mathematical Interpreters
• Specialized Algorithms (DLA, IFS)
b) Integration Layer:
• Canvas Renderer
• Web Viewer
• Minecraft Integration Points (mentioned in branches)
┌─────────────────────────────────────────────┐
• Client Applications │
• (Web Viewer, Minecraft, Custom Solutions) │
• ┘
• ↑
┌─────────────────────────────────────────────┐
• Integration Layer │
• (Canvas API, Rendering Systems) │
• ┘
• ↑
┌─────────────────────────────────────────────┐
• Core Components │
• ┬─────────────┬────────────────┤
• Geometry │ Transform- │ Algorithm │
• Engine │ ation │ Engine │
• ┴─────────────┴────────────────┘
Component Details
a) Geometry Engine (Blue Rectangle):
• Vector Operations (vector.ts)
• L-System Implementation (lsystem.ts)
• Turtle Graphics (turtle.ts)
b) Transformation Engine (Green Rectangle):
• Space Transformations (transform.ts)
• Expression Evaluation (expression.ts)
• Utility Functions (utils.ts)
c) Algorithm Engine (Purple Rectangle):
• DLA Implementation (DLA2D.ts, DLA3D.ts)
• IFS Implementation (ifs.ts)
• Hyper Geometric Operations (hyper.ts)
□ Core Components
◇ Integration Layers
○ Client Applications
Blue: Geometry Operations
Green: Transformations
Purple: Advanced Algorithms
Gray: Integration Components
Additional Notes
• Clear separation between pure mathematical operations and rendering systems
• Modular nature of the transformation system
• Extension points for different platforms (Minecraft, Web)
• Version/build pipeline information from GitHub workflows
Remember to include notes about the asynchronous nature of certain operations (like DLA and IFS) and how they integrate with the synchronous geometric operations.
This structure will give a clear understanding of how the library processes voxel geometry from mathematical concepts through to final rendering, while maintaining clarity about the separation of concerns between core mathematical operations and platform-specific implementations.