WebGL2RenderingContext: Methode texImage3D()
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 texImage3D() der Schnittstelle WebGL2RenderingContext der WebGL-API definiert ein dreidimensionales Texturbild.
Syntax
texImage3D(target, level, internalformat, width, height, depth, border, format, type, srcData)
texImage3D(target, level, internalformat, width, height, depth, border, format, type, srcData, srcOffset)
texImage3D(target, level, internalformat, width, height, depth, border, format, type, source)
texImage3D(target, level, internalformat, width, height, depth, border, format, type, offset)
Parameter
target-
Ein
GLenum, das den Bindungspunkt (target) 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. internalformat-
Ein
GLenum, das angibt, wie die Textur nach dem Laden gespeichert werden soll. 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 einerTEXTURE_2D_ARRAYangibt. border-
Ein
GLint, das die Breite des Randes angibt. Muss 0 sein. format-
Ein
GLenum, das angibt, wie jedes Integer-Element in den rohen Texeldaten als Farbkomponenten interpretiert werden soll. type-
Ein
GLenum, das die Größe jedes Integer-Elements in den rohen Texeldaten angibt.Die Werte für
internalformat,formatundtypemüssen miteinander kompatibel sein. Alle gültigen Kombinationen finden Sie unterWebGLRenderingContext.texImage2D().
Die Texturquelle kann auf drei Arten bereitgestellt werden: aus einem ArrayBuffer (gegebenenfalls gemeinsam genutzt) ü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, odernull, um Texturspeicher zuzuweisen, ohne Pixel hochzuladen (die zugewiesene Textur wird mit Nullen initialisiert). Der Typ muss zum Parametertypepassen; sieheWebGLRenderingContext.texImage2D(). Wenntypeden WertFLOAT_32_UNSIGNED_INT_24_8_REVhat, musssrcDatanullsein. srcOffsetOptional-
Eine Ganzzahl, die den Index in
srcDataangibt, ab dem gelesen werden soll. Der Standardwert ist0. source-
Eine DOM-Pixelquelle, aus der gelesen wird. Dies 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.texImage3D(
gl.TEXTURE_3D,
0, // level
gl.RGBA, // internalFormat
1, // width
1, // height
1, // depth
0, // border
gl.RGBA, // format
gl.UNSIGNED_BYTE, // type
new Uint8Array([0xff, 0x00, 0x00, 0x00]),
); // data
Spezifikationen
| Spezifikation |
|---|
| WebGL 2.0 Specification> # 4.7.6> |
Browser-Kompatibilität
Siehe auch
WebGLRenderingContext.createTexture()WebGLRenderingContext.bindTexture()WebGL2RenderingContext.texSubImage3D()WebGL2RenderingContext.compressedTexImage3D()WebGL2RenderingContext.copyTexSubImage3D()WebGLRenderingContext.getTexParameter()WEBGL_depth_textureOES_texture_floatOES_texture_half_floatEXT_texture_norm16EXT_sRGB