The SEDRIS Data Representation Model
APPENDIX D - Functions
SE SetScaleMatrix4x4
extern SE_DRM_Status_Code
SE_SetScaleMatrix4x4
(
SRM_Matrix_4x4 mat_ptr,1
constSRM_Vector_3D vec_ptr,2
SE_LSR_Transformation_Axis axis,3
SRM_Long_Float scale_factor4
);

Definition

Sets *mat_ptr to a scale matrix for the given scale factor 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,
  2. scale_factor is zero, or
  3. axis == SE_LSR_Transformation_AxisSE_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 (U, V, or W).

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 scale

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

4 the scale factor being used; must be non-zero

Prev: SE_SetScaleMatrix3x3. Next: SE_SetString. Up:Index.

Last updated: July 26, 2006 Copyright © 2006 SEDRIS™