SE SetScaleMatrix4x4

The SEDRIS Data Representation Model APPENDIX D - Functions SE SetScaleMatrix4x4

extern SE_DRM_Status_Code
SE_SetScaleMatrix4x4
(
	SRM_Matrix_4x4	*	mat_ptr,	(notes)
const	SRM_Vector_3D	*	vec_ptr,	(notes)
	SE_LSR_Transformation_Axis		axis,	(notes)
	SRM_Long_Float		scale_factor	(notes)
);

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

mat_ptr is NULL,
scale_factor is zero, or
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 scale

axis

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

scale_factor

 the scale factor being used; must be non-zero

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 mat_ptr is NULL, scale_factor is zero, or 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