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

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die WebGL2RenderingContext.copyTexSubImage3D() Methode der WebGL API kopiert Pixel vom aktuellen WebGLFramebuffer in ein bestehendes 3D-Textur-Unterbild.

Syntax

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

Parameter

target

Ein GLenum, das 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, das das Detaillevel angibt. Level 0 ist das Basisbildlevel und Level n ist das n-te Mipmap-Reduktionslevel.

xoffset

Ein GLint, das den x-Offset innerhalb des Texturbildes spezifiziert.

yoffset

Ein GLint, das den y-Offset innerhalb des Texturbildes spezifiziert.

zoffset

Ein GLint, das den z-Offset innerhalb des Texturbildes spezifiziert.

x

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

y

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

width

Ein GLsizei, das die Breite der Textur spezifiziert.

height

Ein GLsizei, das die Höhe der Textur spezifiziert.

Rückgabewert

Keiner (undefined).

Beispiele

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

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.6

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch