Cartesian Transformation

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) and m_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 and m_sYVector members are not perpendicular or if they are not unit vectors, the data is invalid.

Returns

A3D_SUCCESS on success, or an error code on failure

Topics

Structures

Functions