WebGL
WebGL2RenderingContext 接口在底层使用了 OpenGL ES 3.0 为 HTML 的 canvas 元素提供了绘图上下文。
要获取该接口的实例对象需要调用一个 <canvas> 标签对象的 HTMLCanvasElement.getContext() 函数,并将 "webgl2" 作为参数传递:
var canvas = document.getElementById("myCanvas");
var gl = canvas.getContext("webgl2");
[!NOTE] 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
WebGLFramebufferinto an existing 3D texture sub-image.
- : Copies pixels from the current
- 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()
- : 指定一个 uniform 变量。
- WebGL2RenderingContext.uniformMatrix()
- : 指定一个 uniform 矩阵变量。
- WebGL2RenderingContext.vertexAttribI()
- : 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 WebGL2RenderingContext.drawArraysInstanced() and WebGL2RenderingContext.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()
- : Clears buffers from the currently bound framebuffer.
查询对象
Methods for working with WebGLQuery objects.
- WebGL2RenderingContext.createQuery()
- : 创建一个新的 WebGLQuery 对象。
- WebGL2RenderingContext.deleteQuery()
- : 删除一个指定的 WebGLQuery 对象。
- WebGL2RenderingContext.isQuery()
- : Returns
trueif a given object is a valid WebGLQuery object.
- : Returns
- WebGL2RenderingContext.beginQuery()
- : 开始一个异步查询。
- WebGL2RenderingContext.endQuery()
- : Marks the end of an asynchronous query.
- WebGL2RenderingContext.getQuery()
- : 返回一个指定目标的 WebGLQuery 对象。
- WebGL2RenderingContext.getQueryParameter()
- : 返回关于一个查询的信息。
采样对象
- WebGL2RenderingContext.createSampler()
- : Creates a new WebGLSampler object.
- WebGL2RenderingContext.deleteSampler()
- : Deletes a given WebGLSampler object.
- WebGL2RenderingContext.bindSampler()
- : Binds a given WebGLSampler to a texture unit.
- WebGL2RenderingContext.isSampler()
- : Returns
trueif a given object is a valid WebGLSampler object.
- : Returns
- WebGL2RenderingContext.samplerParameter()
- : Sets sampler parameters.
- WebGL2RenderingContext.getSamplerParameter()
- : Returns sampler parameter information.
同步对象
- WebGL2RenderingContext.fenceSync()
- : 创建一个 WebGLSync 对象并插入到 GL 命令流中。
- WebGL2RenderingContext.isSync()
- : Returns
trueif the passed object is a valid WebGLSync object.
- : Returns
- WebGL2RenderingContext.deleteSync()
- : 删除一个指定的 WebGLSync 对象。
- WebGL2RenderingContext.clientWaitSync()
- : Blocks and waits for a WebGLSync object to become signaled or a given timeout to be passed.
- WebGL2RenderingContext.waitSync()
- : Returns immediately, but waits on the GL server until the given WebGLSync object is signaled.
- WebGL2RenderingContext.getSyncParameter()
- : 根据一个 WebGLSync 对象返回参数信息。
变换反馈
- WebGL2RenderingContext.createTransformFeedback()
- : 创建并初始化 WebGLTransformFeedback 对象。
- WebGL2RenderingContext.deleteTransformFeedback()
- : 删除一个指定的 WebGLTransformFeedback 对象。
- WebGL2RenderingContext.isTransformFeedback()
- : Returns
trueif the passed object is a valid WebGLTransformFeedback object.
- : Returns
- WebGL2RenderingContext.bindTransformFeedback()
- : Binds a passed WebGLTransformFeedback object to the current GL state.
- WebGL2RenderingContext.beginTransformFeedback()
- : Starts a transform feedback operation.
- WebGL2RenderingContext.endTransformFeedback()
- : Ends a transform feedback operation.
- WebGL2RenderingContext.transformFeedbackVaryings()
- : Specifies values to record in WebGLTransformFeedback buffers.
- WebGL2RenderingContext.getTransformFeedbackVarying()
- : Returns information about varying variables from WebGLTransformFeedback buffers.
- WebGL2RenderingContext.pauseTransformFeedback()
- : Pauses a transform feedback operation.
- WebGL2RenderingContext.resumeTransformFeedback()
- : Resumes a transform feedback operation.
Uniform 缓冲对象
- WebGL2RenderingContext.bindBufferBase()
- : Binds a given WebGLBuffer to a given binding point (
target) at a givenindex.
- : Binds a given WebGLBuffer to a given binding point (
- WebGL2RenderingContext.bindBufferRange()
- : Binds a range of a given WebGLBuffer to a given binding point (
target) at a givenindex.
- : Binds a range of a given WebGLBuffer to a given binding point (
- WebGL2RenderingContext.getUniformIndices()
- : Retrieves the indices of a number of uniforms within a WebGLProgram.
- WebGL2RenderingContext.getActiveUniforms()
- : Retrieves information about active uniforms within a WebGLProgram.
- WebGL2RenderingContext.getUniformBlockIndex()
- : Retrieves the index of a uniform block within a WebGLProgram.
- WebGL2RenderingContext.getActiveUniformBlockParameter()
- : Retrieves information about an active uniform block within a WebGLProgram.
- WebGL2RenderingContext.getActiveUniformBlockName()
- : Retrieves the name of the active uniform block at a given index within a WebGLProgram.
- WebGL2RenderingContext.uniformBlockBinding()
- : Assigns binding points for active uniform blocks.
顶点数组对象
Methods for working with WebGLVertexArrayObject (VAO) objects.
- WebGL2RenderingContext.createVertexArray()
- : 创建一个新的 WebGLVertexArrayObject。
- WebGL2RenderingContext.deleteVertexArray()
- : 删除一个指定的 WebGLVertexArrayObject。
- WebGL2RenderingContext.isVertexArray()
- : 如果一个指定的 WebGLVertexArrayObject 对象有效则返回
true。
- : 如果一个指定的 WebGLVertexArrayObject 对象有效则返回
- WebGL2RenderingContext.bindVertexArray()
- : 绑定一个指定的 WebGLVertexArrayObject 到缓冲。
规范
浏览器兼容性
相关链接
- HTMLCanvasElement
- WebGLRenderingContext
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
