GLAPI/glGenTextures: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
4.0 API.
 
m Bot: Adjusting API page category.
Line 40: Line 40:


[[Category:API Reference 4|GenTextures]]
[[Category:API Reference 4|GenTextures]]
[[Category:GL 4 API Texturing|GenTextures]]

Revision as of 03:16, 26 February 2012

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