glGenTextures — generate texture names
void glGenTextures( | GLsizei | n, |
GLuint * | textures) ; |
n
Specifies the number of texture names to be generated.
textures
Specifies an array in which the generated texture names are stored.
glGenTextures
returns n
texture names in textures
.
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 glGenTextures
.
The generated textures have no dimensionality; they assume the dimensionality of the texture target to which they are first bound (see glBindTexture).
Texture names returned by a call to glGenTextures
are not returned by
subsequent calls, unless they are first deleted with
glDeleteTextures.
GL_INVALID_VALUE
is generated if n
is negative.
GL_INVALID_OPERATION
is generated if glGenTextures
is executed
between the execution of glBegin and the corresponding
execution of glEnd.
glBindTexture, glCopyTexImage1D, glCopyTexImage2D, glDeleteTextures, glGet, glGetTexParameter, glTexImage1D, glTexImage2D, glTexImage3D, glTexParameter
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.