WebGL2RenderingContext: framebufferTextureLayer() 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.framebufferTextureLayer() Methode der WebGL 2 API hängt eine einzelne Ebene einer Textur an einen Framebuffer an.

Diese Methode ist ähnlich wie WebGLRenderingContext.framebufferTexture2D(), jedoch wird nur eine bestimmte einzelne Ebene des Textur-Levels an den Befestigungspunkt angebracht.

Syntax

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

Parameter

target

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

  • gl.FRAMEBUFFER: Speichert Kollektionen von Pufferdaten von Farbe, Alpha, Tiefe und Stencil-Puffern, 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 Befestigungspunkt für die texture angibt. Mögliche Werte:

  • gl.COLOR_ATTACHMENT{0-15}: Hängt die Textur an einen der Farbpuffer des Framebuffers an.
  • gl.DEPTH_ATTACHMENT: Hängt die Textur an den Tiefenpuffer des Framebuffers an.
  • gl.STENCIL_ATTACHMENT: Hängt die Textur an den Stencil-Puffer des Framebuffers an.
  • gl.DEPTH_STENCIL_ATTACHMENT: Tiefen- und Stencil-Puffer.
texture

Ein WebGLTexture Objekt, dessen Bild angebracht werden soll.

level

Ein GLint, der das Mipmap-Level des anzubringenden Texturbildes angibt.

layer

Ein GLint, der die Ebene des anzubringenden Texturbildes angibt.

Rückgabewert

Keiner (undefined).

Beispiele

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

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.4

Browser-Kompatibilität

Siehe auch