Struct VectorPoint 

#[repr(C)]
pub struct VectorPoint<M: Clone = MValue> {
    pub x: f64,
    pub y: f64,
    pub z: Option<f64>,
    pub m: Option<M>,
    pub t: Option<f64>,
}

Vector Points

Description

A Vector Point uses a structure for 2D or 3D points. Useful for geometry that also has m-values

Implements the ops Add, AddAssign, Sub, SubAssign, Mul, MulAssign, Div, DivAssign, Rem, RemAssign, Neg, PartialEq, and Eq.

Also implements local traits GetXY, GetZ, GetM, SetXY, SetZ, SetM, NewXY, NewXYM, NewXYZ, NewXYZM, MValueCompatible, MValue, and Interpolate.

Fields

• x: X coordinate
• y: Y coordinate
• z: Z coordinate or “altitude”. May be None
• m: M-Value
• t: T for tolerance. A tmp value often used for simplification if needed.

Usage

• VectorPoint::new: Creates a new VectorPoint
• VectorPoint::to_m_value: Convert to an MValue VectorPoint using to_m_value
• VectorPoint::project: Project the point into the 0->1 coordinate system
• VectorPoint::unproject: Unproject the point from the 0->1 coordinate system
• VectorPoint::is_empty: Returns true if the point is the zero vector
• VectorPoint::face: Returns the S2 face assocated with this point
• `VectorPoint::modulo: Apply modular arithmetic
• VectorPoint::angle: Returns the angle between “this” and v in radians, in the range [0, pi]. If either vector is zero-length, or nearly zero-length, the result will be zero, regardless of the other value
• VectorPoint::cross: Get the cross product of two Vector Points
• VectorPoint::dot: dot returns the standard dot product of v and ov.
• VectorPoint::abs: Returns the absolute value of the point.
• VectorPoint::invert: Returns the inverse of the point
• VectorPoint::len: Returns the length of the point
• VectorPoint::norm: norm returns the vector’s norm. (sqrt of norm2)
• VectorPoint::norm2: norm2 returns the vector’s squared norm (self.dot(self))
• VectorPoint::normalize: Normalize this point to unit length
• VectorPoint::distance: return the distance from this point to the other point
• VectorPoint::largest_abs_component: Returns the largest absolute component of the point
• VectorPoint::interpolate: Interpolate between two points with a given t value

Fields

x: f64

X coordinate

y: f64

Y coordinate

z: Option<f64>

Z coordinate or “altitude”. May be None

m: Option<M>

M-Value

t: Option<f64>

T for tolerance. A tmp value used for simplification

Implementations

impl VectorPoint<MValue>

pub fn from_xy(x: f64, y: f64) -> Self

Helper function for tests. Create a new point quickly from an xy coordinate

pub fn from_xyz(x: f64, y: f64, z: f64) -> Self

Helper function for tests. Create a new point quickly from an xyz coordinate

impl<M: Clone> VectorPoint<M>

pub fn new(x: f64, y: f64, z: Option<f64>, m: Option<M>) -> Self

Create a new point

pub fn new_xy(x: f64, y: f64, m: Option<M>) -> Self

Create a new point with xy

pub fn new_xyz(x: f64, y: f64, z: f64, m: Option<M>) -> Self

Create a new point with xyz

pub fn to_m_value(&self) -> VectorPoint<MValue>

where M: Into<MValue>,

Convert to an MValue VectorPoint

pub fn project(&mut self, bbox: Option<&mut BBox3D>)

Project the point into the 0->1 coordinate system

pub fn unproject(&mut self)

Unproject the point from the 0->1 coordinate system back to a lon-lat coordinate

pub fn is_empty(&self) -> bool

Returns true if the point is the zero vector.

pub fn face(&self, f: u8) -> f64

Returns the S2 face assocated with this point

pub fn modulo(self, modulus: f64) -> Self

Apply modular arithmetic to x, y, and z using modulus

pub fn angle<M2: Clone>(&self, b: &VectorPoint<M2>) -> f64

Returns the angle between “this” and v in radians, in the range [0, pi]. If either vector is zero-length, or nearly zero-length, the result will be zero, regardless of the other value.

pub fn cross<M2: Clone>(&self, b: &VectorPoint<M2>) -> Self

Get the cross product of two Vector Points

pub fn dot<M2: Clone>(&self, b: &VectorPoint<M2>) -> f64

dot returns the standard dot product of v and ov.

pub fn abs(&self) -> Self

Returns the absolute value of the point.

pub fn invert(&self) -> Self

Returns the inverse of the point

pub fn len(&self) -> f64

Returns the length of the point.

pub fn norm(&self) -> f64

norm returns the vector’s norm.

pub fn norm2(&self) -> f64

norm2 returns the vector’s squared norm.

pub fn normalize(&mut self)

Normalize this point to unit length.

pub fn distance<M2: Clone>(&self, b: &VectorPoint<M2>) -> f64

return the distance from this point to the other point in radians

pub fn largest_abs_component(&self) -> u8

Returns the largest absolute component of the point.

pub fn intermediate<M2: Clone>(&self, b: &VectorPoint<M2>, t: f64) -> Self

Returns the intermediate point between this and the other point.

pub fn perpendicular(&self) -> Self

Returns the perpendicular vector

Trait Implementations

impl<M1: Clone, M2: Clone> Add<&VectorPoint<M2>> for &VectorPoint<M1>

type Output = VectorPoint<M1>

The resulting type after applying the + operator.

fn add(self, other: &VectorPoint<M2>) -> Self::Output

Performs the + operation.

impl<M: Clone> Add<f64> for &VectorPoint<M>

type Output = VectorPoint<M>

The resulting type after applying the + operator.

fn add(self, other: f64) -> Self::Output

Performs the + operation.

impl<M1: Clone, M2: Clone> AddAssign<&VectorPoint<M2>> for VectorPoint<M1>

fn add_assign(&mut self, other: &VectorPoint<M2>)

Performs the += operation.

impl<M: Clone> AddAssign<f64> for VectorPoint<M>

fn add_assign(&mut self, other: f64)

Performs the += operation.

impl<M: Clone + Clone> Clone for VectorPoint<M>

fn clone(&self) -> VectorPoint<M>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<M: Debug + Clone> Debug for VectorPoint<M>

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

Formats the value using the given formatter.

impl<M: Default + Clone> Default for VectorPoint<M>

fn default() -> VectorPoint<M>

Returns the “default value” for a type.

impl<'de, M> Deserialize<'de> for VectorPoint<M>

where M: Deserialize<'de> + Clone,

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<M1: Clone, M2: Clone> Div<&VectorPoint<M2>> for &VectorPoint<M1>

type Output = VectorPoint<M1>

The resulting type after applying the / operator.

fn div(self, other: &VectorPoint<M2>) -> Self::Output

Performs the / operation.

impl<M: Clone> Div<f64> for &VectorPoint<M>

type Output = VectorPoint<M>

The resulting type after applying the / operator.

fn div(self, other: f64) -> Self::Output

Performs the / operation.

impl<M1: Clone, M2: Clone> DivAssign<&VectorPoint<M2>> for VectorPoint<M1>

fn div_assign(&mut self, other: &VectorPoint<M2>)

Performs the /= operation.

impl<M: Clone> DivAssign<f64> for VectorPoint<M>

fn div_assign(&mut self, other: f64)

Performs the /= operation.

impl<M: Clone, P: GetXYZ> From<&P> for VectorPoint<M>

fn from(p: &P) -> Self

Converts to this type from the input type.

impl<M: Clone> From<Point> for VectorPoint<M>

fn from(p: Point) -> Self

Converts to this type from the input type.

impl<M: Clone> From<Point3D> for VectorPoint<M>

fn from(p: Point3D) -> Self

Converts to this type from the input type.

impl<M: Clone> GetM<M> for VectorPoint<M>

fn m(&self) -> Option<&M>

Returns the m value

impl<M: Clone> GetXY for VectorPoint<M>

fn x(&self) -> f64

Returns the x value

fn y(&self) -> f64

Returns the y value

fn xy(&self) -> (f64, f64)

Returns the x and y values

impl<M: Clone> GetZ for VectorPoint<M>

fn z(&self) -> Option<f64>

Returns the z value

impl<M: Interpolate + Clone> Interpolate for VectorPoint<M>

fn interpolate(&self, other: &Self, t: f64) -> Self

Interpolate between two of the same type

impl<M1: Clone, M2: Clone> Mul<&VectorPoint<M2>> for &VectorPoint<M1>

type Output = VectorPoint<M1>

The resulting type after applying the * operator.

fn mul(self, other: &VectorPoint<M2>) -> Self::Output

Performs the * operation.

impl<M: Clone> Mul<f64> for &VectorPoint<M>

type Output = VectorPoint<M>

The resulting type after applying the * operator.

fn mul(self, other: f64) -> Self::Output

Performs the * operation.

impl<M1: Clone, M2: Clone> MulAssign<&VectorPoint<M2>> for VectorPoint<M1>

fn mul_assign(&mut self, other: &VectorPoint<M2>)

Performs the *= operation.

impl<M: Clone> MulAssign<f64> for VectorPoint<M>

fn mul_assign(&mut self, other: f64)

Performs the *= operation.

impl<M: Clone> Neg for &VectorPoint<M>

type Output = VectorPoint<M>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl<M: Clone> NewXY for VectorPoint<M>

fn new_xy(x: f64, y: f64) -> Self

Create a new point with xy

impl<M: Clone> NewXYM<M> for VectorPoint<M>

fn new_xym(x: f64, y: f64, m: M) -> Self

Create a new point with xy

impl<M: Clone> NewXYZ for VectorPoint<M>

fn new_xyz(x: f64, y: f64, z: f64) -> Self

Create a new point with xyz

impl<M: Clone> NewXYZM<M> for VectorPoint<M>

fn new_xyzm(x: f64, y: f64, z: f64, m: M) -> Self

Create a new point with xyzm

impl<M: Clone> Ord for VectorPoint<M>

fn cmp(&self, other: &VectorPoint<M>) -> 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,

Restrict a value to a certain interval.

impl<M: Clone> PartialEq for VectorPoint<M>

fn eq(&self, other: &VectorPoint<M>) -> 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<M: Clone> PartialOrd for VectorPoint<M>

fn partial_cmp(&self, other: &VectorPoint<M>) -> Option<Ordering>

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

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

Tests less than (for self and other) and is used by the < operator.

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

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

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

Tests greater than (for self and other) and is used by the > operator.

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

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

impl<M: Clone> Rem<f64> for VectorPoint<M>

type Output = VectorPoint<M>

The resulting type after applying the % operator.

fn rem(self, modulus: f64) -> Self::Output

Performs the % operation.

impl<M: Clone> RemAssign<f64> for VectorPoint<M>

fn rem_assign(&mut self, modulus: f64)

Performs the %= operation.

impl<M> Serialize for VectorPoint<M>

where M: Serialize + Clone,

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl<M: Clone> SetM<M> for VectorPoint<M>

fn set_m(&mut self, m: M)

Set the m value

impl<M: Clone> SetXY for VectorPoint<M>

fn set_xy(&mut self, x: f64, y: f64)

Set both x and y

fn set_x(&mut self, x: f64)

Set the x value

fn set_y(&mut self, y: f64)

Set the y value

impl<M: Clone> SetZ for VectorPoint<M>

fn set_z(&mut self, z: f64)

Set the z value

impl<M1: Clone, M2: Clone> Sub<&VectorPoint<M2>> for &VectorPoint<M1>

type Output = VectorPoint<M1>

The resulting type after applying the - operator.

fn sub(self, other: &VectorPoint<M2>) -> Self::Output

Performs the - operation.

impl<M: Clone> Sub<f64> for &VectorPoint<M>

type Output = VectorPoint<M>

The resulting type after applying the - operator.

fn sub(self, other: f64) -> Self::Output

Performs the - operation.

impl<M1: Clone, M2: Clone> SubAssign<&VectorPoint<M2>> for VectorPoint<M1>

fn sub_assign(&mut self, other: &VectorPoint<M2>)

Performs the -= operation.

impl<M: Clone> SubAssign<f64> for VectorPoint<M>

fn sub_assign(&mut self, other: f64)

Performs the -= operation.

impl<M: Clone> Eq for VectorPoint<M>