Struct SpriteDense 

pub struct SpriteDense { /* private fields */ }

Dense occupancy + colour grid for one sprite frame, plus its pivot — the decoded form the per-pixel raycaster marches. Built once from a Kv6 (SpriteDense::from_kv6) or a voxel-clip VoxelFrame (SpriteDense::from_voxel_frame); the latter lets an animated clip cache every frame’s grid up front instead of rebuilding per frame.

Both sources store only surface voxels (a from-air ray’s first hit is the visible surface), so the grid is the visible hull.

Implementations

impl SpriteDense

pub fn from_kv6(kv6: &Kv6) -> Self

Decode a Kv6’s surface-voxel run tables into a dense grid.

pub fn from_kv6_with_materials(kv6: &Kv6, material_map: &[(u32, u8)]) -> Self

Like from_kv6 but classifies each voxel into a material id by colour (TV.3 mixed models) via material_map ((rgb, material_id) pairs; see material_for_color). The resulting per-voxel mat array is consulted by the draw_sprite_dense_shaded accumulate path. An empty map yields the same all-opaque (uniform) result as from_kv6.

pub fn from_voxel_frame( frame: &VoxelFrame, dims: [u32; 3], pivot: [f32; 3], ) -> Self

Decode a voxel-clip VoxelFrame (dense-column layout) into the dense grid, given the clip’s dims + pivot. The frame’s columns are col = x + y*dims[0], each a per-column occupancy bitmask with an ascending-z colour run — walked here into the raycaster’s (x·my + y)·mz + z grid.

pub fn from_voxel_frame_with_materials( frame: &VoxelFrame, dims: [u32; 3], pivot: [f32; 3], material_map: &[(u32, u8)], ) -> Self

Like from_voxel_frame but classifies each voxel into a material id by colour (TV.3 mixed models) via material_map — the clip analogue of from_kv6_with_materials. An empty map yields the same all-opaque (uniform) result as from_voxel_frame.