Struct euclid::TypedRotation3D
source · #[repr(C)]pub struct TypedRotation3D<T, Src, Dst> {
pub i: T,
pub j: T,
pub k: T,
pub r: T,
/* private fields */
}
Expand description
A transform that can represent rotations in 3d, represented as a quaternion.
Most methods expect the quaternion to be normalized.
When in doubt, use unit_quaternion
instead of quaternion
to create
a rotation as the former will ensure that its result is normalized.
Some people use the x, y, z, w
(or w, x, y, z
) notations. The equivalence is
as follows: x -> i
, y -> j
, z -> k
, w -> r
.
The memory layout of this type corresponds to the x, y, z, w
notation
Fields
i: T
j: T
k: T
r: T
Implementations
sourceimpl<T, Src, Dst> TypedRotation3D<T, Src, Dst>
impl<T, Src, Dst> TypedRotation3D<T, Src, Dst>
sourcepub fn quaternion(a: T, b: T, c: T, r: T) -> Self
pub fn quaternion(a: T, b: T, c: T, r: T) -> Self
Creates a rotation around from a quaternion representation.
The parameters are a, b, c and r compose the quaternion a*i + b*j + c*k + r
where a
, b
and c
describe the vector part and the last parameter r
is
the real part.
The resulting quaternion is not necessarily normalized. See unit_quaternion
.
sourceimpl<T, Src, Dst> TypedRotation3D<T, Src, Dst>where
T: Copy,
impl<T, Src, Dst> TypedRotation3D<T, Src, Dst>where
T: Copy,
sourcepub fn vector_part(&self) -> Vector3D<T>
pub fn vector_part(&self) -> Vector3D<T>
Returns the vector part (i, j, k) of this quaternion.
sourceimpl<T, Src, Dst> TypedRotation3D<T, Src, Dst>where
T: Float,
impl<T, Src, Dst> TypedRotation3D<T, Src, Dst>where
T: Float,
sourcepub fn unit_quaternion(i: T, j: T, k: T, r: T) -> Self
pub fn unit_quaternion(i: T, j: T, k: T, r: T) -> Self
Creates a rotation around from a quaternion representation and normalizes it.
The parameters are a, b, c and r compose the quaternion a*i + b*j + c*k + r
before normalization, where a
, b
and c
describe the vector part and the
last parameter r
is the real part.
sourcepub fn around_axis(axis: TypedVector3D<T, Src>, angle: Angle<T>) -> Self
pub fn around_axis(axis: TypedVector3D<T, Src>, angle: Angle<T>) -> Self
Creates a rotation around a given axis.
sourcepub fn euler(roll: Angle<T>, pitch: Angle<T>, yaw: Angle<T>) -> Self
pub fn euler(roll: Angle<T>, pitch: Angle<T>, yaw: Angle<T>) -> Self
Creates a rotation from Euler angles.
The rotations are applied in roll then pitch then yaw order.
- Roll (also called bank) is a rotation around the x axis.
- Pitch (also called bearing) is a rotation around the y axis.
- Yaw (also called heading) is a rotation around the z axis.
sourcepub fn inverse(&self) -> TypedRotation3D<T, Dst, Src>
pub fn inverse(&self) -> TypedRotation3D<T, Dst, Src>
Returns the inverse of this rotation.
pub fn square_norm(&self) -> T
pub fn is_normalized(&self) -> boolwhere
T: ApproxEq<T>,
sourcepub fn slerp(&self, other: &Self, t: T) -> Selfwhere
T: ApproxEq<T>,
pub fn slerp(&self, other: &Self, t: T) -> Selfwhere
T: ApproxEq<T>,
Spherical linear interpolation between this rotation and another rotation.
t
is expected to be between zero and one.
sourcepub fn lerp(&self, other: &Self, t: T) -> Self
pub fn lerp(&self, other: &Self, t: T) -> Self
Basic Linear interpolation between this rotation and another rotation.
t
is expected to be between zero and one.
sourcepub fn rotate_point3d(
&self,
point: &TypedPoint3D<T, Src>
) -> TypedPoint3D<T, Dst>where
T: ApproxEq<T>,
pub fn rotate_point3d(
&self,
point: &TypedPoint3D<T, Src>
) -> TypedPoint3D<T, Dst>where
T: ApproxEq<T>,
Returns the given 3d point transformed by this rotation.
The input point must be use the unit Src, and the returned point has the unit Dst.
sourcepub fn rotate_point2d(
&self,
point: &TypedPoint2D<T, Src>
) -> TypedPoint2D<T, Dst>where
T: ApproxEq<T>,
pub fn rotate_point2d(
&self,
point: &TypedPoint2D<T, Src>
) -> TypedPoint2D<T, Dst>where
T: ApproxEq<T>,
Returns the given 2d point transformed by this rotation then projected on the xy plane.
The input point must be use the unit Src, and the returned point has the unit Dst.
sourcepub fn rotate_vector3d(
&self,
vector: &TypedVector3D<T, Src>
) -> TypedVector3D<T, Dst>where
T: ApproxEq<T>,
pub fn rotate_vector3d(
&self,
vector: &TypedVector3D<T, Src>
) -> TypedVector3D<T, Dst>where
T: ApproxEq<T>,
Returns the given 3d vector transformed by this rotation then projected on the xy plane.
The input vector must be use the unit Src, and the returned point has the unit Dst.
sourcepub fn rotate_vector2d(
&self,
vector: &TypedVector2D<T, Src>
) -> TypedVector2D<T, Dst>where
T: ApproxEq<T>,
pub fn rotate_vector2d(
&self,
vector: &TypedVector2D<T, Src>
) -> TypedVector2D<T, Dst>where
T: ApproxEq<T>,
Returns the given 2d vector transformed by this rotation then projected on the xy plane.
The input vector must be use the unit Src, and the returned point has the unit Dst.
sourcepub fn to_transform(&self) -> TypedTransform3D<T, Src, Dst>where
T: ApproxEq<T>,
pub fn to_transform(&self) -> TypedTransform3D<T, Src, Dst>where
T: ApproxEq<T>,
Returns the matrix representation of this rotation.
sourcepub fn pre_rotate<NewSrc>(
&self,
other: &TypedRotation3D<T, NewSrc, Src>
) -> TypedRotation3D<T, NewSrc, Dst>where
T: ApproxEq<T>,
pub fn pre_rotate<NewSrc>(
&self,
other: &TypedRotation3D<T, NewSrc, Src>
) -> TypedRotation3D<T, NewSrc, Dst>where
T: ApproxEq<T>,
Returns a rotation representing the other rotation followed by this rotation.
sourcepub fn post_rotate<NewDst>(
&self,
other: &TypedRotation3D<T, Dst, NewDst>
) -> TypedRotation3D<T, Src, NewDst>where
T: ApproxEq<T>,
pub fn post_rotate<NewDst>(
&self,
other: &TypedRotation3D<T, Dst, NewDst>
) -> TypedRotation3D<T, Src, NewDst>where
T: ApproxEq<T>,
Returns a rotation representing this rotation followed by the other rotation.