tie(3G)

NAME
     tie - ties two valuators to a button

C SPECIFICATION
     void tie(b, v1, v2)
     Device b, v1, v2;

PARAMETERS
     b    expects a button.

     v1   expects a valuator.

     v2   expects a valuator.

DESCRIPTION
     tie requires a button b and two valuators v1 and v2.  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.  The valuators v1 and v2 need not be (and probably should
     not be) queued.

     You can tie one valuator to a button by calling tie with v2 set to
     NULLDEV.  You can untie a button by calling tie with both v1 and v2 set
     to NULLDEV.  v1 appears before v2 in the event queue; b precedes both v1
     and v2.

SEE ALSO
     getbutton

NOTES
     This routine is available only in immediate mode.

     The symbol NULLDEV is defined in <gl/device.h>.