glGenRenderbuffers - OpenGL ES 3.1 Reference Pages

## Name

glGenRenderbuffers — generate renderbuffer object names

## C Specification

`void glGenRenderbuffers(` | GLsizei n,
| GLuint *renderbuffers`)`;

## Parameters

`n`

  Specifies the number of renderbuffer object names to generate.

`renderbuffers`

  Specifies an array in which the generated renderbuffer object names are stored.

## Description

`glGenRenderbuffers` returns `n` renderbuffer object names in `renderbuffers`. 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 `glGenRenderbuffers`.

Renderbuffer object names returned by a call to `glGenRenderbuffers` are not returned by subsequent calls, unless they are first deleted with glDeleteRenderbuffers.

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

## Errors

`GL_INVALID_VALUE` is generated if `n` is negative.

## Associated Gets

glIsRenderbuffer, glGetRenderbufferParameteriv

## API Version Support

| OpenGL ES API Version
--- | ---
Function Name | 2.0 | 3.0 | 3.1
glGenRenderbuffers | ✔ | ✔ | ✔

## See Also

glBindRenderbuffer, glFramebufferRenderbuffer, glDeleteRenderbuffers

## Copyright

Copyright © 2010-2014 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/.