Function Name: Local Transformation

Definition

Computes the transformation matrix needed to transform a canonical LTP space, located at source_coord_ptr, when the specified coordinate conversion/transformation is invoked.

Returns

SE_COORD_SUCCESS - and *dest_3x3_ptr is set to the appropriate values, if valid parameters were passed in.

SE_COORD_INVALID_SRF_PAIR - and *dest_3x3_ptr is left unchanged, if convert_params_ptr was NULL.

SE_COORD_INVALID_SOURCE_COORD - and *dest_3x3_ptr is left unchanged, if if source_coord_ptr is NULL and is required.

SE_COORD_INVALID_DEST_MATRIX - and *dest_3x3_ptr is left unchanged, if dest_3x3_ptr is NULL.

SE_COORD_FAILURE - and *dest_3x3_ptr is left unchanged, if an error condition not covered by the above occurred.

Prototype


extern SE_COORD_STATUS_CODE_ENUM
SRM_LocalTransformation
(
constSE_CONVERT_COORD_SYSTEM_PAIR convert_params_ptr, (notes)
constSE_COORD *source_coord_ptr, (notes)
SE_MATRIX_3X3_TYPE *dest_3x3_ptr (notes)
);

Parameters Notes

convert_params_ptr

 the spatial reference frame (SRF) parameters of the source and
 destination SRFs

source_coord_ptr

 "origin" of the canonical LTP space to be transformed

dest_3x3_ptr

 a pointer to where the resulting transformation matrix will be stored
Prev: HLS to RGB. Next: Matrix 3X3 Add. Up:Index.