Light | Dark

# docs.GL

OpenGL 4
OpenGL 3
OpenGL 2
OpenGL ES 3
OpenGL ES 2

# glGetTexParameter

## Name

glGetTexParameter — 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_2D`, `GL_TEXTURE_2D_ARRAY`, `GL_TEXTURE_3D`, and `GL_TEXTURE_CUBE_MAP` are accepted.

`pname`

  Specifies the symbolic name of a texture parameter. `GL_DEPTH_STENCIL_TEXTURE_MODE`, `GL_TEXTURE_BASE_LEVEL`, `GL_TEXTURE_COMPARE_FUNC`, `GL_TEXTURE_COMPARE_MODE`, `GL_TEXTURE_IMMUTABLE_FORMAT`, `GL_TEXTURE_IMMUTABLE_LEVELS`, `GL_TEXTURE_MAG_FILTER`, `GL_TEXTURE_MAX_LEVEL`, `GL_TEXTURE_MAX_LOD`, `GL_TEXTURE_MIN_FILTER`, `GL_TEXTURE_MIN_LOD`, `GL_TEXTURE_SWIZZLE_R`, `GL_TEXTURE_SWIZZLE_G`, `GL_TEXTURE_SWIZZLE_B`, `GL_TEXTURE_SWIZZLE_A`, `GL_TEXTURE_WRAP_S`, `GL_TEXTURE_WRAP_T`, and `GL_TEXTURE_WRAP_R` 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. `GL_TEXTURE_2D`, `GL_TEXTURE_3D`, `GL_TEXTURE_2D_ARRAY`, and `GL_TEXTURE_CUBE_MAP` specify two- or three-dimensional, two-dimensional array, or cube-mapped texturing, respectively. `pname` accepts the same symbols as glTexParameter, with the same interpretations:

`GL_DEPTH_STENCIL_TEXTURE_MODE`

  Returns the single-value depth stencil texture mode, a symbolic constant. The initial value is `GL_DEPTH_COMPONENT`.

`GL_IMAGE_FORMAT_COMPATIBILITY_TYPE`

  Returns the single-valued image format compatibility matching criteria. This can be one of `GL_IMAGE_FORMAT_COMPATIBILITY_BY_CLASS` or `GL_IMAGE_FORMAT_COMPATIBILITY_BY_SIZE`.

`GL_TEXTURE_BASE_LEVEL`

  Returns the single-valued base texture mipmap level. The initial value is 0.

`GL_TEXTURE_COMPARE_FUNC`

  Returns a single-valued texture comparison function, a symbolic constant. The initial value is `GL_LEQUAL`. See glTexParameter.

`GL_TEXTURE_COMPARE_MODE`

  Returns a single-valued texture comparison mode, a symbolic constant. The initial value is `GL_NONE`. See glTexParameter.

`GL_TEXTURE_IMMUTABLE_FORMAT`

  Returns a single-value boolean representing the immutability of the texture format and size. initial value is `GL_FALSE`. See glTexStorage2D.

`GL_TEXTURE_IMMUTABLE_LEVELS`

  Returns a single-valued number of texture levels in an immutable texture. See glTexStorage2D.

`GL_TEXTURE_MAG_FILTER`

  Returns the single-valued texture magnification filter, a symbolic constant. The initial value is `GL_LINEAR`.

`GL_TEXTURE_MAX_LEVEL`

  Returns the single-valued maximum texture mipmap array level. 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_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_SWIZZLE_R`

  Returns the red component swizzle. The initial value is `GL_RED`.

`GL_TEXTURE_SWIZZLE_G`

  Returns the green component swizzle. The initial value is `GL_GREEN`.

`GL_TEXTURE_SWIZZLE_B`

  Returns the blue component swizzle. The initial value is `GL_BLUE`.

`GL_TEXTURE_SWIZZLE_A`

  Returns the alpha component swizzle. The initial value is `GL_ALPHA`.

`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`.

## Notes

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.

## API Version Support

| OpenGL ES API Version
--- | ---
Function Name | 2.0 | 3.0 | 3.1
`glGetTexParameterfv` | ✔ | ✔ | ✔
`glGetTexParameteriv` | ✔ | ✔ | ✔

## See Also

glTexParameter, glTexStorage2D

## Copyright

Copyright © 1991-2006 Silicon Graphics, Inc. Copyright © 2010-2014 Khronos Group. This document is licensed under the SGI Free Software B License. For details, see https://web.archive.org/web/20171022161616/http://oss.sgi.com/projects/FreeB/.

Think you can improve this page? Edit this page on GitHub.