WebGLRenderingContext.renderbufferStorage()

WebGL API 的 WebGLRenderingContext.renderbufferStorage() 方法用来创建和初始化一个渲染缓冲区对象的数据存储.

语法

void gl.renderbufferStorage(target, internalFormat, width, height);

参数

target
 Glenum (en-US) 指定一个渲染缓冲区对象. 可能的值:
  • gl.RENDERBUFFER:单一图像的缓冲数据存储在一个可渲染的内部格式。
    .
internalFormat
 Glenum (en-US) 指定渲染缓冲区的内部格式. 可能的值:
  • gl.RGBA4: 4 red bits, 4 green bits, 4 blue bits 4 alpha bits.
  • gl.RGB565: 5 red bits, 6 green bits, 5 blue bits.
  • gl.RGB5_A1: 5 red bits, 5 green bits, 5 blue bits, 1 alpha bit.
  • gl.DEPTH_COMPONENT16: 16 depth bits.
  • gl.STENCIL_INDEX8: 8 stencil bits.
  • gl.DEPTH_STENCIL
  • 当使用{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}}时, 下面的值也是可用的:
    • gl.R8
    • gl.R8UI
    • gl.R8I
    • gl.R16UI
    • gl.R16I
    • gl.R32UI
    • gl.R32I
    • gl.RG8
    • gl.RG8UI
    • gl.RG8I
    • gl.RG16UI
    • gl.RG16I
    • gl.RG32UI
    • gl.RG32I
    • gl.RGB8
    • gl.RGBA8
    • gl.SRGB8_ALPHA8 (也可以作为WebGL 1的扩展，参见下面)
    • gl.RGB10_A2
    • gl.RGBA8UI
    • gl.RGBA8I
    • gl.RGB10_A2UI
    • gl.RGBA16UI
    • gl.RGBA16I
    • gl.RGBA32I
    • gl.RGBA32UI
    • gl.DEPTH_COMPONENT24
    • gl.DEPTH_COMPONENT32F
    • gl.DEPTH24_STENCIL8
    • gl.DEPTH32F_STENCIL8
  • 当使用{domxref("WEBGL_color_buffer_float")}} 扩展:
    • ext.RGBA32F_EXT: RGBA 32-bit 浮点类型.
    • ext.RGB32F_EXT: RGB 32-bit 浮点类型.
  • 当使用{domxref("EXT_sRGB")}} 扩展:
    • ext.SRGB8_ALPHA8_EXT: 8-bit sRGB 和 alpha.
  • 当使用{domxref("WebGL2RenderingContext", "WebGL 2 context", "", 1)}} 和 EXT_color_buffer_float (en-US) 扩展:
    • gl.R16F
    • gl.RG16F
    • gl.RGBA16F
    • gl.R32F
    • gl.RG32F
    • gl.RGBA32F
    • gl.R11F_G11F_B10F
width
 GLsizei (en-US) 指定渲染缓冲区的宽度(以像素为单位).
height
 GLsizei (en-US) 指定渲染缓冲区的高度(以像素为单位).

返回值

None.

示例

gl.renderbufferStorage(gl.RENDERBUFFER, gl.RGBA4, 256, 256);

说明

Specification Status Comment
WebGL 1.0
renderbufferStorage		 Recommendation WebGL初始定义.
OpenGL ES 2.0
glRenderbufferStorage		 Standard OpenGL ES 2 API手册.
WebGL 2.0
getRenderbufferParameter		 Editor's Draft WebGL 2更新定义.
OpenGL ES 3.0
glRenderbufferStorage		 Standard  OpenGL ES 3 API手册(类似).
添加许多新的内部格式.

浏览器兼容性

BCD tables only load in the browser

另见