GLAPI/glGenVertexArrays: Difference between revisions

From OpenGL Wiki
Jump to navigation Jump to search
4.0 API.
 
m Bot: Adding better formatting.
 
(5 intermediate revisions by the same user not shown)
Line 8: Line 8:
== Function Definition ==
== Function Definition ==


   void '''glGenVertexArrays'''(GLsizei ''n'', GLuint *''arrays'');
   void '''glGenVertexArrays'''(GLsizei {{param|n}}, GLuint *{{param|arrays}});


; n
; n
Line 17: Line 17:
== Description ==
== Description ==


'''glGenVertexArrays''' returns ''n'' vertex array object names in ''arrays''. 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 '''glGenVertexArrays'''.
'''glGenVertexArrays''' returns {{param|n}} vertex array object names in {{param|arrays}}. 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 '''glGenVertexArrays'''.


Vertex array object names returned by a call to '''glGenVertexArrays''' are not returned by subsequent calls, unless they are first deleted with [[GLAPI/glDeleteVertexArrays|glDeleteVertexArrays]].
Vertex array object names returned by a call to '''glGenVertexArrays''' are not returned by subsequent calls, unless they are first deleted with {{apifunc|glDeleteVertexArrays}}.


The names returned in ''arrays'' are marked as used, for the purposes of '''glGenVertexArrays''' only, but they acquire state and type only when they are first bound.
The names returned in {{param|arrays}} are marked as used, for the purposes of '''glGenVertexArrays''' only, but they acquire state and type only when they are first bound.


== Errors ==
== Errors ==


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


== See Also ==
== See Also ==


[[GLAPI/glBindVertexArray|glBindVertexArray]], [[GLAPI/glDeleteVertexArrays|glDeleteVertexArrays]]
{{apifunc|glBindVertexArray}}, {{apifunc|glIsVertexArray}}, {{apifunc|glDeleteVertexArrays}}


== Copyright ==
== Copyright ==
Line 35: Line 35:
Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. [http://opencontent.org/openpub/ http://opencontent.org/openpub/].
Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. [http://opencontent.org/openpub/ http://opencontent.org/openpub/].


[[Category:API Reference 4|GenVertexArrays]]
[[Category:Core API Ref Vertex Arrays|GenVertexArrays]]
[[Category:Core API Reference|GenVertexArrays]]

Latest revision as of 01:46, 27 September 2012

glGenVertexArrays
Core in version 4.6
Core since version 3.0

glGenVertexArrays: generate vertex array object names

Function Definition

 void glGenVertexArrays(GLsizei n​, GLuint *arrays​);
n
Specifies the number of vertex array object names to generate.
arrays
Specifies an array in which the generated vertex array object names are stored.

Description

glGenVertexArrays returns n​ vertex array object names in arrays​. 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 glGenVertexArrays.

Vertex array object names returned by a call to glGenVertexArrays are not returned by subsequent calls, unless they are first deleted with glDeleteVertexArrays.

The names returned in arrays​ are marked as used, for the purposes of glGenVertexArrays only, but they acquire state and type only when they are first bound.

Errors

GL_INVALID_VALUE is generated if n​ is negative.

See Also

glBindVertexArray, glIsVertexArray, glDeleteVertexArrays

Copyright

Copyright © 2010 Khronos Group. This material may be distributed subject to the terms and conditions set forth in the Open Publication License, v 1.0, 8 June 1999. http://opencontent.org/openpub/.