glGenTextures(3G) OpenGL Reference glGenTextures(3G)
NAME
glGenTextures - generate texture names
C SPECIFICATION
void glGenTextures( GLsizei n,
GLuint *textures )
PARAMETERS
n Specifies the number of texture names to be generated.
textures Specifies an array in which the generated texture names are
stored.
DESCRIPTION
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.
NOTES
glGenTextures is available only if the GL version is 1.1 or greater.
ERRORS
GLINVALIDVALUE is generated if n is negative.
GLINVALIDOPERATION is generated if glGenTextures is executed between
the execution of glBegin and the corresponding execution of glEnd.
ASSOCIATED GETS
glIsTexture
MACHINE DEPENDENCIES
RealityEngine, RealityEngine2, and VTX systems do not support texture
name sharing. Texture names are always local to the rendering context
which was active at the time the names were created.
The implementation on O2 systems uses a minimum of 64K bytes for every
texture object defined.
Page 1
glGenTextures(3G) OpenGL Reference glGenTextures(3G)
SEE ALSO
glBindTexture, glCopyTexImage1D, glCopyTexImage2D, glDeleteTextures,
glGet, glGetTexParameter, glTexImage1D, glTexImage2D, glTexImage3DEXT,
glTexParameter
Page 2