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