GLGETTEXENV() MachTen Programmer’s Manual GLGETTEXENV()

NAME
glGetTexEnvfv, glGetTexEnviv - return texture environment
parameters

C SPECIFICATION
void glGetTexEnvfv( GLenum target,
GLenum pname,
GLfloat *params )
void glGetTexEnviv( GLenum target,
GLenum pname,
GLint *params )

PARAMETERS
target Specifies a texture environment. Must be
GL_TEXTURE_ENV.

pname Specifies the symbolic name of a texture environ-
ment parameter. Accepted values are
GL_TEXTURE_ENV_MODE and GL_TEXTURE_ENV_COLOR.

params Returns the requested data.

DESCRIPTION
glGetTexEnv returns in params selected values of a texture
environment that was specified with glTexEnv. target
specifies a texture environment. Currently, only one tex-
ture environment is defined and supported: GL_TEXTURE_ENV.

pname names a specific texture environment parameter, as
follows:

GL_TEXTURE_ENV_MODE
params returns the single-valued texture envi-
ronment mode, a symbolic constant. The initial
value is GL_MODULATE.

GL_TEXTURE_ENV_COLOR
params 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 repre-
sentation such that 1.0 maps to the most posi-
tive representable integer, and -1.0 maps to the
most negative representable integer. The initial
value is (0, 0, 0, 0).

NOTES
If an error is generated, no change is made to the con-
tents of params.

ERRORS
GL_INVALID_ENUM is generated if target or pname is not an
accepted value.

GL_INVALID_OPERATION is generated if glGetTexEnv is exe-
cuted between the execution of glBegin and the correspond-
ing execution of glEnd.

SEE ALSO
glTexEnv

MachTen 2