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: copyTexSubImage3D() Methode

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.

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

Die copyTexSubImage3D() Methode des WebGL2RenderingContext Schnittstelle der WebGL API kopiert Pixel vom aktuellen WebGLFramebuffer in ein 3D-Textur-Sub-Image.

Syntax

js
copyTexSubImage3D(target, level, xoffset, yoffset, zoffset, x, y, width, height)

Parameter

target

Ein GLenum, das den Bindepunkt (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, der die Detailstufe angibt. Level 0 ist die Basisbildstufe und Level n ist die n-te Mipmap-Reduktionsstufe.

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.

x

Ein GLint, der die x-Koordinate der unteren linken Ecke angibt, von der das Kopieren begonnen wird.

y

Ein GLint, der die y-Koordinate der unteren linken Ecke angibt, von der das Kopieren begonnen wird.

width

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

height

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

Rückgabewert

Kein (undefined).

Beispiele

js
gl.copyTexSubImage3D(gl.TEXTURE_3D, 0, 0, 0, 0, 0, 0, 16, 16);

Spezifikationen

Spezifikation
WebGL 2.0 Specification
# 3.7.6

Browser-Kompatibilität

Siehe auch