REQUEST LOCATOR
CALL SEQUENCE
void preq_loc(
Pint ws_id, /* workstation identifier */
Pint loc_dev, /* locator device number */
Pin_status *status, /* (out) input status */
Pint *view_index, /* (out) view index */
Ppoint *loc_pos /* (out) locator position */
)
TYPES
typedef enum {
PIN_STATUS_NONE,
PIN_STATUS_OK,
PIN_STATUS_NO_IN
} Pin_status;
typedef struct {
Pfloat x; /* x coordinate */
Pfloat y; /* y coordinate */
} Ppoint;
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
Request the 2D position of the graphic cursor in WC space by user action on the
left mouse button of the active input device loc_dev with the
possibility of cancelling the input by clicking on the right button of the
mouse.
The request state is thus attributed the OK or NONE (break) state.
ERRORS
- 3
Ignoring function, function requires state (PHOP, WSOP,*,*)
- 54
- Ignoring function, the specified workstation is not open
- 61
- Ignoring function, specified workstation is neither of category INPUT nor
of category OUTIN
- 250
- Ignoring function, the specified device is not available on the specified
workstation
- 251
- Ignoring function, the function requires the input device to be in REQUEST
mode
SEE ALSO
set locator mode, request locator 3, initialize locator, sample locator, get
locator, await event, inquire locator device state, inquire default locator
device state, locator without interaction (ext)