tie Subroutine

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

tie Subroutine

Purpose

Ties two valuators to a button.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void tie(Device button, Device val1, Device val2)

FORTRAN Syntax

SUBROUTINE TIE(button, val1, val2)
INTEGER*4 button, val1, val2

Description

The tie subroutine requires a button and two valuators, specified by the val1 and val2 parameters. When a queued button changes state, three entries are made in the queue: one records the current state of the button, and two record the current positions of each valuator.

Tie one valuator to a button by making the val2 parameter = 0. Untie a button by making both the val1 and val2 parameters = 0. The button parameter precedes both the val1 and val2 parameters in the event queue. The val1 parameter appears before the val2 parameter.

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

Parameters

button	Specifies the current state of a button.
val1	Specifies the current position of the first valuator.
val2	Specifies the current position of the second valuator.

Example

The example C language program vlsi.c uses the tie subroutine to enter the current mouse coordinates into the event queue whenever the left or middle mouse buttons are 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

Returning the current state of a button with the getbutton subroutine.

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