The SEDRIS Data Representation Model
APPENDIX D - Functions
SE SetRotateMatrix3x3
extern SE_DRM_Status_Code
SE_SetRotateMatrix3x3
(
SRM_Matrix_3x3 *mat_ptr, (notes)
constSRM_Vector_3D *vec_ptr, (notes)
SE_LSR_Transformation_Axis axis, (notes)
SRM_Long_Float theta_in_radians (notes)
);

Definition

Sets *mat_ptr to a rotation matrix for the given angle of rotation 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_LSR_TRNSFRM_AXIS_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_LSR_TRNSFRM_AXIS_AXIS_REFERENCE_VECTOR is not yet supported

Parameters Notes


mat_ptr

 pointer to the matrix to be set

vec_ptr

 if axis == SE_LSR_TRNSFRM_AXIS_AXIS_REFERENCE_VECTOR,
    this vector is used to specify the axis of rotation

axis

 identifies the axis around which we're rotating

theta_in_radians

 the angle of rotation, in radians

Prev: SE_SetOutFilePtr. Next: SE_SetRotateMatrix4x4. Up:Index.

Last updated: July 16, 2004 Copyright © 2004 SEDRIS™