NAME

GET VALUATOR − retrieve the VALUATOR event in the PHIGS current event report

SYNOPSIS

C Syntax

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

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

GET VALUATOR retrieves the current event report from the PHIGS state list when the event report contains a VALUATOR event. 

A VALUATOR event consists of a floating point number that the operator has selected. 

C Output Parameter

valuator
PHIGS copies the event’s contents to the variable pointed to by valuator. 

Execution

GET VALUATOR retrieves the contents of a VALUATOR event 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 triggered 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 contents of the event 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)

September 02, 1992