glGetTexEnviv function

The glGetTexEnvfv and glGetTexEnviv functions return texture environment parameters.

Syntax


void WINAPI glGetTexEnviv(
   GLenum target,
   GLenum pname,
   GLint  *params
);

Parameters

target

A texture environment. Must be GL_TEXTURE_ENV.

pname

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

ValueMeaning
GL_TEXTURE_ENV_MODE

The params parameter returns the single-valued texture environment mode, a symbolic constant.

GL_TEXTURE_ENV_COLOR

The params parameter returns four integer or floating-point values that are the texture environment color. Integer values, when requested, are linearly mapped from 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 requested data.

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 pname was not an accepted value.

GL_INVALID_OPERATION

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

Error codes

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

NameMeaning
GL_INVALID_ENUM

target or pname 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 glGetTexEnv function returns in params selected values of a texture environment that was specified with glTexEnv. The target parameter specifies a texture environment. Currently, only one texture environment is defined and supported: GL_TEXTURE_ENV.

The pname parameter names a specific texture environment parameter.

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

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Gl.h

Library

Opengl32.lib

DLL

Opengl32.dll

See also

glBegin
glEnd
glTexEnv

 

 

Show: