getvaluator Subroutine

GL3.2 for AIX: Graphics Library (GL) Technical Reference

getvaluator Subroutine

Purpose

Returns the current state of a valuator.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

Int32 getvaluator(Device device)

FORTRAN Syntax

INTEGER*4 FUNCTION GETVAL(device)
INTEGER*4 device

Description

The getvaluator subroutine returns the current value (an integer) of the valuator specified in the device parameter.

Note: This subroutine cannot be used to add to a display list.

Parameter

device

Identifier of the valuator (such as MOUSEX or BPADX) to be read.

Return Value

The value stored at the device named by the device parameter.

Example

The example C language program select1.c uses the getvaluator subroutine to obtain the mouse coordinates whenever the left mouse button is pressed.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

Files

/usr/include/gl/gl.h	Contains C language constant and variable type definitions for GL.
/usr/include/gl/fgl.h	Contains FORTRAN constant and variable type definitions for GL.
/usr/include/gl/device.h	Contains C language constant and variable type definitions for GL.
/usr/include/gl/fdevice.h	Contains FORTRAN constant and variable type definitions for GL.

Related Information

Reading a list of valuators with the getdev subroutine.

Assigning initial, minimum, and maximum values to a valuator with the setvaluator subroutine.

AIX Graphics Library Overview, Controlling Queues and Devices, Using the Keyboard, and Querying the System.