glGetTexEnvfv(3)

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      and
               GL_TEXTURE_ENV_COLOR.

       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  environ-
       ment.   Currently,  only  one  texture  environment is defined and sup-
       ported: 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).

NOTES

       If an error is generated, no change is made to the contents of  params.

       When   the  GL_ARB_multitexture  extension  is  supported,  glGetTexEnv
       returns the texture environment parameters for the active texture unit.

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

       glActiveTextureARB(3G), glTexEnv(3G)

                                                               GLGETTEXENV(3G)