2017-08-03 01:37:44 +08:00
|
|
|
use num::One;
|
2016-12-05 05:44:42 +08:00
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
use alga::general::Real;
|
2016-12-05 05:44:42 +08:00
|
|
|
|
2018-05-19 23:15:15 +08:00
|
|
|
use base::allocator::Allocator;
|
2018-10-22 13:00:10 +08:00
|
|
|
use base::dimension::{DimNameAdd, DimNameSum, U1};
|
|
|
|
use base::{DefaultAllocator, MatrixN};
|
2016-12-05 05:44:42 +08:00
|
|
|
|
2018-02-02 19:26:35 +08:00
|
|
|
use geometry::{TCategory, Transform};
|
2016-12-05 05:44:42 +08:00
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Real, D: DimNameAdd<U1>, C: TCategory> Transform<N, D, C>
|
2018-10-22 13:00:10 +08:00
|
|
|
where DefaultAllocator: Allocator<N, DimNameSum<D, U1>, DimNameSum<D, U1>>
|
2018-02-02 19:26:35 +08:00
|
|
|
{
|
2016-12-05 05:44:42 +08:00
|
|
|
/// Creates a new identity transform.
|
2018-11-08 14:51:43 +08:00
|
|
|
///
|
|
|
|
/// # Example
|
|
|
|
///
|
|
|
|
/// ```
|
|
|
|
/// # use nalgebra::{Transform2, Projective2, Affine2, Transform3, Projective3, Affine3, Point2, Point3};
|
|
|
|
///
|
|
|
|
/// let pt = Point2::new(1.0, 2.0);
|
|
|
|
/// let t = Projective2::identity();
|
|
|
|
/// assert_eq!(t * pt, pt);
|
|
|
|
///
|
|
|
|
/// let aff = Affine2::identity();
|
|
|
|
/// assert_eq!(aff * pt, pt);
|
|
|
|
///
|
|
|
|
/// let aff = Transform2::identity();
|
|
|
|
/// assert_eq!(aff * pt, pt);
|
|
|
|
///
|
|
|
|
/// // Also works in 3D.
|
|
|
|
/// let pt = Point3::new(1.0, 2.0, 3.0);
|
|
|
|
/// let t = Projective3::identity();
|
|
|
|
/// assert_eq!(t * pt, pt);
|
|
|
|
///
|
|
|
|
/// let aff = Affine3::identity();
|
|
|
|
/// assert_eq!(aff * pt, pt);
|
|
|
|
///
|
|
|
|
/// let aff = Transform3::identity();
|
|
|
|
/// assert_eq!(aff * pt, pt);
|
|
|
|
/// ```
|
2016-12-05 05:44:42 +08:00
|
|
|
#[inline]
|
|
|
|
pub fn identity() -> Self {
|
2017-08-03 01:37:44 +08:00
|
|
|
Self::from_matrix_unchecked(MatrixN::<_, DimNameSum<D, U1>>::identity())
|
2016-12-05 05:44:42 +08:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2017-08-03 01:37:44 +08:00
|
|
|
impl<N: Real, D: DimNameAdd<U1>, C: TCategory> One for Transform<N, D, C>
|
2018-10-22 13:00:10 +08:00
|
|
|
where DefaultAllocator: Allocator<N, DimNameSum<D, U1>, DimNameSum<D, U1>>
|
2018-02-02 19:26:35 +08:00
|
|
|
{
|
2016-12-05 05:44:42 +08:00
|
|
|
/// Creates a new identity transform.
|
|
|
|
#[inline]
|
|
|
|
fn one() -> Self {
|
|
|
|
Self::identity()
|
|
|
|
}
|
|
|
|
}
|