GLAPI/glGenTextures

From OpenGL Wiki
Revision as of 20:46, 27 December 2011 by Alfonse (talk | contribs) (4.0 API.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search
glGenTextures
Core in version 4.6
Core since version 1.1

glGenTextures: generate texture names

Function Definition

 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.

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.

Errors

GL_INVALID_VALUE is generated if n is negative.

Associated Gets

glIsTexture

See Also

glBindTexture, glCopyTexImage1D, glCopyTexImage2D, glDeleteTextures, glGet, glGetTexParameter, glTexImage1D, glTexImage2D, glTexImage3D, glTexParameter

Copyright

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/.