glGetTexParameteriv function

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.

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

See also

glBegin

glEnd

glTexParameter