1991-2006
Silicon Graphics, Inc.
glGetTexGen
3G

# glGetTexGen

return texture coordinate generation parameters

## C Specification

                    void glGetTexGendv
                    GLenum coord
                    GLenum pname
                    GLdouble * params

                    void glGetTexGenfv
                    GLenum coord
                    GLenum pname
                    GLfloat * params

                    void glGetTexGeniv
                    GLenum coord
                    GLenum pname
                    GLint * params

## Parameters

`coord`

  Specifies a texture coordinate. Must be `GL_S`, `GL_T`, `GL_R`, or `GL_Q`.

`pname`

  Specifies 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`.

`params`

  Returns the requested data.

## Description

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

`pname` specifies one of three symbolic names:

`GL_TEXTURE_GEN_MODE`

  `params` returns the single-valued texture generation function, a symbolic constant. The initial value is `GL_EYE_LINEAR`.

`GL_OBJECT_PLANE`

  `params` 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`

  `params` 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 identity when glTexGen was called.

## Notes

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

For OpenGL versions 1.3 and greater, or when the `ARB_multitexture` extension is supported, `glGetTexGen` returns the texture coordinate generation parameters for the active texture unit.

## Errors

`GL_INVALID_ENUM` is generated if `coord` or `pname` is not an accepted value.

`GL_INVALID_OPERATION` is generated if `glGetTexGen` is executed between the execution of glBegin and the corresponding execution of glEnd.

## See Also

glActiveTexture, glTexGen

## Copyright

Copyright 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.