108 lines
2.9 KiB
Plaintext
108 lines
2.9 KiB
Plaintext
'\" e
|
|
'\"! eqn | mmdoc
|
|
'\"macro stdmacro
|
|
.ds Vn Version 1.2
|
|
.ds Dt 24 September 1999
|
|
.ds Re Release 1.2.1
|
|
.ds Dp Jan 14 18:30
|
|
.ds Dm 01 gettexgen
|
|
.ds Xs 2655 5 gettexgen.gl
|
|
.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(3G)\fP,
|
|
\%\f3glTexGen(3G)\fP
|