Cartesian Transformation
Parent module: Transformations Module
- group a3d_cartesiantransfo3d
Functions and structures for defining combinations of transformations (without the use of a matrix)
Entity type is kA3DTypeMiscCartesianTransformation.
This entity describes combinations of transformations such as relocation to a new 3D Cartesian coordinate system, scaling, and rotation. The A3DMiscCartesianTransformationData structure provides parameters for the transformation. The behaviour mask specified by the A3DMiscCartesianTransformationData::m_ucBehaviour member specifies the transformations that apply. Those transformations must be consistent with the actual data provided in other fields as described here:
If the
m_sOrigin
member is null vector, translation is disabled.If the
m_sXVector
member is (1,0,0) andm_sYVector
member is (0,1,0), rotation is disabled.If the
m_sScale
member is (1,1,1), scaling is disabled.If the
m_sXVector
andm_sYVector
members are not perpendicular or if they are not unit vectors, the data is invalid.
- Sample code
A3DMiscCartesianTransformationData sData; A3D_INITIALIZE_DATA(sData); A3DUns32 iErr=A3DMiscCartesianTransformationGet(pCsys, &sData); if (iErr==A3D_SUCCESS) { /* Insert here your own code to parse through members of CartesianTransformation3d */ iErr = A3DMiscCartesianTransformationGet( NULL, &sData ); }
- Version
2.3
Warning
Some particular formats do not support Cartesian transformations directly, but define general ones instead. When possible, the associated readers try to make cartesian tranformations out of them, setting this Behaviour flag. In all cases, except for Mirror, direct use of transformation members is valid, where behavior is just informational.
Sub-modules
Bitmasks that can be OR’d together to specify the transformation behavior. |
Data Structures
Structure for defining an A3DMiscCartesianTransformation entity. |
Functions
Populates the A3DMiscCartesianTransformationData structure. |
|
Creates an A3DMiscCartesianTransformation from an A3DMiscCartesianTransformationData structure. |