WebGLRenderingContext: framebufferTexture2D()-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.framebufferTexture2D() der WebGL-API bindet eine Textur an ein WebGLFramebuffer.
Syntax
framebufferTexture2D(target, attachment, textarget, texture, level)
Parameter
target-
Ein
GLenum, das den Bindungspunkt (Target) 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-
Wird als Ziel für Zeichen-, Rendering-, Lösch- und Schreiboperationen verwendet.
gl.READ_FRAMEBUFFER-
Wird als Quelle für Leseoperationen verwendet.
Beim Binden setzt
gl.FRAMEBUFFERsowohl den Bindungspunktgl.DRAW_FRAMEBUFFERals auchgl.READ_FRAMEBUFFER. Bei einer Referenzierung bezieht sichgl.FRAMEBUFFERauf die Bindunggl.DRAW_FRAMEBUFFER. attachment-
Ein
GLenum, das den Attachment-Punkt fürtextureangibt. Mögliche Werte:gl.COLOR_ATTACHMENT0: Bindet die Textur an den Farb-Buffer des Framebuffers.gl.DEPTH_ATTACHMENT: Bindet die Textur an den Tiefen-Buffer des Framebuffers.gl.STENCIL_ATTACHMENT: Bindet die Textur an den Stencil-Buffer des Framebuffers.
Bei Verwendung eines WebGL-2-Kontexts sind zusätzlich folgende Werte verfügbar:
gl.DEPTH_STENCIL_ATTACHMENT: Tiefen- und Stencil-Buffer.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
Bei Verwendung der Erweiterung
WEBGL_depth_texture:gl.DEPTH_STENCIL_ATTACHMENT: Speicher für Tiefen- und Stencil-Buffer-Daten.
textarget-
Ein
GLenum, das das Textur-Target angibt. Mögliche Werte:gl.TEXTURE_2D: Ein 2D-Bild.gl.TEXTURE_CUBE_MAP_POSITIVE_X: Bild für die positive X-Seite des Würfels.gl.TEXTURE_CUBE_MAP_NEGATIVE_X: Bild für die negative X-Seite des Würfels.gl.TEXTURE_CUBE_MAP_POSITIVE_Y: Bild für die positive Y-Seite des Würfels.gl.TEXTURE_CUBE_MAP_NEGATIVE_Y: Bild für die negative Y-Seite des Würfels.gl.TEXTURE_CUBE_MAP_POSITIVE_Z: Bild für die positive Z-Seite des Würfels.gl.TEXTURE_CUBE_MAP_NEGATIVE_Z: Bild für die negative Z-Seite des Würfels.
texture-
Ein
WebGLTexture-Objekt, dessen Bild angebunden werden soll, odernull, um das aktuell am angegebenen Attachment-Punkt angebundene Bild zu lösen. level-
Ein
GLint, das die Mipmap-Stufe des anzubindenden Texturbilds angibt. Muss 0 sein.
Rückgabewert
Keiner (undefined).
Ausnahmen
-
Ein
gl.INVALID_ENUM-Fehler wird ausgelöst, wenntargetnichtgl.FRAMEBUFFERist.attachmentkeiner der zulässigen Attachment-Punkte ist.textargetkeines der zulässigen Textur-Targets ist.
-
Ein
gl.INVALID_VALUE-Fehler wird ausgelöst, wennlevelnicht 0 ist. -
Ein
gl.INVALID_OPERATION-Fehler wird ausgelöst, wenntextureweder 0 noch der Name eines vorhandenen Texturobjekts ist.
Beispiele
gl.framebufferTexture2D(
gl.FRAMEBUFFER,
gl.COLOR_ATTACHMENT0,
gl.TEXTURE_2D,
texture,
0,
);
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification> # 5.14.6> |