glRenderbufferStorage

Name

glRenderbufferStorage — create and initialize a renderbuffer object's data store

C Specification

`void glRenderbufferStorage(`	GLenum `target`,
	GLenum `internalformat`,
	GLsizei `width`,
	GLsizei `height)`;

Parameters

target: Specifies the renderbuffer target. The symbolic constant must be GL_RENDERBUFFER.
internalformat: Specifies the color-renderable, depth-renderable, or stencil-renderable format of the renderbuffer. Must be one of the following symbolic constants: GL_RGBA4, GL_RGB565, GL_RGB5_A1, GL_DEPTH_COMPONENT16, or GL_STENCIL_INDEX8.
width: Specifies the width of the renderbuffer in pixels.
height: Specifies the height of the renderbuffer in pixels.

Description

glRenderbufferStorage establishes the data storage, format, and dimensions of a renderbuffer object's image. Any existing data store for the renderbuffer is deleted and the contents of the new data store are undefined.

An implementation may vary its allocation of internal component resolution based on any glRenderbufferStorage parameter (except target), but the allocation and chosen internal format must not be a function of any other state and cannot be changed once they are established. The actual resolution in bits of each component of the allocated image can be queried with glGetRenderbufferParameteriv.

Errors

GL_INVALID_ENUM is generated if target is not GL_RENDERBUFFER.

GL_INVALID_ENUM is generated if internalformat is not an accepted format.

GL_INVALID_VALUE is generated if width or height is less than zero or greater than GL_MAX_RENDERBUFFER_SIZE.

GL_OUT_OF_MEMORY is generated if the implementation is unable to create a data store with the requested width and height.

GL_INVALID_OPERATION is generated if the reserved renderbuffer object name 0 is bound.

Associated Gets

glGetRenderbufferParameteriv