MayaTheShy/Starworld
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

fix: enhance wireframe rendering for entity types with detailed descriptions and future model support

Browse Source
This commit is contained in:
MayaTheShy
2025-11-08 22:32:02 -05:00
parent f2a980969e
commit 4b6a153dcb
1 changed files with 17 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
ENTITY_RENDERING_ENHANCEMENTS.md
View File

@@ -80,18 +80,30 @@ struct Node {
### 4. Enhanced Rendering (`bridge/src/lib.rs` - `reify()`) ### 4. Enhanced Rendering (`bridge/src/lib.rs` - `reify()`)
**Implemented type-specific rendering:** **Implemented type-specific wireframe rendering:**
- **Box entities (type 1):** Colored wireframe cubes using entity color The current implementation uses wireframe visualizations for all entity types, providing a lightweight and performant rendering solution that works with the Stardust Lines API:
- **Sphere entities (type 2):** Three orthogonal wireframe circles (XY, XZ, YZ planes) in entity color
- **Model entities (type 3):** Distinctive octahedron wireframe (placeholder for actual model loading) - **Box entities (type 1):** Colored wireframe cubes (12 edges) using entity color and dimensions
- **Sphere entities (type 2):** Three orthogonal wireframe circles (XY, XZ, YZ planes) forming a sphere visualization
- **Model entities (type 3):** Distinctive octahedron wireframe (12 edges) as a placeholder for 3D models
- **Unknown types:** Gray wireframe cube as fallback - **Unknown types:** Gray wireframe cube as fallback
**Features:** **Features:**
- Respects entity dimensions for accurate sizing - Respects entity dimensions for accurate sizing
- Uses entity-specific colors - Uses entity-specific RGB colors with alpha transparency
- Applies proper transforms (position, rotation, scale) - Applies proper transforms (position, rotation, scale)
- Maintains visual distinction between entity types - Maintains visual distinction between entity types
- Lightweight rendering using the Stardust Lines element
**Note on 3D Model Support:**
Full 3D model rendering with textures requires:
1. Downloading Overte model assets (typically GLTF/GLB format)
2. Caching them locally
3. Using `Model::direct(PathBuf)` with local file paths
4. The current implementation uses wireframe placeholders as Overte model URLs are HTTP-based and require asset pipeline integration
Future enhancement: Implement a background asset downloader that fetches Overte models and textures, caches them locally, and dynamically updates the scene graph to replace wireframe placeholders with actual 3D models.
### 5. StardustBridge C++ Interface (`StardustBridge.hpp/.cpp`) ### 5. StardustBridge C++ Interface (`StardustBridge.hpp/.cpp`)