$darkmode
Eigen  5.0.1-dev
Translation.h
1 // This file is part of Eigen, a lightweight C++ template library
2 // for linear algebra.
3 //
4 // Copyright (C) 2008 Gael Guennebaud <gael.guennebaud@inria.fr>
5 //
6 // This Source Code Form is subject to the terms of the Mozilla
7 // Public License v. 2.0. If a copy of the MPL was not distributed
8 // with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
9 
10 #ifndef EIGEN_TRANSLATION_H
11 #define EIGEN_TRANSLATION_H
12 
13 // IWYU pragma: private
14 #include "./InternalHeaderCheck.h"
15 
16 namespace Eigen {
17 
32 template <typename Scalar_, int Dim_>
33 class Translation {
34  public:
35  EIGEN_MAKE_ALIGNED_OPERATOR_NEW_IF_VECTORIZABLE_FIXED_SIZE(Scalar_, Dim_)
37  enum { Dim = Dim_ };
39  typedef Scalar_ Scalar;
48 
49  protected:
50  VectorType m_coeffs;
51 
52  public:
54  EIGEN_DEVICE_FUNC Translation() {}
56  EIGEN_DEVICE_FUNC inline Translation(const Scalar& sx, const Scalar& sy) {
57  eigen_assert(Dim == 2);
58  m_coeffs.x() = sx;
59  m_coeffs.y() = sy;
60  }
62  EIGEN_DEVICE_FUNC inline Translation(const Scalar& sx, const Scalar& sy, const Scalar& sz) {
63  eigen_assert(Dim == 3);
64  m_coeffs.x() = sx;
65  m_coeffs.y() = sy;
66  m_coeffs.z() = sz;
67  }
69  EIGEN_DEVICE_FUNC explicit inline Translation(const VectorType& vector) : m_coeffs(vector) {}
70 
72  EIGEN_DEVICE_FUNC constexpr Scalar x() const { return m_coeffs.x(); }
74  EIGEN_DEVICE_FUNC constexpr Scalar y() const { return m_coeffs.y(); }
76  EIGEN_DEVICE_FUNC constexpr Scalar z() const { return m_coeffs.z(); }
77 
79  EIGEN_DEVICE_FUNC constexpr Scalar& x() { return m_coeffs.x(); }
81  EIGEN_DEVICE_FUNC constexpr Scalar& y() { return m_coeffs.y(); }
83  EIGEN_DEVICE_FUNC constexpr Scalar& z() { return m_coeffs.z(); }
84 
85  EIGEN_DEVICE_FUNC const VectorType& vector() const { return m_coeffs; }
86  EIGEN_DEVICE_FUNC VectorType& vector() { return m_coeffs; }
87 
88  EIGEN_DEVICE_FUNC const VectorType& translation() const { return m_coeffs; }
89  EIGEN_DEVICE_FUNC VectorType& translation() { return m_coeffs; }
90 
92  EIGEN_DEVICE_FUNC inline Translation operator*(const Translation& other) const {
93  return Translation(m_coeffs + other.m_coeffs);
94  }
95 
97  EIGEN_DEVICE_FUNC inline AffineTransformType operator*(const UniformScaling<Scalar>& other) const;
98 
100  template <typename OtherDerived>
101  EIGEN_DEVICE_FUNC inline AffineTransformType operator*(const EigenBase<OtherDerived>& linear) const;
102 
104  template <typename Derived>
105  EIGEN_DEVICE_FUNC inline IsometryTransformType operator*(const RotationBase<Derived, Dim>& r) const {
106  return *this * IsometryTransformType(r);
107  }
108 
110  // its a nightmare to define a templated friend function outside its declaration
111  template <typename OtherDerived>
112  friend EIGEN_DEVICE_FUNC inline AffineTransformType operator*(const EigenBase<OtherDerived>& linear,
113  const Translation& t) {
115  res.matrix().setZero();
116  res.linear() = linear.derived();
117  res.translation() = linear.derived() * t.m_coeffs;
118  res.matrix().row(Dim).setZero();
119  res(Dim, Dim) = Scalar(1);
120  return res;
121  }
122 
124  template <int Mode, int Options>
125  EIGEN_DEVICE_FUNC inline Transform<Scalar, Dim, Mode> operator*(
126  const Transform<Scalar, Dim, Mode, Options>& t) const {
128  res.pretranslate(m_coeffs);
129  return res;
130  }
131 
133  template <typename Derived>
134  inline std::enable_if_t<Derived::IsVectorAtCompileTime, VectorType> operator*(const MatrixBase<Derived>& vec) const {
135  return m_coeffs + vec.derived();
136  }
137 
139  Translation inverse() const { return Translation(-m_coeffs); }
140 
141  static const Translation Identity() { return Translation(VectorType::Zero()); }
142 
148  template <typename NewScalarType>
149  EIGEN_DEVICE_FUNC inline typename internal::cast_return_type<Translation, Translation<NewScalarType, Dim> >::type
150  cast() const {
151  return typename internal::cast_return_type<Translation, Translation<NewScalarType, Dim> >::type(*this);
152  }
153 
155  template <typename OtherScalarType>
156  EIGEN_DEVICE_FUNC inline explicit Translation(const Translation<OtherScalarType, Dim>& other) {
157  m_coeffs = other.vector().template cast<Scalar>();
158  }
159 
164  EIGEN_DEVICE_FUNC bool isApprox(const Translation& other, const typename NumTraits<Scalar>::Real& prec =
166  return m_coeffs.isApprox(other.m_coeffs, prec);
167  }
168 };
169 
172 typedef Translation<float, 2> Translation2f;
173 typedef Translation<double, 2> Translation2d;
174 typedef Translation<float, 3> Translation3f;
175 typedef Translation<double, 3> Translation3d;
177 
178 template <typename Scalar, int Dim>
180  const UniformScaling<Scalar>& other) const {
182  res.matrix().setZero();
183  res.linear().diagonal().fill(other.factor());
184  res.translation() = m_coeffs;
185  res(Dim, Dim) = Scalar(1);
186  return res;
187 }
188 
189 template <typename Scalar, int Dim>
190 template <typename OtherDerived>
192  const EigenBase<OtherDerived>& linear) const {
194  res.matrix().setZero();
195  res.linear() = linear.derived();
196  res.translation() = m_coeffs;
197  res.matrix().row(Dim).setZero();
198  res(Dim, Dim) = Scalar(1);
199  return res;
200 }
201 
202 } // end namespace Eigen
203 
204 #endif // EIGEN_TRANSLATION_H
ConstLinearPart linear() const
Definition: Transform.h:374
constexpr Derived & derived()
Definition: EigenBase.h:49
IsometryTransformType operator*(const RotationBase< Derived, Dim > &r) const
Definition: Translation.h:105
constexpr Scalar & z()
Returns the z-translation as a reference.
Definition: Translation.h:83
Scalar_ Scalar
Definition: Translation.h:39
Namespace containing all symbols from the Eigen library.
Definition: B01_Experimental.dox:1
constexpr Scalar z() const
Returns the z-translation by value.
Definition: Translation.h:76
Holds information about the various numeric (i.e. scalar) types allowed by Eigen. ...
Definition: NumTraits.h:232
Matrix< Scalar, Dim, Dim > LinearMatrixType
Definition: Translation.h:43
Matrix< Scalar, Dim, 1 > VectorType
Definition: Translation.h:41
internal::cast_return_type< Translation, Translation< NewScalarType, Dim > >::type cast() const
Definition: Translation.h:150
Definition: EigenBase.h:33
Represents a translation transformation.
Definition: ForwardDeclarations.h:463
Derived & setZero(Index size)
Definition: CwiseNullaryOp.h:567
Translation(const Translation< OtherScalarType, Dim > &other)
Definition: Translation.h:156
std::enable_if_t< Derived::IsVectorAtCompileTime, VectorType > operator*(const MatrixBase< Derived > &vec) const
Definition: Translation.h:134
Transform< Scalar, Dim, Mode > operator*(const Transform< Scalar, Dim, Mode, Options > &t) const
Definition: Translation.h:125
Represents a generic uniform scaling transformation.
Definition: ForwardDeclarations.h:475
Common base class for compact rotation representations.
Definition: ForwardDeclarations.h:455
ConstTranslationPart translation() const
Definition: Transform.h:384
const MatrixType & matrix() const
Definition: Transform.h:369
constexpr Derived & derived()
Definition: EigenBase.h:49
constexpr Scalar & y()
Returns the y-translation as a reference.
Definition: Translation.h:81
Transform< Scalar, Dim, Affine > AffineTransformType
Definition: Translation.h:45
constexpr Scalar x() const
Returns the x-translation by value.
Definition: Translation.h:72
Translation operator*(const Translation &other) const
Definition: Translation.h:92
bool isApprox(const Translation &other, const typename NumTraits< Scalar >::Real &prec=NumTraits< Scalar >::dummy_precision()) const
Definition: Translation.h:164
constexpr Scalar y() const
Returns the y-translation by value.
Definition: Translation.h:74
Translation(const VectorType &vector)
Definition: Translation.h:69
constexpr Scalar & x()
Returns the x-translation as a reference.
Definition: Translation.h:79
Translation inverse() const
Definition: Translation.h:139
Translation()
Definition: Translation.h:54
friend AffineTransformType operator*(const EigenBase< OtherDerived > &linear, const Translation &t)
Definition: Translation.h:112
Base class for all dense matrices, vectors, and expressions.
Definition: MatrixBase.h:52
Represents an homogeneous transformation in a N dimensional space.
Definition: ForwardDeclarations.h:469
Transform< Scalar, Dim, Isometry > IsometryTransformType
Definition: Translation.h:47