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 bindet eine einzelne Schicht einer Textur an einen Framebuffer.

Diese Methode ähnelt WebGLRenderingContext.framebufferTexture2D(), wobei jedoch nur eine bestimmte einzelne Schicht der Texturebene an den Anhangspunkt gebunden wird.

Syntax

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

Parameter

target

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

  • gl.FRAMEBUFFER: Sammlung von Pufferspeicherdaten der Farb-, Alpha-, Tiefen- und Stencil-Puffer, die zum Rendern eines Bildes verwendet werden.
  • gl.DRAW_FRAMEBUFFER: Entspricht gl.FRAMEBUFFER.
  • gl.READ_FRAMEBUFFER: Wird als Quelle für Lesevorgänge verwendet.
attachment

Ein GLenum, das den Anhangspunkt für die texture angibt. Mögliche Werte:

  • gl.COLOR_ATTACHMENT{0-15}: Bindet die Textur an einen der Farb-Puffer des Framebuffers.
  • gl.DEPTH_ATTACHMENT: Bindet die Textur an den Tiefen-Puffer des Framebuffers.
  • gl.STENCIL_ATTACHMENT: Bindet die Textur an den Stencil-Puffer des Framebuffers.
  • gl.DEPTH_STENCIL_ATTACHMENT: Tiefen- und Stencil-Puffer.
texture

Ein WebGLTexture-Objekt, dessen Bild gebunden werden soll.

level

Ein GLint, das die Mipmap-Ebene des zu bindenden Texturbildes angibt.

layer

Ein GLint, das die Schicht des zu bindenden 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

BCD tables only load in the browser

Siehe auch