c_digpt - Retrieves a map coordinate from a digitizer

SYNTAX

FUNCTION c_digpt (yx, flag)

     double             *yx;
     long               *flag;

PARAMETERS

yx (output, double)

The map coordinate of the point sparked on the digitizer. This field is a double dimensioned to two, which is compatible with the fields in the tie point files. The Y coordinate is in the first array element, followed by the X coordinate in the second array element.

flag (input, long)

A boolean flag. A TRUE value instructs c_digpt() to issue the following prompt:

      Spark map point (1) to select, (2) new map, (3) to quit >
and a FALSE value instructs c_digpt() to issue:

      Spark map point (1) to select, (3) to abort >

DESCRIPTION

The c_digpt() call is used to get a map coordinate from the digitizer. The map must have been previously registered to the digitizer using the c_regmap() call. The digitizer-to-map fit parameters are stored in a common area and are accessible by c_digpt() and are transparent to the calling routine.

RETURN VALUE

c_digpt() returns the number of the button pushed on the digitizer puck.

SPECIAL CONSIDERATIONS:

The c_digpt() call is for C only.