Struct rust_3d::Point3D

pub struct Point3D {
    pub x: f64,
    pub y: f64,
    pub z: f64,
}

Point3D, a point / position within 3D space

Fields

x: f64

y: f64

z: f64

Implementations

impl Point3D

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

Trait Implementations

impl<P, '_, '_> Add<&'_ P> for &'_ Point3D where
    P: Is3D, 

type Output = Point3D

The resulting type after applying the + operator.

fn add(self, other: &P) -> Point3D

Performs the + operation.

impl<P> Add<P> for Point3D where
    P: Is3D, 

type Output = Point3D

The resulting type after applying the + operator.

fn add(self, other: P) -> Point3D

Performs the + operation.

impl<'_> Add<Point3D> for &'_ Point3D

type Output = Point3D

The resulting type after applying the + operator.

fn add(self, other: Point3D) -> Point3D

Performs the + operation.

impl Clone for Point3D

fn clone(&self) -> Point3D

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Point3D

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

Formats the value using the given formatter.

impl Default for Point3D

fn default() -> Point3D

Returns the "default value" for a type.

impl Display for Point3D

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

Formats the value using the given formatter.

impl Div<f64> for Point3D

type Output = Point3D

The resulting type after applying the / operator.

fn div(self, other: f64) -> Point3D

Performs the / operation.

impl<'_> Div<f64> for &'_ Point3D

type Output = Point3D

The resulting type after applying the / operator.

fn div(self, other: f64) -> Point3D

Performs the / operation.

impl Eq for Point3D

impl Hash for Point3D

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, 

Feeds a slice of this type into the given [Hasher].

impl Is3D for Point3D

fn x(&self) -> f64

Should return the x-coordinate

fn y(&self) -> f64

Should return the y-coordinate

fn z(&self) -> f64

Should return the z-coordinate

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

Returns the position as x,y,z array

fn xy(&self) -> [f64; 2]

Returns the components of the position as array

fn xz(&self) -> [f64; 2]

Returns the components of the position as array

fn yz(&self) -> [f64; 2]

Returns the components of the position as array

fn dot(&self, other: &dyn Is3D) -> f64

Calculates the dot product with another Is3D

fn abs(&self) -> NonNegative

The absolute / length of this position

fn rad_to(&self, other: &dyn Is3D) -> Result<Rad>

Calculates the angle to the other Is3D in radians

fn to_str(&self) -> String

Transforms the position in a "x y z" string. E.g. "3.72 5.99 1.01"

impl IsBuildable3D for Point3D

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

Should build an object from x, y and z coordinates

fn from<P>(&mut self, other: &P) where
    P: Is3D, 

Should use the coordinates of another as its own

fn new_from<P>(other: &P) -> Self where
    P: Is3D, 

Uses the coordinates of other to create a new

fn multiply_m(&self, m: &Matrix4) -> Self

Applies a matrix to this

fn normalized(&self) -> Result<Self>

Returns this with normalized values

fn zero() -> Self

Returns a new object with 0/0/0 as coordinates

fn parse(text: &str) -> Result<Self>

Creates this from a "x y z" string. E.g. "32.2 14.7 1.90"

fn center<P>(&self, other: &P) -> Self where
    P: Is3D, 

Returns the center between this and other

impl IsBuildableND for Point3D

fn new_nd(coords: &[f64]) -> Result<Self>

Should build an object from the correct number of coordinates

fn from_nd<P>(&mut self, other: P) -> Result<()> where
    P: IsBuildableND, 

Should use the coordinates of another as its own

fn zero_nd() -> Result<Self>

Returns a new object with 0 for all coordinates

fn center_nd<P>(&self, other: &P, buffer: &mut Vec<f64>) -> Result<Self> where
    P: IsND, 

Returns the center between this and other

impl IsEditable3D for Point3D

fn set_x(&mut self, val: f64)

Should set the position in x

fn set_y(&mut self, val: f64)

Should set the position in y

fn set_z(&mut self, val: f64)

Should set the position in z

fn set_xyz(&mut self, x: f64, y: f64, z: f64)

Sets the position from x, y and z values

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

Updates the position with x and y values

fn set_xz(&mut self, x: f64, z: f64)

Updates the position with x and z values

fn set_yz(&mut self, y: f64, z: f64)

Updates the position with y and z values

fn increase_distance_to_by<P>(&mut self, other: &P, factor: Positive) where
    P: Is3D, 

Increases distance towards other by factor

fn add<P>(&mut self, other: &P) where
    P: Is3D, 

Adds the coordinates of other onto this. x = x + other.x ...

fn subtract<P>(&mut self, other: &P) where
    P: Is3D, 

Subtracts the coordinates of other from this. x = x - other.x ...

fn scale_pos(&mut self, val: f64)

Scales the coordinates by applying a factor to all of them

impl IsEditableND for Point3D

fn set_position(&mut self, dimension: usize, val: f64) -> Result<()>

Should set the coordinate / position at dimension to val

impl IsMatrix4Transformable for Point3D

fn transformed(&self, m: &Matrix4) -> Self

Should return self transformed by the Matrix

fn transform(&mut self, m: &Matrix4)

Should transform self by the Matrix

impl IsMovable3D for Point3D

fn move_by(&mut self, x: f64, y: f64, z: f64)

Should move the object by the given offset

impl IsND for Point3D

fn n_dimensions() -> usize

Should return the number of dimensions. E.g. 2 for points in 2D space, 3 for points in 3D space etc.

fn position_nd(&self, dimension: usize) -> Result<f64>

Should return the value of a given dimensions. E.g. for 2D position with x = 4.3, y = 1.8 the result for dimension = 1 should be 1.8

impl IsTransFormableTo2D for Point3D

fn transform_to_2d<P>(&self) -> P where
    P: IsBuildable2D, 

Should create representation of self within the 2D space

impl Mul<f64> for Point3D

type Output = Point3D

The resulting type after applying the * operator.

fn mul(self, other: f64) -> Point3D

Performs the * operation.

impl<'_> Mul<f64> for &'_ Point3D

type Output = Point3D

The resulting type after applying the * operator.

fn mul(self, other: f64) -> Point3D

Performs the * operation.

impl Neg for Point3D

type Output = Point3D

The resulting type after applying the - operator.

fn neg(self) -> Point3D

Performs the unary - operation.

impl<'_> Neg for &'_ Point3D

type Output = Point3D

The resulting type after applying the - operator.

fn neg(self) -> Point3D

Performs the unary - operation.

impl Ord for Point3D

fn cmp(&self, other: &Self) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

🔬 This is a nightly-only experimental API. (clamp)

Restrict a value to a certain interval.

impl PartialEq<Point3D> for Point3D

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

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

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

This method tests for !=.

impl PartialOrd<Point3D> for Point3D

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

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

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

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

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

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

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

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

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

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

impl StructuralPartialEq for Point3D

impl<P, '_, '_> Sub<&'_ P> for &'_ Point3D where
    P: Is3D, 

type Output = Point3D

The resulting type after applying the - operator.

fn sub(self, other: &P) -> Point3D

Performs the - operation.

impl<P> Sub<P> for Point3D where
    P: Is3D, 

type Output = Point3D

The resulting type after applying the - operator.

fn sub(self, other: P) -> Point3D

Performs the - operation.

impl<'_> Sub<Point3D> for &'_ Point3D

type Output = Point3D

The resulting type after applying the - operator.

fn sub(self, other: Point3D) -> Point3D

Performs the - operation.