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 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 new_unchecked(x: f64, y: f64, z: f64) -> Self

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.

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 apply_transform(&mut self, transform: Transform3<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.

pub fn apply_isometry(&mut self, isometry: Isometry3<f64>)

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

Fast path: rotates and translates directly via nalgebra::Isometry3 instead of going through a full homogeneous Transform3 multiply.

pub fn apply_translation(&mut self, vector: Vector3<f64>)

Applies a pure translation to this position in place.

Fast path: a plain component-wise add, with no rotation or matrix math at all.

pub fn apply_rotation(&mut self, rotation: Rotation3<f64>)

Applies a pure rotation (about the origin) to this position in place.

Fast path: rotates directly via nalgebra::Rotation3 instead of going through a full homogeneous Transform3 multiply.

pub fn apply_scale(&mut self, scale: Scale3<f64>)

Applies a per-axis scale to this position in place.

Fast path: a plain component-wise multiply. Uniform scale is just Scale3::new(s, s, s) at the call site.

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 Copy for DirectPosition

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<DVec3> for DirectPosition

fn from(item: Vector) -> 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<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 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 PartialEq for DirectPosition

fn eq(&self, other: &DirectPosition) -> bool

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for DirectPosition

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

type Error = Error

The type returned in the event of a conversion error.

fn try_from(item: Point3<f64>) -> Result<Self, Self::Error>

Performs the conversion.