Struct ElevationGrid 

pub struct ElevationGrid {
    pub width: u32,
    pub height: u32,
    pub min_elev: f32,
    pub max_elev: f32,
    pub data: Vec<f32>,
    pub tile: TileId,
}

A regular grid of elevation samples aligned to a slippy-map tile.

Heights are in meters above the WGS-84 ellipsoid. The grid is always rectangular (width * height samples) and aligned to a single TileId.

Construct with flat for an all-zero grid or from_data to supply pre-decoded heights.

Fields

width: u32

Number of samples along the X (east-west) axis.

height: u32

Number of samples along the Y (north-south) axis.

min_elev: f32

Minimum elevation in the grid (meters).

max_elev: f32

Maximum elevation in the grid (meters).

data: Vec<f32>

Row-major elevation data (width * height samples, meters).

Index y * width + x gives the sample at column x, row y, where row 0 is the northern-most row.

tile: TileId

The tile this grid is aligned to.

Implementations

impl ElevationGrid

pub fn flat(tile: TileId, width: u32, height: u32) -> Self

Create a flat (all-zero) elevation grid for a tile.

Useful as a no-op placeholder when terrain is disabled or while a real elevation tile is still loading.

pub fn from_data( tile: TileId, width: u32, height: u32, data: Vec<f32>, ) -> Option<Self>

Create an elevation grid from raw height data, computing min/max automatically.

Returns None if data.len() != width * height (size mismatch).

pub fn elevation_range(&self) -> f32

The elevation range (max - min) in meters.

Returns 0.0 for flat grids. Useful for terrain mesh LOD decisions: tiles with small elevation range can use coarser mesh resolution.

pub fn sample(&self, u: f64, v: f64) -> Option<f32>

Bilinear interpolation at fractional coordinates (u, v) in [0, 1].

• (0, 0) is the north-west corner of the tile.
• (1, 1) is the south-east corner.

Values outside [0, 1] are clamped to the grid boundary.

Returns None if the grid is empty (width == 0 or height == 0).

pub fn sample_geo(&self, coord: &GeoCoord) -> Option<f32>

Sample elevation at a geographic coordinate.

Converts the GeoCoord to tile-relative (u, v) using the tile’s geographic bounds, then delegates to sample.

Returns None if:

• The tile has zero geographic extent (degenerate).
• The grid is empty.

Coordinates outside the tile’s bounds are clamped to the nearest edge (via the [0, 1] clamp in sample).

Trait Implementations

impl Clone for ElevationGrid

fn clone(&self) -> ElevationGrid

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ElevationGrid

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ElevationGrid

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ElevationGrid

fn eq(&self, other: &ElevationGrid) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ElevationGrid

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ElevationGrid