WebGLRenderingContext: framebufferRenderbuffer()-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 Methode WebGLRenderingContext.framebufferRenderbuffer() der WebGL-API hängt ein WebGLRenderbuffer-Objekt an ein WebGLFramebuffer-Objekt an.
Syntax
framebufferRenderbuffer(target, attachment, renderbuffertarget, renderbuffer)
Parameter
target-
Ein
GLenum, das den Bindungspunkt (Target) für den Framebuffer angibt. Mögliche Werte:gl.FRAMEBUFFER-
Speicher für die Farb-, Alpha-, Tiefen- und Stencil-Buffer-Daten, die zum Rendern eines Bildes verwendet werden.
Bei Verwendung eines WebGL-2-Kontexts sind zusätzlich folgende Werte verfügbar:
gl.DRAW_FRAMEBUFFER-
Entspricht
gl.FRAMEBUFFER. Wird als Ziel für Zeichen-, Render-, Lösch- und Schreiboperationen verwendet. gl.READ_FRAMEBUFFER-
Wird als Quelle für Leseoperationen verwendet.
attachment-
Ein
GLenum, das den Anhangspunkt für den Renderbuffer angibt. Mögliche Werte:gl.COLOR_ATTACHMENT0: Farbbuffer.gl.DEPTH_ATTACHMENT: Tiefenbuffer.gl.DEPTH_STENCIL_ATTACHMENT: Tiefen- und Stencil-Buffer.gl.STENCIL_ATTACHMENT: Stencil-Buffer.
Bei Verwendung eines WebGL-2-Kontexts sind zusätzlich folgende Werte verfügbar:
gl.COLOR_ATTACHMENT1 gl.COLOR_ATTACHMENT2 gl.COLOR_ATTACHMENT3 gl.COLOR_ATTACHMENT4 gl.COLOR_ATTACHMENT5 gl.COLOR_ATTACHMENT6 gl.COLOR_ATTACHMENT7 gl.COLOR_ATTACHMENT8 gl.COLOR_ATTACHMENT9 gl.COLOR_ATTACHMENT10 gl.COLOR_ATTACHMENT11 gl.COLOR_ATTACHMENT12 gl.COLOR_ATTACHMENT13 gl.COLOR_ATTACHMENT14 gl.COLOR_ATTACHMENT15
Bei Verwendung der Erweiterung
WEBGL_draw_buffers:ext.COLOR_ATTACHMENT0_WEBGL(entsprichtgl.COLOR_ATTACHMENT0)ext.COLOR_ATTACHMENT1_WEBGL ext.COLOR_ATTACHMENT2_WEBGL ext.COLOR_ATTACHMENT3_WEBGL ext.COLOR_ATTACHMENT4_WEBGL ext.COLOR_ATTACHMENT5_WEBGL ext.COLOR_ATTACHMENT6_WEBGL ext.COLOR_ATTACHMENT7_WEBGL ext.COLOR_ATTACHMENT8_WEBGL ext.COLOR_ATTACHMENT9_WEBGL ext.COLOR_ATTACHMENT10_WEBGL ext.COLOR_ATTACHMENT11_WEBGL ext.COLOR_ATTACHMENT12_WEBGL ext.COLOR_ATTACHMENT13_WEBGL ext.COLOR_ATTACHMENT14_WEBGL ext.COLOR_ATTACHMENT15_WEBGL
renderbuffertarget-
Ein
GLenum, das den Bindungspunkt (Target) für den Renderbuffer angibt. Mögliche Werte:gl.RENDERBUFFER-
Buffer-Datenspeicher für einzelne Bilder in einem renderbaren internen Format.
renderbuffer-
Ein
WebGLRenderbuffer-Objekt, das angehängt werden soll, odernull, um das derzeit am angegebenen Anhangspunkt angehängte Bild zu lösen.
Rückgabewert
Keiner (undefined).
Ausnahmen
- Ein
gl.INVALID_ENUM-Fehler wird ausgelöst, wenntargetwedergl.FRAMEBUFFERnochgl.DRAW_FRAMEBUFFERodergl.READ_FRAMEBUFFERist. - Ein
gl.INVALID_ENUM-Fehler wird ausgelöst, wennrenderbuffertargetnichtgl.RENDERBUFFERist. - Ein
gl.INVALID_ENUM-Fehler wird ausgelöst, wennattachmentkeiner der zulässigen Enum-Werte ist.
Beispiele
gl.framebufferRenderbuffer(
gl.FRAMEBUFFER,
gl.COLOR_ATTACHMENT0,
gl.RENDERBUFFER,
renderbuffer,
);
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification> # 5.14.6> |