glGetTexParameteriv function

Article
03/09/2021

The glGetTexParameterfv and glGetTexParameteriv functions return texture parameter values.

Syntax

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

Parameters

target

The symbolic name of the target texture. GL_TEXTURE_1D and GL_TEXTURE_2D are accepted.

pname

The symbolic name of a texture parameter. The following values are accepted.

Value	Meaning
GL_TEXTURE_MAG_FILTER	Returns the single-valued texture magnification filter, a symbolic constant.
GL_TEXTURE_MIN_FILTER	Returns the single-valued texture minification filter, a symbolic constant.
GL_TEXTURE_WRAP_S	Returns the single-valued wrapping function for texture coordinate s, a symbolic constant.
GL_TEXTURE_WRAP_T	Returns the single-valued wrapping function for texture coordinate t, a symbolic constant.
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.
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.

params

Returns the texture parameters.

Return value

This function does not return a value.

Error codes

The following error codes can be retrieved by the glGetError function.

Name	Meaning
GL_INVALID_ENUM	target or name was not an accepted value.
GL_INVALID_OPERATION	The function was called between a call to glBegin and the corresponding call to glEnd.

Remarks

The glGetTexParameter function returns in params the value or values of the texture parameter specified as pname. The target parameter defines the target texture, either GL_TEXTURE_1D or GL_TEXTURE_2D, to specify one-dimensional or two-dimensional texturing. The pname parameter accepts the same symbols as glTexParameter, with the same interpretations.

If an error is generated, no change is made to the contents of params.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Gl.h
Library	Opengl32.lib
DLL	Opengl32.dll