glGetTexParameter

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)

PARAMETERS

target: Specifies the symbolic name of the target texture. GL_TEXTURE_1D and GL_TEXTURE_2D are accepted.
pname: Specifies the symbolic name of a texture parameter. GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T, and GL_TEXTURE_BORDER_COLOR 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 or GL_TEXTURE_2D to specify one- or two-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.
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.

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.

GL_INVALID_OPERATION is generated if glGetTexParameter is called between a call to glBegin and the corresponding call to glEnd.