xenocara/doc/gl-docs/GL/gl/deletetextures.3gl

61 lines
1.7 KiB
Plaintext
Raw Normal View History

'\" 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 deletetex
.ds Xs 39225 4 deletetextures.gl
.TH GLDELETETEXTURES 3G
.SH NAME
.B "glDeleteTextures
\- delete named textures
.SH C SPECIFICATION
void \f3glDeleteTextures\fP(
GLsizei \fIn\fP,
.nf
.ta \w'\f3void \fPglDeleteTextures( 'u
const GLuint \fI*textures\fP )
.fi
.SH PARAMETERS
.TP \w'\fItextures\fP\ \ 'u
\f2n\fP
Specifies the number of textures to be deleted.
.TP
\f2textures\fP
Specifies an array of textures to be deleted.
.SH DESCRIPTION
\%\f3glDeleteTextures\fP deletes \f2n\fP textures named by the elements of the array \f2textures\fP.
After a texture is deleted, it has no contents or dimensionality,
and its name is free for reuse (for example by \%\f3glGenTextures\fP).
If a texture that is currently bound is deleted, the binding reverts
to 0 (the default texture).
.P
\%\f3glDeleteTextures\fP silently ignores 0's and names that do not correspond to
existing textures.
.SH NOTES
\%\f3glDeleteTextures\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 \%\f3glDeleteTextures\fP is executed
between the execution of \%\f3glBegin\fP and the corresponding
execution of \%\f3glEnd\fP.
.SH ASSOCIATED GETS
\%\f3glIsTexture\fP
.SH SEE ALSO
\%\f3glAreTexturesResident(3G)\fP,
\%\f3glBindTexture(3G)\fP,
\%\f3glCopyTexImage1D(3G)\fP,
\%\f3glCopyTexImage2D(3G)\fP,
\%\f3glGenTextures(3G)\fP,
\%\f3glGet(3G)\fP,
\%\f3glGetTexParameter(3G)\fP,
\%\f3glPrioritizeTextures(3G)\fP,
\%\f3glTexImage1D(3G)\fP,
\%\f3glTexImage2D(3G)\fP,
\%\f3glTexParameter(3G)\fP