REQUEST VALUATOR
CALL SEQUENCE
void preq_val(
Pint ws_id, /* workstation identifier */
Pint valuator_dev, /* valuator device number */
Pin_status *status, /* (out) input status */
Pfloat *value /* (out) valuator value */
)
TYPES
typedef enum {
PIN_STATUS_NONE,
PIN_STATUS_OK,
PIN_STATUS_NO_IN
} Pin_status;
PHIGS STATE
(PHOP, WSOP, *, *).
EFFECT
Request a real number by user action on the left mouse button of the active
input device valuator_dev with the possibility of cancelling the input
by clicking on the right button of the mouse.
Example:
/* Request valuator on workstation number 1 using device number 21 */
Pint ws_id,val_dev;
Pin_status status;
Pfloat value;
.....
ws_id = 1;
val_dev = 21;
preq_val(ws_id,val_dev,&status,&value);
......
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 valuator mode, initialize valuator 3, sample valuator, get valuator, await
event, inquire valuator device state 3, inquire default valuator device state 3