64 lines
1.8 KiB
Plaintext
64 lines
1.8 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 gentextur
|
||
|
.ds Xs 11752 4 gentextures.gl
|
||
|
.TH GLGENTEXTURES 3G
|
||
|
.SH NAME
|
||
|
.B "glGenTextures
|
||
|
\- generate texture names
|
||
|
|
||
|
.SH C SPECIFICATION
|
||
|
void \f3glGenTextures\fP(
|
||
|
GLsizei \fIn\fP,
|
||
|
.nf
|
||
|
.ta \w'\f3void \fPglGenTextures( 'u
|
||
|
GLuint \fI*textures\fP )
|
||
|
.fi
|
||
|
|
||
|
.SH PARAMETERS
|
||
|
.TP \w'\fItextures\fP\ \ 'u
|
||
|
\f2n\fP
|
||
|
Specifies the number of texture names to be generated.
|
||
|
.TP
|
||
|
\f2textures\fP
|
||
|
Specifies an array in which the generated texture names are stored.
|
||
|
.SH DESCRIPTION
|
||
|
\%\f3glGenTextures\fP returns \f2n\fP texture names in \f2textures\fP.
|
||
|
There is no guarantee that the names form a contiguous set of integers;
|
||
|
however, it is guaranteed that none of the returned names was in use
|
||
|
immediately before the call to \%\f3glGenTextures\fP.
|
||
|
.P
|
||
|
The generated textures have no dimensionality; they assume the dimensionality
|
||
|
of the texture target to which they are first bound
|
||
|
(see \%\f3glBindTexture\fP).
|
||
|
.P
|
||
|
Texture names returned by a call to \%\f3glGenTextures\fP are not returned by
|
||
|
subsequent calls, unless they are first deleted with
|
||
|
\%\f3glDeleteTextures\fP.
|
||
|
.SH NOTES
|
||
|
\%\f3glGenTextures\fP is available only if the GL version is 1.1 or greater.
|
||
|
.SH ERRORS
|
||
|
\%\f3GL_INVALID_VALUE\fP is generated if \f2n\fP is negative.
|
||
|
.P
|
||
|
\%\f3GL_INVALID_OPERATION\fP is generated if \%\f3glGenTextures\fP is executed
|
||
|
between the execution of \%\f3glBegin\fP and the corresponding
|
||
|
execution of \%\f3glEnd\fP.
|
||
|
.SH ASSOCIATED GETS
|
||
|
\%\f3glIsTexture\fP
|
||
|
.SH SEE ALSO
|
||
|
\%\f3glBindTexture(3G)\fP,
|
||
|
\%\f3glCopyTexImage1D(3G)\fP,
|
||
|
\%\f3glCopyTexImage2D(3G)\fP,
|
||
|
\%\f3glDeleteTextures(3G)\fP,
|
||
|
\%\f3glGet(3G)\fP,
|
||
|
\%\f3glGetTexParameter(3G)\fP,
|
||
|
\%\f3glTexImage1D(3G)\fP,
|
||
|
\%\f3glTexImage2D(3G)\fP,
|
||
|
\%\f3glTexImage3D(3G)\fP,
|
||
|
\%\f3glTexParameter(3G)\fP
|