GLAPI/glGenTextures: Difference between revisions
m Renaming category: 'GL 4 API Texturing' to 'Core API Ref Texturing'. |
m Bot: Adding better formatting. |
||
| 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 == | ||
{{code|GL_INVALID_VALUE}} is generated if | {{code|GL_INVALID_VALUE}} is generated if {{param|n}} is negative. | ||
== Associated Gets == | == Associated Gets == | ||
{{apifunc|glIsTexture}} | |||
== See Also == | == See Also == | ||
{{apifunc|glBindTexture}}, {{apifunc|glCopyTexImage1D}}, {{apifunc|glCopyTexImage2D}}, {{apifunc|glDeleteTextures}}, {{apifunc|glGet}}, {{apifunc|glGetTexParameter}}, {{apifunc|glTexImage1D}}, {{apifunc|glTexImage2D}}, {{apifunc|glTexImage3D}}, {{apifunc|glTexParameter}} | |||
== Copyright == | == Copyright == | ||
Revision as of 01:18, 29 April 2012
| 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, 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/.