Query: glgettexparameter
OS: osx
Section: 3g
Links: osx man pages all man pages
Forums: unix linux community forum categories
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
GLGETTEXPARAMETER(3G) GLGETTEXPARAMETER(3G)NAMEglGetTexParameterfv, glGetTexParameteriv - return texture parameter valuesC SPECIFICATIONvoid glGetTexParameterfv( GLenum target, GLenum pname, GLfloat *params ) void glGetTexParameteriv( GLenum target, GLenum pname, GLint *params )PARAMETERStarget Specifies the symbolic name of the target texture. GL_TEXTURE_1D,GL_TEXTURE_2D, and GL_TEXTURE_3D are accepted. pname Specifies the symbolic name of a texture parameter. GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MIN_LOD, GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_MAX_LEVEL, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T, GL_TEXTURE_WRAP_R, GL_TEXTURE_BORDER_COLOR, GL_TEXTURE_PRIORITY, and GL_TEXTURE_RESIDENT are accepted. params Returns the texture parameters.DESCRIPTIONglGetTexParameter 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 to specify one-, two-, or three-dimensional texturing. pname accepts the same sym- bols 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 Returns the single-valued texture minimum level-of-detail value. The initial value is -1000. GL_TEXTURE_MAX_LOD Returns the single-valued texture maximum level-of-detail value. The initial value is 1000. GL_TEXTURE_BASE_LEVEL Returns the single-valued base texture mipmap level. The initial value is 0. GL_TEXTURE_MAX_LEVEL Returns the single-valued maximum texture mipmap array 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_WRAP_R Returns the single-valued wrapping function for texture coordinate r, 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.NOTESGL_TEXTURE_PRIORITY and GL_TEXTURE_RESIDENT are available only if the GL version is 1.1 or greater. GL_TEXTURE_3D, GL_TEXTURE_MIN_LOD, GL_TEXTURE_MAX_LOD, GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_MAX_LEVEL, and GL_TEXTURE_WRAP_R are available only if the GL version is 1.2 or greater. If an error is generated, no change is made to the contents of params.ERRORSGL_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.SEE ALSOglAreTexturesResident, glPrioritizeTextures, glTexParameter GLGETTEXPARAMETER(3G)