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: Diese Funktion ist in Web Workers verfügbar.

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

Syntax

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

Parameter

target

Ein GLenum, der den Bindungspunkt (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, der die Detailstufe angibt. Stufe 0 ist das Basisbildniveau und Stufe n ist das n-te Mipmap-Reduktionsniveau.

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 wo das Kopieren beginnt.

y

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

width

Ein GLsizei, der die Breite der Textur angibt.

height

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

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

Siehe auch