[Front] [Reference] [Imp. Guide] [Index]

glGetTexParameter
[Prev] [Next]

glGetTexParameterfv, glGetTexParameteriv: return texture parameter values.

C Specification | Parameters | Description | Notes | Errors | See Also

[Up] C Specification

void glGetTexParameterfv(
    GLenum	 target,
    GLenum	 pname,
    GLfloat	 *params)
void glGetTexParameteriv(
    GLenum	 target,
    GLenum	 pname,
    GLint	 *params)

[Up] 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_WRAP_R_EXT, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T, GL_TEXTURE_BORDER_COLOR, GL_TEXTURE_PRIORITY, GL_GENERATE_MIPMAP_EXT, GL_TEXTURE_COMPARE_EXT, GL_TEXTURE_COMPARE_OPERATOR_EXT, and GL_TEXTURE_RESIDENT are accepted.
params
Returns the texture parameters.

[Up] 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. 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_WRAP_R_EXT
Returns the single-valued wrapping function for texture coordinate r, a symbolic constant.
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_GENERATE_MIPMAP_EXT
Returns the single-valued flag which determines whether automatic mip level generation is in effect, either GL_TRUE or GL_FALSE.
GL_TEXTURE_COMPARE_EXT
Returns the single-valued flag which determines whether depth texture comparision is enabled, either GL_TRUE or GL_FALSE.
GL_TEXTURE_COMPARE_OPERATOR_EXT
Returns the single-valued depth texture comparision operator, a symbolic constant.
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.

[Up] Notes

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

GL_TEXTURE_WRAP_R_EXT and the target GL_TEXTURE_3D_EXT are only supported if the extension GL_EXT_texture3D is supported.

GL_GENERATE_MIPMAP_EXT is only supported if the extension GL_EXT_generate_mipmap is supported.

GL_TEXTURE_COMPARE_EXT and GL_TEXTURE_COMPARE_OPERATOR_EXT are only supported if the extension GL_EXT_shadow is supported.

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

[Up] Errors

[Up] See Also

glAreTexturesResident,
glPrioritizeTextures,
glTexParameter

[Prev] [Next]
Front Reference [Imp. Guide] Index