attachcursor Subroutine

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

attachcursor Subroutine

Purpose

Couples cursor position to valuator device.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void attachcursor (Device vx, Device vy)

FORTRAN Syntax

SUBROUTINE ATTACH (vx, vy) INTEGER*4 vx, vy

Description

The attachcursor subroutine couples the pointer location to the indicated valuators. As the values generated by the valuators change, the cursor position is updated to reflect the new readings. The values are interpreted as screen coordinates (as measured in pixels) from the lower-left hand corner of the screen. Currently, the only devices supported by the attachcursor subroutine are the MOUSEX, MOUSEY, GHOSTX and GHOSTY devices. This subroutine cannot be used to add to a display list.

Note: For FORTRAN users, this subroutine accepts long integer parameters (INTEGER*4) when started from a FORTRAN program, although it accepts short integers when started from a C program. The C and FORTRAN syntax shown here reflect this difference.

Parameters

vx	Token representing the valuator device that controls the horizontal location of the cursor. By default, the x position of the cursor is attached to the MOUSEX device.
vy	Token representing the valuator device that controls the vertical location of the cursor. By default, the y position of the cursor is attached to the MOUSEY device.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 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.

Related Information

Tying valuators to a button with the tie subroutine.

Filtering valuator motion with the noise subroutine.

Setting the minimum, maximum, and current value of a valuator with the setvaluator subroutine.

AIX Graphics Library Overview, Creating a Cursor, and Creating and Managing Windows.