glGetTexParameter

Name

glGetTexParameterf , glGetTexParameterx - return texture parameter values

C Specification

void glGetTexParameterf(GLenum target,
    GLenum pname,
    GLfloat * params)

void glGetTexParameterx(GLenum target,
    GLenum pname,
    GLfixed * params)

Parameters

target: Specifies the target texture, which must be GL_TEXTURE_2D.
pname: Specifies the symbolic name of a texture parameter. Which can be one of the following: GL_TEXTURE_MIN_FILTER, GL_TEXTURE_MAG_FILTER, GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T, or GL_GENERATE_MIPMAP.
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, which must be GL_TEXTURE_2D which specifies two-dimensional texturing. pname accepts the same symbols as glTexParameter, with the same interpretations:

GL_TEXTURE_MIN_FILTER: Returns the texture minifying function. Which can one of the following: GL_NEAREST, GL_LINEAR, GL_NEAREST_MIPMAP_NEAREST, GL_LINEAR_MIPMAP_NEAREST, GL_NEAREST_MIPMAP_LINEAR, or GL_LINEAR_MIPMAP_LINEAR. The initial value is GL_NEAREST_MIPMAP_LINEAR.
GL_TEXTURE_MAG_FILTER: Returns the texture magnification function. Which can be either GL_NEAREST or GL_LINEAR. The initial value is GL_LINEAR.
GL_TEXTURE_WRAP_S: Returns the wrap parameter for texture coordinate s. Which can be either: GL_CLAMP, GL_CLAMP_TO_EDGE, or GL_REPEAT. The initial value is GL_REPEAT.
GL_TEXTURE_WRAP_T: Returns the wrap parameter for texture coordinate t. Which can be either: GL_CLAMP, GL_CLAMP_TO_EDGE, or GL_REPEAT. The initial value is GL_REPEAT.
GL_GENERATE_MIPMAP: Returns the automatic mipmap generation parameter. The initial value is GL_FALSE.

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 one of the accepted defined values.

Copyright

This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.