当前位置：文江博客知识库简体中文文档 Web API WebGL2RenderingContext

WebGL2RenderingContext - Web API 接口参考编辑

这是一个实验中的功能
此功能某些浏览器尚在开发中，请参考浏览器兼容性表格以得到在不同浏览器中适合使用的前缀。由于该功能对应的标准文档可能被重新修订，所以在未来版本的浏览器中该功能的语法和行为可能随之改变。

WebGL2RenderingContext 接口在底层使用了OpenGL ES 3.0 为 HTML 的 <canvas> 元素提供了绘图上下文。

要获取该接口的实例对象需要调用一个 <canvas> 标签对象的 getContext() 函数，并将 "webgl2" 作为参数传递：

var canvas = document.getElementById('myCanvas');
var gl = canvas.getContext('webgl2');

WebGL 2 是 WebGL 1 的扩展。 WebGL2RenderingContext 接口实现了 WebGLRenderingContext 接口的所有成员。有一些 WebGL 1 上下文中的方法在使用 WebGL 2 上下文的时候可以接受附加值。您可以通过 WebGL 1 的参考页了解这些信息。

这个 WebGL 教程中提供了关于如何开始使用 WebGL 的更多信息、示例以及资源。

常量

请看 WebGL 常量页面。

状态信息

WebGL2RenderingContext.getIndexedParameter(): 返回指定目标的索引值。

缓冲区

WebGL2RenderingContext.copyBufferSubData(): 将缓冲区的部分数据复制到另一个缓冲区。
WebGL2RenderingContext.getBufferSubData(): 从缓冲区中读取数据，然后将其写入到 ArrayBuffer 或 SharedArrayBuffer 中。

帧缓冲区

WebGL2RenderingContext.blitFramebuffer(): 将一个像素块从读取帧缓冲区传输到绘制帧缓冲区。
WebGL2RenderingContext.framebufferTextureLayer(): 附着一个单层的材质到帧缓冲区。
WebGL2RenderingContext.invalidateFramebuffer(): 使附着到缓冲区的内容失效。
WebGL2RenderingContext.invalidateSubFramebuffer(): 使附着到缓冲区的部分内容失效。
WebGL2RenderingContext.readBuffer(): 选择一个颜色缓冲作为像素的source。

渲染缓冲区

WebGL2RenderingContext.getInternalformatParameter(): Returns information about implementation-dependent support for internal formats.
WebGL2RenderingContext.renderbufferStorageMultisample(): Creates and initializes a renderbuffer object's data store and allows specifying the number of samples to be used.

纹理

WebGL2RenderingContext.texStorage2D(): Specifies all levels of two-dimensional texture storage.
WebGL2RenderingContext.texStorage3D(): Specifies all levels of a three-dimensional texture or two-dimensional array texture.
WebGL2RenderingContext.texImage3D(): Specifies a three-dimensional texture image.
WebGL2RenderingContext.texSubImage3D(): Specifies a sub-rectangle of the current 3D texture.
WebGL2RenderingContext.copyTexSubImage3D(): Copies pixels from the current WebGLFramebuffer into an existing 3D texture sub-image.
WebGL2RenderingContext.compressedTexImage3D(): Specifies a three-dimensional texture image in a compressed format.
WebGL2RenderingContext.compressedTexSubImage3D(): Specifies a three-dimensional sub-rectangle for a texture image in a compressed format.

程序和着色器

WebGL2RenderingContext.getFragDataLocation(): Returns the binding of color numbers to user-defined varying out variables.

Uniforms 和 Attributes

WebGL2RenderingContext.uniform[1234][fiu][v](): 指定一个uniform变量。
WebGL2RenderingContext.uniformMatrix[1234][fv](): 指定一个uniform矩阵变量。
WebGL2RenderingContext.vertexAttribI[iuv](): Methods specifying integer values for generic vertex attributes.
WebGL2RenderingContext.vertexAttribIPointer(): Specifies integer data formats and locations of vertex attributes in a vertex attributes array.

绘图缓冲区

WebGL2RenderingContext.vertexAttribDivisor(): Modifies the rate at which generic vertex attributes advance when rendering multiple instances of primitives with gl.drawArraysInstanced() and gl.drawElementsInstanced().
WebGL2RenderingContext.drawArraysInstanced(): Renders primitives from array data. In addition, it can execute multiple instances of the range of elements.
WebGL2RenderingContext.drawElementsInstanced(): Renders primitives from array data. In addition, it can execute multiple instances of a set of elements.
WebGL2RenderingContext.drawRangeElements(): Renders primitives from array data in a given range.
WebGL2RenderingContext.drawBuffers(): Specifies a list of color buffers to be drawn into.
WebGL2RenderingContext.clearBuffer[fiuv](): Clears buffers from the currently bound framebuffer.