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

SRM_STAT_CODE_SUCCESS	and *dest_3x3_ptr is set to appropriately, if valid parameters were passed in.
SRM_STAT_CODE_INVALID_SRF_PAIR	and no changes are made, if convert_params_ptr was NULL.
SRM_STAT_CODE_INVALID_SOURCE_MATRIX	and no changes are made, if source_3x3_ptr was NULL.
SRM_STAT_CODE_INVALID_SOURCE_COORD	and no changes are made, if source_coord_ptr is NULL and is required.
SRM_STAT_CODE_INVALID_DEST_MATRIX	and no changes are made, if dest_3x3_ptr is NULL.

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: SRM_ConvergenceOfMeridian. Next: SRM_ConvertVector3D. Up:Index.

Last updated: May 15, 2003 Copyright © 2003 SEDRIS™