In general, a vector in a projected coordinate system must be rotated to
account for the fact that meridians in such spatial reference frames are
curved, and usually do not align with true north. More precisely, the
rotation angle for transforming vectors must be determined. This angle
is called the Convergence Of The Meridian (COM) in Geodesy.
SE_COORD_INVALID_SRF_PAIR - if convert_params_ptr was NULL.
SE_COORD_INVALID_SOURCE_COORD - if source_coord_ptr is NULL and is required
SE_COORD_INVALID_DEST_COSINE_GAMMA -- if dest_cosine_gamma is NULL
SE_COORD_INVALID_DEST_SINE_GAMMA -- if dest_sine_gamma is NULL
_COORD_FAILURE - if an error condition not covered by the above occurred.
| extern SE_COORD_STATUS_CODE_ENUM | ||||
| SRM_ConvergenceOfMeridian | ||||
| ( | ||||
| const | SE_CONVERT_COORD_SYSTEM_PAIR | convert_params_ptr, | (notes) | |
| const | SE_COORD | * | source_coord_ptr, | |
| SE_FLOAT64 | * | dest_cosine_gamma, | (notes) | |
| SE_FLOAT64 | * | dest_sine_gamma | (notes) | |
| ); | ||||
the spatial reference frame (SRF) parameters of the source and destination SRFs
a pointer to where the cosine of gamma will be stored
a pointer to where the sine of gamma will be stored