DragonFly On-Line Manual Pages

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_TEX-
	       TURE_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_TEXTURE_WRAP_T,  GL_TEXTURE_BORDER_COLOR,  GL_TEXTURE_PRIOR-
	       ITY, and	GL_TEXTURE_RESIDENT 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-dimen-
       sional  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.  The  initial   value   is
					  GL_LINEAR.

       GL_TEXTURE_MIN_FILTER		  Returns  the	single-valued  texture
					  minification filter, a symbolic con-
					  stant. The initial value is GL_NEAR-
					  EST_MIPMAP_LINEAR.

       GL_TEXTURE_WRAP_S		  Returns the  single-valued  wrapping
					  function for texture coordinate $s$,
					  a  symbolic  constant.  The  initial
					  value	is GL_REPEAT.

       GL_TEXTURE_WRAP_T		  Returns the  single-valued  wrapping
					  function for texture coordinate $t$,
					  a  symbolic  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.	Float-
					  ing-point values are returned	in the
					  range	 [0,  1].   Integer values are
					  returned as a	linear mapping of  the
					  internal  floating-point representa-
					  tion such that 1.0 maps to the  most
					  positive  representable  integer and
					  -1.0 maps to the most	negative  rep-
					  resentable   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 glPrioritizeTex-
					  tures.

       GL_TEXTURE_RESIDENT		  Returns the residence	status of  the
					  target   texture.    If   the	 value
					  returned in params is	 GL_TRUE,  the
					  texture  is resident in texture mem-
					  ory.	See glAreTexturesResident.

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()