WebGLRenderingContext: bindFramebuffer()-Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGLRenderingContext.bindFramebuffer()-Methode der WebGL API bindet an das angegebene Ziel das bereitgestellte WebGLFramebuffer. Ist das framebuffer-Argument null, wird das Standard-WebGLFramebuffer gebunden, das mit dem Canvas-Rendering-Kontext verknüpft ist.

In diesem Artikel

Syntax

bindFramebuffer(target, framebuffer)

Parameter

target

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

gl.FRAMEBUFFER

Sammlungspufferdaten für Farb-, Alpha-, Tiefen- und Stencil-Puffer, die sowohl als Ziel für das Zeichnen als auch als Quelle für das Lesen verwendet werden (siehe unten).

Bei Verwendung eines WebGL 2-Kontexts stehen zusätzlich folgende Werte zur Verfügung:

gl.DRAW_FRAMEBUFFER

Wird als Ziel für Zeichenoperationen wie gl.draw*, gl.clear* und gl.blitFramebuffer verwendet.

gl.READ_FRAMEBUFFER

Wird als Quelle für Leseoperationen wie gl.readPixels und gl.blitFramebuffer verwendet.

framebuffer

Ein WebGLFramebuffer-Objekt, das gebunden werden soll, oder null für die Bindung des HTMLCanvasElement oder OffscreenCanvas-Objekts, das mit dem Rendering-Kontext verknüpft ist.

js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
const framebuffer = gl.createFramebuffer();

gl.bindFramebuffer(gl.FRAMEBUFFER, framebuffer);