|
enum | { TransformTimeDiagonalMode = ((Mode==int(Isometry))?Affine:int(Mode))
} |
|
typedef _Scalar | Scalar |
| the scalar type of the coefficients
|
|
typedef Matrix< Scalar, HDim, HDim > | MatrixType |
| type of the matrix used to represent the transformation
|
|
typedef Matrix< Scalar, Dim, Dim > | LinearMatrixType |
| type of the matrix used to represent the linear part of the transformation
|
|
typedef Block< MatrixType, Dim, Dim > | LinearPart |
| type of read/write reference to the linear part of the transformation
|
|
typedef const Block< const MatrixType, Dim, Dim > | ConstLinearPart |
| type of read/write reference to the linear part of the transformation
|
|
typedef Matrix< Scalar, Dim, 1 > | VectorType |
| type of a vector
|
|
typedef Block< MatrixType, Dim, 1 > | TranslationPart |
| type of a read/write reference to the translation part of the rotation
|
|
typedef const Block< const MatrixType, Dim, 1 > | ConstTranslationPart |
| type of a read/write reference to the translation part of the rotation
|
|
typedef Translation< Scalar, Dim > | TranslationType |
| corresponding translation type
|
|
typedef Scaling< Scalar, Dim > | ScalingType |
| corresponding scaling transformation type
|
|
typedef _Scalar | Scalar |
| the scalar type of the coefficients
|
|
typedef DenseIndex | Index |
|
typedef internal::make_proper_matrix_type< Scalar, Rows, HDim, Options >::type | MatrixType |
| type of the matrix used to represent the transformation
|
|
typedef const MatrixType | ConstMatrixType |
| constified MatrixType
|
|
typedef Matrix< Scalar, Dim, Dim, Options > | LinearMatrixType |
| type of the matrix used to represent the linear part of the transformation
|
|
typedef Block< MatrixType, Dim, Dim, int(Mode)==(AffineCompact) &&(Options &RowMajor)==0 > | LinearPart |
| type of read/write reference to the linear part of the transformation
|
|
typedef const Block< ConstMatrixType, Dim, Dim, int(Mode)==(AffineCompact) &&(Options &RowMajor)==0 > | ConstLinearPart |
| type of read reference to the linear part of the transformation
|
|
typedef internal::conditional< int(Mode)==int(AffineCompact), MatrixType &, Block< MatrixType, Dim, HDim > >::type | AffinePart |
| type of read/write reference to the affine part of the transformation
|
|
typedef internal::conditional< int(Mode)==int(AffineCompact), const MatrixType &, const Block< const MatrixType, Dim, HDim > >::type | ConstAffinePart |
| type of read reference to the affine part of the transformation
|
|
typedef Matrix< Scalar, Dim, 1 > | VectorType |
| type of a vector
|
|
typedef Block< MatrixType, Dim, 1, int(Mode)==(AffineCompact)> | TranslationPart |
| type of a read/write reference to the translation part of the rotation
|
|
typedef const Block< ConstMatrixType, Dim, 1, int(Mode)==(AffineCompact)> | ConstTranslationPart |
| type of a read reference to the translation part of the rotation
|
|
typedef Translation< Scalar, Dim > | TranslationType |
| corresponding translation type
|
|
typedef Transform< Scalar, Dim, TransformTimeDiagonalMode > | TransformTimeDiagonalReturnType |
| The return type of the product between a diagonal matrix and a transform.
|
|
typedef internal::transform_take_affine_part< Transform > | take_affine_part |
|
|
| EIGEN_MAKE_ALIGNED_OPERATOR_NEW_IF_VECTORIZABLE_FIXED_SIZE (_Scalar, _Dim==Dynamic ? Dynamic :(_Dim+1) *(_Dim+1)) enum |
|
| Transform () |
| Default constructor without initialization of the coefficients. More...
|
|
| Transform (const Transform &other) |
|
| Transform (const TranslationType &t) |
|
| Transform (const ScalingType &s) |
|
template<typename Derived > |
| Transform (const RotationBase< Derived, Dim > &r) |
|
Transform & | operator= (const Transform &other) |
|
template<typename OtherDerived > |
| Transform (const MatrixBase< OtherDerived > &other) |
| Constructs and initializes a transformation from a Dim^2 or a (Dim+1)^2 matrix. More...
|
|
template<typename OtherDerived > |
Transform & | operator= (const MatrixBase< OtherDerived > &other) |
| Set *this from a (Dim+1)^2 matrix. More...
|
|
Scalar | operator() (int row, int col) const |
| shortcut for m_matrix(row,col); More...
|
|
Scalar & | operator() (int row, int col) |
| shortcut for m_matrix(row,col); More...
|
|
const MatrixType & | matrix () const |
|
MatrixType & | matrix () |
|
ConstLinearPart | linear () const |
|
LinearPart | linear () |
|
ConstTranslationPart | translation () const |
|
TranslationPart | translation () |
|
template<typename OtherDerived > |
const ei_transform_product_impl< OtherDerived, _Dim, _Dim+1 >::ResultType | operator* (const MatrixBase< OtherDerived > &other) const |
|
const Transform | operator* (const Transform &other) const |
| Contatenates two transformations.
|
|
void | setIdentity () |
|
template<typename OtherDerived > |
Transform & | scale (const MatrixBase< OtherDerived > &other) |
|
template<typename OtherDerived > |
Transform & | prescale (const MatrixBase< OtherDerived > &other) |
|
Transform & | scale (Scalar s) |
| Applies on the right a uniform scale of a factor c to *this and returns a reference to *this . More...
|
|
Transform & | prescale (Scalar s) |
| Applies on the left a uniform scale of a factor c to *this and returns a reference to *this . More...
|
|
template<typename OtherDerived > |
Transform & | translate (const MatrixBase< OtherDerived > &other) |
|
template<typename OtherDerived > |
Transform & | pretranslate (const MatrixBase< OtherDerived > &other) |
|
template<typename RotationType > |
Transform & | rotate (const RotationType &rotation) |
|
template<typename RotationType > |
Transform & | prerotate (const RotationType &rotation) |
|
Transform & | shear (Scalar sx, Scalar sy) |
| Applies on the right the shear transformation represented by the vector other to *this and returns a reference to *this . More...
|
|
Transform & | preshear (Scalar sx, Scalar sy) |
| Applies on the left the shear transformation represented by the vector other to *this and returns a reference to *this . More...
|
|
Transform & | operator= (const TranslationType &t) |
|
Transform & | operator*= (const TranslationType &t) |
|
Transform | operator* (const TranslationType &t) const |
|
Transform & | operator= (const ScalingType &t) |
|
Transform & | operator*= (const ScalingType &s) |
|
Transform | operator* (const ScalingType &s) const |
|
template<typename Derived > |
Transform & | operator= (const RotationBase< Derived, Dim > &r) |
|
template<typename Derived > |
Transform & | operator*= (const RotationBase< Derived, Dim > &r) |
|
template<typename Derived > |
Transform | operator* (const RotationBase< Derived, Dim > &r) const |
|
LinearMatrixType | rotation () const |
|
template<typename RotationMatrixType , typename ScalingMatrixType > |
void | computeRotationScaling (RotationMatrixType *rotation, ScalingMatrixType *scaling) const |
| decomposes the linear part of the transformation as a product rotation x scaling, the scaling being not necessarily positive. More...
|
|
template<typename ScalingMatrixType , typename RotationMatrixType > |
void | computeScalingRotation (ScalingMatrixType *scaling, RotationMatrixType *rotation) const |
| decomposes the linear part of the transformation as a product rotation x scaling, the scaling being not necessarily positive. More...
|
|
template<typename PositionDerived , typename OrientationType , typename ScaleDerived > |
Transform & | fromPositionOrientationScale (const MatrixBase< PositionDerived > &position, const OrientationType &orientation, const MatrixBase< ScaleDerived > &scale) |
|
const MatrixType | inverse (TransformTraits traits=Affine) const |
|
const Scalar * | data () const |
|
Scalar * | data () |
|
template<typename NewScalarType > |
internal::cast_return_type< Transform, Transform< NewScalarType, Dim > >::type | cast () const |
|
template<typename OtherScalarType > |
| Transform (const Transform< OtherScalarType, Dim > &other) |
| Copy constructor with scalar type conversion.
|
|
bool | isApprox (const Transform &other, typename NumTraits< Scalar >::Real prec=precision< Scalar >()) const |
|
| EIGEN_MAKE_ALIGNED_OPERATOR_NEW_IF_VECTORIZABLE_FIXED_SIZE (_Scalar, _Dim==Dynamic ? Dynamic :(_Dim+1) *(_Dim+1)) enum |
|
| Transform () |
| Default constructor without initialization of the meaningful coefficients. More...
|
|
| Transform (const Transform &other) |
|
| Transform (const TranslationType &t) |
|
| Transform (const UniformScaling< Scalar > &s) |
|
template<typename Derived > |
| Transform (const RotationBase< Derived, Dim > &r) |
|
Transform & | operator= (const Transform &other) |
|
template<typename OtherDerived > |
| Transform (const EigenBase< OtherDerived > &other) |
| Constructs and initializes a transformation from a Dim^2 or a (Dim+1)^2 matrix. More...
|
|
template<typename OtherDerived > |
Transform & | operator= (const EigenBase< OtherDerived > &other) |
| Set *this from a Dim^2 or (Dim+1)^2 matrix. More...
|
|
template<int OtherOptions> |
| Transform (const Transform< Scalar, Dim, Mode, OtherOptions > &other) |
|
template<int OtherMode, int OtherOptions> |
| Transform (const Transform< Scalar, Dim, OtherMode, OtherOptions > &other) |
|
template<typename OtherDerived > |
| Transform (const ReturnByValue< OtherDerived > &other) |
|
template<typename OtherDerived > |
Transform & | operator= (const ReturnByValue< OtherDerived > &other) |
|
Scalar | operator() (Index row, Index col) const |
| shortcut for m_matrix(row,col); More...
|
|
Scalar & | operator() (Index row, Index col) |
| shortcut for m_matrix(row,col); More...
|
|
const MatrixType & | matrix () const |
|
MatrixType & | matrix () |
|
ConstLinearPart | linear () const |
|
LinearPart | linear () |
|
ConstAffinePart | affine () const |
|
AffinePart | affine () |
|
ConstTranslationPart | translation () const |
|
TranslationPart | translation () |
|
template<typename OtherDerived > |
EIGEN_STRONG_INLINE const OtherDerived::PlainObject | operator* (const EigenBase< OtherDerived > &other) const |
|
template<typename DiagonalDerived > |
const TransformTimeDiagonalReturnType | operator* (const DiagonalBase< DiagonalDerived > &b) const |
|
template<typename OtherDerived > |
Transform & | operator*= (const EigenBase< OtherDerived > &other) |
|
const Transform | operator* (const Transform &other) const |
| Concatenates two transformations.
|
|
template<int OtherMode, int OtherOptions> |
internal::transform_transform_product_impl< Transform, Transform< Scalar, Dim, OtherMode, OtherOptions > >::ResultType | operator* (const Transform< Scalar, Dim, OtherMode, OtherOptions > &other) const |
| Concatenates two different transformations.
|
|
void | setIdentity () |
|
template<typename OtherDerived > |
Transform & | scale (const MatrixBase< OtherDerived > &other) |
|
template<typename OtherDerived > |
Transform & | prescale (const MatrixBase< OtherDerived > &other) |
|
Transform & | scale (const Scalar &s) |
| Applies on the right a uniform scale of a factor c to *this and returns a reference to *this . More...
|
|
Transform & | prescale (const Scalar &s) |
| Applies on the left a uniform scale of a factor c to *this and returns a reference to *this . More...
|
|
template<typename OtherDerived > |
Transform & | translate (const MatrixBase< OtherDerived > &other) |
|
template<typename OtherDerived > |
Transform & | pretranslate (const MatrixBase< OtherDerived > &other) |
|
template<typename RotationType > |
Transform & | rotate (const RotationType &rotation) |
|
template<typename RotationType > |
Transform & | prerotate (const RotationType &rotation) |
|
Transform & | shear (const Scalar &sx, const Scalar &sy) |
| Applies on the right the shear transformation represented by the vector other to *this and returns a reference to *this . More...
|
|
Transform & | preshear (const Scalar &sx, const Scalar &sy) |
| Applies on the left the shear transformation represented by the vector other to *this and returns a reference to *this . More...
|
|
Transform & | operator= (const TranslationType &t) |
|
Transform & | operator*= (const TranslationType &t) |
|
Transform | operator* (const TranslationType &t) const |
|
Transform & | operator= (const UniformScaling< Scalar > &t) |
|
Transform & | operator*= (const UniformScaling< Scalar > &s) |
|
Transform< Scalar, Dim,(int(Mode)==int(Isometry)?int(Affine):int(Mode))> | operator* (const UniformScaling< Scalar > &s) const |
|
Transform & | operator*= (const DiagonalMatrix< Scalar, Dim > &s) |
|
template<typename Derived > |
Transform & | operator= (const RotationBase< Derived, Dim > &r) |
|
template<typename Derived > |
Transform & | operator*= (const RotationBase< Derived, Dim > &r) |
|
template<typename Derived > |
Transform | operator* (const RotationBase< Derived, Dim > &r) const |
|
const LinearMatrixType | rotation () const |
|
template<typename RotationMatrixType , typename ScalingMatrixType > |
void | computeRotationScaling (RotationMatrixType *rotation, ScalingMatrixType *scaling) const |
|
template<typename ScalingMatrixType , typename RotationMatrixType > |
void | computeScalingRotation (ScalingMatrixType *scaling, RotationMatrixType *rotation) const |
|
template<typename PositionDerived , typename OrientationType , typename ScaleDerived > |
Transform & | fromPositionOrientationScale (const MatrixBase< PositionDerived > &position, const OrientationType &orientation, const MatrixBase< ScaleDerived > &scale) |
|
Transform | inverse (TransformTraits traits=(TransformTraits) Mode) const |
|
const Scalar * | data () const |
|
Scalar * | data () |
|
template<typename NewScalarType > |
internal::cast_return_type< Transform, Transform< NewScalarType, Dim, Mode, Options > >::type | cast () const |
|
template<typename OtherScalarType > |
| Transform (const Transform< OtherScalarType, Dim, Mode, Options > &other) |
| Copy constructor with scalar type conversion.
|
|
bool | isApprox (const Transform &other, const typename NumTraits< Scalar >::Real &prec=NumTraits< Scalar >::dummy_precision()) const |
|
void | makeAffine () |
| Sets the last row to [0 ... More...
|
|
Block< MatrixType, int(Mode)==int(Projective)?HDim:Dim, Dim > | linearExt () |
|
const Block< MatrixType, int(Mode)==int(Projective)?HDim:Dim, Dim > | linearExt () const |
|
Block< MatrixType, int(Mode)==int(Projective)?HDim:Dim, 1 > | translationExt () |
|
const Block< MatrixType, int(Mode)==int(Projective)?HDim:Dim, 1 > | translationExt () const |
|
template<typename OtherDerived > |
Transform< Scalar, Dim > & | scale (const MatrixBase< OtherDerived > &other) |
| Applies on the right the non uniform scale transformation represented by the vector other to *this and returns a reference to *this . More...
|
|
template<typename OtherDerived > |
Transform< Scalar, Dim > & | prescale (const MatrixBase< OtherDerived > &other) |
| Applies on the left the non uniform scale transformation represented by the vector other to *this and returns a reference to *this . More...
|
|
template<typename OtherDerived > |
Transform< Scalar, Dim > & | translate (const MatrixBase< OtherDerived > &other) |
| Applies on the right the translation matrix represented by the vector other to *this and returns a reference to *this . More...
|
|
template<typename OtherDerived > |
Transform< Scalar, Dim > & | pretranslate (const MatrixBase< OtherDerived > &other) |
| Applies on the left the translation matrix represented by the vector other to *this and returns a reference to *this . More...
|
|
template<typename RotationType > |
Transform< Scalar, Dim > & | rotate (const RotationType &rotation) |
| Applies on the right the rotation represented by the rotation rotation to *this and returns a reference to *this . More...
|
|
template<typename RotationType > |
Transform< Scalar, Dim > & | prerotate (const RotationType &rotation) |
| Applies on the left the rotation represented by the rotation rotation to *this and returns a reference to *this . More...
|
|
template<typename Derived > |
Transform< Scalar, Dim > & | operator= (const RotationBase< Derived, Dim > &r) |
|
template<typename Derived> |
Transform< Scalar, Dim > | operator* (const RotationBase< Derived, Dim > &r) const |
|
template<typename PositionDerived , typename OrientationType , typename ScaleDerived > |
Transform< Scalar, Dim > & | fromPositionOrientationScale (const MatrixBase< PositionDerived > &position, const OrientationType &orientation, const MatrixBase< ScaleDerived > &scale) |
| Convenient method to set *this from a position, orientation and scale of a 3D object.
|
|
template<typename OtherDerived > |
Transform< Scalar, Dim, Mode, Options > & | scale (const MatrixBase< OtherDerived > &other) |
| Applies on the right the non uniform scale transformation represented by the vector other to *this and returns a reference to *this . More...
|
|
template<typename OtherDerived > |
Transform< Scalar, Dim, Mode, Options > & | prescale (const MatrixBase< OtherDerived > &other) |
| Applies on the left the non uniform scale transformation represented by the vector other to *this and returns a reference to *this . More...
|
|
template<typename OtherDerived > |
Transform< Scalar, Dim, Mode, Options > & | translate (const MatrixBase< OtherDerived > &other) |
| Applies on the right the translation matrix represented by the vector other to *this and returns a reference to *this . More...
|
|
template<typename OtherDerived > |
Transform< Scalar, Dim, Mode, Options > & | pretranslate (const MatrixBase< OtherDerived > &other) |
| Applies on the left the translation matrix represented by the vector other to *this and returns a reference to *this . More...
|
|
template<typename RotationType > |
Transform< Scalar, Dim, Mode, Options > & | rotate (const RotationType &rotation) |
| Applies on the right the rotation represented by the rotation rotation to *this and returns a reference to *this . More...
|
|
template<typename RotationType > |
Transform< Scalar, Dim, Mode, Options > & | prerotate (const RotationType &rotation) |
| Applies on the left the rotation represented by the rotation rotation to *this and returns a reference to *this . More...
|
|
template<typename Derived > |
Transform< Scalar, Dim, Mode, Options > & | operator= (const RotationBase< Derived, Dim > &r) |
|
template<typename Derived> |
Transform< Scalar, Dim, Mode, Options > | operator* (const RotationBase< Derived, Dim > &r) const |
|
template<typename PositionDerived , typename OrientationType , typename ScaleDerived > |
Transform< Scalar, Dim, Mode, Options > & | fromPositionOrientationScale (const MatrixBase< PositionDerived > &position, const OrientationType &orientation, const MatrixBase< ScaleDerived > &scale) |
| Convenient method to set *this from a position, orientation and scale of a 3D object.
|
|
template<typename _Scalar, int _Dim>
class Eigen::Transform< _Scalar, _Dim >
Represents an homogeneous transformation in a N dimensional space
- Parameters
-
_Scalar | the scalar type, i.e., the type of the coefficients |
_Dim | the dimension of the space |
The homography is internally represented and stored as a (Dim+1)^2 matrix which is available through the matrix() method.
Conversion methods from/to Qt's QMatrix and QTransform are available if the preprocessor token EIGEN_QT_SUPPORT is defined.
- See also
- class Matrix, class Quaternion
Represents an homogeneous transformation in a N dimensional space
- Template Parameters
-
_Scalar | the scalar type, i.e., the type of the coefficients |
_Dim | the dimension of the space |
_Mode | the type of the transformation. Can be:
- Affine: the transformation is stored as a (Dim+1)^2 matrix, where the last row is assumed to be [0 ... 0 1].
- AffineCompact: the transformation is stored as a (Dim)x(Dim+1) matrix.
- Projective: the transformation is stored as a (Dim+1)^2 matrix without any assumption.
|
_Options | has the same meaning as in class Matrix. It allows to specify DontAlign and/or RowMajor. These Options are passed directly to the underlying matrix type. |
The homography is internally represented and stored by a matrix which is available through the matrix() method. To understand the behavior of this class you have to think a Transform object as its internal matrix representation. The chosen convention is right multiply:
Therefore, an affine transformation matrix M is shaped like this:
\( \left( \begin{array}{cc} linear & translation\\ 0 ... 0 & 1 \end{array} \right) \)
Note that for a projective transformation the last row can be anything, and then the interpretation of different parts might be sightly different.
However, unlike a plain matrix, the Transform class provides many features simplifying both its assembly and usage. In particular, it can be composed with any other transformations (Transform,Translation,RotationBase,DiagonalMatrix) and can be directly used to transform implicit homogeneous vectors. All these operations are handled via the operator*. For the composition of transformations, its principle consists to first convert the right/left hand sides of the product to a compatible (Dim+1)^2 matrix and then perform a pure matrix product. Of course, internally, operator* tries to perform the minimal number of operations according to the nature of each terms. Likewise, when applying the transform to points, the latters are automatically promoted to homogeneous vectors before doing the matrix product. The conventions to homogeneous representations are performed as follow:
Translation t (Dim)x(1): \( \left( \begin{array}{cc} I & t \\ 0\,...\,0 & 1 \end{array} \right) \)
Rotation R (Dim)x(Dim): \( \left( \begin{array}{cc} R & 0\\ 0\,...\,0 & 1 \end{array} \right) \)
Scaling DiagonalMatrix S (Dim)x(Dim): \( \left( \begin{array}{cc} S & 0\\ 0\,...\,0 & 1 \end{array} \right) \)
Column point v (Dim)x(1): \( \left( \begin{array}{c} v\\ 1 \end{array} \right) \)
Set of column points V1...Vn (Dim)x(n): \( \left( \begin{array}{ccc} v_1 & ... & v_n\\ 1 & ... & 1 \end{array} \right) \)
The concatenation of a Transform object with any kind of other transformation always returns a Transform object.
A little exception to the "as pure matrix product" rule is the case of the transformation of non homogeneous vectors by an affine transformation. In that case the last matrix row can be ignored, and the product returns non homogeneous vectors.
Since, for instance, a Dim x Dim matrix is interpreted as a linear transformation, it is not possible to directly transform Dim vectors stored in a Dim x Dim matrix. The solution is either to use a Dim x Dynamic matrix or explicitly request a vector transformation by making the vector homogeneous:
m' = T * m.colwise().homogeneous();
Note that there is zero overhead.
Conversion methods from/to Qt's QMatrix and QTransform are available if the preprocessor token EIGEN_QT_SUPPORT is defined.
This class can be extended with the help of the plugin mechanism described on the page Customizing/Extending Eigen by defining the preprocessor symbol EIGEN_TRANSFORM_PLUGIN
.
- See also
- class Matrix, class Quaternion