REQUEST VALUATOR
CALL SEQUENCE
void preq_val (ws_id, valuator_dev, status, value)
INPUT PARAMETERS
Pint ws_id,
Pint valuator_dev,
OUTPUT PARAMETERS
Pin_status *status,
Pfloat *value
ARGUMENTS
- ws_id,
- Workstation identifier
- valuator_dev,
- Valuator device number
- status,
- Input status
- value
- 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