Enum CameraProjection 

pub enum CameraProjection {
    WebMercator,
    Equirectangular,
    Globe,
    VerticalPerspective {
        center: GeoCoord,
        camera_height: f64,
    },
}

Camera-facing map projection selection.

Variants

WebMercator

Web Mercator (EPSG:3857).

Equirectangular

Equirectangular / Plate Carree.

Globe

Globe / geocentric Earth-centered projection.

VerticalPerspective

Near-sided vertical perspective projection onto a tangent plane.

Fields

center: GeoCoord

Tangency center of the projection.

camera_height: f64

Viewer height above the ellipsoid surface in meters.

Implementations

impl CameraProjection

pub fn support_level(&self) -> ProjectionSupport

Release-support classification for this projection.

pub fn is_stable_for_v1(&self) -> bool

Whether this projection is part of the intended stable v1.0 surface.

pub fn is_experimental_for_v1(&self) -> bool

Whether this projection should be treated as experimental in v1.0.

pub fn vertical_perspective(center: GeoCoord, camera_height: f64) -> Self

Construct a vertical-perspective projection from a center point and viewer height.

pub fn center(&self) -> Option<GeoCoord>

Return the configured center for center-aware projections.

pub fn camera_height(&self) -> Option<f64>

Return the configured viewer height for vertical perspective.

pub fn is_tile_compatible(&self) -> bool

Whether this projection is fully compatible with the current slippy-map tile and terrain update path.

pub fn project(&self, geo: &GeoCoord) -> WorldCoord

Project a geographic coordinate into engine world space.

pub fn unproject(&self, world: &WorldCoord) -> GeoCoord

Inverse-project engine world space back into geographic coordinates.

pub fn scale_factor(&self, geo: &GeoCoord) -> f64

Projection-local scale factor at the given geographic coordinate.

pub fn max_extent(&self) -> f64

Maximum useful half-extent for camera clamping and wrapping.

pub fn world_size(&self) -> f64

Full projected world width in meters.

pub fn project_position(&self, geo: &GeoCoord) -> [f64; 3]

Project a geographic coordinate into the active planar world space as raw XYZ meters.

pub fn tile_geo_bounds(&self, tile: &TileId) -> GeoBounds

Geographic bounds for a slippy-map tile, expressed as south-west and north-east corners.

pub fn project_tile_corner(&self, tile: &TileId, u: f64, v: f64) -> [f64; 3]

Project a tile corner into the active planar world space.

pub fn project_tile_center(&self, tile: &TileId) -> [f64; 3]

Project the geographic centre of a tile into planar world space.

This is equivalent to averaging the four projected corners but requires only a single projection call, making it ~4× cheaper for the per-frame tile reposition path.

Trait Implementations

impl Clone for CameraProjection

fn clone(&self) -> CameraProjection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CameraProjection

impl Debug for CameraProjection

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

Formats the value using the given formatter.

impl Default for CameraProjection

fn default() -> CameraProjection

Returns the “default value” for a type.

impl Eq for CameraProjection

impl Hash for CameraProjection

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CameraProjection

fn eq(&self, other: &CameraProjection) -> 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 StructuralPartialEq for CameraProjection