大网数据广告活动
Web 标准与前端开发

WebGLTexture

· 52CE 我爱测

WebGLTexture** 接口是 WebGL API 的一部分,表示一个不透明的纹理对象,为纹理操作提供存储和状态。

WebGL

WebGLTexture 接口是 WebGL API 的一部分,表示一个不透明的纹理对象,为纹理操作提供存储和状态。

WebGL 纹理

WebGLTexture 对象自身未定义任何方法或属性,其内容也无法直接访问。使用 WebGLTexture 对象时,WebGLRenderingContext 的下列方法很有用:

  • WebGLRenderingContext.bindTexture()
  • WebGLRenderingContext.createTexture()
  • WebGLRenderingContext.deleteTexture()
  • WebGLRenderingContext.isTexture()

另请参阅 WebGL 教程中的在 WebGL 中使用纹理。

WebXR 不透明纹理

使用 WebXR 图层时,XRWebGLBinding 对象会为颜色附件和深度/模板附件返回不透明的 WebGLTexture 实例。

返回不透明 WebGLTexture 对象的 WebXR 方法:

  • XRWebGLBinding.getSubImage()
  • XRWebGLBinding.getViewSubImage()

WebXR 不透明纹理与标准 WebGLTexture 相同,但有以下例外:

  • 在其会话的 WebXR requestAnimationFrame() 回调之外,WebXR 不透明纹理无效。
  • 在由 XRWebGLBinding.getSubImage() 或 XRWebGLBinding.getViewSubImage() 返回之前,WebXR 不透明纹理无效。
  • 用于颜色附件的 WebXR 不透明纹理包含预乘 alpha 的颜色。
  • 在 requestAnimationFrame() 回调结束时,WebXR 不透明纹理会被解除绑定,并与所有 WebGLShader 对象分离。
  • 即使使用 WebGL 1.0 上下文,WebXR 不透明纹理的行为也如同使用 WebGL2RenderingContext.texStorage2D 或 WebGL2RenderingContext.texStorage3D(视情况而定)分配。
  • 若对 WebXR 不透明纹理调用 WebGLRenderingContext.deleteTexture(),将抛出 INVALID_OPERATION 错误。
  • 不允许更改 WebXR 不透明纹理的尺寸或格式。GL 函数只能修改纹素(texel)值和纹理参数。

示例

创建纹理

const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const texture = gl.createTexture();

规范

浏览器兼容性

参见

  • WebGLRenderingContext.bindTexture()
  • WebGLRenderingContext.createTexture()
  • WebGLRenderingContext.deleteTexture()
  • WebGLRenderingContext.isTexture()
  • WebGLRenderingContext.compressedTexImage2D()
  • WebGLRenderingContext.compressedTexSubImage2D()
  • WebGLRenderingContext.copyTexImage2D()
  • WebGLRenderingContext.copyTexSubImage2D()
  • WebGLRenderingContext.generateMipmap()
  • WebGLRenderingContext.getTexParameter()
  • WebGLRenderingContext.texImage2D()
  • WebGLRenderingContext.texSubImage2D()
  • WebGLRenderingContext/texParameter
  • WebGLRenderingContext/texParameter

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。