WebGLRenderingContext: getRenderbufferParameter() 方法

Baseline 已广泛支持

此特性已相当成熟,可在许多设备和浏览器版本上使用。自 ⁨2015 年 7 月⁩以来,各浏览器均已提供此特性。

注意:此功能在 Web Workers 中可用。

WebGLRenderingContext.getRenderbufferParameter() 方法是 WebGL API 的一部分,用于返回有关渲染缓冲区的信息。

语法

js
getRenderbufferParameter(target, pname)

参数

目标

一个 GLenum,指定目标渲染缓冲区对象。可能的值

gl.RENDERBUFFER

为具有可渲染内部格式的单个图像提供缓冲区数据存储。

pname

一个 GLenum,指定要查询的信息。可能的值

gl.RENDERBUFFER_WIDTH

返回一个 GLint,表示当前绑定的渲染缓冲区的图像宽度。

gl.RENDERBUFFER_HEIGHT

返回一个 GLint,表示当前绑定的渲染缓冲区的图像高度。

gl.RENDERBUFFER_INTERNAL_FORMAT

返回一个 GLenum,表示当前绑定的渲染缓冲区的内部格式。默认为 gl.RGBA4。可能的返回值

  • gl.RGBA4:4 位红色、4 位绿色、4 位蓝色和 4 位 Alpha。
  • gl.RGB565:5 位红色、6 位绿色、5 位蓝色。
  • gl.RGB5_A1:5 位红色、5 位绿色、5 位蓝色、1 位 Alpha。
  • gl.DEPTH_COMPONENT16:16 位深度。
  • gl.STENCIL_INDEX8:8 位模板。
gl.RENDERBUFFER_GREEN_SIZE

返回一个 GLint,表示绿色颜色的分辨率大小(以位为单位)。

gl.RENDERBUFFER_BLUE_SIZE

返回一个 GLint,表示蓝色颜色的分辨率大小(以位为单位)。

gl.RENDERBUFFER_RED_SIZE

返回一个 GLint,表示红色颜色的分辨率大小(以位为单位)。

gl.RENDERBUFFER_ALPHA_SIZE

返回一个 GLint,表示 Alpha 分辨率大小(以位为单位)。

gl.RENDERBUFFER_DEPTH_SIZE

返回一个 GLint,表示深度分辨率大小(以位为单位)。

gl.RENDERBUFFER_STENCIL_SIZE

返回一个 GLint,表示模板分辨率大小(以位为单位)。

当使用 WebGL 2 context 时,还可以使用以下值:

gl.RENDERBUFFER_SAMPLES

返回一个 GLint,表示当前绑定的渲染缓冲区的图像样本数。

返回值

取决于请求的信息(通过 pname 指定)。返回 GLintGLenum

示例

js
gl.getRenderbufferParameter(gl.RENDERBUFFER, gl.RENDERBUFFER_WIDTH);

规范

规范
WebGL 规范
# 5.14.7
WebGL 2.0 规范
# 3.7.5

浏览器兼容性

另见