Struct MapProjectionHandle 

pub struct MapProjectionHandle { /* private fields */ }

Owns one native handle.

A camera view for converting between screen points and coordinates.

See mln_map_projection in the C API reference.

Implementations

impl MapProjectionHandle

pub fn id(&self) -> u64

Returns the native handle value.

impl MapProjectionHandle

pub fn create(view: &MapView) -> Result<MapProjectionHandle>

Creates a projection that converts coordinates for one view of a map.

Create it from the view of an MapSnapshot or an RenderFrameResult. The projection doesn’t follow the map, so create a new one after the map’s camera or size changes.

See mln_map_projection_create in the C API reference.

pub fn get_camera(&self) -> Result<MapProjectionCameraResult>

Reads the projection’s camera.

See mln_map_projection_get_camera in the C API reference.

pub fn lat_lng_for_pixel(&self, point: ScreenPoint) -> Result<LatLng>

Finds the coordinate at a screen point.

The longitude stays between -180 and 180.

See mln_map_projection_lat_lng_for_pixel in the C API reference.

pub fn lat_lng_for_pixel_unwrapped(&self, point: ScreenPoint) -> Result<LatLng>

Finds the coordinate at a screen point, without wrapping its longitude.

The longitude can fall outside -180 to 180, to show which copy of the world the point is in.

See mln_map_projection_lat_lng_for_pixel_unwrapped in the C API reference.

pub fn lat_lngs_for_pixels(&self, points: &[ScreenPoint]) -> Result<Vec<LatLng>>

Finds the coordinates at several screen points, as MapProjectionHandle::lat_lng_for_pixel() does.

See mln_map_projection_lat_lngs_for_pixels in the C API reference.

pub fn lat_lngs_for_pixels_unwrapped( &self, points: &[ScreenPoint], ) -> Result<Vec<LatLng>>

Finds the coordinates at several screen points, as MapProjectionHandle::lat_lng_for_pixel_unwrapped() does.

See mln_map_projection_lat_lngs_for_pixels_unwrapped in the C API reference.

pub fn meters_per_pixel_at_latitude(&self, latitude: f64) -> Result<f64>

Computes how many meters one screen pixel covers at latitude, at the projection’s zoom.

The result ignores the camera’s pitch.

See mln_map_projection_meters_per_pixel_at_latitude in the C API reference.

pub fn pixel_for_lat_lng(&self, coordinate: LatLng) -> Result<ScreenPoint>

Finds the screen point of a coordinate.

The point is in the copy of the world nearest the camera’s center.

See mln_map_projection_pixel_for_lat_lng in the C API reference.

pub fn pixels_for_lat_lngs( &self, coordinates: &[LatLng], ) -> Result<Vec<ScreenPoint>>

Finds the screen points of several coordinates, as MapProjectionHandle::pixel_for_lat_lng() does.

See mln_map_projection_pixels_for_lat_lngs in the C API reference.

pub fn release(self) -> Result<(), ReleaseError<Self>>

Releases a projection.

See mln_map_projection_release in the C API reference.

pub fn set_camera(&self, camera: &CameraOptions) -> Result<()>

Moves the projection’s camera, without changing the map.

Camera fields that camera doesn’t set keep their values.

See mln_map_projection_set_camera in the C API reference.

Trait Implementations

impl Debug for MapProjectionHandle

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

Formats the value using the given formatter.