Export (0) Print
Expand All

glGetTexParameteriv function

Applies to: desktop apps only

The glGetTexParameterfv and glGetTexParameteriv functions return texture parameter values.

Syntax

void WINAPI 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.

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

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.

 

params

Returns the texture parameters.

Return value

This function does not return a value.

Error codes

The following error codes can be retrieved by the glGetError function.

NameMeaning
GL_INVALID_ENUM

target or name was not an accepted value.

GL_INVALID_OPERATION

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

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-dimensional or two-dimensional texturing. The pname parameter accepts the same symbols as glTexParameter, with the same interpretations.

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

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

Header

Gl.h

Library

Opengl32.lib

DLL

Opengl32.dll

See also

glBegin
glEnd
glTexParameter

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Community Additions

ADD
Show:
© 2014 Microsoft