GLAPI/glGenTextures: Difference between revisions
< GLAPI
4.0 API. |
JeffKhronos (talk | contribs) |
||
| (6 intermediate revisions by one other user not shown) | |||
| Line 8: | Line 8: | ||
== Function Definition == | == Function Definition == | ||
void '''glGenTextures'''(GLsizei | void '''glGenTextures'''(GLsizei {{param|n}}, GLuint * {{param|textures}}); | ||
; n | ; n | ||
| Line 17: | Line 17: | ||
== Description == | == Description == | ||
'''glGenTextures''' returns | '''glGenTextures''' returns {{param|n}} texture names in {{param|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 | The generated textures have no dimensionality; they assume the dimensionality of the texture target to which they are first bound (see {{apifunc|glBindTexture}}). | ||
Texture names returned by a call to '''glGenTextures''' are not returned by subsequent calls, unless they are first deleted with | Texture names returned by a call to '''glGenTextures''' are not returned by subsequent calls, unless they are first deleted with {{apifunc|glDeleteTextures}}. | ||
== Errors == | == Errors == | ||
{{ | {{enum|GL_INVALID_VALUE}} is generated if {{param|n}} is negative. | ||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glIsTexture}} | |||
== See Also == | == See Also == | ||
{{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 [ | 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:API Reference | [[Category:Core API Reference|GenTextures]] | ||
[[Category:Core API Ref Texturing|GenTextures]] | |||
Latest revision as of 21:59, 5 February 2021
| 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
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.