|
SRM Reference Manual
Functions SRM CreateGCSOldNewParameters |
|---|
| extern SRM_Status_Code | ||||
| SRM_CreateGCSOldNewParameters | ||||
| ( | ||||
| const | SRM_SRF_Parameters | * | source_SRF_params_ptr, | (notes) |
| const | SRM_SRF_Parameters | * | dest_SRF_params_ptr, | (notes) |
| SRM_SRF_Parameters_Pair | * | coord_op_params_ptr | (notes) | |
| ); | ||||
This function interprets the GCS parameter structure in *source_SRF_params_ptr as an "oldstyle" GCS parameter set, and initializes *coord_op_params_ptr so that it can be passed to SRM_ChangeCoordinateSRF() to convert to a new style GCS coordinate, as specified by *dest_SRF_params_ptr.
If passed a Celestiodetic (GC) parameters set, then it will return GC.
| SRM_STAT_CODE_SUCCESS | and *coord_op_params_ptr is set appropriately, if valid parameters were passed in and all operations succeeded. |
| SRM_STAT_CODE_INVALID_SOURCE_SRF_PARAMETERS | and no changes are made, if source_SRF_params_ptr is NULL or *source_SRF_params_ptr is not a valid old-style GCS SRF. |
| SRM_STAT_CODE_INVALID_DEST_SRF_PARAMETERS | and no changes are made, if dest_SRF_params_ptr is NULL or is not a valid GCS SRF. |
| SRM_STAT_CODE_FAILURE | and *coord_op_params_ptr is set to NULL, if memory allocation failed. |
old-style GCS SRF to convert
GCS SRF target
result
Prev: SRM_CoordinateEqual.
Next: SRM_CreateSRFParametersPair.
Up:Index.
|