WebGL2RenderingContext: texSubImage3D() Methode

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨September 2021⁩.

* Some parts of this feature may have varying levels of support.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die texSubImage3D()-Methode der WebGL2RenderingContext-Schnittstelle der WebGL API spezifiziert ein dreidimensionales Unterrechteck für ein Texturbild.

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, der den Bindepunkt (Ziel) der aktiven Textur spezifiziert. Mögliche Werte:

gl.TEXTURE_3D: Eine dreidimensionale Textur.
gl.TEXTURE_2D_ARRAY: Eine zweidimensionale Array-Textur.

level

Ein GLint, der das Detaillevel angibt. Level 0 ist das Basisbild-Level und Level n ist das n-te Mipmap-Reduktionslevel.

xoffset

Ein GLint, der den x-Versatz innerhalb des Texturbildes angibt.

yoffset

Ein GLint, der den y-Versatz innerhalb des Texturbildes angibt.

zoffset

Ein GLint, der den z-Versatz innerhalb des Texturbildes angibt.

width

Ein GLsizei, der die Breite der Textur in Texeln angibt.

height

Ein GLsizei, der die Höhe der Textur in Texeln angibt.

depth

Ein GLsizei, der die Tiefe der Textur/die Anzahl der Texturen in einem TEXTURE_2D_ARRAY angibt.

format

Ein GLenum, der angibt, wie jedes Integer-Element in den rohen Texeldaten als Farbkomponenten interpretiert werden soll.

type

Ein GLenum, der die Größe jedes Integer-Elements in den rohen Texeldaten spezifiziert. Für die verfügbaren Kombinationen von format und type siehe WebGLRenderingContext.texSubImage2D().

Die Texturquelle kann auf eine von drei Arten bereitgestellt werden: aus einem ArrayBuffer (möglicherweise gemeinsam genutzt) unter Verwendung von srcData und srcOffset; aus einer DOM-Pixelquelle; oder von gl.PIXEL_UNPACK_BUFFER unter Verwendung von offset.

srcData

Ein TypedArray oder DataView, das die komprimierten Texturdaten enthält. Sein Typ muss mit dem type-Parameter übereinstimmen; siehe WebGLRenderingContext.texImage2D().

srcOffset Optional

Ein Integer, der den Index von srcData angibt, ab dem gelesen werden soll. Standard ist 0.

source

Gelesen von einer DOM-Pixelquelle, die eine der folgenden sein kann:

offset

Ein GLintptr, der die Startadresse im Puffer angibt, der an gl.PIXEL_UNPACK_BUFFER gebunden ist.

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

Specification
WebGL 2.0 Specification # 3.7.6

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden