这是 实验性技术
检查 浏览器兼容性表格 要小心谨慎在生产中使用这之前。

WebGL2RenderingContext.texSubImage3D() 方法在 WebGL API specifies a sub-rectangle of the current texture.

句法

void gl.texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, ArrayBufferView? srcData, optional srcOffset);
void gl.texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, ImageBitmap? pixels);
void gl.texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, ImageData? pixels);
void gl.texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, HTMLImageElement? pixels);
void gl.texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, HTMLCanvasElement? pixels);
void gl.texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, HTMLVideoElement? pixels);
void gl.texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, GLintptr offset);
							

参数

target

A GLenum specifying the binding point (target) of the active texture. Possible values:

• gl.TEXTURE_3D : A three-dimensional texture.
• gl.TEXTURE_2D_ARRAY : A two-dimensional array texture.

level

A GLint specifying the level of detail. Level 0 is the base image level and level n 是 n th mipmap reduction level.

xoffset

A GLint specifying the x offset within the texture image.

yoffset

A GLint specifying the y offset within the texture image.

zoffset

A GLint specifying the z offset within the texture image.

width

A GLsizei specifying the width of the texture.

height

A GLsizei specifying the height of the texture.

depth

A GLsizei specifying the depth of the texture.

format

A GLenum specifying the format of the texel data. Possible values:

• gl.ALPHA : Discards the red, green and blue components and reads the alpha component.
• gl.RGB : Discards the alpha components and reads the red, green and blue components.
• gl.RGBA : Red, green, blue and alpha components are read from the color buffer.
• gl.LUMINANCE : Each color component is a luminance component, alpha is 1.0.
• gl.LUMINANCE_ALPHA : Each component is a luminance/alpha component.
• gl.R8
• gl.R16F
• gl. R32F
• gl.R8UI
• gl.RG8
• gl.RG16F
• gl.RG32F
• gl.RGUI
• gl.RGB8
• gl.SRGB8
• gl.RGB565
• gl.R11F_G11F_B10F
• gl.RGB9_E5
• gl.RGB16F
• gl.RGB32F
• gl.RGB8UI
• gl.RGBA8
• gl.SRGB_APLHA8
• gl.RGB5_A1
• gl.RGBA4444
• gl.RGBA16F
• gl.RGBA32F
• gl.RGBA8UI

type

A GLenum specifying the data type of the texel data. Possible values:

• gl.UNSIGNED_BYTE : 8 bits per channel for gl.RGBA
• gl.UNSIGNED_SHORT_5_6_5 : 5 red bits, 6 green bits, 5 blue bits.
• gl.UNSIGNED_SHORT_4_4_4_4 : 4 red bits, 4 green bits, 4 blue bits, 4 alpha bits.
• gl.UNSIGNED_SHORT_5_5_5_1 : 5 red bits, 5 green bits, 5 blue bits, 1 alpha bit.
• gl.BYTE
• gl.UNSIGNED_SHORT
• gl.SHORT
• gl.UNSIGNED_INT
• gl.INT
• gl.HALF_FLOAT
• gl.FLOAT
• gl.UNSIGNED_INT_2_10_10_10_REV
• gl.UNSIGNED_INT_10F_11F_11F_REV
• gl.UNSIGNED_INT_5_9_9_9_REV
• gl.UNSIGNED_INT_24_8
• gl.FLOAT_32_UNSIGNED_INT_24_8_REV (pixels must be null )

pixels

One of the following objects can be used as a pixel source for the texture:

• ArrayBufferView ,
  • A Uint8Array must be used if type is gl.UNSIGNED_BYTE .
  • A Uint16Array must be used if type 是 gl.UNSIGNED_SHORT_5_6_5 , gl.UNSIGNED_SHORT_4_4_4_4 , gl.UNSIGNED_SHORT_5_5_5_1 ，或 ext.HALF_FLOAT_OES .
  • A Float32Array must be used if type is gl.FLOAT .
• ImageBitmap ,
• ImageData ,
• HTMLImageElement ,
• HTMLCanvasElement ,
• HTMLVideoElement .

offset

A GLintptr byte offset into the WebGLBuffer 's data store. Used to upload data to the currently bound WebGLTexture 从 WebGLBuffer bound to the PIXEL_UNPACK_BUFFER 目标。

返回值

None.

范例

gl.texSubImage3D(gl.TEXTURE_3D, 0, 0, 0, 0, image.width, image.height, 1, gl.RGBA, gl.UNSIGNED_BYTE, image);
						

规范

规范	状态	注释
WebGL 2.0 The definition of 'texSubImage3D' in that specification.	编者草案	Initial definition for WebGL.
OpenGL ES 3.0 The definition of 'glTexSubImage2D' in that specification.	标准	Man page of the (similar) OpenGL ES 3.0 API.

浏览器兼容性

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

更新 GitHub 上的兼容性数据

	桌面						移动
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
texSubImage3D	Chrome 56	Edge 79	Firefox 51	IE 不支持 No	Opera 43	Safari 不支持 No	WebView Android 58	Chrome Android 58	Firefox Android 51	Opera Android 43	Safari iOS 不支持 No	Samsung Internet Android 7.0
SharedArrayBuffer as a parameter	Chrome 60	Edge 79	Firefox 79	IE 不支持 No	Opera 47	Safari 不支持 No	WebView Android 60	Chrome Android 60	Firefox Android ?	Opera Android 44	Safari iOS 不支持 No	Samsung Internet Android 8.0

图例

完整支持

不支持

不支持

兼容性未知 ?

兼容性未知

另请参阅

• WebGLRenderingContext.createTexture()
• WebGLRenderingContext.bindTexture()
• WebGLRenderingContext.texImage2D()
• WebGLRenderingContext.compressedTexImage2D()
• WebGLRenderingContext.copyTexImage2D()
• WebGLRenderingContext.getTexParameter()

元数据

• 最后修改： 2019 年 3 月 23 日