fglGetTexEnv(3G)

NAME
     fglGetTexEnvfv, fglGetTexEnviv - return texture environment parameters


FORTRAN SPECIFICATION
     SUBROUTINE fglGetTexEnvfv( INTEGER*4 target,
                                INTEGER*4 pname,
                                CHARACTER*8 params )
     SUBROUTINE fglGetTexEnviv( INTEGER*4 target,
                                INTEGER*4 pname,
                                CHARACTER*8 params )


PARAMETERS
     target  Specifies a texture environment.  Must be GL_TEXTURE_ENV.

     pname   Specifies the symbolic name of a texture environment parameter.
             Accepted values are GL_TEXTURE_ENV_MODE, GL_TEXTURE_ENV_COLOR,
             and GL_TEXTURE_ENV_BIAS_SGIX.

     params  Returns the requested data.

DESCRIPTION
     fglGetTexEnv returns in params selected values of a texture environment
     that was specified with fglTexEnv.  target specifies a texture
     environment.  Currently, only one texture environment is defined and
     supported:  GL_TEXTURE_ENV.

     pname names a specific texture environment parameter, as follows:

     GL_TEXTURE_ENV_MODE
               params returns the single-valued texture environment mode, a
               symbolic constant. The initial value is GL_MODULATE.

     GL_TEXTURE_ENV_COLOR
               params returns four integer or floating-point values that are
               the texture environment color. Integer values, when requested,
               are linearly mapped from the internal floating-point
               representation such that 1.0 maps to the most positive
               representable integer, and -1.0 maps to the most negative
               representable integer. The initial value is (0, 0, 0, 0).

     GL_TEXTURE_ENV_BIAS_SGIX
               params returns four integer or floating-point values that are
               the texture environment bias color.  Integer values are mapped
               in the same way as those for GL_TEXTURE_ENV_COLOR.

NOTES
     If an error is generated, no change is made to the contents of params.
ERRORS
     GL_INVALID_ENUM is generated if target or pname is not an accepted value.

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


SEE ALSO
     fglTexEnv