glGetTexParameterfv, glGetTexParameteriv

[New - Windows 95, OEM Service Release 2]

The glGetTexParameterfv and glGetTexParameteriv functions return texture parameter values.

void glGetTexParameterfv(

    GLenum target,

 

    GLenum pname,

 

    GLfloat * params

 

   );

 

 

void glGetTexParameteriv(

    GLenum target,

 

    GLenum pname,

 

    GLint * params

 

   );

 

 

Parameters

target

The symbolic name of the target texture. GL_TEXTURE_1D and GL_TEXTURE_2D are accepted.

pname

The symbolic name of a texture parameter. The following values are accepted:

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_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.

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.

params

Returns the texture parameters.

 

Remarks

The glGetTexParameter function returns in params the value or values of the texture parameter specified as pname. The target parameter defines the target texture either GL_TEXTURE_1D or GL_TEXTURE_2D to specify one- or two-dimensional texturing. The pname parameter accepts the same symbols as glTexParameter51MLQ7N, with the same interpretations.

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

Error Codes

The following are the error codes generated and their conditions.

Error Code

Condition

GL_INVALID_ENUM

target or pname was not an accepted value.

GL_INVALID_OPERATION

glGetTexParameter was called between a call to glBegin and the corresponding call to glEnd.

 

See Also

glBegin, glEnd, glTexParameter