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

Specification
WebGL 2.0 Specification
# 3.7.6

Browser-Kompatibilität

Siehe auch