xenocara/doc/gl-docs/GL/gl/gentextures.3gl
2006-11-29 17:00:35 +00:00

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