ilattice3: Voxel Structures

DEPRECATION NOTICE: ilattice3 is being superceded by building-blocks

ilattice3 provides many useful types and functions for dealing with voxel data. The core types are Point, Extent, and the various "lattice maps," which allow storing (or generating), data at each point in a 3D integer lattice.

Consider this example which samples a signed distance function at each point and stores it in a compact vector structure.

fn sphere_sdf(p: &Point) -> f32 {
    let d = p.dot(p);

    (d - 10) as f32
}

let sample_extent = Extent::from_center_and_radius([0, 0, 0].into(), 20);
let sampled_sphere =
    VecLatticeMap::copy_from_map(&FnLatticeMap::new(sphere_sdf), sample_extent);

In addition to the FnLatticeMap and VecLatticeMap, there are:

• ChunkedLatticeMap: a sparse lattice map implemented as a "compressible map" of VecLatticeMaps
• PaletteLatticeMap: a ChunkedLatticeMap where data shared between voxels lives in a separate "palette" vector

Other miscellaneous features:

• conversion to/from VOX format
• conversion to/from RgbaImage format

There are also companion modules:

• ilattice3-mesh: various meshing algorithms for voxel data
• ilattice3-wfc: the Wave Function Collapse algorithm for 2D and 3D lattices