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, GL_TEXTURE_2D, and GL_TEXTURE_3D_EXT are accepted.
pname	Specifies the symbolic name of a texture parameter. GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MIN_LOD_EXT, GL_TEXTURE_MAX_LOD_EXT, GL_TEXTURE_BASE_LEVEL_EXT, GL_TEXTURE_MAX_LEVEL_EXT, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T, GL_TEXTURE_BORDER_COLOR, GL_TEXTURE_PRIORITY, GL_TEXTURE_RESIDENT, and GL_GENERATE_MIPMAP_EXT 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, GL_TEXTURE_2D, or GL_TEXTURE_3D_EXT 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. The initial value is GL_LINEAR.
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_EXT: Returns the single-valued minimum level-of-detail (LOD) value. The initial value is -1000.
GL_TEXTURE_MAX_LOD_EXT: Returns the single-valued maximum level-of-detail (LOD) value. The initial value is 1000.
GL_TEXTURE_BASE_LEVEL_EXT: Returns the single-valued texture base level. The initial value is 0.
GL_TEXTURE_MAX_LEVEL_EXT: Returns the single-valued maximum texture level. The initial value is 1000.
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_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. The initial value is (0, 0, 0, 0).
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.
GL_GENERATE_MIPMAP_EXT: Returns the mipmap generation enable state. If the value returned in params is GL_TRUE, mipmap generation is enabled. See glTexParameter.

NOTES

GL_TEXTURE_PRIORITY and GL_TEXTURE_RESIDENT are only available if the GL version is 1.1 or greater.

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

EXTENSIONS

Some routines and constants for this function are part of an extension, not part of the core GL command set. The following extension names must be present in the string returned by glGetString when called with argument GL_EXTENSIONS to use these routines and constants.

GL_EXT_generate_mipmap: GL_GENERATE_MIPMAP_EXT is part of the EXT_generate_mipmap extension.
GL_EXT_texture_lod: GL_TEXTURE_MIN_LOD_EXT, GL_TEXTURE_MAX_LOD_EXT, GL_TEXTURE_BASE_LEVEL_EXT, and GL_TEXTURE_MAX_LEVEL_EXT are part of the EXT_texture_lod extension.
GL_EXT_texture3D: GL_TEXTURE_3D_EXT is part of the EXT_texture3D extension.

ERRORS

GL_INVALID_ENUM is generated if target or pname is not an accepted value.

GL_INVALID_OPERATION is generated if glGetTexParameter is executed between the execution of glBegin and the corresponding execution of glEnd.