Converts point coordinates from source coordinate system to destination.
int
ade_projptforward(
ads_point pt,
ads_point result);
Returns RTNORM or an error code.
| pt | Source point to convert, a set of 2D or 3D coordinate values. If 3D, the Z value is ignored. |
| result | Corresponding destination values. |
Before you can use ade_projptforward to convert points, you must first identify the coordinate systems that you are converting between. Use ade_projsetsrc to set the source system and ade_projsetdest to set the destination system. The ade_projptforward function assumes that the coordinate values you pass to it belong to the source system, and it returns corresponding destination values. The ade_projptbackward function does the inverse.
The following example prompts the user for a source point and passes the corresponding destination coordinates through the result parameter.
ads_point pt1; ads_point result; ads_getpoint (NULL, "Pick a point", pt1); ade_projptforward (pt1, result);
For more information, see Converting Coordinates.