Function Name: Convert Matrix 3x3

Definition

Assumptions:

  1. A 3x3 matrix (pointed to by source_3x3_ptr) exists in a spatial spatial frame SRF1.
  2. There is a location, source_coord, in SRF1, associated with *source_3x3_ptr as the "origin" of the matrix.

The caller wishes to convert the source matrix from SRF1 into a different spatial reference frame SRF2, where the transformation from SRF1 to SRF2 is specified by convert_params_ptr.

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 - if convert_params_ptr was NULL.

SE_COORD_INVALID_SOURCE_MATRIX - if source_3x3_ptr is NULL

SE_COORD_INVALID_SOURCE_COORD - if source_coord_ptr is NULL and is required

SE_COORD_INVALID_DEST_MATRIX - if dest_3x3_ptr is NULL

SE_COORD_FAILURE - an unspecified error condition occurred

Prototype


extern SE_COORD_STATUS_CODE_ENUM
SRM_ConvertMatrix3x3
(
constSE_CONVERT_COORD_SYSTEM_PAIR convert_params_ptr, (notes)
constSE_COORD *source_coord_ptr, (notes)
constSE_MATRIX_3X3_TYPE *source_3x3_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

 the "origin" of the source matrix

source_3x3_ptr

 a pointer to the incoming matrix, which is to be converted

dest_3x3_ptr

 a pointer to where the converted matrix will be stored.  This
 can be the same location that source_3x3_ptr points to, but it
 does not have to be.
Prev: Convert Feet To Meters. Next: Convert Meters To Feet. Up:Index.