WebGLRenderingContext.renderbufferStorage()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

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

语法

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

参数

target

Glenum 指定一个渲染缓冲区对象。可能的值:

  • gl.RENDERBUFFER:单一图像的缓冲数据存储在一个可渲染的内部格式。 .
internalFormat

Glenum 指定渲染缓冲区的内部格式。可能的值:

  • 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 扩展:

    • gl.R16F
    • gl.RG16F
    • gl.RGBA16F
    • gl.R32F
    • gl.RG32F
    • gl.RGBA32F
    • gl.R11F_G11F_B10F
width

GLsizei 指定渲染缓冲区的宽度 (以像素为单位).

height

GLsizei 指定渲染缓冲区的高度 (以像素为单位).

返回值

None.

示例

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

规范

Specification
WebGL Specification
# 5.14.7
WebGL 2.0 Specification
# 3.7.5

浏览器兼容性

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
renderbufferStorage

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

参见