glGenFramebuffers - OpenGL 4 Reference Pages

## Name

glGenFramebuffers — generate framebuffer object names

## C Specification

`void glGenFramebuffers(` | GLsizei n,
| GLuint *ids`)`;

## Parameters

`n`

  Specifies the number of framebuffer object names to generate.

`ids`

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

## Description

`glGenFramebuffers` returns `n` framebuffer object names in `ids`. 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 `glGenFramebuffers`.

Framebuffer object names returned by a call to `glGenFramebuffers` are not returned by subsequent calls, unless they are first deleted with glDeleteFramebuffers.

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

## Errors

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

## Version Support

| OpenGL Version
--- | ---
Function / Feature Name | 2.0 | 2.1 | 3.0 | 3.1 | 3.2 | 3.3 | 4.0 | 4.1 | 4.2 | 4.3 | 4.4 | 4.5
`glGenFramebuffers` | - | - | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔

## See Also

glBindFramebuffer, glDeleteFramebuffers

## 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/.