SRM Reference Manual
Functions
SRM LocalTransformation
extern SRM_Status_Code
SRM_LocalTransformation
(
constSRM_SRF_Parameters_Pair convert_params_ptr, (notes)
constSRM_Coordinate *source_coord_ptr, (notes)
SRM_Matrix_3x3 *dest_3x3_ptr (notes)
);

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

SRM_STAT_CODE_SUCCESS and *dest_3x3_ptr is set to the appropriate values, if valid parameters were passed in.
SRM_STAT_CODE_INVALID_SRF_PAIR and *dest_3x3_ptr is left unchanged, if convert_params_ptr was NULL.
SRM_STAT_CODE_INVALID_SOURCE_COORD and *dest_3x3_ptr is left unchanged, if source_coord_ptr is NULL and is required.
SRM_STAT_CODE_INVALID_DEST_MATRIX and *dest_3x3_ptr is left unchanged, if dest_3x3_ptr is NULL.
SRM_STAT_CODE_FAILURE and *dest_3x3_ptr is left unchanged, if an error condition not covered by the above occurred.


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: SRM_GetWGS84GeoidalSeparation. Next: SRM_Matrix3x3Add. Up:Index.

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