pub struct Transform<P, O, S> {
pub position: Vec3<P>,
pub orientation: Quaternion<O>,
pub scale: Vec3<S>,
}
Expand description
A convenient position + orientation + scale container, backed by two Vec3
and a Quaternion.
It can be easily interpolated and converted to a Mat4
of any layout.
let (p, rz, s) = (Vec3::unit_x(), 3.0_f32, 5.0_f32);
let a = Mat4::scaling_3d(s).rotated_z(rz).translated_3d(p);
let b = Mat4::from(Transform {
position: p,
orientation: Quaternion::rotation_z(rz),
scale: Vec3::broadcast(s),
});
assert_relative_eq!(a, b);
Fields§
§position: Vec3<P>
Local position.
orientation: Quaternion<O>
Local orientation; It is not named rotation
because rotation
denotes an
operation, but not a current state.
scale: Vec3<S>
Local scale.
Trait Implementations§
source§impl<P: Zero, O: Zero + One, S: One> Default for Transform<P, O, S>
impl<P: Zero, O: Zero + One, S: One> Default for Transform<P, O, S>
The default Transform
has a zero position, identity orientation and unit scale.
let a = Transform {
position: Vec3::<f32>::zero(),
orientation: Quaternion::<f32>::identity(),
scale: Vec3::<f32>::one(),
};
assert_eq!(a, Transform::default());
source§impl<'de, P, O, S> Deserialize<'de> for Transform<P, O, S>where
P: Deserialize<'de>,
O: Deserialize<'de>,
S: Deserialize<'de>,
impl<'de, P, O, S> Deserialize<'de> for Transform<P, O, S>where
P: Deserialize<'de>,
O: Deserialize<'de>,
S: Deserialize<'de>,
source§fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where
__D: Deserializer<'de>,
source§impl<T> From<Transform<T, T, T>> for Mat4<T>where
T: Real + MulAdd<T, T, Output = T>,
impl<T> From<Transform<T, T, T>> for Mat4<T>where
T: Real + MulAdd<T, T, Output = T>,
A Mat4
can be obtained from a Transform
, by rotating, then scaling, then
translating.
source§impl<T> From<Transform<T, T, T>> for Mat4<T>where
T: Real + MulAdd<T, T, Output = T>,
impl<T> From<Transform<T, T, T>> for Mat4<T>where
T: Real + MulAdd<T, T, Output = T>,
A Mat4
can be obtained from a Transform
, by rotating, then scaling, then
translating.
source§impl<'a, P, O, S, Factor> Lerp<Factor> for &'a Transform<P, O, S>where
Factor: Copy + Into<O>,
&'a P: Lerp<Factor, Output = P>,
&'a S: Lerp<Factor, Output = S>,
O: Lerp<O, Output = O> + Real + Add<Output = O>,
impl<'a, P, O, S, Factor> Lerp<Factor> for &'a Transform<P, O, S>where
Factor: Copy + Into<O>,
&'a P: Lerp<Factor, Output = P>,
&'a S: Lerp<Factor, Output = S>,
O: Lerp<O, Output = O> + Real + Add<Output = O>,
LERP on a Transform
is defined as LERP-ing between the positions and scales,
and performing SLERP between the orientations.
source§fn lerp_unclamped(a: Self, b: Self, t: Factor) -> Self::Output
fn lerp_unclamped(a: Self, b: Self, t: Factor) -> Self::Output
from
to to
with factor
unconstrained,
using the supposedly fastest but less precise implementation. Read moresource§fn lerp_unclamped_precise(a: Self, b: Self, t: Factor) -> Self::Output
fn lerp_unclamped_precise(a: Self, b: Self, t: Factor) -> Self::Output
from
to to
with factor
unconstrained,
using a possibly slower but more precise operation. Read moresource§fn lerp_unclamped_inclusive_range(
range: RangeInclusive<Self>,
factor: Factor
) -> Self::Output
fn lerp_unclamped_inclusive_range(
range: RangeInclusive<Self>,
factor: Factor
) -> Self::Output
lerp_unclamped()
that used a single RangeInclusive
parameter instead of two values.source§fn lerp_unclamped_precise_inclusive_range(
range: RangeInclusive<Self>,
factor: Factor
) -> Self::Output
fn lerp_unclamped_precise_inclusive_range(
range: RangeInclusive<Self>,
factor: Factor
) -> Self::Output
lerp_unclamped_precise()
that used a single RangeInclusive
parameter instead of two values.source§impl<P, O, S, Factor> Lerp<Factor> for Transform<P, O, S>where
Factor: Copy + Into<O>,
P: Lerp<Factor, Output = P>,
S: Lerp<Factor, Output = S>,
O: Lerp<O, Output = O> + Real + Add<Output = O>,
impl<P, O, S, Factor> Lerp<Factor> for Transform<P, O, S>where
Factor: Copy + Into<O>,
P: Lerp<Factor, Output = P>,
S: Lerp<Factor, Output = S>,
O: Lerp<O, Output = O> + Real + Add<Output = O>,
LERP on a Transform
is defined as LERP-ing between the positions and scales,
and performing SLERP between the orientations.
source§fn lerp_unclamped(a: Self, b: Self, t: Factor) -> Self
fn lerp_unclamped(a: Self, b: Self, t: Factor) -> Self
from
to to
with factor
unconstrained,
using the supposedly fastest but less precise implementation. Read moresource§fn lerp_unclamped_precise(a: Self, b: Self, t: Factor) -> Self
fn lerp_unclamped_precise(a: Self, b: Self, t: Factor) -> Self
from
to to
with factor
unconstrained,
using a possibly slower but more precise operation. Read moresource§fn lerp_unclamped_inclusive_range(
range: RangeInclusive<Self>,
factor: Factor
) -> Self::Output
fn lerp_unclamped_inclusive_range(
range: RangeInclusive<Self>,
factor: Factor
) -> Self::Output
lerp_unclamped()
that used a single RangeInclusive
parameter instead of two values.source§fn lerp_unclamped_precise_inclusive_range(
range: RangeInclusive<Self>,
factor: Factor
) -> Self::Output
fn lerp_unclamped_precise_inclusive_range(
range: RangeInclusive<Self>,
factor: Factor
) -> Self::Output
lerp_unclamped_precise()
that used a single RangeInclusive
parameter instead of two values.