Ask the user to specify an orientation.
This function pauses to get an angle from the user. You may prompt the user to specify an angle, either numerically, or by picking points.
This function measures the angle relative to a horizontal line extending to the right. The current value of the ANGBASE system variable has no effect on sds_getorient.
The argument point is the starting point, which may be null. If null, the user enters the angle itself, using the current units for angles. If given a starting point (point), the user picks another point to define a rubber-band line, and sds_getorient determines the counter-clockwise angle between a horizontal line and the rubber-band line.
The argument prompt represents a command-line prompt requesting that the user specify or pick an angle. This argument may be null.
The answer argument represents the angle specified by the user, counter-clockwise from the zero direction, expressed in radians (regardless of the current units for angles).
This function returns one of the following: RTCAN, RTERROR, RTKWORD, RTNONE, or RTNORM.
Example
sds_real *real1;
sds_point point1;
sds_getpoint(NULL,"\nFirst point: ",point1);
sds_getorient(point1,"\nSecond point: ",&real1);
sds_printf("\nThe angle is %f radians. ",real1);
Tell me about...
Programming Overview of SDS™ (Solutions Development System™)