glGetTexParameteriv

GLGETTEXPARAMETER(3G)					GLGETTEXPARAMETER(3G)



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,GL_TEXTURE_2D,  and GL_TEXTURE_3D	are accepted.

       pname   Specifies  the  symbolic	 name	of   a	 texture   parameter.
	       GL_TEXTURE_MAG_FILTER,		       GL_TEXTURE_MIN_FILTER,
	       GL_TEXTURE_MIN_LOD, GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL,
	       GL_TEXTURE_MAX_LEVEL,   GL_TEXTURE_WRAP_S,  GL_TEXTURE_WRAP_T,
	       GL_TEXTURE_WRAP_R,		     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
       parameter specified as pname.   target  defines	the  target  texture,
       either GL_TEXTURE_1D, GL_TEXTURE_2D, or GL_TEXTURE_3D to specify one-,
       two-, or three-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.   The  initial  value  is
					  GL_LINEAR.

       GL_TEXTURE_MIN_FILTER		  Returns the  single-valued  texture
					  minification	 filter,  a  symbolic
					  constant.  The  initial  value   is
					  GL_NEAREST_MIPMAP_LINEAR.

       GL_TEXTURE_MIN_LOD		  Returns  the	single-valued texture
					  minimum level-of-detail value.  The
					  initial value is −1000.

       GL_TEXTURE_MAX_LOD		  Returns  the	single-valued texture
					  maximum level-of-detail value.  The
					  initial value is 1000.

       GL_TEXTURE_BASE_LEVEL		  Returns the single-valued base tex-
					  ture	mipmap	level.	 The  initial
					  value is 0.

       GL_TEXTURE_MAX_LEVEL		  Returns  the	single-valued maximum
					  texture mipmap  array	 level.	  The
					  initial value is 1000.

       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_WRAP_R		  Returns  the single-valued wrapping
					  function for texture coordinate  r,
					  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.
					  Floating-point  values are returned
					  in the range [0, 1].	Integer	 val-
					  ues  are  returned as a linear map-
					  ping 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. 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
					  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 available only if the
       GL version is 1.1 or greater.

       GL_TEXTURE_3D,	      GL_TEXTURE_MIN_LOD,	  GL_TEXTURE_MAX_LOD,
       GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_MAX_LEVEL, and GL_TEXTURE_WRAP_R are
       available only if the GL version is 1.2 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(3G),		    glPrioritizeTextures(3G),
       glTexParameter(3G)



							GLGETTEXPARAMETER(3G)