glGetTexGeniv function

The glGetTexGendv, glGetTexGenfv, and glGetTexGeniv functions return texture coordinate generation parameters.

Syntax

void WINAPI glGetTexGeniv(
   GLenum coord,
   GLenum pname,
   GLint  *params
);

Parameters

coord

A texture coordinate. Must be GL_S, GL_T, GL_R, or GL_Q.

pname

The symbolic name of the value(s) to be returned. Must be either GL_TEXTURE_GEN_MODE or the name of one of the texture generation plane equations: GL_OBJECT_PLANE or GL_EYE_PLANE. These values are as follows.

Value	Meaning
GL_TEXTURE_GEN_MODE	The params parameter returns the single-valued texture generation function, a symbolic constant.
GL_OBJECT_PLANE	The params parameter returns the four plane equation coefficients that specify object linear-coordinate generation. Integer values, when requested, are mapped directly from the internal floating-point representation.
GL_EYE_PLANE	The params parameter returns the four plane equation coefficients that specify eye linear-coordinate generation. Integer values, when requested, are mapped directly from the internal floating-point representation. The returned values are those maintained in eye coordinates. They are not equal to the values specified using glTexGen, unless the modelview matrix was identified at the time glTexGen was called.

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.

Remarks

The glGetTexGen function returns in params selected parameters of a texture-coordinate generation function that you specified with glTexGen. The coord parameter names one of the (s, t, r, q) texture coordinates, using the symbolic constant GL_S, GL_T, GL_R, or GL_Q.

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

Requirements

See also

glBegin

glEnd

glTexGen