NAME    [Toc]    [Back]

       glGetTexParameter,   glGetTexParameterfv,  glGetTexParameteriv
 - return texture parameter values

SYNOPSIS    [Toc]    [Back]

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

PARAMETERS    [Toc]    [Back]

       Specifies  the  symbolic  name  of  the  target   texture.
       GL_TEXTURE_1D,GL_TEXTURE_2D,    and    GL_TEXTURE_3D   are
       accepted.  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.  Returns the texture parameters.

DESCRIPTION    [Toc]    [Back]

       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 threedimensional
 texturing.  pname accepts the same symbols  as
       glTexParameter(),  with  the same interpretations: Returns
       the single-valued texture magnification filter, a symbolic
       constant.  The  initial  value  is GL_LINEAR.  Returns the
       single-valued texture minification filter, a symbolic constant.
  The  initial  value  is  GL_NEAREST_MIPMAP_LINEAR.
       Returns the single-valued texture minimum  level-of-detail
       value.   The  initial value is -1000.  Returns the singlevalued
 texture maximum level-of-detail value. The  initial
       value  is  1000.   Returns  the single-valued base texture
       mipmap level.  The initial value is 0.  Returns  the  single-valued
  maximum  texture mipmap array level.  The initial
 value is 1000.  Returns  the  single-valued  wrapping
       function  for  texture  coordinate s, a symbolic constant.
       The initial value is GL_REPEAT.  Returns the single-valued
       wrapping  function  for  texture  coordinate t, a symbolic
       constant. The initial value  is  GL_REPEAT.   Returns  the
       single-valued  wrapping function for texture coordinate r,
       a symbolic  constant.  The  initial  value  is  GL_REPEAT.
       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 floatingpoint
  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).  Returns the residence priority of the target  texture
       (or  the  named texture bound to it). The initial value is
       1. See glPrioritizeTextures().  Returns the residence status
 of the target texture. If the value returned in params
       is GL_TRUE, the texture is resident in texture memory. See
       glAreTexturesResident().

NOTES    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       glAreTexturesResident(3),  glPrioritizeTextures(3), glTexParameter(3)



                                            glGetTexParameter(3G)