WebGLRenderingContext:bindTexture() 方法
注意:此功能在 Web Workers 中可用。
WebGLRenderingContext.bindTexture() 方法(屬於 WebGL API)將給定的 WebGLTexture 物件繫結到指定的紋理目標(繫結點)。
語法
js
bindTexture(target, texture)
引數
目標-
一個
GLenum,指定繫結點(目標)。可能的值gl.TEXTURE_2D-
二維紋理。
gl.TEXTURE_CUBE_MAP-
立方體貼圖紋理。
使用 WebGL 2 上下文時,還可以使用以下值:
gl.TEXTURE_3D-
三維紋理。
gl.TEXTURE_2D_ARRAY-
二維陣列紋理。
texture-
要繫結的
WebGLTexture物件。如果傳入null,則會解除繫結指定目標上當前繫結的紋理。
返回值
無(undefined)。
異常
如果 target 不是 gl.TEXTURE_2D、gl.TEXTURE_CUBE_MAP、gl.TEXTURE_3D 或 gl.TEXTURE_2D_ARRAY,則會丟擲 gl.INVALID_ENUM 錯誤。
示例
繫結紋理
js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const texture = gl.createTexture();
gl.bindTexture(gl.TEXTURE_2D, texture);
解綁紋理
js
// Unbind any texture currently bound to TEXTURE_2D
gl.bindTexture(gl.TEXTURE_2D, null);
獲取當前繫結
要檢查當前紋理繫結,請查詢 gl.TEXTURE_BINDING_2D 或 gl.TEXTURE_BINDING_CUBE_MAP 常量。
js
gl.getParameter(gl.TEXTURE_BINDING_2D);
規範
| 規範 |
|---|
| WebGL 規範 # 5.14.8 |
| WebGL 2.0 規範 # 3.7.1 |
瀏覽器相容性
載入中…