Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

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

js
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 einer TEXTURE_2D_ARRAY angibt.

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, format und type müssen miteinander kompatibel sein. Alle gültigen Kombinationen finden Sie unter WebGLRenderingContext.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 TypedArray oder DataView, das die Bildpixeldaten enthält, oder null, um Texturspeicher zuzuweisen, ohne Pixel hochzuladen (die zugewiesene Textur wird mit Nullen initialisiert). Der Typ muss zum Parameter type passen; siehe WebGLRenderingContext.texImage2D(). Wenn type den Wert FLOAT_32_UNSIGNED_INT_24_8_REV hat, muss srcData null sein.

srcOffset Optional

Eine Ganzzahl, die den Index in srcData angibt, ab dem gelesen werden soll. Der Standardwert ist 0.

source

Eine DOM-Pixelquelle, aus der gelesen wird. Dies kann eines der folgenden Objekte sein:

offset

Ein GLintptr, das die Startadresse im an gl.PIXEL_UNPACK_BUFFER gebundenen Puffer angibt.

Rückgabewert

Keiner (undefined).

Beispiele

js
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