CFx SDK Documentation
2022 SP0
|
#include <GeMatrix3d.h>
Public Attributes | |
double | entry [4][4] |
Static Public Attributes | |
static GE_STATIC_EXPORT const OdGeMatrix3d | kIdentity |
This class represents 3D transformation matrices that define affine ( translation, rotation, and/or scaling ) transformations.
An OdGeMatrix3d, M, can be expressed as a 4 4 matrix*, in the form
a00 a01 a02 t0 a10 a11 a12 t1 a20 a21 a22 t2 0 0 0 1
The linear part of M is the matrix
a00 a01 a02 a10 a11 a12 a20 a21 a22
The translational part of M is the column
t0 t1 t2
The origin of the coordinate system of M is (t0, t1, t2).
Corresponding C++ library: TD_Ge
<group OdGe_Classes>
Definition at line 72 of file GeMatrix3d.h.
OdGeMatrix3d::OdGeMatrix3d | ( | ) |
|
static |
Returns the matrix which maps the coordinate system defined by fromOrigin, fromXAxis, fromYAxis, and fromZAxis, to the coordinate system defined by toOrigin, toXAxis, toYAxis, and toZAxis.
fromOrigin | [in] Origin of the initial coordinate system. |
fromXAxis | [in] X-axis of the initial coordinate system. |
fromYAxis | [in] Y-axis of the initial coordinate system. |
fromZAxis | [in] Z-axis of the initial coordinate system. |
toOrigin | [in] Origin of the initial coordinate system. |
toXAxis | [in] X-axis of the initial coordinate system. |
toYAxis | [in] Y-axis of the initial coordinate system. |
toZAxis | [in] Z-axis of the initial coordinate system. |
OdGeMatrix2d OdGeMatrix3d::convertToLocal | ( | OdGeVector3d & | normal, |
double & | elevation | ||
) | const |
Transforms the plane specified by a normal and an elevation.
normal | [in/out] Normal to the plane. |
elevation | [in/out] Elevation of the plane. |
double OdGeMatrix3d::det | ( | ) | const |
Returns the determinant of this matrix.
void OdGeMatrix3d::getCoordSystem | ( | OdGePoint3d & | origin, |
OdGeVector3d & | xAxis, | ||
OdGeVector3d & | yAxis, | ||
OdGeVector3d & | zAxis | ||
) | const |
Returns the origin, X-axis, Y-axis, and Z-axis of the coordinate system to which this matrix maps the WCS.
origin | [out] Receives the origin of the coordinate system. |
xAxis | [out] Receives the X-axis of the coordinate system. |
yAxis | [out] Receives the Y-axis of the coordinate system. |
zAxis | [out] Receives the Z-axis of the coordinate system. |
OdGePoint3d OdGeMatrix3d::getCsOrigin | ( | ) | const |
Returns the origin of the coordinate system to which this matrix maps the WCS.
OdGeVector3d OdGeMatrix3d::getCsXAxis | ( | ) | const |
Returns the X-axis of the coordinate system to which this matrix maps the WCS.
OdGeVector3d OdGeMatrix3d::getCsYAxis | ( | ) | const |
Returns the Y-axis of the coordinate system to which this matrix maps the WCS.
OdGeVector3d OdGeMatrix3d::getCsZAxis | ( | ) | const |
Returns the Z-axis of the coordinate system to which this matrix maps the WCS.
OdGeMatrix3d OdGeMatrix3d::inverse | ( | ) | const |
OdGeMatrix3d OdGeMatrix3d::inverse | ( | const OdGeTol & | tol | ) | const |
bool OdGeMatrix3d::inverse | ( | OdGeMatrix3d & | inverseMatrix, |
double | tol | ||
) | const |
Returns true if and only if this matrix has an inverse, and the inverse of this matrix.
inverseMatrix | [out] Receives the inverse matrix. |
tol | [in] Geometric tolerance. |
OdGeMatrix3d& OdGeMatrix3d::invert | ( | ) |
Sets this matrix to its inverse, and returns a reference to this matrix.
bool OdGeMatrix3d::isEqualTo | ( | const OdGeMatrix3d & | matrix, |
const OdGeTol & | tol = OdGeContext::gTol |
||
) | const |
Returns true if and only if matrix is identical to this one, within the specified tolerance.
matrix | [in] Matrix to be compared. |
tol | [in] Geomentric tolerance. |
bool OdGeMatrix3d::isPerspective | ( | const OdGeTol & | tol = OdGeContext::gTol | ) | const |
DOM
bool OdGeMatrix3d::isScaledOrtho | ( | const OdGeTol & | tol = OdGeContext::gTol | ) | const |
Returns true if and only the column vectors of the linear part of this matrix are mutually perpendicular within the specified tolerance.
tol | [in] Geomentric tolerance. |
bool OdGeMatrix3d::isSingular | ( | const OdGeTol & | tol = OdGeContext::gTol | ) | const |
Returns true if and only if this matrix is singular.
bool OdGeMatrix3d::isUniScaledOrtho | ( | const OdGeTol & | tol = OdGeContext::gTol | ) | const |
Returns true if and only the columns vectors of the linear part of this matrix are of equal length and mutually perpendicular within the specified tolerance.
tol | [in] Geomentric tolerance. |
|
static |
Sets this matrix to the matrix which mirrors about the specified object, and returns a reference to this matrix.
mirrorLine | [in] Mirror line entity. |
|
static |
Sets this matrix to the matrix which mirrors about the specified object, and returns a reference to this matrix.
mirrorPlane | [in] Mirror plane. |
|
static |
Sets this matrix to the matrix which mirrors about the specified object, and returns a reference to this matrix.
mirrorPoint | [in] Mirror point. |
double OdGeMatrix3d::norm | ( | ) | const |
Returns the largest absolute value of the linear part of this matrix.
bool OdGeMatrix3d::operator!= | ( | const OdGeMatrix3d & | matrix | ) | const |
Inequality operator.
|
inline |
Definition at line 695 of file GeMatrix3d.h.
|
inline |
Returns or references entry[row][column] as matrix(row,column).
row | [in] Row. |
column | [in] Column. |
Definition at line 690 of file GeMatrix3d.h.
OdGeMatrix3d OdGeMatrix3d::operator* | ( | const OdGeMatrix3d & | matrix | ) | const |
Returns the product (this matrix) * matrix.
OdGeMatrix3d& OdGeMatrix3d::operator*= | ( | const OdGeMatrix3d & | matrix | ) |
Sets this matrix to the product (this matrix) * matrix, and returns a reference to this matrix.
bool OdGeMatrix3d::operator== | ( | const OdGeMatrix3d & | matrix | ) | const |
Equality operator.
|
inline |
Definition at line 685 of file GeMatrix3d.h.
|
inline |
Returns or references entry[row] as matrix[row].
row | [in] Row. |
Definition at line 680 of file GeMatrix3d.h.
|
static |
Returns the matrix which maps the plane coordinate system to the WCS.
plane | [in] The plane. |
|
static |
Returns the matrix which maps the plane coordinate system to the WCS.
normal | [in] The normal to the plane. |
OdGeMatrix3d& OdGeMatrix3d::postMultBy | ( | const OdGeMatrix3d & | rightSide | ) |
Sets this matrix to the product (this matrix) * rightSide, and returns a reference to this matrix.
rightSide | [in] Any 2D matrix |
OdGeMatrix3d& OdGeMatrix3d::preMultBy | ( | const OdGeMatrix3d & | leftSide | ) |
Sets this matrix to the product leftSide * (this matrix), and returns a reference to this matrix.
leftSide | [in] Any 2D matrix |
|
static |
Returns the matrix which parallel projects onto the specified plane in the specified direction.
projectionPlane | [in] Projection plane. |
projectDir | [in] Projection direction. |
|
static |
Returns the matrix which rotates by angle about an axis passing through center, and returns a reference to this matrix.
angle | [in] Rotation angle. |
axis | [in] Rotation axis. |
center | [in] Center of rotation. |
double OdGeMatrix3d::scale | ( | ) | const |
Returns the scale factor of this matrix.
|
static |
Returns the matrix which scales by scale about center, and returns a reference to this matrix.
scale | [in] Scale factor. |
center | [in] Center of scaling. |
|
static |
Returns the matrix which scales by scale about center, and returns a reference to this matrix.
scale | [in] Scale factor. |
center | [in] Center of scaling. |
OdGeMatrix3d& OdGeMatrix3d::setCoordSystem | ( | const OdGePoint3d & | origin, |
const OdGeVector3d & | xAxis, | ||
const OdGeVector3d & | yAxis, | ||
const OdGeVector3d & | zAxis | ||
) |
Sets this matrix to the matrix which maps the WCS to the coordinate system defined by origin, X-axis, Y-axis, and Z-axis, and returns a reference to this matrix.
origin | [in] Origin of the coordinate system. |
xAxis | [in] X-axis of the coordinate system. |
yAxis | [in] Y-axis of the coordinate system. |
zAxis | [in] Z-axis of the coordinate system. |
OdGeMatrix3d& OdGeMatrix3d::setToAlignCoordSys | ( | const OdGePoint3d & | fromOrigin, |
const OdGeVector3d & | fromXAxis, | ||
const OdGeVector3d & | fromYAxis, | ||
const OdGeVector3d & | fromZAxis, | ||
const OdGePoint3d & | toOrigin, | ||
const OdGeVector3d & | toXAxis, | ||
const OdGeVector3d & | toYAxis, | ||
const OdGeVector3d & | toZAxis | ||
) |
Sets this matrix to the matrix which maps the coordinate system defined by fromOrigin, fromXAxis, fromYAxis, and fromZAxis, to the coordinate system defined by toOrigin, toXAxis, toYAxis, and toZAxis, and returns a reference to this matrix.
fromOrigin | [in] Origin of the initial coordinate system. |
fromXAxis | [in] X-axis of the initial coordinate system. |
fromYAxis | [in] Y-axis of the initial coordinate system. |
fromZAxis | [in] Z-axis of the initial coordinate system. |
toOrigin | [in] Origin of the initial coordinate system. |
toXAxis | [in] X-axis of the initial coordinate system. |
toYAxis | [in] Y-axis of the initial coordinate system. |
toZAxis | [in] Z-axis of the initial coordinate system. |
OdGeMatrix3d& OdGeMatrix3d::setToIdentity | ( | ) |
Sets this matrix to the identity matrix, and returns a reference to this matrix.
OdGeMatrix3d& OdGeMatrix3d::setToMirroring | ( | const OdGeLine3d & | mirrorLine | ) |
Sets this matrix to the matrix which mirrors about the specified object, and returns a reference to this matrix.
mirrorLine | [in] Mirror line entity. |
OdGeMatrix3d& OdGeMatrix3d::setToMirroring | ( | const OdGePlane & | mirrorPlane | ) |
Sets this matrix to the matrix which mirrors about the specified object, and returns a reference to this matrix.
mirrorPlane | [in] Mirror plane. |
OdGeMatrix3d& OdGeMatrix3d::setToMirroring | ( | const OdGePoint3d & | mirrorPoint | ) |
Sets this matrix to the matrix which mirrors about the specified object, and returns a reference to this matrix.
mirrorPoint | [in] Mirror point. |
OdGeMatrix3d& OdGeMatrix3d::setToPlaneToWorld | ( | const OdGePlane & | plane | ) |
Sets this matrix to the matrix which maps the plane coordinate system to the WCS, and returns a reference to this matrix.
plane | [in] The plane. |
OdGeMatrix3d& OdGeMatrix3d::setToPlaneToWorld | ( | const OdGeVector3d & | normal | ) |
Sets this matrix to the matrix which maps the plane coordinate system to the WCS, and returns a reference to this matrix.
normal | [in] The normal to the plane. |
OdGeMatrix3d& OdGeMatrix3d::setToProduct | ( | const OdGeMatrix3d & | matrix1, |
const OdGeMatrix3d & | matrix2 | ||
) |
Sets this matrix to the product matrix1 * matrix2, and returns a reference to this matrix.
matrix1 | [in] Any 2D matrix |
matrix2 | [in] Any 2D matrix |
OdGeMatrix3d& OdGeMatrix3d::setToProjection | ( | const OdGePlane & | projectionPlane, |
const OdGeVector3d & | projectDir | ||
) |
Sets this matrix to the matrix which parallel projects onto the specified plane in the specified directionm and returns a reference to this matrix.
projectionPlane | [in] Projection plane. |
projectDir | [in] Projection direction. |
OdGeMatrix3d& OdGeMatrix3d::setToRotation | ( | double | angle, |
const OdGeVector3d & | axis, | ||
const OdGePoint3d & | center = OdGePoint3d::kOrigin |
||
) |
Sets this matrix to the matrix which rotates by angle about an axis passing through center, and returns a reference to this matrix.
angle | [in] Rotation angle. |
axis | [in] Rotation axis. |
center | [in] Center of rotation. |
OdGeMatrix3d& OdGeMatrix3d::setToScaling | ( | const OdGeScale3d & | scale, |
const OdGePoint3d & | center = OdGePoint3d::kOrigin |
||
) |
Sets this matrix to the matrix which scales by scale about center, and returns a reference to this matrix.
scale | [in] Scale factor. |
center | [in] Center of scaling. |
OdGeMatrix3d& OdGeMatrix3d::setToScaling | ( | double | scale, |
const OdGePoint3d & | center = OdGePoint3d::kOrigin |
||
) |
Sets this matrix to the matrix which scales by scale about center, and returns a reference to this matrix.
scale | [in] Scale factor. |
center | [in] Center of scaling. |
OdGeMatrix3d& OdGeMatrix3d::setToTranslation | ( | const OdGeVector3d & | vect | ) |
Sets this matrix to the matrix which translates by vect, and returns a reference to this matrix.
vect | [in] Translation vector. |
OdGeMatrix3d& OdGeMatrix3d::setToWorldToPlane | ( | const OdGePlane & | plane | ) |
Sets this matrix to the matrix which maps the WCS to the plane coordinate system, and returns a reference to this matrix.
plane | [in] The plane. |
OdGeMatrix3d& OdGeMatrix3d::setToWorldToPlane | ( | const OdGeVector3d & | normal | ) |
Sets this matrix to the matrix which maps the WCS to the plane coordinate system, and returns a reference to this matrix.
normal | [in] The normal to the plane. |
OdGeMatrix3d& OdGeMatrix3d::setTranslation | ( | const OdGeVector3d & | vect | ) |
Sets the translation part of the matrix to the specified vector.
vect | [in] Translation vector. |
OdGeVector3d OdGeMatrix3d::translation | ( | ) | const |
Returns the translation vector of this matrix.
|
static |
Returns the matrix of the translation by vect.
vect | [in] Translation vector. |
OdGeMatrix3d OdGeMatrix3d::transpose | ( | ) | const |
Returns the transpose of this matrix.
OdGeMatrix3d& OdGeMatrix3d::transposeIt | ( | ) |
Sets this matrix to its transpose, and returns a reference to this matrix.
void OdGeMatrix3d::validateZero | ( | const OdGeTol & | tol = OdGeContext::gTol | ) |
Sets any values within tol of 0 to 0.
|
static |
Returns the matrix which maps the WCS to the plane coordinate system.
plane | [in] The plane. |
|
static |
Returns the matrix which maps the WCS to the plane coordinate system.
normal | [in] The normal to the plane. |
double OdGeMatrix3d::entry[4][4] |
Definition at line 675 of file GeMatrix3d.h.
|
static |
Definition at line 79 of file GeMatrix3d.h.