Struct Serializer3DF32 

pub struct Serializer3DF32<'a> { /* private fields */ }

Available on crate feature f32-storage only.

Serialization builder for Index3DF32, created by Index3DF32::serialize. Writes f32 box records plus an optional per-item payload and descriptive metadata; the f32-box counterpart of Serializer3D.

Implementations

impl<'a> Serializer3DF32<'a>

pub fn payloads<P: AsRef<[u8]>>(self, payloads: &'a [P]) -> Self

Attach one opaque payload blob per item, in item order.

pub fn interleaved(self) -> Self

Available on crate feature stream only.

Use the streaming-tuned interleaved node layout (box and index adjacent per node), so StreamIndex3DF32 fetches each level in one coalesced read instead of two. Same file size.

pub fn records(self, stride: usize, flat: &'a [u8]) -> Self

Attach a fixed-width payload: flat is num_items * stride bytes (one stride-byte record per item). See Serializer3D::records.

pub fn triangles<T: Triangle3>(self, triangles: &'a [T]) -> Self

Attach a fixed-width triangle payload, one per item. A compact mesh BVH that streams through StreamIndex3DF32.

pub fn crs(self, crs: &'a str) -> Self

Set the coordinate reference system identifier (opaque, e.g. "EPSG:4979").

pub fn content_type(self, content_type: &'a str) -> Self

Set the payload content type / media type.

pub fn attribution(self, attribution: &'a str) -> Self

Set an attribution / license string.

pub fn to_bytes(self) -> Result<Vec<u8>, PayloadError>

Serialize into a new buffer.

pub fn payload_prefix_len(self, len: u32) -> Self

Also write a payload-prefix section: a contiguous, leaf-rank-indexed copy of the first len bytes of every payload blob.

Queries that need only a fixed-size head of each payload — an id, a key, a record header — otherwise read those bytes where they lie, strided through variable-length bodies, which cannot coalesce and costs one range read per match. A dense copy collapses that to a handful of runs, for len extra bytes per item on disk. Worth it when bodies are much larger than len and the reader is remote; pointless otherwise.

Requires payloads; ignored for a fixed-width payload whose whole record is already the prefix.

pub fn to_bytes_into(self, out: &mut Vec<u8>) -> Result<(), PayloadError>

Serialize into a reused buffer (cleared first).