NAME

GET VALUATOR − retrieve the VALUATOR measure from the PHIGS current event report

SYNOPSIS

C Syntax

void
pgetval ( valuator )
Pfloat∗valuator;OUT valuator value

FORTRAN Syntax

SUBROUTINE pgtvl ( VAL )
REALVALOUT value

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use GET VALUATOR to retrieve the measure (logical input value) of the VALUATOR device from the current event report in the PHIGS state list. 

A VALUATOR device measure consists of a floating point number. 

C Output Parameter

valuator
A pointer to a Pfloat variable in which to store the VALUATOR measure. 

FORTRAN Output Parameter

VALThe VALUATOR measure. 

Execution

The GET VALUATOR function retrieves the measure of a VALUATOR device from the current event report in the PHIGS state list. 

When an input device that is set to EVENT mode is triggered by the operator, an event report is added to the input event queue.  The event report contains the identity and current measure of the device.  AWAIT EVENT moves the measure of the oldest event in the input queue to the current event report in the PHIGS state list.  If the event was a VALUATOR event, GET VALUATOR is used to retrieve the measure from the current event report. 

See INITIALIZE VALUATOR 3 for a description of the available VALUATOR devices and how their measure values are determined. 

ERRORS

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

259Ignoring function, the input device class of the current input report does not match the class being requested

SEE ALSO

INITIALIZE VALUATOR (3P)
INITIALIZE VALUATOR 3 (3P)
AWAIT EVENT (3P)

Sun Release 4.0  —  Last change: 12 July 1989