GLES3.0中文API-glRenderbufferStorage

名称

glRenderbufferStorage - 创建并初始化renderbuffer对象的数据存储

C规范

void glRenderbufferStorage（GLenum target,

                                                    GLenum internalformat,

                                                    GLsizei width,

                                                    GLsizei height）;

参数

target

指定renderbuffer目标。 符号常量必须为GL_RENDERBUFFER。

internalformat

指定渲染缓冲区的颜色可渲染，深度可渲染或模板可渲染格式。 必须是以下符号常量之一：GL_RGBA4，GL_RGB565，GL_RGB5_A1，GL_DEPTH_COMPONENT16或GL_STENCIL_INDEX8。

width

指定渲染缓冲区的宽度（以像素为单位）。

height

指定渲染缓冲区的高度（以像素为单位）。

描述

glRenderbufferStorage建立renderbuffer对象图像的数据存储，格式和尺寸。 删除渲染缓冲区的任何现有数据存储，则新数据存储的内容为未定义的。

实现可以基于任何glRenderbufferStorage参数（target除外）改变其内部组件分辨率的分配，但是分配和选择的内部格式不能是任何其他状态的函数，并且一旦建立就不能改变。 可以使用glGetRenderbufferParameteriv查询分配的图像的每个分量的实际分辨率。

错误

GL_INVALID_ENUM ：target不是GL_RENDERBUFFER。

GL_INVALID_ENUM ：internalformat不是可接受的值。

GL_INVALID_VALUE ：如果width或height小于零或大于GL_MAX_RENDERBUFFER_SIZE。

GL_OUT_OF_MEMORY ：如果实现无法创建具有请求的width和height的数据存储。

GL_INVALID_OPERATION ：如果绑定了保留的renderbuffer对象名称0。

相关Gets

glGetRenderbufferParameteriv

另见

glBindRenderbuffer，glDeleteRenderbuffers，glFramebufferRenderbuffer，glGenRenderbuffers，glGetRenderbufferParameteriv，glIsRenderbuffer

版权

https://www.khronos.org/registry/OpenGL-Refpages/es3.0/html/glRenderbufferStorage.xhtml