[ Previous | Next | Contents | Glossary | Home | Search ]
GL3.2 for AIX: Graphics Library (GL) Technical Reference

getcursor Subroutine

Purpose

Returns the cursor characteristics.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void getcursor
(Int16 *index, 
Colorindex *color, Colorindex *writemask, 
Int32 *bool)

FORTRAN Syntax

SUBROUTINE GETCUR(index, color, writemask, bool)
INTEGER*2 index, color, writemask
LOGICAL bool

Description

The getcursor subroutine finds the index of the current cursor and returns it in the index parameter. The cursor index is an index into a table of cursor bitmaps set by the defcursor subroutine.

The default is the cursor at index 0 (zero) in the cursor bitmaps. This cursor is displayed in red and is automatically updated on each vertical retrace.

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

Parameters

index Specifies an index that was previously associated with a bitmap by the defcursor subroutine.
color Retained for compatibility, but disregarded.
writemask Retained for compatibility, but disregarded.
bool Specifies a pointer to the location into which the system returns a boolean indicating if the cursor is visible in the current window.

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.

Related Information

Defining a cursor with the defcursor subroutine.

Setting the cursor characteristics with the setcursor subroutine.

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


[ Previous | Next | Contents | Glossary | Home | Search ]