Expand description
Section 20 (SURF1): Hierarchical Surfel / 3D Gaussian Splat Primitives for .10d Living Containers.
Provides the runtime data container and offline meshlet-to-surfel fitting mathematics for Tier 4 far-field rendering (Screen-Space Radius: 1–8 px). At this distance, drawing full geometry, LODs, or even impostor billboards causes overdraw and cache thrashing. A hierarchical surfel condenses an entire 64-triangle meshlet cluster into a single 32-byte oriented disc / splat primitive evaluated in a single GPU compute rasterization pass.
§32-Byte POD Binary Layout (SurfelBinaryRecord)
| Offset | Type | Field | Description |
|---|---|---|---|
0x00 | [f32; 3] | position | World or local space centroid (12 bytes) |
0x0C | u32 | normal_oct32 | Octahedral encoded orientation (4 bytes) |
0x10 | [u16; 2] | radii | Major and minor splat radii in IEEE 754 f16 (4 bytes) |
0x14 | [u16; 3] | spectral_coeffs | Jakob-Hanika $(c_0, c_1, c_2)$ in f16 (6 bytes) |
0x1A | u16 | roughness | Aggregate perceptual roughness in f16 (2 bytes) |
0x1C | u32 | flags | Material bitmask / hierarchy indices (4 bytes) |
Structs§
- Surfel
Binary Record - 32-byte POD binary record for a single Tier 4 Surfel / 3D Gaussian Splat.
- Surfel
Section Mini Header - 64-byte POD header encoding hierarchical surfel table in SectionType::HierarchicalSurfels (20).
Enums§
Constants§
- FLAG_
SURFEL_ GAUSSIAN_ COVARIANCE - FLAG_
SURFEL_ HIERARCHICAL - MAGIC_
SURF - SURFEL_
MINI_ HEADER_ SIZE - SURFEL_
RECORD_ SIZE - SURFEL_
SECTION_ VERSION
Functions§
- decode_
octahedral_ normal - Decode a 32-bit octahedral normal back into a normalized 3D vector.
- decode_
surfel_ section - Zero-copy parser for a surfel section. Returns a borrowed reference to header and records.
- encode_
octahedral_ normal - Encode a 3D unit normal vector into a 32-bit octahedral representation (two i16s packed into u32).
- encode_
surfel_ section - Encode a surfel section into a caller-supplied byte buffer. Zero-heap.
- generate_
surfel_ from_ cluster - Deterministic 1:1 generator mapping a meshlet triangle cluster into a 32-byte Tier 4 Surfel.