[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]
OpenGL 1.2 for AIX: Reference Manual

glGetTexParameter Subroutine

Purpose

Returns texture parameter values.

Library

OpenGL C bindings library: libGL.a

C Syntax

void glGetTexParameterfv(GLenum Target,
           GLenum ParameterName, 
           GLfloat *ParameterValues)
void glGetTexParameteriv(GLenum Target,
           GLenum ParameterName, 
           GLint *ParameterValues)

Description

The glGetTexParameter subroutine returns in ParameterValues the value or values of the texture parameter specified as ParameterName. Target defines the target texture, either GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, and GL_TEXTURE_3D_EXT (if the 3D texture extension is supported). ParameterName accepts the same symbols as glTexParameter, with the same interpretations:

GL_TEXTURE_BASE_LEVEL Specifies for the texture the base array level. Any non-negative integer value is permissable. Supported in OpenGL 1.2 and later.
GL_TEXTURE_MAX_LEVEL Specifies for the texture the maximum array level. Any non-negative integer value is permissable. Supported in OpenGL 1.2 and later.
GL_TEXTURE_BORDER_COLOR Returns four integer or floating-point numbers that comprise the red, green, blue, alpha (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_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_MAX_LOD Specifies for the texture the maximum level of detail of the image array. Any floating-point value is permissable. Supported in OpenGL 1.2 and later.
GL_TEXTURE_MIN_LOD Specifies for the texture the minimum level of detail of the image array. Any floating-point value is permissable. Supported in OpenGL 1.2 and later.
GL_TEXTURE_PRIORITY (1.1 only)
GL_TEXTURE_PRIORITY_EXT (EXT_texture_object)
Returns the priority of the target texture (or the named texture bound to it). The initial value is 1. See glPrioritizeTextures.
GL_TEXTURE_RESIDENT (1.1 only)
GL_TEXTURE_RESIDENT_EXT (EXT_texture_object)
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_TEXTURE_WRAP_R Returns the single-valued wrapping function for texture coordinate r, a symbolic constant.
GL_TEXTURE_WRAP_R (3D Texture Extension) 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.
GL_TEXTURE_WRAP_T Returns the single-valued wrapping function for texture coordinate t, a symbolic constant.

Parameters

Target Specifies the symbolic name of the target texture. GL_TEXTURE_1D, GL_TEXTURE_2D, GL_TEXTURE_3D, and GL_TEXTURE_3D_EXT (EXT_texture_3D) are accepted.
ParameterName Specifies the symbolic name of a texture parameter. GL_TEXTURE_BASE_LEVEL, GL_TEXTURE_MAX_LEVEL, GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MAX_LOD, GL_TEXTURE_MIN_LOD, GL_TEXTURE_PRIORITY, GL_TEXTURE_PRIORITY_EXT, GL_TEXTURE_RESIDENT, GL_TEXTURE_RESIDENT_EXT, GL_TEXTURE_WRAP_R, GL_TEXTURE_WRAP_R_EXT, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T, and GL_TEXTURE_BORDER_COLOR are accepted.
ParameterValues Returns the texture parameters.

Notes

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

Errors

GL_INVALID_ENUM Either Target or ParameterName is not an accepted value.
GL_INVALID_OPERATION The glGetTexParameter subroutine is called between a call to glBegin and the corresponding call to glEnd.

Files

/usr/include/GL/gl.h Contains C language constants, variable type definitions, and ANSI function prototypes for OpenGL.

Related Information

The glBegin or glEnd subroutine, glTexParameter subroutine.

OpenGL Overview.


[ Next Article | Previous Article | Book Contents | Library Home | Legal | Search ]