Struct Vector3

pub struct Vector3<T: CoordsFloat>(pub T, pub T, pub T);

3D vector representation

Generics

• T: CoordsFloat – Generic type for coordinates representation.

Example

use honeycomb_core::geometry::Vector3;

let unit_x = Vector3::unit_x();
let unit_y = Vector3::unit_y();
let unit_z = Vector3::unit_z();

assert_eq!(unit_x.dot(&unit_y), 0.0);
assert_eq!(unit_x.cross(&unit_y), unit_z);

let three: f64 = 3.0;
let x_plus_y_plus_z: Vector3<f64> = unit_x + unit_y + unit_z;

assert_eq!(x_plus_y_plus_z.norm(), three.sqrt());
assert_eq!(x_plus_y_plus_z.unit_dir()?, Vector3(1.0 / three.sqrt(), 1.0 / three.sqrt(), 1.0 / three.sqrt()));

Tuple Fields

0: T

1: T

2: T

Implementations

impl<T: CoordsFloat> Vector3<T>

pub fn unit_x() -> Self

Base vector

Return

Return a unit vector along the x axis.

pub fn unit_y() -> Self

Base vector

Return

Return a unit vector along the y axis.

pub fn unit_z() -> Self

Base vector

Return

Return a unit vector along the z axis.

pub fn into_inner(self) -> (T, T, T)

Consume self to return inner value

Return

Return coordinate values as a simple tuple.

pub fn x(&self) -> T

Getter

Return

Return the value of the x coordinate of the vector.

pub fn y(&self) -> T

Getter

Return

Return the value of the y coordinate of the vector.

pub fn z(&self) -> T

Getter

Return

Return the value of the z coordinate of the vector.

pub fn norm(&self) -> T

Compute the norm of self.

Return

Return the norm. Its type is the same as the one used for internal representation.

Example

See Vector3 example.

pub fn unit_dir(&self) -> Result<Self, CoordsError>

Compute the direction of self as a unit vector.

Return

Return a Vector3 indicating the direction of self. The norm of the returned struct is equal to one.

Errors

This method will return an error if called on a Vector3 with a norm equal to zero, i.e. a null Vector3.

Example

See Vector3 example.

pub fn dot(&self, other: &Vector3<T>) -> T

Compute the dot product between two vectors

Arguments

• other: &Vector3 – reference to the second vector.

Return

Return the dot product between self and other.

Example

See Vector3 example.

pub fn cross(&self, other: &Vector3<T>) -> Self

Compute the cross product between two vectors

Arguments

• other: &Vector3 – reference to the second vector.

Return

Return the cross product between self and other.

Example

See Vector3 example.

Trait Implementations

impl<T: CoordsFloat> Add<&Vector3<T>> for Vertex3<T>

type Output = Vertex3<T>

The resulting type after applying the + operator.

fn add(self, rhs: &Vector3<T>) -> Self::Output

Performs the + operation.

impl<T: CoordsFloat> Add<Vector3<T>> for Vertex3<T>

type Output = Vertex3<T>

The resulting type after applying the + operator.

fn add(self, rhs: Vector3<T>) -> Self::Output

Performs the + operation.

impl<T: CoordsFloat> Add for Vector3<T>

type Output = Vector3<T>

The resulting type after applying the + operator.

fn add(self, rhs: Vector3<T>) -> Self::Output

Performs the + operation.

impl<T: CoordsFloat> AddAssign<&Vector3<T>> for Vertex3<T>

fn add_assign(&mut self, rhs: &Vector3<T>)

Performs the += operation.

impl<T: CoordsFloat> AddAssign<Vector3<T>> for Vertex3<T>

fn add_assign(&mut self, rhs: Vector3<T>)

Performs the += operation.

impl<T: CoordsFloat> AddAssign for Vector3<T>

fn add_assign(&mut self, rhs: Vector3<T>)

Performs the += operation.

impl<T: Clone + CoordsFloat> Clone for Vector3<T>

fn clone(&self) -> Vector3<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug + CoordsFloat> Debug for Vector3<T>

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

Formats the value using the given formatter.

impl<T: Default + CoordsFloat> Default for Vector3<T>

fn default() -> Vector3<T>

Returns the “default value” for a type.

impl<T: CoordsFloat> Div<T> for Vector3<T>

type Output = Vector3<T>

The resulting type after applying the / operator.

fn div(self, rhs: T) -> Self::Output

Performs the / operation.

impl<T: CoordsFloat> DivAssign<T> for Vector3<T>

fn div_assign(&mut self, rhs: T)

Performs the /= operation.

impl<T: CoordsFloat> From<(T, T, T)> for Vector3<T>

fn from((x, y, z): (T, T, T)) -> Self

Converts to this type from the input type.

impl<T: CoordsFloat> From<Vector2<T>> for Vector3<T>

fn from(v: Vector2<T>) -> Self

Converts to this type from the input type.

impl<T: CoordsFloat> Mul<T> for Vector3<T>

type Output = Vector3<T>

The resulting type after applying the * operator.

fn mul(self, rhs: T) -> Self::Output

Performs the * operation.

impl<T: CoordsFloat> MulAssign<T> for Vector3<T>

fn mul_assign(&mut self, rhs: T)

Performs the *= operation.

impl<T: CoordsFloat> Neg for Vector3<T>

type Output = Vector3<T>

The resulting type after applying the - operator.

fn neg(self) -> Self::Output

Performs the unary - operation.

impl<T: PartialEq + CoordsFloat> PartialEq for Vector3<T>

fn eq(&self, other: &Vector3<T>) -> 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<T: CoordsFloat> Sub<&Vector3<T>> for Vertex3<T>

type Output = Vertex3<T>

The resulting type after applying the - operator.

fn sub(self, rhs: &Vector3<T>) -> Self::Output

Performs the - operation.

impl<T: CoordsFloat> Sub<Vector3<T>> for Vertex3<T>

type Output = Vertex3<T>

The resulting type after applying the - operator.

fn sub(self, rhs: Vector3<T>) -> Self::Output

Performs the - operation.

impl<T: CoordsFloat> Sub for Vector3<T>

type Output = Vector3<T>

The resulting type after applying the - operator.

fn sub(self, rhs: Vector3<T>) -> Self::Output

Performs the - operation.

impl<T: CoordsFloat> SubAssign<&Vector3<T>> for Vertex3<T>

fn sub_assign(&mut self, rhs: &Vector3<T>)

Performs the -= operation.

impl<T: CoordsFloat> SubAssign<Vector3<T>> for Vertex3<T>

fn sub_assign(&mut self, rhs: Vector3<T>)

Performs the -= operation.

impl<T: CoordsFloat> SubAssign for Vector3<T>

fn sub_assign(&mut self, rhs: Vector3<T>)

Performs the -= operation.

impl<T: Copy + CoordsFloat> Copy for Vector3<T>

impl<T: CoordsFloat> Send for Vector3<T>

impl<T: CoordsFloat> StructuralPartialEq for Vector3<T>

impl<T: CoordsFloat> Sync for Vector3<T>