Light | Dark

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
Think you can improve this page? Edit this page on GitHub.