OVR_multiview2: framebufferTextureMultiviewOVR()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Die OVR_multiview2.framebufferTextureMultiviewOVR()-Methode des WebGL-APIs befestigt eine Multiview-Textur an einem WebGLFramebuffer.

Syntax

js
framebufferTextureMultiviewOVR(target, attachment, texture, level, baseViewIndex, numViews)

Parameter

target

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

gl.FRAMEBUFFER

Sammlung von Pufferdatenspeicher für Farb-, Alpha-, Tiefen- und Schablonenpuffer, die zum Rendern eines Bildes verwendet werden.

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 die texture spezifiziert. Mögliche Werte:

  • gl.COLOR_ATTACHMENT0: Befestigt die Textur am Farb-Puffer des Framebuffers.

  • gl.DEPTH_ATTACHMENT: Befestigt die Textur am Tiefen-Puffer des Framebuffers.

  • gl.STENCIL_ATTACHMENT: Befestigt die Textur am Schablonen-Puffer des Framebuffers.

  • gl.DEPTH_STENCIL_ATTACHMENT: Tiefen- und Schablonen-Puffer.

  • 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 WEBGL_draw_buffers-Erweiterung:

    • ext.COLOR_ATTACHMENT0_WEBGL (gleich wie gl.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 WEBGL_depth_texture-Erweiterung:

  • ext.DEPTH_STENCIL_ATTACHMENT: Datenspeicher für Tiefen- und Schablonenpuffer.
texture

Ein WebGLTexture-Objekt, dessen Bild angefügt werden soll.

level

Ein GLint, der die Mipmap-Ebene des Texturbildes spezifiziert, das angefügt werden soll. Muss 0 sein.

baseViewIndex

Ein GLint, der den Basis-View-Index des Framebuffer-Objektanhangs spezifiziert.

numViews

Ein GLsizei, der die Anzahl der Ansichten des Framebuffer-Objektanhangs spezifiziert.

Rückgabewert

Keiner (undefined).

Ausnahmen

  • Ein gl.INVALID_ENUM-Fehler wird ausgelöst, wenn

    • target nicht gl.FRAMEBUFFER ist.
    • attachment nicht einer der akzeptierten Anhangspunkte ist.

  • Ein gl.INVALID_VALUE-Fehler wird ausgelöst, wenn

    • level nicht 0 ist.
    • wenn numViews kleiner als eins oder größer als MAX_VIEWS_OVR ist.

  • Ein gl.INVALID_OPERATION-Fehler wird ausgelöst, wenn texture nicht 0 oder der Name eines vorhandenen Texturobjekts ist.

Beispiele

js
ext.framebufferTextureMultiviewOVR(
  gl.DRAW_FRAMEBUFFER,
  gl.COLOR_ATTACHMENT0,
  colorTex,
  0,
  0,
  2,
);

Spezifikationen

Specification
WebGL OVR_multiview2 Extension Specification

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch