Struct DirectPosition 

pub struct DirectPosition { /* private fields */ }

A 3-D coordinate triple in a coordinate reference system (CRS).

Corresponds to gml:DirectPositionType in ISO 19136. All three components must be finite; NaN and ±infinity are rejected at construction time.

Invariant

x, y, and z are always finite f64 values.

Implementations

impl DirectPosition

pub const MIN: DirectPosition

The position with the smallest representable coordinates (f64::MIN, f64::MIN, f64::MIN).

pub const MAX: DirectPosition

The position with the largest representable coordinates (f64::MAX, f64::MAX, f64::MAX).

pub const ORIGIN: DirectPosition

The origin (0.0, 0.0, 0.0).

pub fn new(x: f64, y: f64, z: f64) -> Result<Self, Error>

Creates a new position from Cartesian coordinates.

Errors

Returns Error::NonFiniteCoordinate if any coordinate is NaN or infinite.

Examples

use egml_core::model::geometry::DirectPosition;

let pos = DirectPosition::new(1.0, 2.0, 3.0).unwrap();
assert_eq!(pos.x(), 1.0);
assert!(DirectPosition::new(f64::NAN, 0.0, 0.0).is_err());

pub fn x(&self) -> f64

Returns the X coordinate.

pub fn y(&self) -> f64

Returns the Y coordinate.

pub fn z(&self) -> f64

Returns the Z coordinate.

pub fn coords(&self) -> [f64; 3]

Returns the coordinates as a [x, y, z] array.

pub fn set_x(&mut self, val: f64) -> Result<(), Error>

Sets the X coordinate.

Errors

Returns Error::NonFiniteCoordinate with the name "x" if val is NaN or infinite.

pub fn set_y(&mut self, val: f64) -> Result<(), Error>

Sets the Y coordinate.

Errors

Returns Error::NonFiniteCoordinate with the name "y" if val is NaN or infinite.

pub fn set_z(&mut self, val: f64) -> Result<(), Error>

Sets the Z coordinate.

Errors

Returns Error::NonFiniteCoordinate with the name "z" if val is NaN or infinite.

pub fn points(&self) -> Vec<&DirectPosition>

Returns a single-element list containing a reference to self.

This method exists so that DirectPosition satisfies the same point-iteration pattern used by multi-point geometry types.

pub fn apply_transform(&mut self, m: &Isometry3<f64>)

Applies a rigid-body transform (rotation + translation) to this position in place.

m is a nalgebra::Isometry3 — a combination of a rotation and a translation that preserves distances and angles.

Trait Implementations

impl Clone for DirectPosition

fn clone(&self) -> DirectPosition

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DirectPosition

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

Formats the value using the given formatter.

impl Default for DirectPosition

fn default() -> DirectPosition

Returns the “default value” for a type.

impl Display for DirectPosition

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

Formats the value using the given formatter.

impl From<&DirectPosition> for Vector3<f64>

fn from(item: &DirectPosition) -> Self

Converts to this type from the input type.

impl From<&Matrix<f64, Const<3>, Const<1>, ArrayStorage<f64, 3, 1>>> for DirectPosition

fn from(item: &Vector3<f64>) -> Self

Converts to this type from the input type.

impl From<DirectPosition> for Vector3<f64>

fn from(item: DirectPosition) -> Self

Converts to this type from the input type.

impl From<DirectPosition> for Point3<f32>

fn from(item: DirectPosition) -> Self

Converts to this type from the input type.

impl From<DirectPosition> for Point3<f64>

fn from(item: DirectPosition) -> Self

Converts to this type from the input type.

impl From<DirectPosition> for Vector

fn from(item: DirectPosition) -> Self

Converts to this type from the input type.

impl From<Matrix<f64, Const<3>, Const<1>, ArrayStorage<f64, 3, 1>>> for DirectPosition

fn from(item: Vector3<f64>) -> Self

Converts to this type from the input type.

impl From<OPoint<f64, Const<3>>> for DirectPosition

fn from(item: Point3<f64>) -> Self

Converts to this type from the input type.

impl From<DVec3> for DirectPosition

fn from(item: Vector) -> Self

Converts to this type from the input type.

impl PartialEq for DirectPosition

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

impl StructuralPartialEq for DirectPosition