glGetTexEnv

GLGETTEXENV(3G)						      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 parame-
	       ter.    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)