Index for Section 3G

Alphabetical listing for G

Bottom of page

glGetTexParameter(3G)
NAME
  glGetTexParameter, glGetTexParameterfv, glGetTexParameteriv - return
  texture parameter values

SYNOPSIS
  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 texture 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 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. 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
      memory. 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(3), glPrioritizeTextures(3), glTexParameter(3)

Index for Section 3G

Alphabetical listing for G

Top of page