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

cyclemap Subroutine

Purpose

Cycles through color maps at a specified rate.

Libraries

Graphics Library

C (libgl.a)

FORTRAN (libfgl.a)

C Syntax

void cyclemap(Int16 duration, Int16 map, Int16 nextmap)

FORTRAN Syntax

SUBROUTINE CYCLEM(duration, map, nextmap)
INTEGER*4 duration, map, nextmap
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 cyclemap subroutine initiates cycling between two small color maps. The system, when using the current color map map, waits the number of vertical retraces specified by the duration parameter before switching to the next map to be used (nextmap).

You can use the cyclemap subroutine used to chain together several color maps into a loop, thus initiating a cycling or blinking that continues indefinitely. The system loops automatically through the chain until cycling is disabled.

You can eliminate a cyclemap entry by calling the cyclemap subroutine with the duration parameter set to 0.

This subroutine must be used in multimap mode.

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

Parameters

duration Specifies duration for the current map in vertical retraces.
map Specifies the number of the current map.
nextmap Specifies the number of the next map to use.

Implementation Specifics

This subroutine is part of GL in the AIXwindows Environment/6000 Version 1, Release 2 with AIXwindows/3D Feature.

The POWER GXT1000 adapter does not support the cyclemap subroutine.

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

Changing a color map entry at a selectable rate with the blink subroutine.

Reconfiguring the system with the gconfig subroutine.

Organizing the color map as 16 small maps with the multimap subroutine.

Understanding the Hardware Used by GL in GL3.2 Version 4 for AIX: Programming Concepts.

Working in Color Map and RGB Modes, Creating Animated Scenes.


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