Crate quantized_mesh 

Encoder and decoder for Cesium quantized-mesh-1.0 terrain format.

This crate provides encoding and decoding functionality for the quantized-mesh terrain format used by CesiumJS for efficient 3D terrain streaming.

References

• Format specification: https://github.com/CesiumGS/quantized-mesh

Example

use quantized_mesh::{
    QuantizedMeshEncoder, QuantizedMeshHeader, QuantizedVertices,
    EdgeIndices, TileBounds,
};

// Create header with tile metadata
let header = QuantizedMeshHeader {
    center: [0.0, 0.0, 6378137.0],
    min_height: 0.0,
    max_height: 100.0,
    bounding_sphere_center: [0.0, 0.0, 6378137.0],
    bounding_sphere_radius: 1000.0,
    horizon_occlusion_point: [0.0, 0.0, 1.0],
};

// Create vertices (simple 2-triangle mesh)
let vertices = QuantizedVertices {
    u: vec![0, 32767, 0, 32767],
    v: vec![0, 0, 32767, 32767],
    height: vec![0, 0, 0, 0],
};

// Triangle indices (2 triangles)
let indices = vec![0, 1, 2, 1, 3, 2];

// Edge indices
let edge_indices = EdgeIndices {
    west: vec![0, 2],
    south: vec![0, 1],
    east: vec![1, 3],
    north: vec![2, 3],
};

// Encode to quantized-mesh format
let encoder = QuantizedMeshEncoder::new(header, vertices, indices, edge_indices);
let data = encoder.encode();

Modules

coords

Coordinate transformations and geodetic constants.

Structs

AvailableRange

Tile availability range for metadata extension.

DecodedExtensions

Decoded extensions from quantized-mesh format.

DecodedMesh

Decoded quantized-mesh data.

EdgeIndices

Edge indices for skirt generation.

EncodeOptions

Options for encoding quantized mesh.

QuantizedMeshDecoder

Quantized mesh decoder.

QuantizedMeshEncoder

Quantized mesh encoder.

QuantizedMeshHeader

Quantized mesh header (88 bytes).

QuantizedVertices

Quantized vertex data.

TileBounds

Tile bounds in geographic coordinates (degrees).

TileMetadata

Metadata for quantized-mesh extension.

Enums

DecodeError

Error type for quantized-mesh decoding.

ExtensionId

Extension IDs for quantized-mesh format.

WaterMask

Water mask data.

Constants

QUANTIZED_MAX

Maximum value for quantized coordinates (2^15 - 1).

Functions

decode_high_water_mark

Decode high-water mark encoded indices.

decode_zigzag_delta

Decode zig-zag delta encoded values.

encode_high_water_mark

Encode indices using high-water mark encoding.

encode_zigzag_delta

Encode vertex coordinates using zig-zag delta encoding.

oct_decode_normal

Decode oct-encoded normal to unit vector.

oct_encode_normal

Oct-encode a unit normal vector to 2 bytes.

zigzag_decode

Decode a zig-zag encoded value.

zigzag_encode

Encode a value using zig-zag encoding.

Type Aliases

DecodeResult

Result type for quantized-mesh decoding.