glGetTexEnv(3G)

NAME
     glGetTexEnvfv, glGetTexEnviv - return texture environment parameters


C SPECIFICATION
     void glGetTexEnvfv( GLenum target,
                         GLenum pname,
                         GLfloat *params )
     void glGetTexEnviv( GLenum target,
                         GLenum pname,
                         GLint *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
     glGetTexEnv returns in params selected values of a texture environment
     that was specified with glTexEnv.  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 glGetTexEnv is executed between the
     execution of glBegin and the corresponding execution of glEnd.


SEE ALSO
     glTexEnv