Struct three_d::core::prelude::Point3

#[repr(C)]
pub struct Point3<S> {
    pub x: S,
    pub y: S,
    pub z: S,
}

A point in 3-dimensional space.

This type is marked as #[repr(C)].

Fields

x: S

y: S

z: S

Implementations

impl<S> Point3<S>

where S: BaseNum,

pub fn from_homogeneous(v: Vector4<S>) -> Point3<S>

pub fn to_homogeneous(self) -> Vector4<S>

impl<S> Point3<S>

pub const fn new(x: S, y: S, z: S) -> Point3<S>

Construct a new point, using the provided values.

pub fn map<U, F>(self, f: F) -> Point3<U>

where F: FnMut(S) -> U,

Perform the given operation on each field in the point, returning a new point constructed from the operations.

pub fn zip<S2, S3, F>(self, p2: Point3<S2>, f: F) -> Point3<S3>

where F: FnMut(S, S2) -> S3,

Construct a new point where each component is the result of applying the given operation to each pair of components of the given points.

impl<S> Point3<S>

where S: NumCast + Copy,

pub fn cast<T>(&self) -> Option<Point3<T>>

where T: NumCast,

Component-wise casting to another type

Trait Implementations

impl<S> AbsDiffEq for Point3<S>

where S: BaseFloat,

type Epsilon = <S as AbsDiffEq>::Epsilon

Used for specifying relative comparisons.

fn default_epsilon() -> <S as AbsDiffEq>::Epsilon

The default tolerance to use when testing values that are close together.

fn abs_diff_eq( &self, other: &Point3<S>, epsilon: <S as AbsDiffEq>::Epsilon ) -> bool

A test for equality that uses the absolute difference to compute the approximate equality of two numbers.

fn abs_diff_ne(&self, other: &Rhs, epsilon: Self::Epsilon) -> bool

The inverse of [AbsDiffEq::abs_diff_eq].

impl<'a, 'b, S> Add<&'a Vector3<S>> for &'b Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the + operator.

fn add(self, other: &'a Vector3<S>) -> Point3<S>

Performs the + operation.

impl<'a, S> Add<&'a Vector3<S>> for Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the + operator.

fn add(self, other: &'a Vector3<S>) -> Point3<S>

Performs the + operation.

impl<'a, S> Add<Vector3<S>> for &'a Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the + operator.

fn add(self, other: Vector3<S>) -> Point3<S>

Performs the + operation.

impl<S> Add<Vector3<S>> for Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the + operator.

fn add(self, other: Vector3<S>) -> Point3<S>

Performs the + operation.

impl<S> AddAssign<Vector3<S>> for Point3<S>

where S: BaseNum + AddAssign,

fn add_assign(&mut self, vector: Vector3<S>)

Performs the += operation.

impl<S> Array for Point3<S>

where S: BaseNum,

type Element = S

fn len() -> usize

Get the number of elements in the array type

fn from_value(scalar: S) -> Point3<S>

Construct a vector from a single value, replicating it.

fn sum(self) -> S

where S: Add<Output = S>,

The sum of the elements of the array.

fn product(self) -> S

where S: Mul<Output = S>,

The product of the elements of the array.

fn is_finite(&self) -> bool

where S: Float,

Whether all elements of the array are finite

fn as_ptr(&self) -> *const Self::Element

Get the pointer to the first element of the array.

fn as_mut_ptr(&mut self) -> *mut Self::Element

Get a mutable pointer to the first element of the array.

fn swap_elements(&mut self, i: usize, j: usize)

Swap the elements at indices i and j in-place.

impl<S> AsMut<[S; 3]> for Point3<S>

fn as_mut(&mut self) -> &mut [S; 3]

Converts this type into a mutable reference of the (usually inferred) input type.

impl<S> AsMut<(S, S, S)> for Point3<S>

fn as_mut(&mut self) -> &mut (S, S, S)

Converts this type into a mutable reference of the (usually inferred) input type.

impl<S> AsRef<[S; 3]> for Point3<S>

fn as_ref(&self) -> &[S; 3]

Converts this type into a shared reference of the (usually inferred) input type.

impl<S> AsRef<(S, S, S)> for Point3<S>

fn as_ref(&self) -> &(S, S, S)

Converts this type into a shared reference of the (usually inferred) input type.

impl<S> Bounded for Point3<S>

where S: Bounded,

fn min_value() -> Point3<S>

Returns the smallest finite number this type can represent

fn max_value() -> Point3<S>

Returns the largest finite number this type can represent

impl<S> Clone for Point3<S>

where S: Clone,

fn clone(&self) -> Point3<S>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<S> Debug for Point3<S>

where S: Debug,

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

Formats the value using the given formatter.

impl<'a, S> Div<S> for &'a Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the / operator.

fn div(self, other: S) -> Point3<S>

Performs the / operation.

impl<S> Div<S> for Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the / operator.

fn div(self, other: S) -> Point3<S>

Performs the / operation.

impl<S> DivAssign<S> for Point3<S>

where S: BaseNum + DivAssign,

fn div_assign(&mut self, scalar: S)

Performs the /= operation.

impl<S> ElementWise<S> for Point3<S>

where S: BaseNum,

fn add_element_wise(self, rhs: S) -> Point3<S>

fn sub_element_wise(self, rhs: S) -> Point3<S>

fn mul_element_wise(self, rhs: S) -> Point3<S>

fn div_element_wise(self, rhs: S) -> Point3<S>

fn rem_element_wise(self, rhs: S) -> Point3<S>

fn add_assign_element_wise(&mut self, rhs: S)

fn sub_assign_element_wise(&mut self, rhs: S)

fn mul_assign_element_wise(&mut self, rhs: S)

fn div_assign_element_wise(&mut self, rhs: S)

fn rem_assign_element_wise(&mut self, rhs: S)

impl<S> ElementWise for Point3<S>

where S: BaseNum,

fn add_element_wise(self, rhs: Point3<S>) -> Point3<S>

fn sub_element_wise(self, rhs: Point3<S>) -> Point3<S>

fn mul_element_wise(self, rhs: Point3<S>) -> Point3<S>

fn div_element_wise(self, rhs: Point3<S>) -> Point3<S>

fn rem_element_wise(self, rhs: Point3<S>) -> Point3<S>

fn add_assign_element_wise(&mut self, rhs: Point3<S>)

fn sub_assign_element_wise(&mut self, rhs: Point3<S>)

fn mul_assign_element_wise(&mut self, rhs: Point3<S>)

fn div_assign_element_wise(&mut self, rhs: Point3<S>)

fn rem_assign_element_wise(&mut self, rhs: Point3<S>)

impl<S> EuclideanSpace for Point3<S>

where S: BaseNum,

type Scalar = S

The associated scalar over which the space is defined.

type Diff = Vector3<S>

The associated space of displacement vectors.

fn origin() -> Point3<S>

The point at the origin of the Euclidean space.

fn from_vec(v: Vector3<S>) -> Point3<S>

Convert a displacement vector to a point.

fn to_vec(self) -> Vector3<S>

Convert a point to a displacement vector.

fn dot(self, v: Vector3<S>) -> S

This is a weird one, but its useful for plane calculations.

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

Returns the middle point between two other points.

fn centroid(points: &[Self]) -> Self

Returns the average position of all points in the slice.

impl<'a, S> From<&'a [S; 3]> for &'a Point3<S>

fn from(v: &'a [S; 3]) -> &'a Point3<S>

Converts to this type from the input type.

impl<'a, S> From<&'a (S, S, S)> for &'a Point3<S>

fn from(v: &'a (S, S, S)) -> &'a Point3<S>

Converts to this type from the input type.

impl<'a, S> From<&'a mut [S; 3]> for &'a mut Point3<S>

fn from(v: &'a mut [S; 3]) -> &'a mut Point3<S>

Converts to this type from the input type.

impl<'a, S> From<&'a mut (S, S, S)> for &'a mut Point3<S>

fn from(v: &'a mut (S, S, S)) -> &'a mut Point3<S>

Converts to this type from the input type.

impl<S> From<[S; 3]> for Point3<S>

where S: Clone,

fn from(v: [S; 3]) -> Point3<S>

Converts to this type from the input type.

impl<S> From<(S, S, S)> for Point3<S>

fn from(v: (S, S, S)) -> Point3<S>

Converts to this type from the input type.

impl<S> Hash for Point3<S>

where S: Hash,

fn hash<__H>(&self, state: &mut __H)

where __H: Hasher,

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> Index<Range<usize>> for Point3<S>

type Output = [S]

The returned type after indexing.

fn index<'a>(&'a self, i: Range<usize>) -> &'a [S]

Performs the indexing (container[index]) operation.

impl<S> Index<RangeFrom<usize>> for Point3<S>

type Output = [S]

The returned type after indexing.

fn index<'a>(&'a self, i: RangeFrom<usize>) -> &'a [S]

Performs the indexing (container[index]) operation.

impl<S> Index<RangeFull> for Point3<S>

type Output = [S]

The returned type after indexing.

fn index<'a>(&'a self, i: RangeFull) -> &'a [S]

Performs the indexing (container[index]) operation.

impl<S> Index<RangeTo<usize>> for Point3<S>

type Output = [S]

The returned type after indexing.

fn index<'a>(&'a self, i: RangeTo<usize>) -> &'a [S]

Performs the indexing (container[index]) operation.

impl<S> Index<usize> for Point3<S>

type Output = S

The returned type after indexing.

fn index<'a>(&'a self, i: usize) -> &'a S

Performs the indexing (container[index]) operation.

impl<S> IndexMut<Range<usize>> for Point3<S>

fn index_mut<'a>(&'a mut self, i: Range<usize>) -> &'a mut [S]

Performs the mutable indexing (container[index]) operation.

impl<S> IndexMut<RangeFrom<usize>> for Point3<S>

fn index_mut<'a>(&'a mut self, i: RangeFrom<usize>) -> &'a mut [S]

Performs the mutable indexing (container[index]) operation.

impl<S> IndexMut<RangeFull> for Point3<S>

fn index_mut<'a>(&'a mut self, i: RangeFull) -> &'a mut [S]

Performs the mutable indexing (container[index]) operation.

impl<S> IndexMut<RangeTo<usize>> for Point3<S>

fn index_mut<'a>(&'a mut self, i: RangeTo<usize>) -> &'a mut [S]

Performs the mutable indexing (container[index]) operation.

impl<S> IndexMut<usize> for Point3<S>

fn index_mut<'a>(&'a mut self, i: usize) -> &'a mut S

Performs the mutable indexing (container[index]) operation.

impl<S> Into<[S; 3]> for Point3<S>

fn into(self) -> [S; 3]

Converts this type into the (usually inferred) input type.

impl<S> Into<(S, S, S)> for Point3<S>

fn into(self) -> (S, S, S)

Converts this type into the (usually inferred) input type.

impl<S> MetricSpace for Point3<S>

where S: BaseFloat,

type Metric = S

The metric to be returned by the distance function.

fn distance2(self, other: Point3<S>) -> S

Returns the squared distance.

impl<'a, S> Mul<S> for &'a Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the * operator.

fn mul(self, other: S) -> Point3<S>

Performs the * operation.

impl<S> Mul<S> for Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the * operator.

fn mul(self, other: S) -> Point3<S>

Performs the * operation.

impl<S> MulAssign<S> for Point3<S>

where S: BaseNum + MulAssign,

fn mul_assign(&mut self, scalar: S)

Performs the *= operation.

impl<S> PartialEq for Point3<S>

where S: PartialEq,

fn eq(&self, other: &Point3<S>) -> 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> RelativeEq for Point3<S>

where S: BaseFloat,

fn default_max_relative() -> <S as AbsDiffEq>::Epsilon

The default relative tolerance for testing values that are far-apart.

fn relative_eq( &self, other: &Point3<S>, epsilon: <S as AbsDiffEq>::Epsilon, max_relative: <S as AbsDiffEq>::Epsilon ) -> bool

A test for equality that uses a relative comparison if the values are far apart.

fn relative_ne( &self, other: &Rhs, epsilon: Self::Epsilon, max_relative: Self::Epsilon ) -> bool

The inverse of [RelativeEq::relative_eq].

impl<'a, S> Rem<S> for &'a Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the % operator.

fn rem(self, other: S) -> Point3<S>

Performs the % operation.

impl<S> Rem<S> for Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the % operator.

fn rem(self, other: S) -> Point3<S>

Performs the % operation.

impl<S> RemAssign<S> for Point3<S>

where S: BaseNum + RemAssign,

fn rem_assign(&mut self, scalar: S)

Performs the %= operation.

impl<'a, 'b, S> Sub<&'a Point3<S>> for &'b Point3<S>

where S: BaseNum,

type Output = Vector3<S>

The resulting type after applying the - operator.

fn sub(self, other: &'a Point3<S>) -> Vector3<S>

Performs the - operation.

impl<'a, S> Sub<&'a Point3<S>> for Point3<S>

where S: BaseNum,

type Output = Vector3<S>

The resulting type after applying the - operator.

fn sub(self, other: &'a Point3<S>) -> Vector3<S>

Performs the - operation.

impl<'a, 'b, S> Sub<&'a Vector3<S>> for &'b Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the - operator.

fn sub(self, other: &'a Vector3<S>) -> Point3<S>

Performs the - operation.

impl<'a, S> Sub<&'a Vector3<S>> for Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the - operator.

fn sub(self, other: &'a Vector3<S>) -> Point3<S>

Performs the - operation.

impl<'a, S> Sub<Point3<S>> for &'a Point3<S>

where S: BaseNum,

type Output = Vector3<S>

The resulting type after applying the - operator.

fn sub(self, other: Point3<S>) -> Vector3<S>

Performs the - operation.

impl<'a, S> Sub<Vector3<S>> for &'a Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the - operator.

fn sub(self, other: Vector3<S>) -> Point3<S>

Performs the - operation.

impl<S> Sub<Vector3<S>> for Point3<S>

where S: BaseNum,

type Output = Point3<S>

The resulting type after applying the - operator.

fn sub(self, other: Vector3<S>) -> Point3<S>

Performs the - operation.

impl<S> Sub for Point3<S>

where S: BaseNum,

type Output = Vector3<S>

The resulting type after applying the - operator.

fn sub(self, other: Point3<S>) -> Vector3<S>

Performs the - operation.

impl<S> SubAssign<Vector3<S>> for Point3<S>

where S: BaseNum + SubAssign,

fn sub_assign(&mut self, vector: Vector3<S>)

Performs the -= operation.

impl<S> Transform<Point3<S>> for Matrix3<S>

where S: BaseFloat,

fn look_at(eye: Point3<S>, center: Point3<S>, up: Vector3<S>) -> Matrix3<S>

👎Deprecated: Use look_at_rh or look_at_lh

Create a transformation that rotates a vector to look at center from eye, using up for orientation.

fn look_at_lh(eye: Point3<S>, center: Point3<S>, up: Vector3<S>) -> Matrix3<S>

Create a transformation that rotates a vector to look at center from eye, using up for orientation.

fn look_at_rh(eye: Point3<S>, center: Point3<S>, up: Vector3<S>) -> Matrix3<S>

Create a transformation that rotates a vector to look at center from eye, using up for orientation.

fn transform_vector(&self, vec: Vector3<S>) -> Vector3<S>

Transform a vector using this transform.

fn transform_point(&self, point: Point3<S>) -> Point3<S>

Transform a point using this transform.

fn concat(&self, other: &Matrix3<S>) -> Matrix3<S>

Combine this transform with another, yielding a new transformation which has the effects of both.

fn inverse_transform(&self) -> Option<Matrix3<S>>

Create a transform that “un-does” this one.

fn inverse_transform_vector( &self, vec: <P as EuclideanSpace>::Diff ) -> Option<<P as EuclideanSpace>::Diff>

Inverse transform a vector using this transform

fn concat_self(&mut self, other: &Self)

Combine this transform with another, in-place.

impl<S> Transform<Point3<S>> for Matrix4<S>

where S: BaseFloat,

fn look_at(eye: Point3<S>, center: Point3<S>, up: Vector3<S>) -> Matrix4<S>

👎Deprecated: Use look_at_rh or look_at_lh

Create a transformation that rotates a vector to look at center from eye, using up for orientation.

fn look_at_lh(eye: Point3<S>, center: Point3<S>, up: Vector3<S>) -> Matrix4<S>

Create a transformation that rotates a vector to look at center from eye, using up for orientation.

fn look_at_rh(eye: Point3<S>, center: Point3<S>, up: Vector3<S>) -> Matrix4<S>

Create a transformation that rotates a vector to look at center from eye, using up for orientation.

fn transform_vector(&self, vec: Vector3<S>) -> Vector3<S>

Transform a vector using this transform.

fn transform_point(&self, point: Point3<S>) -> Point3<S>

Transform a point using this transform.

fn concat(&self, other: &Matrix4<S>) -> Matrix4<S>

Combine this transform with another, yielding a new transformation which has the effects of both.

fn inverse_transform(&self) -> Option<Matrix4<S>>

Create a transform that “un-does” this one.

fn inverse_transform_vector( &self, vec: <P as EuclideanSpace>::Diff ) -> Option<<P as EuclideanSpace>::Diff>

Inverse transform a vector using this transform

fn concat_self(&mut self, other: &Self)

Combine this transform with another, in-place.

impl<S> UlpsEq for Point3<S>

where S: BaseFloat,

fn default_max_ulps() -> u32

The default ULPs to tolerate when testing values that are far-apart.

fn ulps_eq( &self, other: &Point3<S>, epsilon: <S as AbsDiffEq>::Epsilon, max_ulps: u32 ) -> bool

A test for equality that uses units in the last place (ULP) if the values are far apart.

fn ulps_ne(&self, other: &Rhs, epsilon: Self::Epsilon, max_ulps: u32) -> bool

The inverse of [UlpsEq::ulps_eq].

impl<S> Copy for Point3<S>

where S: Copy,

impl<S> Eq for Point3<S>

where S: Eq,

impl<S> StructuralPartialEq for Point3<S>