Struct GridSnapshot 

pub struct GridSnapshot {
    pub transform: GridTransform,
    pub chunks: Vec<(IVec3, Vec<u8>)>,
    pub chunk_versions: Vec<(IVec3, u64)>,
    pub name: Option<String>,
    pub render_sky: bool,
    pub mip_levels_override: Option<u32>,
    pub lod_thresholds: LodThresholds,
    pub stream_radius: StreamRadius,
    pub voxel_world_size: f64,
}

One grid’s snapshot: transform + flattened chunks + the grid’s runtime configuration (QE.5b — pre-QE.5 snapshots restored every config field to its default, so a loaded save silently lost render_sky / LOD / streaming settings).

The generator and store hooks are host code and cannot be serialised — rebind them after Scene::load_snapshot, keyed on name.

Fields

transform: GridTransform

The grid’s world placement (position + rotation).

chunks: Vec<(IVec3, Vec<u8>)>

Chunks as (chunk_idx, vxl_bytes). vxl_bytes is roxlap_formats::vxl::serialize output — re-parseable via roxlap_formats::vxl::parse.

chunk_versions: Vec<(IVec3, u64)>

S7.2: per-chunk edit version counters, sorted by chunk index. Chunks absent from this list restore as version 0 — the same as a freshly generated or pre-S7.2 snapshot. (#[serde(default)] covers self-describing formats; the wire-format compatibility story is the QE.5b envelope version in Scene::save_snapshot.)

name: Option<String>

QE.5b — the grid’s host-assigned rebind tag (crate::Grid::name).

render_sky: bool

QE.5b — crate::Grid::render_sky.

mip_levels_override: Option<u32>

QE.5b — crate::Grid::mip_levels_override.

lod_thresholds: LodThresholds

QE.5b — crate::Grid::lod_thresholds.

stream_radius: StreamRadius

QE.5b — crate::Grid::stream_radius.

voxel_world_size: f64

SC.snap (v2) — the grid’s GridTransform::voxel_world_size. Stored as a sibling field (not inside the transform, whose wire form stays frozen with #[serde(skip)]). The #[serde(default)] covers self-describing formats; the bincode positional gap between v1 and v2 is handled by the private GridSnapshotV1 shadow shape + the version dispatch in Scene::load_snapshot. v1 blobs restore this at 1.0.

Trait Implementations

impl Clone for GridSnapshot

fn clone(&self) -> GridSnapshot

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for GridSnapshot

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for GridSnapshot

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for GridSnapshot

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.