GLAPI/glGenTextures

From OpenGL.org
Jump to: navigation, search
glGenTextures
Core in version 4.4
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, glDeleteTextures, glIsTexture

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