home | help 
GLGETTEXPARAMETER()					     GLGETTEXPARAMETER()

NAME
     glGetTexParameterfv, glGetTexParameteriv - return texture parameter values

C SPECIFICATION
     void glGetTexParameterfv( GLenum target,
			       GLenum pname,
			       GLfloat *params )
     void glGetTexParameteriv( GLenum target,
			       GLenum pname,
			       GLint *params )

     delim $$

PARAMETERS
     target  Specifies	the  symbolic name of the target texture.  GL_TEXTURE_1D
	     and GL_TEXTURE_2D are accepted.

     pname   Specifies the  symbolic  name  of	a  texture  parameter.	 GL_TEX-
	     TURE_MAG_FILTER,  GL_TEXTURE_MIN_FILTER, GL_TEXTURE_WRAP_S, GL_TEX-
	     TURE_WRAP_T,  GL_TEXTURE_BORDER_COLOR,   GL_TEXTURE_PRIORITY,   and
	     GL_TEXTURE_RESIDENT are accepted.

     params  Returns the texture parameters.

DESCRIPTION
     glGetTexParameter	returns in params the value or values of the texture pa-
     rameter specified as pname.  target  defines  the	target	texture,  either
     GL_TEXTURE_1D  or GL_TEXTURE_2D, to specify one- or two-dimensional textur-
     ing.  pname accepts the same symbols as glTexParameter, with the  same  in-
     terpretations:

     GL_TEXTURE_MAG_FILTER		Returns the single-valued texture magni-
					fication  filter,  a  symbolic constant.
					The initial value is GL_LINEAR.

     GL_TEXTURE_MIN_FILTER		Returns the single-valued texture  mini-
					fication  filter,  a  symbolic constant.
					The   initial	 value	  is	GL_NEAR-
					EST_MIPMAP_LINEAR.

     GL_TEXTURE_WRAP_S			Returns the single-valued wrapping func-
					tion  for texture coordinate $s$, a sym-
					bolic constant.  The  initial  value  is
					GL_REPEAT.

     GL_TEXTURE_WRAP_T			Returns the single-valued wrapping func-
					tion  for texture coordinate $t$, a sym-
					bolic constant.  The  initial  value  is
					GL_REPEAT.

     GL_TEXTURE_BORDER_COLOR		Returns  four  integer or floating-point
					numbers that comprise the RGBA color  of
					the texture border.  Floating-point val-
					ues  are  returned  in the range [0, 1].
					Integer values are returned as a  linear
					mapping  of  the internal floating-point
					representation such that 1.0 maps to the
					most positive representable integer  and
					-1.0  maps  to	the most negative repre-
					sentable integer. The initial  value  is
					(0, 0, 0, 0).

     GL_TEXTURE_PRIORITY		Returns  the  residence  priority of the
					target texture	(or  the  named  texture
					bound  to  it).  The initial value is 1.
					See glPrioritizeTextures.

     GL_TEXTURE_RESIDENT		Returns the residence status of the tar-
					get texture.  If the value  returned  in
					params	is GL_TRUE, the texture is resi-
					dent in texture memory.   See  glAreTex-
					turesResident.

NOTES
     GL_TEXTURE_PRIORITY  and  GL_TEXTURE_RESIDENT  are only available if the GL
     version is 1.1 or greater.

     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 glGetTexParameter is executed  between
     the execution of glBegin and the corresponding execution of glEnd.

SEE ALSO
     glAreTexturesResident, glPrioritizeTextures, glTexParameter

							     GLGETTEXPARAMETER()
home | help