Struct mappers::ConversionPipe

pub struct ConversionPipe<S: Projection, T: Projection> { /* private fields */ }

A struct that allows for easy conversion between two projections.

It can be constructed directly with the constructor or from Projection with pipe_to method.

The implementation is very naive as it converts coordinates to longitude and latitude then projects them to the target projection. Therefore projection and numerical errors are accumulated with every step and long conversion chains are discouraged.

Main purpose of this struct is to allow creating generic conversion patterns independent of projections.

For usage see examples in the main module.

Implementations

impl<S: Projection, T: Projection> ConversionPipe<S, T>

pub fn new(source: &S, target: &T) -> Self

Creates a new conversion pipe from source to target projection.

pub fn invert(&self) -> ConversionPipe<T, S>

Reverse the direction of conversion.

pub fn convert(&self, x: f64, y: f64) -> Result<(f64, f64), ProjectionError>

Converts the coordinates from source to target projection.

Errors

This function uses checked projection methods and returns ProjectionError if any step emits non-finite values.

pub fn convert_unchecked(&self, x: f64, y: f64) -> (f64, f64)

Converts the coordinates from source to target projection without checking the result.

Trait Implementations

impl<S: Clone + Projection, T: Clone + Projection> Clone for ConversionPipe<S, T>

fn clone(&self) -> ConversionPipe<S, T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S: Debug + Projection, T: Debug + Projection> Debug for ConversionPipe<S, T>

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

Formats the value using the given formatter.

impl<S: Default + Projection, T: Default + Projection> Default for ConversionPipe<S, T>

fn default() -> ConversionPipe<S, T>

Returns the “default value” for a type.

impl<S: Hash + Projection, T: Hash + Projection> Hash for ConversionPipe<S, T>

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<S: Ord + Projection, T: Ord + Projection> Ord for ConversionPipe<S, T>

fn cmp(&self, other: &ConversionPipe<S, T>) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized + PartialOrd,

Restrict a value to a certain interval.

impl<S: PartialEq + Projection, T: PartialEq + Projection> PartialEq for ConversionPipe<S, T>

fn eq(&self, other: &ConversionPipe<S, T>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<S: PartialOrd + Projection, T: PartialOrd + Projection> PartialOrd for ConversionPipe<S, T>

fn partial_cmp(&self, other: &ConversionPipe<S, T>) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

This method tests less than (for self and other) and is used by the < operator.

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

This method tests less than or equal to (for self and other) and is used by the <= operator.

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

This method tests greater than (for self and other) and is used by the > operator.

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

This method tests greater than or equal to (for self and other) and is used by the >= operator.

impl<S: Copy + Projection, T: Copy + Projection> Copy for ConversionPipe<S, T>

impl<S: Eq + Projection, T: Eq + Projection> Eq for ConversionPipe<S, T>

impl<S: Projection, T: Projection> StructuralPartialEq for ConversionPipe<S, T>