WebGL2RenderingContext: Methode texSubImage3D()
Baseline
Weitgehend verfügbar
*
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2021 browserübergreifend verfügbar.
* Einige Teile dieser Funktion werden möglicherweise unterschiedlich gut unterstützt.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methode texSubImage3D() der Schnittstelle WebGL2RenderingContext der WebGL-API legt einen dreidimensionalen Teilbereich eines Texturbilds fest.
Syntax
texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, srcData)
texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, srcData, srcOffset)
texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, source)
texSubImage3D(target, level, xoffset, yoffset, zoffset, width, height, depth, format, type, offset)
Parameter
target-
Ein
GLenum, das den Bindungspunkt (das Ziel) der aktiven Textur angibt. Mögliche Werte:gl.TEXTURE_3D: Eine dreidimensionale Textur.gl.TEXTURE_2D_ARRAY: Eine zweidimensionale Array-Textur.
level-
Ein
GLint, das die Detailstufe angibt. Stufe 0 ist die Stufe des Basisbilds; Stufe n ist die n-te Mipmap-Reduktionsstufe. xoffset-
Ein
GLint, das den x-Versatz innerhalb des Texturbilds angibt. yoffset-
Ein
GLint, das den y-Versatz innerhalb des Texturbilds angibt. zoffset-
Ein
GLint, das den z-Versatz innerhalb des Texturbilds angibt. width-
Ein
GLsizei, das die Breite der Textur in Texeln angibt. height-
Ein
GLsizei, das die Höhe der Textur in Texeln angibt. depth-
Ein
GLsizei, das die Tiefe der Textur bzw. die Anzahl der Texturen in einemTEXTURE_2D_ARRAYangibt. format-
Ein
GLenum, das angibt, wie jedes Ganzzahlelement in den unverarbeiteten Texeldaten als Farbkomponente interpretiert werden soll. type-
Ein
GLenum, das die Größe jedes Ganzzahlelements in den unverarbeiteten Texeldaten angibt. Informationen zu den verfügbaren Kombinationen ausformatundtypefinden Sie unterWebGLRenderingContext.texSubImage2D().
Die Texturquelle kann auf drei Arten bereitgestellt werden: aus einem ArrayBuffer (der möglicherweise gemeinsam genutzt wird) über srcData und srcOffset, aus einer DOM-Pixelquelle über source oder aus gl.PIXEL_UNPACK_BUFFER über offset.
srcData-
Ein
TypedArrayoderDataView, das die Bildpixeldaten enthält. Sein Typ muss dem Parametertypeentsprechen; sieheWebGLRenderingContext.texImage2D(). srcOffsetOptional-
Eine Ganzzahl, die den Index in
srcDataangibt, ab dem gelesen wird. Der Standardwert ist0. source-
Eine DOM-Pixelquelle, aus der gelesen wird. Sie kann eines der folgenden Objekte sein:
offset-
Ein
GLintptr, das die Startadresse im angl.PIXEL_UNPACK_BUFFERgebundenen Puffer angibt.
Rückgabewert
Keiner (undefined).
Beispiele
gl.texSubImage3D(
gl.TEXTURE_3D,
0,
0,
0,
0,
image.width,
image.height,
1,
gl.RGBA,
gl.UNSIGNED_BYTE,
image,
);
Spezifikationen
| Spezifikation |
|---|
| WebGL 2.0 Specification> # 4.7.6> |
Browser-Kompatibilität
Siehe auch
WebGLRenderingContext.createTexture()WebGLRenderingContext.bindTexture()WebGL2RenderingContext.texImage3D()WebGL2RenderingContext.compressedTexImage3D()WebGL2RenderingContext.copyTexSubImage3D()WebGLRenderingContext.getTexParameter()OES_texture_floatOES_texture_half_floatEXT_sRGBEXT_texture_norm16