|
SRM Reference Manual
Functions SRM ChangeCoordinateSRFUnvalidated |
|---|
| extern SRM_Status_Code | ||||
| SRM_ChangeCoordinateSRFUnvalidated | ||||
| ( | ||||
| const | SRM_SRF_Parameters_Pair | coord_op_params_ptr, | (notes) | |
| const | SRM_Coordinate | * | source_coord_ptr, | (notes) |
| SRM_Coordinate | * | dest_coord_ptr | (notes) | |
| ); | ||||
This performs the same conversion as SRM_ChangeCoordinateSRF() but skips boundary checks for use with trusted data in order to achieve increased speed. As a result, operations may be "successfully" performed on invalid coordinates, or result in invalid coordinates.
| SRM_STAT_CODE_SUCCESS | and *dest_coord_ptr is set to the appropriate operation result, if the coordinate operation succeeded. |
| SRM_STAT_CODE_UNSUPPORTED | and *dest_coord_ptr is left unchanged, if the coordinate operation (conversion and/or transformation) is unsupported. |
| SRM_STAT_CODE_INVALID_SRF_PAIR | and *dest_coord_ptr is left unchanged, if coord_op_params_ptr was NULL or invalid. |
| SRM_STAT_CODE_INVALID_SOURCE_COORD | and *dest_coord_ptr is left unchanged, if source_coord_ptr is NULL. |
| SRM_STAT_CODE_INVALID_DEST_COORD | and *dest_coord_ptr is left unchanged, if dest_coord_ptr is NULL. |
| SRM_STAT_CODE_FAILURE | and *dest_coord_ptr is left unchanged, if the coordinate operation failed for reasons unspecified. |
a pointer to the optimized coordinate operations
parameters
a pointer to the incoming coordinate, the coordinate
to convert
a pointer to where the converted coordinate will be
stored. This can be the same location that source_coord_ptr
points to, but it does not have to be.
Prev: SRM_ChangeCoordinateSRF.
Next: SRM_ConvergenceOfMeridian.
Up:Index.
|