GLAPI/glGenBuffers: Difference between revisions
m Renaming category: 'API Reference 4' to 'Core API Reference'. |
m Bot: Adding better formatting. |
||
| Line 8: | Line 8: | ||
== Function Definition == | == Function Definition == | ||
void '''glGenBuffers'''(GLsizei | void '''glGenBuffers'''(GLsizei {{param|n}}, GLuint * {{param|buffers}}); | ||
; n | ; n | ||
| Line 17: | Line 17: | ||
== Description == | == Description == | ||
'''glGenBuffers''' returns | '''glGenBuffers''' returns {{param|n}} buffer object names in {{param|buffers}}. 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 '''glGenBuffers'''. | ||
Buffer object names returned by a call to '''glGenBuffers''' are not returned by subsequent calls, unless they are first deleted with | Buffer object names returned by a call to '''glGenBuffers''' are not returned by subsequent calls, unless they are first deleted with {{apifunc|glDeleteBuffers}}. | ||
No buffer objects are associated with the returned buffer object names until they are first bound by calling | No buffer objects are associated with the returned buffer object names until they are first bound by calling {{apifunc|glBindBuffer}}. | ||
== 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|glIsBuffer}} | |||
== See Also == | == See Also == | ||
{{apifunc|glBindBuffer}}, {{apifunc|glDeleteBuffers}}, {{apifunc|glGet}} | |||
== Copyright == | == Copyright == | ||
Revision as of 01:18, 29 April 2012
| Core in version | 4.6 | |
|---|---|---|
| Core since version | 1.5 | |
glGenBuffers: generate buffer object names
Function Definition
void glGenBuffers(GLsizei n, GLuint * buffers);
- n
- Specifies the number of buffer object names to be generated.
- buffers
- Specifies an array in which the generated buffer object names are stored.
Description
glGenBuffers returns n buffer object names in buffers. 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 glGenBuffers.
Buffer object names returned by a call to glGenBuffers are not returned by subsequent calls, unless they are first deleted with glDeleteBuffers.
No buffer objects are associated with the returned buffer object names until they are first bound by calling glBindBuffer.
Errors
GL_INVALID_VALUE is generated if n is negative.
Associated Gets
See Also
glBindBuffer, glDeleteBuffers, glGet
Copyright
Copyright © 2005 Addison-Wesley. 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/.