graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPGTVL - Get Valuator

GPGTVL (value)

Purpose

Use GPGTVL to retrieve a valuator input value from the current event report. The event is not removed from the current event report until the next invocation of the Await Event (GPAWEV) subroutine.

The value returned is in the range found in the valuator record at the time that the device was placed in event mode.

The device to which this value corresponds was identified on the previous invocation of GPAWEV

Parameters

value -- returned by the graPHIGS API, short floating-point number

Value of logical valuator when event was triggered.

Error Codes

150: GET FUNCTION DOES NOT MATCH CURRENT EVENT CLASS
519: NO CURRENT EVENT REPORT AVAILABLE

Related Subroutines

GPAWEV: Await Event

RCP code

201336067 (X'0C002503')