The SEDRIS Data Representation Model
APPENDIX D - Functions
SE SetTranslateMatrix4x4
extern SE_DRM_Status_Code
SE_SetTranslateMatrix4x4
(
SRM_Matrix_4x4  mat_ptr,1
const SRM_Vector_3D  vec_ptr,2
SE_LSR_Transformation_Axis  axis,3
SRM_Long_Float  translation_amount4
);

Definition

Sets *mat_ptr to a translate matrix for the given translation amount for the given axis.


Returns

SE_DRM_STAT_CODE_SUCCESS and *mat_ptr is set appropriately, if valid parameters were passed in.
SE_DRM_STAT_CODE_NULL_REQUIRED_PARAMETER and no changes are made, if
  1. mat_ptr is NULL, or
  2. axis == SE_LSRAXIS_AXIS_REFERENCE_VECTOR and vec_ptr is NULL
SE_DRM_STAT_CODE_FAILURE and no changes are made, if axis is not a valid, single axis (X, Y, or Z)
$$$ SE_LSRAXIS_AXIS_REFERENCE_VECTOR is not yet supported

Parameters Notes

1 pointer to the matrix to be set

2 if axis == SE_LSRAXIS_AXIS_REFERENCE_VECTOR, this vector is used to specify the axis of translation

3 identifies the axis (or axes) along which we're translating

4 the distance we're translating


Prev: SE_SetTranslateMatrix3x3. Next: SE_SetURL. Up:Index.