orion-ecs / keen-eye / 20881812010

65%

Build Type

push

github

Committed by tyevco

Commit Message

feat(graphics): Add GPU instanced rendering for batched draw calls

Implement GPU instancing to batch multiple entities with the same mesh into
single draw calls, reducing CPU overhead significantly (100-1000x fewer draw
calls for similar objects like trees, rocks, particles).

Key additions:
- InstanceBufferHandle: Opaque handle for instance buffer GPU resources
- InstanceData: Per-instance data struct (ModelMatrix + ColorTint)
- InstanceBatch: ECS component marking entities for instanced rendering
- InstanceBufferManager: Manages GPU instance buffers with pooling
- InstanceBatchingSystem: Batches and renders instanced entities
- Instanced shaders: InstancedLit, InstancedUnlit, InstancedSolid variants

The implementation uses vertex attribute divisors for per-instance data:
- Locations 0-3: Per-vertex data (Position, Normal, TexCoord, Color)
- Locations 4-7: Per-instance ModelMatrix (mat4 = 4 vec4s)
- Location 8: Per-instance ColorTint

Closes #899

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Run Details

9425 of 13097 branches covered (71.96%)

Branch coverage included in aggregate %.

192 of 370 new or added lines in 12 files covered. (51.89%)

2 existing lines in 2 files now uncovered.

163249 of 187679 relevant lines covered (86.98%)

0.99 hits per line