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

setcursor Subroutine

Purpose

Sets the cursor characteristics.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void setcursor
(Int16 index, Colorindex color, Colorindex  writemask)

FORTRAN Syntax

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

Description

The setcursor subroutine selects a cursor from among those defined with the defcursor subroutine. To set the color for the cursor, use the mapcolor and drawmode subroutines.

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.

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

Setting the origin of a cursor with the curorigin subroutine.

Controlling cursor visibility by window with the curson or cursoff subroutine.

Defining the type and size of a cursor with the curstype subroutine.

Defining a cursor with the defcursor subroutine.

Setting the drawing mode to CURSORDRAW with the drawmode subroutine.

Returning the cursor characteristics with the getcursor subroutine.

Changing a color map entry with the mapcolor subroutine.

Putting the system in picking mode with the pick subroutine.

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


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