|
SRM Reference Manual
Functions SRM NaturalRegion |
|---|
| extern SRM_Status_Code | |||
| SRM_NaturalRegion | |||
| ( | |||
| SRM_SRF | cd_srf, | (notes) | |
| SRM_Coordinate | cd_coord, | (notes) | |
| SRM_SRF | dest_srf, | (notes) | |
| SRM_Integer | * | dest_region_out_ptr | (notes) |
| ); | |||
Given a CD SRF, a coordinate defined in that SRF, and a target SRF determines the 'natural region' of that coordinate.
The current implementation supports only geodetic (GD) source and GCS destination coordinates. The current version of this function supports only cell id mappings that require no horizontal datum transforms.
| SRM_STAT_CODE_SUCCESS | and *dest_SRF_params_ptr is set to the 'natural region' of *source_coord_ptr in the target SRF, if valid parameters were passed in. |
| SRM_STAT_CODE_INVALID_SOURCE_SRF | and no changes are made, if
|
| SRM_STAT_CODE_INVALID_SOURCE_COORDINATE | and no changes are made, if source_coord_ptr is NULL, or if *source_coord_ptr is not a valid GD coordinate. |
| SRM_STAT_CODE_INVALID_TARGET_SRF | and no changes are made, if dest_SRF_params_ptr is NULL. |
The Celestiodeteic SRF
The Celestiodetic coordinate
The destination SRF
The Set Member code of the region where the coordinate resides
Prev: SRM_Matrix4x4Sub.
Next: SRM_PrintAZ2DCoordinate.
Up:Index.
|