fglMatrixMode(3G)

NAME
     fglMatrixMode - specify which matrix is the current matrix


FORTRAN SPECIFICATION
     SUBROUTINE fglMatrixMode( INTEGER*4 mode )


PARAMETERS
     mode  Specifies which matrix stack is the target for subsequent matrix
           operations.  Four values are accepted:  GL_MODELVIEW,
           GL_PROJECTION, GL_TEXTURE, and GL_COLOR (if and only if the
           SGI_color_matrix extension is supported).  The initial value is
           GL_MODELVIEW.

DESCRIPTION
     fglMatrixMode sets the current matrix mode.  mode can assume one of four
     values:

     GL_MODELVIEW        Applies subsequent matrix operations to the modelview
                         matrix stack.

     GL_PROJECTION       Applies subsequent matrix operations to the
                         projection matrix stack.

     GL_TEXTURE          Applies subsequent matrix operations to the texture
                         matrix stack.

     GL_COLOR            Applies subsequent matrix operations to the color
                         matrix stack.  This option is available only if the
                         SGI_color_matrix extension is supported.

     To find out which matrix stack is currently the target of all matrix
     operations, call fglGet with argument GL_MATRIX_MODE. The initial value
     is GL_MODELVIEW.

ERRORS
     GL_INVALID_ENUM is generated if mode is not an accepted value.

     GL_INVALID_OPERATION is generated if fglMatrixMode is executed between
     the execution of fglBegin and the corresponding execution of fglEnd.

ASSOCIATED GETS
     fglGet with argument GL_MATRIX_MODE


MACHINE DEPENDENCIES
     RealityEngine, RealityEngine2, and VTX systems do not support color
     matrix transformations on images as they are loaded to or read back from
     texture memory.
SEE ALSO
     fglLoadMatrix, fglMatrixMode, fglPixelTransfer (for information about the
     color matrix stack), fglPushMatrix