lmcolo(3G)

NAME
     lmcolo - change the effect of color commands while lighting is active

FORTRAN 77 SPECIFICATION
     subroutine lmcolo(mode)
     integer*4 mode

PARAMETERS
     mode   the name of the mode to be used.  Possible modes are:

            LMCCOL, RGB color commands will set the current color.  If a color
            is the last thing sent before a vertex the vertex will be colored.
            If a normal is the last thing sent before a vertex the vertex will
            be lighted.  LMCCOL is the default mode.

            LMCEMI, RGB color commands will set the EMISSI color property of
            the current material.

            LMCAMB, RGB color commands will set the AMBIEN color property of
            the current material.

            LMCDIF, RGB color commands will set the DIFFUS color property of
            the current material.  Alpha, the fourth color component specified
            by RGB color commands will set the ALPHA property of the current
            material.

            LMCSPE, RGB color commands will set the SPECUL color property of
            the current material.

            LMCAD, RGB color commands will set the DIFFUS and AMBIEN color
            property of the current material.  Alpha, the fourth color
            component specified by RGB color commands will set the ALPHA
            property of the current material.

            LMCNUL, RGB color commands will be ignored.

DESCRIPTION
     Properties of the currently bound material can be changed by calls to
     lmdef.  Because the data structure of the material must be modified by
     this operation, however, it is relatively slow to execute.  lmcolo is
     provided to support fast and efficient changes to the current material as
     maintained in the graphics hardware, without changing the definition of
     the currently bound material.  Thus lmcolo changes are lost whenever a
     new material is bound.

     The standard RGB color commands (RGBcol, c, and cpack) are used to change
     material properties efficiently.  lmcolo specifies which material
     property is to be affected by these commands.  While lighting is not
     active color commands change the current color.  lmcolo mode is
     significant only while lighting is on.
SEE ALSO
     lmdef, lmbind, RGBcol, c, cpack

NOTE
     lmcolo allows changes only to the properties of MATERI, not to the
     properties of BACKMA.

     While lmcolo is other than LMCNUL or LMCCOL, and lighting is active, the
     results of lighting are undefined between the time that a material is
     bound and an RGB color command is issued.

     While lmcolo is other than LMCNUL or LMCCOL, and lighting is active, the
     results of lighting are undefined if an RGB color command is specified
     between an n command and the subsequent v command.