Struct galileo::MapView

pub struct MapView { /* private fields */ }

Map view specifies the area of the map that should be drawn. In other words, it sets the position of “camera” that looks at the map.

The main view parameters are:

• position - coordinates of the point in the center of the map
• resolution - number of map units in a single pixel at the center of the map
• size - size of the rendering area in pixels
• crs - coordinate system that the map will be rendered to. This specifies the geographic projection that the map is displayed in. Note, that currently geographic CRSs are not supported, and a map with such a view will not be drawn.

The view can also specify rotation along x (tilt) and z (rotation) axis.

Implementations

impl MapView

pub fn new(position: &impl GeoPoint<Num = f64>, resolution: f64) -> Self

Creates a new view with the given position and resolution with default CRS (web-mercator EPSG:3857).

pub fn new_with_crs( position: &impl GeoPoint<Num = f64>, resolution: f64, crs: Crs ) -> Self

Creates a new view with the given CRS.

pub fn new_projected( position: &impl CartesianPoint2d<Num = f64>, resolution: f64 ) -> Self

Creates a new view, taking position value as projected coordinates. Default CRS is used (EPSG:3857).

pub fn new_projected_with_crs( position: &impl CartesianPoint2d<Num = f64>, resolution: f64, crs: Crs ) -> Self

Creates a new view, taking position value as projected coordinates.

pub fn crs(&self) -> &Crs

CRS of the view.

pub fn position(&self) -> Option<GeoPoint2d>

Position of the center point of the map (screen).

If the projected position cannot be projected into geographic coordinates, None is returned.

pub fn resolution(&self) -> f64

Resolution at the center of the map.

pub fn with_resolution(&self, resolution: f64) -> Self

Creates a new view, same as the current one, but with the given resolution.

pub fn size(&self) -> Size

Size of the view in pixels.

pub fn with_size(&self, new_size: Size) -> Self

Creates a new view, same as the current one, but with the given size.

pub fn get_bbox(&self) -> Option<Rect>

Returns bounding rectangle of the view (in projected coordinates).

pub fn map_to_scene_transform(&self) -> Option<OMatrix<f64, U4, U4>>

Returns transformation matrix that transforms map coordinates to scene coordinates.

Scene coordinates are [-1.0, 1.0] coordinates of the render area with Y going from bottom to top.

pub fn map_to_scene_mtx(&self) -> Option<[[f32; 4]; 4]>

Returns transformation matrix that transforms map coordinates to scene coordinates.

Scene coordinates are [-1.0, 1.0] coordinates of the render area with Y going from bottom to top.

pub fn rotation_x(&self) -> f64

Rotation angle around X axis in radians (tilt).

pub fn rotation_z(&self) -> f64

Rotation angle around Z axis in radians.

pub fn with_rotation_x(&self, rotation_x: f64) -> Self

Creates a new view, same as the current one, but with the given rotation x.

pub fn with_rotation_z(&self, rotation_z: f64) -> Self

Creates a new view, same as the current one, but with the given rotation z.

pub fn with_rotation(&self, rotation_x: f64, rotation_z: f64) -> Self

Creates a new view, same as the current one, but with the given rotation values.

pub fn screen_to_map(&self, px_position: Point2d) -> Option<Point2d>

Projects the given screen point into map coordinates at the 0 elevation.

Returns None if the point is outside of map (this can be possible, if the map is tilted and the point is above the horizon, or if the point is outside the projection bounds).

pub fn screen_to_map_geo(&self, px_position: Point2d) -> Option<GeoPoint2d>

Projects the given screen point into map coordinates at the 0 elevation, and then projects them into geographic coordinates.

Returns None if the point is outside of map (this can be possible, if the map is tilted and the point is above the horizon, or if the point is outside the projection bounds).

pub fn translate_by_pixels(&self, from: Point2d, to: Point2d) -> Self

Creates a new view, same as the current one, but translated so that point from on the current view becomes the point to in the new view.

pub fn translate(&self, delta: Vector2<f64>) -> Self

Move the vew by the given projected coorinates delta.

Trait Implementations

impl Clone for MapView

fn clone(&self) -> MapView

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for MapView

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

Formats the value using the given formatter.