glGetTexParameter
Prev | GL | Next

## 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`);`

## Python Specification

``glGetTexParameterfv`` | `(` | ``target`, `pname`, `params`) → `None``
``glGetTexParameteriv`` | `(` | ``target`, `pname`, `params`) → `None``

## 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, glPrioritizeTextures, glTexParameter

Prev | Up | Next
glGetTexLevelParameter | Home | glHint