'\" e '\"macro stdmacro .ds Vn Version 1.2 .ds Dt 24 September 1999 .ds Re Release 1.2.1 .ds Dp May 22 14:45 .ds Dm 6 May 22 14: .ds Xs 02655 5 .TH GLGETTEXGEN 3G .SH NAME .B "glGetTexGendv, glGetTexGenfv, glGetTexGeniv \- return texture coordinate generation parameters .SH C SPECIFICATION void \f3glGetTexGendv\fP( GLenum \fIcoord\fP, .nf .ta \w'\f3void \fPglGetTexGendv( 'u GLenum \fIpname\fP, GLdouble \fI*params\fP ) .fi void \f3glGetTexGenfv\fP( GLenum \fIcoord\fP, .nf .ta \w'\f3void \fPglGetTexGenfv( 'u GLenum \fIpname\fP, GLfloat \fI*params\fP ) .fi void \f3glGetTexGeniv\fP( GLenum \fIcoord\fP, .nf .ta \w'\f3void \fPglGetTexGeniv( 'u GLenum \fIpname\fP, GLint \fI*params\fP ) .fi .EQ delim $$ .EN .SH PARAMETERS .TP \w'\fIparams\fP\ \ 'u \f2coord\fP Specifies a texture coordinate. Must be \%\f3GL_S\fP, \%\f3GL_T\fP, \%\f3GL_R\fP, or \%\f3GL_Q\fP. .TP \f2pname\fP Specifies the symbolic name of the value(s) to be returned. Must be either \%\f3GL_TEXTURE_GEN_MODE\fP or the name of one of the texture generation plane equations: \%\f3GL_OBJECT_PLANE\fP or \%\f3GL_EYE_PLANE\fP. .TP \f2params\fP Returns the requested data. .SH DESCRIPTION \%\f3glGetTexGen\fP returns in \f2params\fP selected parameters of a texture coordinate generation function that was specified using \%\f3glTexGen\fP. \f2coord\fP names one of the (\f2s\fP, \f2t\fP, \f2r\fP, \f2q\fP) texture coordinates, using the symbolic constant \%\f3GL_S\fP, \%\f3GL_T\fP, \%\f3GL_R\fP, or \%\f3GL_Q\fP. .P \f2pname\fP specifies one of three symbolic names: .TP 28 \%\f3GL_TEXTURE_GEN_MODE\fP \f2params\fP returns the single-valued texture generation function, a symbolic constant. The initial value is \%\f3GL_EYE_LINEAR\fP. .TP \%\f3GL_OBJECT_PLANE\fP \f2params\fP 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. .BP .TP \%\f3GL_EYE_PLANE\fP \f2params\fP 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 \%\f3glTexGen\fP, unless the modelview matrix was identity when \%\f3glTexGen\fP was called. .SH NOTES If an error is generated, no change is made to the contents of \f2params\fP. .P When the \%\f3GL_ARB_multitexture\fP extension is supported, \%\f3glGetTexGen\fP returns the texture coordinate generation parameters for the active texture unit. .SH ERRORS \%\f3GL_INVALID_ENUM\fP is generated if \f2coord\fP or \f2pname\fP is not an accepted value. .P \%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glGetTexGen\fP is executed between the execution of \%\f3glBegin\fP and the corresponding execution of \%\f3glEnd\fP. .SH SEE ALSO \%\f3glActiveTextureARB\fP, \%\f3glTexGen\fP