cyclem(3G)

NAME
     cyclem - cycles between color maps at a specified rate

FORTRAN 77 SPECIFICATION
     subroutine cyclem(durati, map, nxtmap)
     integer*4 durati, map, nxtmap

PARAMETERS
     durati     expects the number of vertical traces before switching to the
                map named by nxtmap.

     map        expects the number of the map to use before completing the
                number of vertical sweeps specified by durati.

     nxtmap     expects the number of the map to use after completing the
                number of vertical sweeps specified by durati.

DESCRIPTION
     When the system is in multimap mode, cyclem allows you to switch from one
     color map to another after a specified duration.  In multimap mode there
     are 16 color maps, numbered 0-15. You can use cyclem within a loop if you
     want to cycle through more than one map.

EXAMPLE
     The code fragment sets up multimap mode and cycle between two maps,
     leaving map 1 on for ten vertical retraces and map 3 on for five
     retraces.

          call multim
          call gconfi
          call cyclem(10, 1, 3)
          call cyclem(5, 3, 1)

SEE ALSO
     blink, gconfi, multim

NOTES
     This routine is available only in immediate mode and cannot be used in
     onemap mode.

     cyclem is not supported on Iris Entry, Indy, XL, XS, XS24, XZ, Elan and
     Extreme systems and IRIS-4D RealityEngine systems.