Struct duku::Vec3

#[repr(C)]pub struct Vec3 {
    pub x: f32,
    pub y: f32,
    pub z: f32,
}

3-component Vector.

Used for 3D sizing and positioning.

Examples

let point1 = Vec3::new(-10.0, -10.0, -10.0);
let point2 = Vec3::new(10.0, 10.0, 10.0);

// when drawing
t.debug_line(point1, point2);

Fields

x: f32

the X component

y: f32

the Y component

z: f32

the Z component

Implementations

impl Vec3

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

Create a new vector

pub const fn up() -> Self

Create a vector facing up

pub const fn down() -> Self

Create a vector facing down

pub const fn left() -> Self

Create a vector facing left

pub const fn right() -> Self

Create a vector facing right

pub const fn forward() -> Self

Create a vector facing forward

pub const fn back() -> Self

Create a vector facing back

pub const fn uniform(v: f32) -> Self

Create a new vector with all components with the same value

pub fn dot(&self, other: impl Into<Self>) -> f32

Calculate the dot-product of the vector

pub fn cross(&self, other: impl Into<Self>) -> Self

Calculate the cross-product of the vector

pub fn sqr_length(&self) -> f32

Calculate the squared length of a vector

Can sometimes use this instead of length, because this is faster.

pub fn length(&self) -> f32

Calculate the length of a vector

pub fn unit(&self) -> Self

Calculate the unit vector

The unit vector is of length 1 and can also be thought of as the direction of the vector.

pub fn angle_between(&self, other: impl Into<Self>) -> f32

Calculate the angle between 2 vectors

Resulting angle is in degrees

Examples

let up = Vec3::up();
let right = Vec3::right();
let angle = up.angle_between(right);
// angle is ~90 degrees

pub fn project_onto(&self, other: impl Into<Self>) -> Self

Calculate the projected vector onto some other vector

pub const fn xy(&self) -> Vec2

Get the Vec2 made from this vectors x and y

pub fn floor(&self) -> Self

Floor every component of the vector

pub fn ceil(&self) -> Self

Ceil every component of the vector

pub fn round(&self) -> Self

Round every component of the vector

Trait Implementations

impl Add<Vec3> for Vec3

type Output = Self

The resulting type after applying the + operator.

pub fn add(self, rhs: Self) -> Self

Performs the + operation.

impl AddAssign<Vec3> for Vec3

pub fn add_assign(&mut self, rhs: Self)

Performs the += operation.

impl Clone for Vec3

pub fn clone(&self) -> Vec3

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Vec3

impl Debug for Vec3

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

Formats the value using the given formatter.

impl Default for Vec3

pub fn default() -> Vec3

Returns the "default value" for a type.

impl Div<f32> for Vec3

type Output = Self

The resulting type after applying the / operator.

pub fn div(self, rhs: f32) -> Self

Performs the / operation.

impl DivAssign<f32> for Vec3

pub fn div_assign(&mut self, rhs: f32)

Performs the /= operation.

impl From<[f32; 3]> for Vec3

pub fn from(a: [f32; 3]) -> Self

Performs the conversion.

impl From<(Vec2, f32)> for Vec3

pub fn from(v: (Vec2, f32)) -> Self

Performs the conversion.

impl From<Rgbf> for Vec3

pub fn from(c: Rgbf) -> Self

Performs the conversion.

impl Index<usize> for Vec3

type Output = f32

The returned type after indexing.

pub fn index(&self, index: usize) -> &f32

Performs the indexing (container[index]) operation.

impl IndexMut<usize> for Vec3

pub fn index_mut(&mut self, index: usize) -> &mut f32

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

impl Mul<Vec3> for Mat4

type Output = Vec3

The resulting type after applying the * operator.

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

Performs the * operation.

impl Mul<Vec3> for Quat

type Output = Vec3

The resulting type after applying the * operator.

pub fn mul(self, rhs: Vec3) -> Vec3

Performs the * operation.

impl Mul<f32> for Vec3

type Output = Self

The resulting type after applying the * operator.

pub fn mul(self, rhs: f32) -> Self

Performs the * operation.

impl MulAssign<f32> for Vec3

pub fn mul_assign(&mut self, rhs: f32)

Performs the *= operation.

impl Neg for Vec3

type Output = Self

The resulting type after applying the - operator.

pub fn neg(self) -> Self

Performs the unary - operation.

impl PartialEq<Vec3> for Vec3

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

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

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

This method tests for !=.

impl StructuralPartialEq for Vec3

impl Sub<Vec3> for Vec3

type Output = Self

The resulting type after applying the - operator.

pub fn sub(self, rhs: Self) -> Self

Performs the - operation.

impl SubAssign<Vec3> for Vec3

pub fn sub_assign(&mut self, rhs: Self)

Performs the -= operation.

impl<'vec> Sum<&'vec Vec3> for Vec3

pub fn sum<I>(iter: I) -> Self where
    I: Iterator<Item = &'vec Self>, 

Method which takes an iterator and generates Self from the elements by "summing up" the items.