glGetTexParameter.3gl

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 )

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_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER,	GL_TEXTURE_WRAP_S,
	  GL_TEXTURE_WRAP_T, and GL_TEXTURE_BORDER_COLOR are accepted.

  params  Returns the texture parameters.

Description

  glGetTexParameter returns in params the value	or values of the texture
  parameter specified as pname.	 target	defines	the target texture, either
  GL_TEXTURE_1D	or GL_TEXTURE_2D, to specify one- or two-dimensional
  texturing.  pname accepts the	same symbols as	glTexParameter,	with the same
  interpretations:

  GL_TEXTURE_MAG_FILTER		     Returns the single-valued texture
				     magnification filter, a symbolic
				     constant.

  GL_TEXTURE_MIN_FILTER		     Returns the single-valued texture
				     minification filter, a symbolic
				     constant.

  GL_TEXTURE_WRAP_S		     Returns the single-valued wrapping
				     function for texture coordinate s,	a
				     symbolic constant.

  GL_TEXTURE_WRAP_T		     Returns the single-valued wrapping
				     function for texture coordinate t,	a
				     symbolic constant.

  GL_TEXTURE_BORDER_COLOR	     Returns four integer or floating-point
				     numbers that comprise the RGBA color of
				     the texture border.  Floating-point
				     values 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
				     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 glGetTexParameter is called between a
  call to glBegin and the corresponding	call to	glEnd.

See Also

  glTexParameter

Introduction | Alphabetic | Specification

Last Edited: Mon, May 22, 1995

AFV