WebGLRenderingContext: framebufferRenderbuffer() Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die WebGLRenderingContext.framebufferRenderbuffer()
-Methode der WebGL API bindet ein WebGLRenderbuffer
Objekt an ein WebGLFramebuffer
Objekt.
Syntax
framebufferRenderbuffer(target, attachment, renderbuffertarget, renderbuffer)
Parameter
target
-
Ein
GLenum
, das den Bindungspunkt (Ziel) für den Framebuffer angibt. Mögliche Werte:gl.FRAMEBUFFER
-
Datenspeicher der Sammlung von Farb-, Alpha-, Tiefen- und Stencil-Puffern, die zum Rendern eines Bildes verwendet werden.
Bei der Verwendung eines WebGL 2 Kontext sind zusätzlich die folgenden 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 Render-Puffer angibt. Mögliche Werte:gl.COLOR_ATTACHMENT0
: Farb-Puffer.gl.DEPTH_ATTACHMENT
: Tiefen-Puffer.gl.DEPTH_STENCIL_ATTACHMENT
: Tiefen- und Stencil-Puffer.gl.STENCIL_ATTACHMENT
: Stencil-Puffer.
Bei der Verwendung eines WebGL 2 Kontext sind zusätzlich die folgenden 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 der Verwendung der
WEBGL_draw_buffers
Erweiterung:ext.COLOR_ATTACHMENT0_WEBGL
(gleich wiegl.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 (Ziel) für den Render-Puffer angibt. Mögliche Werte:gl.RENDERBUFFER
-
Datenspeicher für Einzelbilder in einem renderbaren internen Format.
renderbuffer
-
Ein
WebGLRenderbuffer
Objekt zum Anbinden.
Rückgabewert
Keiner (undefined
).
Ausnahmen
- Ein
gl.INVALID_ENUM
Fehler wird ausgelöst, wenntarget
nichtgl.FRAMEBUFFER
,gl.DRAW_FRAMEBUFFER
odergl.READ_FRAMEBUFFER
ist. - Ein
gl.INVALID_ENUM
Fehler wird ausgelöst, wennrenderbuffertarget
nichtgl.RENDERBUFFER
ist. - Ein
gl.INVALID_ENUM
Fehler wird ausgelöst, wennattachment
nicht einer der erlaubten Enums ist.
Beispiele
gl.framebufferRenderbuffer(
gl.FRAMEBUFFER,
gl.COLOR_ATTACHMENT0,
gl.RENDERBUFFER,
renderbuffer,
);
Spezifikationen
Specification |
---|
WebGL Specification # 5.14.6 |
Browser-Kompatibilität
BCD tables only load in the browser