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 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

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

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 aus format und type finden Sie unter WebGLRenderingContext.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 TypedArray oder DataView, das die Bildpixeldaten enthält. Sein Typ muss dem Parameter type entsprechen; siehe WebGLRenderingContext.texImage2D().

srcOffset Optional

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

source

Eine DOM-Pixelquelle, aus der gelesen wird. Sie 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.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