REQUEST VALUATOR(3P) — SUNPHIGS LIBRARY

NAME

REQUEST VALUATOR − request an operator interaction with a valuator device

SYNOPSIS

C Syntax

void
preqval ( ws, dev, valuator )
Pintws;workstation identifier
Pintdev;valuator device number
Pqval∗valuator;OUT requested valuator data

FORTRAN Syntax

SUBROUTINE prqvl ( WKID, VLDNR, STAT, VAL )
INTEGERWKIDworkstation identifier
INTEGERVLDNRvaluator device number
INTEGERSTATOUT status (PNONE, POK)
REALVALOUT value

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use REQUEST VALUATOR to request an operator interaction with a specified valuator device. The device must be in request mode. See SET VALUATOR MODE and INITIALIZE VALUATOR for more information. See the Available Devices section of INITIALIZE VALUATOR for a description of the available valuator devices.

The request suspends PHIGS until the specified device is triggered, or the operator performs a BREAK. A BREAK is performed by typing the CONTROL and D keys simultaneously (^D).

C Input Parameters

wsWorkstation identifier. An integer specifying the workstation with which the requested valuator device is associated.

devThe device number of the requested valuator device. See the Available Devices section of INITIALIZE VALUATOR for a description of the available valuator devices.

valuator
A pointer to a Pqval structure in which to store the request status and the device’s measure. Pqval is defined in phigs.h as follows:

typedef struct {
Pistatusstatus;/∗ status of request ∗/
Pfloatval;/∗ value ∗/
} Pqval;
Pistatus is defined in phigs.h as follows:

typedef enum {
PSTAT_OK,
PSTAT_NONE
} Pistatus;

FORTRAN Input Parameters

WKIDThe workstation identifier of the workstation associated with the device.

VLDNR
The device number of the VALUATOR device. See the Available Devices section of INITIALIZE VALUATOR 3 for a description of the available devices.

STATThe request status. Valid values as defined in phigs77.h are:

• PNONE(BREAK)
• POK(OK)

VALThe valuator’s value.

Execution

REQUEST VALUATOR requests a logical input value from the specified valuator device. The specified device must be in request mode. See SET VALUATOR MODE for more information.

REQUEST VALUATOR creates a measure process for the specified device and suspends PHIGS until the device is triggered or the operator issues a BREAK. A BREAK is generated by the operator by depressing the Control and D keys simultaneously (^D).

If a BREAK occurs, a status of NONE is returned and the valuator data is undefined. If a status of OK is returned the valuator data is available. In either case the measure process is then terminated, and PHIGS processing resumes

See INITIALIZE VALUATOR for a description of the available valuator devices.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

061Ignoring function, specified workstation is neither of category INPUT nor of category OUTIN

250Ignoring function, the specified device is not available on the specified workstation

251Ignoring function, the function requires the input device to be in REQUEST mode

Museum