euclid

Struct Translation3D

Source
#[repr(C)]
pub struct Translation3D<T, Src, Dst> { pub x: T, pub y: T, pub z: T, /* private fields */ }
Expand description

A 3d transformation from a space to another that can only express translations.

The main benefit of this type over a Vector3D is the ability to cast between a source and a destination spaces.

Fields§

§x: T§y: T§z: T

Implementations§

Source§

impl<T, Src, Dst> Translation3D<T, Src, Dst>

Source

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

Source

pub fn identity() -> Self
where T: Zero,

Creates no-op translation (x, y and z is zero()).

Source

pub fn is_identity(&self) -> bool
where T: Zero + PartialEq,

Check if translation does nothing (x, y and z is zero()).

use euclid::default::Translation3D;

assert_eq!(Translation3D::<f32>::identity().is_identity(), true);
assert_eq!(Translation3D::new(0, 0, 0).is_identity(), true);
assert_eq!(Translation3D::new(1, 0, 0).is_identity(), false);
assert_eq!(Translation3D::new(0, 1, 0).is_identity(), false);
assert_eq!(Translation3D::new(0, 0, 1).is_identity(), false);
Source

pub fn transform_size(self, s: Size2D<T, Src>) -> Size2D<T, Dst>

No-op, just cast the unit.

Source§

impl<T: Copy, Src, Dst> Translation3D<T, Src, Dst>

Source

pub fn to_vector(&self) -> Vector3D<T, Src>

Cast into a 3D vector.

Source

pub fn to_array(&self) -> [T; 3]

Cast into an array with x, y and z.

Source

pub fn to_tuple(&self) -> (T, T, T)

Cast into a tuple with x, y and z.

Source

pub fn to_untyped(&self) -> Translation3D<T, UnknownUnit, UnknownUnit>

Drop the units, preserving only the numeric value.

Source

pub fn from_untyped(t: &Translation3D<T, UnknownUnit, UnknownUnit>) -> Self

Tag a unitless value with units.

Source

pub fn to_transform(&self) -> Transform3D<T, Src, Dst>
where T: Zero + One,

Returns the matrix representation of this translation.

Source

pub fn transform_point3d(&self, p: &Point3D<T, Src>) -> Point3D<T::Output, Dst>
where T: Add,

Translate a point and cast its unit.

Source

pub fn transform_point2d(&self, p: &Point2D<T, Src>) -> Point2D<T::Output, Dst>
where T: Add,

Translate a point and cast its unit.

Source

pub fn transform_box2d(&self, b: &Box2D<T, Src>) -> Box2D<T::Output, Dst>
where T: Add,

Translate a 2D box and cast its unit.

Source

pub fn transform_box3d(&self, b: &Box3D<T, Src>) -> Box3D<T::Output, Dst>
where T: Add,

Translate a 3D box and cast its unit.

Source

pub fn transform_rect(&self, r: &Rect<T, Src>) -> Rect<T, Dst>
where T: Add<Output = T>,

Translate a rectangle and cast its unit.

Source

pub fn inverse(&self) -> Translation3D<T::Output, Dst, Src>
where T: Neg,

Return the inverse transformation.

Trait Implementations§

Source§

impl<T: Add, Src, Dst1, Dst2> Add<Translation3D<T, Dst1, Dst2>> for Translation3D<T, Src, Dst1>

Source§

type Output = Translation3D<<T as Add>::Output, Src, Dst2>

The resulting type after applying the + operator.
Source§

fn add(self, other: Translation3D<T, Dst1, Dst2>) -> Self::Output

Performs the + operation. Read more
Source§

impl<T: AddAssign, Src, Dst> AddAssign<Translation3D<T, Dst, Dst>> for Translation3D<T, Src, Dst>

Source§

fn add_assign(&mut self, other: Translation3D<T, Dst, Dst>)

Performs the += operation. Read more
Source§

impl<T: Clone, Src, Dst> Clone for Translation3D<T, Src, Dst>

Source§

fn clone(&self) -> Self

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T: Debug, Src, Dst> Debug for Translation3D<T, Src, Dst>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T, Src, Dst> Default for Translation3D<T, Src, Dst>
where T: Zero,

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl<'de, T, Src, Dst> Deserialize<'de> for Translation3D<T, Src, Dst>
where T: Deserialize<'de>,

Source§

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>
where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl<T, Src, Dst> From<Vector3D<T, Src>> for Translation3D<T, Src, Dst>

Source§

fn from(v: Vector3D<T, Src>) -> Self

Converts to this type from the input type.
Source§

impl<T, Src, Dst> Hash for Translation3D<T, Src, Dst>
where T: Hash,

Source§

fn hash<H: Hasher>(&self, h: &mut H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl<T, Src, Dst> Into<Transform3D<T, Src, Dst>> for Translation3D<T, Src, Dst>
where T: Zero + One,

Source§

fn into(self) -> Transform3D<T, Src, Dst>

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

impl<T, Src, Dst> Into<Vector3D<T, Src>> for Translation3D<T, Src, Dst>

Source§

fn into(self) -> Vector3D<T, Src>

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

impl<T, Src, Dst> PartialEq for Translation3D<T, Src, Dst>
where T: PartialEq,

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl<T, Src, Dst> Serialize for Translation3D<T, Src, Dst>
where T: Serialize,

Source§

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
where S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl<T: Sub, Src, Dst1, Dst2> Sub<Translation3D<T, Dst1, Dst2>> for Translation3D<T, Src, Dst2>

Source§

type Output = Translation3D<<T as Sub>::Output, Src, Dst1>

The resulting type after applying the - operator.
Source§

fn sub(self, other: Translation3D<T, Dst1, Dst2>) -> Self::Output

Performs the - operation. Read more
Source§

impl<T: SubAssign, Src, Dst> SubAssign<Translation3D<T, Dst, Dst>> for Translation3D<T, Src, Dst>

Source§

fn sub_assign(&mut self, other: Translation3D<T, Dst, Dst>)

Performs the -= operation. Read more
Source§

impl<T: Copy, Src, Dst> Copy for Translation3D<T, Src, Dst>

Source§

impl<T, Src, Dst> Eq for Translation3D<T, Src, Dst>
where T: Eq,

Auto Trait Implementations§

§

impl<T, Src, Dst> Freeze for Translation3D<T, Src, Dst>
where T: Freeze,

§

impl<T, Src, Dst> RefUnwindSafe for Translation3D<T, Src, Dst>

§

impl<T, Src, Dst> Send for Translation3D<T, Src, Dst>
where T: Send, Src: Send, Dst: Send,

§

impl<T, Src, Dst> Sync for Translation3D<T, Src, Dst>
where T: Sync, Src: Sync, Dst: Sync,

§

impl<T, Src, Dst> Unpin for Translation3D<T, Src, Dst>
where T: Unpin, Src: Unpin, Dst: Unpin,

§

impl<T, Src, Dst> UnwindSafe for Translation3D<T, Src, Dst>
where T: UnwindSafe, Src: UnwindSafe, Dst: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dst: *mut T)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,