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: framebufferTextureLayer()-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 Methode WebGL2RenderingContext.framebufferTextureLayer() der WebGL 2 API fügt einem Framebuffer eine einzelne Ebene einer Textur hinzu.

Diese Methode ähnelt WebGLRenderingContext.framebufferTexture2D(), fügt dem Attachment Point jedoch nur eine einzelne Ebene des angegebenen Texturlevels hinzu.

Syntax

js
framebufferTextureLayer(target, attachment, texture, level, layer)

Parameter

target

Ein GLenum, der den Bindungspunkt (Target) angibt. Mögliche Werte:

  • gl.FRAMEBUFFER: Speicher für die Daten der Farb-, Alpha-, Tiefen- und Stencil-Buffer, die zum Rendern eines Bildes verwendet werden.
  • gl.DRAW_FRAMEBUFFER: Entspricht gl.FRAMEBUFFER.
  • gl.READ_FRAMEBUFFER: Wird als Quelle für Leseoperationen verwendet.
attachment

Ein GLenum, der den Attachment Point für die texture angibt. Mögliche Werte:

  • gl.COLOR_ATTACHMENT{0-15}: Fügt die Textur einem der Farb-Buffer des Framebuffers hinzu.
  • gl.DEPTH_ATTACHMENT: Fügt die Textur dem Tiefen-Buffer des Framebuffers hinzu.
  • gl.STENCIL_ATTACHMENT: Fügt die Textur dem Stencil-Buffer des Framebuffers hinzu.
  • gl.DEPTH_STENCIL_ATTACHMENT: Tiefen- und Stencil-Buffer.
texture

Ein WebGLTexture-Objekt, dessen Bild hinzugefügt werden soll, oder null, um das aktuell am angegebenen Attachment Point angehängte Bild zu entfernen.

level

Ein GLint, der das Mipmap-Level des hinzuzufügenden Texturbilds angibt.

layer

Ein GLint, der die Ebene des hinzuzufügenden Texturbilds angibt.

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.framebufferTextureLayer(gl.FRAMEBUFFER, gl.COLOR_ATTACHMENT0, texture, 0, 8);

Spezifikationen

Spezifikation
WebGL 2.0 Specification
# 4.7.4

Browser-Kompatibilität

Siehe auch