Struct Transformer 

pub struct Transformer { /* private fields */ }

PROJ Transformer

Description

A Transformer class contains all projections necessary for converting coordinates from one projection to another. This is a modular class that can be extended to add new projections as needed to reduce code size and improve performance. Both forward and inverse projections are default set to wgs84.

See the NadGridStore

Usage

Utilizes the TransformCoordinates trait

Useful methods

• Transformer::forward: Given a point in the source projection, return the point in the destination projection
• Transformer::forward_mut: Given a point in the source projection, return the point in the destination projection
• Transformer::inverse: Given a point in the destination projection, return the point in the source projection
• Transformer::inverse_mut: Given a mutable point in the destination projection, return the point in the source projection
• Transformer::set_source: Set the source projection
• Transformer::set_destination: Set the destination projection
• Transformer::insert_epsg_code: Insert an EPSG code definition

Example

use gistools::proj::{Coords, Transformer};

let mut transformer = Transformer::new();
// Insert a source or destination as needed
// transformer.set_source("WKT_STRING...".into());

let mut point = Coords::new_xy(0., 0.);
transformer.forward_mut(&mut point);
assert_eq!(point, Coords::new_xy(0., 0.));

Implementations

impl Transformer

pub fn new() -> Self

Create a new Transformer

pub fn forward<P: TransformCoordinates + Debug>(&self, p: &P) -> P

Move forward from source projection to destination projection

pub fn forward_mut<P: TransformCoordinates + Debug>(&self, p: &mut P)

Move forward from source projection to destination projection in place

pub fn inverse<P: TransformCoordinates + Debug>(&self, p: &P) -> P

Move backward from destination projection to source projection

pub fn inverse_mut<P: TransformCoordinates + Debug>(&self, p: &mut P)

Move backward from destination projection to source projection in place

pub fn insert_epsg_code(&mut self, code: String, value: String)

Insert an EPSG code definition

use gistools::proj::Transformer;

let mut transformer = Transformer::new();
transformer.insert_epsg_code("4326".to_string(), "WKT_STRING".to_string());

Parameters

• code: EPSG code to insert e.g. “4326”: “WKT_STRING”
• value: the EPSG definition which is either a WKT string object or proj4 encoded string

pub fn set_source(&mut self, code: String)

Set the source projection

Parameters

• code: can be a name or a json/wkt coded definition

pub fn set_source_def(&mut self, def: ProjectionTransform)

Set the source projection

Parameters

• def: transform definition

pub fn set_destination(&mut self, code: String)

Set the destination projection

Parameters

• code: can be a name or a coded definition

pub fn set_destination_def(&mut self, def: ProjectionTransform)

Set the source projection

Parameters

• def: transform definition

pub fn get_epsg_code(&self, code: String) -> Option<String>

Get access to an epsg code

Trait Implementations

impl Clone for Transformer

fn clone(&self) -> Transformer

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Transformer

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

Formats the value using the given formatter.

impl Default for Transformer

fn default() -> Transformer

Returns the “default value” for a type.

impl PartialEq for Transformer

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