glGetTexEnv.3gl

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 environment.

  Currently, only one texture environment is defined and supported:

  GL_TEXTURE_ENV.



  pname	names a	specific texture environment parameter.	 The two parameters

  are as follows:



  GL_TEXTURE_ENV_MODE

	    params returns the single-valued texture environment mode, a

	    symbolic constant.



  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.

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 called between a call

  to glBegin and the corresponding call	to glEnd.

See Also

  glTexEnv

Introduction | Alphabetic | Specification

Last Edited: Mon, May 22, 1995

AFV