Measures the geodetic distance between two points.
int
ade_projwsgeodistance(
ads_point pt1,
ads_point pt2,
ads_real* pdDistance,
char** ppchDistUnits,
int nDistUnitsBuffSize,
ads_real* pdAzimuthForward,
ads_real* ppdAzimuthReverse);
Returns RTNORM if successful.
Returns RTERROR if failed.
Returns ADEMEMERROR if memory allocation failed.
Returns ADEINVERROR if acedInvoke() failed.
| pt1 | Input first point. |
| pt2 | Input second point. |
| pdDistance | Output calculated geodetic distance between the points. |
| ppchDistUnits | Output name of the distance units used in calculations. This argument is a pointer to the buffer (char**). If the buffer was not allocated, call this function with *ppchDistUnits = NULL. This function will allocate the needed buffer, and caller must free the memory that *ppchDistUnits points to. The returned display units depend on the AutoCAD Map menu setting: Map > Options > Coordinate Systems > Geodetic Distance > Units For Display. |
| nDistUnitsBuffSize | Input size of the buffer to use to copy the name of the units if *ppchDistUnits != NULL and memory was allocated when function is called. |
| pdAzimuthForward | Output angle, expressed in radians east of north, of the line from the first point to the second point, measured at the first point. |
| ppdAzimuthReverse | Output angle, expressed in radians east of north, of the line from the second point to the first point, measured at the second point. |