nalgebra/src/geometry/rotation_conversion.rs

340 lines
10 KiB
Rust
Raw Normal View History

use num::Zero;
2020-03-21 19:16:46 +08:00
use simba::scalar::{RealField, SubsetOf, SupersetOf};
use simba::simd::{PrimitiveSimdValue, SimdValue};
2019-03-23 21:29:07 +08:00
use crate::base::allocator::Allocator;
use crate::base::dimension::{DimMin, DimNameAdd, DimNameSum, U1};
use crate::base::{CMatrixN, Const, DefaultAllocator, Matrix2, Matrix3, Matrix4, MatrixN, Scalar};
2019-03-23 21:29:07 +08:00
use crate::geometry::{
2020-03-21 19:16:46 +08:00
AbstractRotation, Isometry, Rotation, Rotation2, Rotation3, Similarity, SuperTCategoryOf,
2021-01-29 07:46:14 +08:00
TAffine, Transform, Translation, UnitComplex, UnitDualQuaternion, UnitQuaternion,
};
/*
* This file provides the following conversions:
* =============================================
*
* Rotation -> Rotation
* Rotation3 -> UnitQuaternion
* Rotation3 -> UnitDualQuaternion
* Rotation2 -> UnitComplex
* Rotation -> Isometry
* Rotation -> Similarity
* Rotation -> Transform
* Rotation -> Matrix (homogeneous)
2017-10-10 01:58:09 +08:00
2017-07-25 23:55:54 +08:00
*/
impl<N1, N2, const D: usize> SubsetOf<Rotation<N2, D>> for Rotation<N1, D>
2018-02-02 19:26:35 +08:00
where
2019-03-25 18:21:41 +08:00
N1: RealField,
N2: RealField + SupersetOf<N1>,
2018-02-02 19:26:35 +08:00
{
#[inline]
fn to_superset(&self) -> Rotation<N2, D> {
Rotation::from_matrix_unchecked(self.matrix().to_superset())
}
#[inline]
fn is_in_subset(rot: &Rotation<N2, D>) -> bool {
crate::is_convertible::<_, CMatrixN<N1, D>>(rot.matrix())
}
#[inline]
2020-03-21 19:16:46 +08:00
fn from_superset_unchecked(rot: &Rotation<N2, D>) -> Self {
Rotation::from_matrix_unchecked(rot.matrix().to_subset_unchecked())
}
}
impl<N1, N2> SubsetOf<UnitQuaternion<N2>> for Rotation3<N1>
2018-02-02 19:26:35 +08:00
where
2019-03-25 18:21:41 +08:00
N1: RealField,
N2: RealField + SupersetOf<N1>,
2018-02-02 19:26:35 +08:00
{
#[inline]
fn to_superset(&self) -> UnitQuaternion<N2> {
let q = UnitQuaternion::<N1>::from_rotation_matrix(self);
q.to_superset()
}
#[inline]
fn is_in_subset(q: &UnitQuaternion<N2>) -> bool {
2019-03-23 21:29:07 +08:00
crate::is_convertible::<_, UnitQuaternion<N1>>(q)
}
#[inline]
2020-03-21 19:16:46 +08:00
fn from_superset_unchecked(q: &UnitQuaternion<N2>) -> Self {
2019-03-23 21:29:07 +08:00
let q: UnitQuaternion<N1> = crate::convert_ref_unchecked(q);
q.to_rotation_matrix()
}
}
impl<N1, N2> SubsetOf<UnitDualQuaternion<N2>> for Rotation3<N1>
where
N1: RealField,
N2: RealField + SupersetOf<N1>,
{
#[inline]
fn to_superset(&self) -> UnitDualQuaternion<N2> {
let q = UnitQuaternion::<N1>::from_rotation_matrix(self);
let dq = UnitDualQuaternion::from_rotation(q);
dq.to_superset()
}
#[inline]
fn is_in_subset(dq: &UnitDualQuaternion<N2>) -> bool {
2021-01-29 07:46:14 +08:00
crate::is_convertible::<_, UnitQuaternion<N1>>(&dq.rotation())
&& dq.translation().vector.is_zero()
}
#[inline]
fn from_superset_unchecked(dq: &UnitDualQuaternion<N2>) -> Self {
let dq: UnitDualQuaternion<N1> = crate::convert_ref_unchecked(dq);
dq.rotation().to_rotation_matrix()
}
}
impl<N1, N2> SubsetOf<UnitComplex<N2>> for Rotation2<N1>
2018-02-02 19:26:35 +08:00
where
2019-03-25 18:21:41 +08:00
N1: RealField,
N2: RealField + SupersetOf<N1>,
2018-02-02 19:26:35 +08:00
{
#[inline]
fn to_superset(&self) -> UnitComplex<N2> {
let q = UnitComplex::<N1>::from_rotation_matrix(self);
q.to_superset()
}
#[inline]
fn is_in_subset(q: &UnitComplex<N2>) -> bool {
2019-03-23 21:29:07 +08:00
crate::is_convertible::<_, UnitComplex<N1>>(q)
}
#[inline]
2020-03-21 19:16:46 +08:00
fn from_superset_unchecked(q: &UnitComplex<N2>) -> Self {
2019-03-23 21:29:07 +08:00
let q: UnitComplex<N1> = crate::convert_ref_unchecked(q);
q.to_rotation_matrix()
}
}
impl<N1, N2, R, const D: usize> SubsetOf<Isometry<N2, R, D>> for Rotation<N1, D>
2018-02-02 19:26:35 +08:00
where
2019-03-25 18:21:41 +08:00
N1: RealField,
N2: RealField + SupersetOf<N1>,
2020-03-21 19:16:46 +08:00
R: AbstractRotation<N2, D> + SupersetOf<Self>,
2018-02-02 19:26:35 +08:00
{
#[inline]
fn to_superset(&self) -> Isometry<N2, R, D> {
2019-03-23 21:29:07 +08:00
Isometry::from_parts(Translation::identity(), crate::convert_ref(self))
}
#[inline]
fn is_in_subset(iso: &Isometry<N2, R, D>) -> bool {
iso.translation.vector.is_zero()
}
#[inline]
fn from_superset_unchecked(iso: &Isometry<N2, R, D>) -> Self {
2019-03-23 21:29:07 +08:00
crate::convert_ref_unchecked(&iso.rotation)
}
}
impl<N1, N2, R, const D: usize> SubsetOf<Similarity<N2, R, D>> for Rotation<N1, D>
2018-02-02 19:26:35 +08:00
where
2019-03-25 18:21:41 +08:00
N1: RealField,
N2: RealField + SupersetOf<N1>,
2020-03-21 19:16:46 +08:00
R: AbstractRotation<N2, D> + SupersetOf<Self>,
2018-02-02 19:26:35 +08:00
{
#[inline]
fn to_superset(&self) -> Similarity<N2, R, D> {
2019-03-23 21:29:07 +08:00
Similarity::from_parts(Translation::identity(), crate::convert_ref(self), N2::one())
}
#[inline]
fn is_in_subset(sim: &Similarity<N2, R, D>) -> bool {
2018-02-02 19:26:35 +08:00
sim.isometry.translation.vector.is_zero() && sim.scaling() == N2::one()
}
#[inline]
fn from_superset_unchecked(sim: &Similarity<N2, R, D>) -> Self {
2019-03-23 21:29:07 +08:00
crate::convert_ref_unchecked(&sim.isometry.rotation)
}
}
impl<N1, N2, C, const D: usize> SubsetOf<Transform<N2, C, D>> for Rotation<N1, D>
2018-02-02 19:26:35 +08:00
where
2019-03-25 18:21:41 +08:00
N1: RealField,
N2: RealField + SupersetOf<N1>,
2018-02-02 19:26:35 +08:00
C: SuperTCategoryOf<TAffine>,
Const<D>: DimNameAdd<U1> + DimMin<Const<D>, Output = Const<D>>, // needed by .is_special_orthogonal()
DefaultAllocator: Allocator<N1, DimNameSum<Const<D>, U1>, DimNameSum<Const<D>, U1>>
+ Allocator<N2, DimNameSum<Const<D>, U1>, DimNameSum<Const<D>, U1>>,
// + Allocator<(usize, usize), D>,
// Allocator<N1, D, D>
// + Allocator<N2, D, D>
2018-02-02 19:26:35 +08:00
{
// needed by .is_special_orthogonal()
#[inline]
fn to_superset(&self) -> Transform<N2, C, D> {
Transform::from_matrix_unchecked(self.to_homogeneous().to_superset())
}
#[inline]
fn is_in_subset(t: &Transform<N2, C, D>) -> bool {
<Self as SubsetOf<_>>::is_in_subset(t.matrix())
}
#[inline]
fn from_superset_unchecked(t: &Transform<N2, C, D>) -> Self {
Self::from_superset_unchecked(t.matrix())
}
}
impl<N1, N2, const D: usize> SubsetOf<MatrixN<N2, DimNameSum<Const<D>, U1>>> for Rotation<N1, D>
2018-02-02 19:26:35 +08:00
where
2019-03-25 18:21:41 +08:00
N1: RealField,
N2: RealField + SupersetOf<N1>,
Const<D>: DimNameAdd<U1> + DimMin<Const<D>, Output = Const<D>>, // needed by .is_special_orthogonal()
DefaultAllocator: Allocator<N1, DimNameSum<Const<D>, U1>, DimNameSum<Const<D>, U1>>
+ Allocator<N2, DimNameSum<Const<D>, U1>, DimNameSum<Const<D>, U1>>, // + Allocator<(usize, usize), D>,
// + Allocator<N1, D, D>
// + Allocator<N2, D, D>
2018-02-02 19:26:35 +08:00
{
// needed by .is_special_orthogonal()
#[inline]
fn to_superset(&self) -> MatrixN<N2, DimNameSum<Const<D>, U1>> {
self.to_homogeneous().to_superset()
}
#[inline]
fn is_in_subset(m: &MatrixN<N2, DimNameSum<Const<D>, U1>>) -> bool {
let rot = m.fixed_slice::<Const<D>, Const<D>>(0, 0);
let bottom = m.fixed_slice::<U1, Const<D>>(D, 0);
// Scalar types agree.
m.iter().all(|e| SupersetOf::<N1>::is_in_subset(e)) &&
// The block part is a rotation.
2019-03-23 21:29:07 +08:00
rot.is_special_orthogonal(N2::default_epsilon() * crate::convert(100.0)) &&
// The bottom row is (0, 0, ..., 1)
bottom.iter().all(|e| e.is_zero()) && m[(D, D)] == N2::one()
}
#[inline]
fn from_superset_unchecked(m: &MatrixN<N2, DimNameSum<Const<D>, U1>>) -> Self {
let r = m.fixed_slice::<Const<D>, Const<D>>(0, 0);
2019-03-23 21:29:07 +08:00
Self::from_matrix_unchecked(crate::convert_unchecked(r.into_owned()))
}
}
2017-07-25 23:55:54 +08:00
2019-03-25 18:21:41 +08:00
impl<N: RealField> From<Rotation2<N>> for Matrix3<N> {
#[inline]
2020-03-21 19:16:46 +08:00
fn from(q: Rotation2<N>) -> Self {
q.to_homogeneous()
}
}
2019-03-25 18:21:41 +08:00
impl<N: RealField> From<Rotation2<N>> for Matrix2<N> {
#[inline]
fn from(q: Rotation2<N>) -> Self {
q.into_inner()
}
}
2019-03-25 18:21:41 +08:00
impl<N: RealField> From<Rotation3<N>> for Matrix4<N> {
#[inline]
fn from(q: Rotation3<N>) -> Self {
q.to_homogeneous()
}
}
2019-03-25 18:21:41 +08:00
impl<N: RealField> From<Rotation3<N>> for Matrix3<N> {
#[inline]
fn from(q: Rotation3<N>) -> Self {
q.into_inner()
}
}
impl<N: Scalar + PrimitiveSimdValue, const D: usize> From<[Rotation<N::Element, D>; 2]>
for Rotation<N, D>
where
N: From<[<N as SimdValue>::Element; 2]>,
N::Element: Scalar + Copy,
{
#[inline]
fn from(arr: [Rotation<N::Element, D>; 2]) -> Self {
Self::from_matrix_unchecked(MatrixN::from([
arr[0].clone().into_inner(),
arr[1].clone().into_inner(),
]))
}
}
impl<N: Scalar + PrimitiveSimdValue, const D: usize> From<[Rotation<N::Element, D>; 4]>
for Rotation<N, D>
where
N: From<[<N as SimdValue>::Element; 4]>,
N::Element: Scalar + Copy,
{
#[inline]
fn from(arr: [Rotation<N::Element, D>; 4]) -> Self {
Self::from_matrix_unchecked(MatrixN::from([
arr[0].clone().into_inner(),
arr[1].clone().into_inner(),
arr[2].clone().into_inner(),
arr[3].clone().into_inner(),
]))
}
}
impl<N: Scalar + PrimitiveSimdValue, const D: usize> From<[Rotation<N::Element, D>; 8]>
for Rotation<N, D>
where
N: From<[<N as SimdValue>::Element; 8]>,
N::Element: Scalar + Copy,
{
#[inline]
fn from(arr: [Rotation<N::Element, D>; 8]) -> Self {
Self::from_matrix_unchecked(MatrixN::from([
arr[0].clone().into_inner(),
arr[1].clone().into_inner(),
arr[2].clone().into_inner(),
arr[3].clone().into_inner(),
arr[4].clone().into_inner(),
arr[5].clone().into_inner(),
arr[6].clone().into_inner(),
arr[7].clone().into_inner(),
]))
}
}
impl<N: Scalar + PrimitiveSimdValue, const D: usize> From<[Rotation<N::Element, D>; 16]>
for Rotation<N, D>
where
N: From<[<N as SimdValue>::Element; 16]>,
N::Element: Scalar + Copy,
{
#[inline]
fn from(arr: [Rotation<N::Element, D>; 16]) -> Self {
Self::from_matrix_unchecked(MatrixN::from([
arr[0].clone().into_inner(),
arr[1].clone().into_inner(),
arr[2].clone().into_inner(),
arr[3].clone().into_inner(),
arr[4].clone().into_inner(),
arr[5].clone().into_inner(),
arr[6].clone().into_inner(),
arr[7].clone().into_inner(),
arr[8].clone().into_inner(),
arr[9].clone().into_inner(),
arr[10].clone().into_inner(),
arr[11].clone().into_inner(),
arr[12].clone().into_inner(),
arr[13].clone().into_inner(),
arr[14].clone().into_inner(),
arr[15].clone().into_inner(),
]))
}
}