GLAPI/glGenTextures: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
m Bot: Adding better formatting.
 
(2 intermediate revisions by one other user not shown)
Line 25: Line 25:
== Errors ==
== Errors ==


{{code|GL_INVALID_VALUE}} is generated if {{param|n}} is negative.
{{enum|GL_INVALID_VALUE}} is generated if {{param|n}} is negative.


== Associated Gets ==
== Associated Gets ==
Line 33: Line 33:
== See Also ==
== See Also ==


{{apifunc|glBindTexture}}, {{apifunc|glCopyTexImage1D}}, {{apifunc|glCopyTexImage2D}}, {{apifunc|glDeleteTextures}}, {{apifunc|glGet}}, {{apifunc|glGetTexParameter}}, {{apifunc|glTexImage1D}}, {{apifunc|glTexImage2D}}, {{apifunc|glTexImage3D}}, {{apifunc|glTexParameter}}
{{apifunc|glBindTexture}}, {{apifunc|glDeleteTextures}}, {{apifunc|glIsTexture}}


== Copyright ==
== 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/ http://oss.sgi.com/projects/FreeB/].
Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see [https://khronos.org/registry/OpenGL-Refpages/LICENSES/LicenseRef-FreeB.txt LicenseRef-FreeB].


[[Category:Core API Reference|GenTextures]]
[[Category:Core API Reference|GenTextures]]
[[Category:Core API Ref Texturing|GenTextures]]
[[Category:Core API Ref Texturing|GenTextures]]

Latest revision as of 21:59, 5 February 2021

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, glDeleteTextures, glIsTexture

Copyright

Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see LicenseRef-FreeB.