XRWebGLBinding: Methode createCylinderLayer()

Limited availability

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

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die createCylinderLayer()-Methode des XRWebGLBinding-Interfaces gibt ein XRCylinderLayer-Objekt zurück, welches eine Ebene darstellt, die einen gekrümmten rechteckigen Raum in der virtuellen Umgebung einnimmt.

Syntax

createCylinderLayer(init)

Parameter

init

Ein Objekt zur Konfiguration des XRCylinderLayer. Es muss die Eigenschaften space, viewPixelHeight und viewPixelWidth enthalten. init hat die folgenden Eigenschaften:

aspectRatio Optional

Eine Zahl, die das Verhältnis des sichtbaren Zylinderabschnitts angibt. Es ist das Verhältnis der Breite des sichtbaren Abschnitts des Zylinders zu seiner Höhe. Die Breite wird berechnet, indem der radius mit dem centralAngle multipliziert wird. Der Standardwert ist 2.0.

centralAngle Optional

Eine Zahl, die den Winkel in Bogenmaß des sichtbaren Abschnitts des Zylinders angibt. Standardwert: 0.78539 (π / 4).

colorFormat Optional

Ein GLenum, das den Datentyp der Farbtexturdaten definiert. Mögliche Werte:

gl.RGB
gl.RGBA Zusätzlich, für Kontexte mit der aktivierten EXT_sRGB-Erweiterung:
ext.SRGB_EXT
ext.SRGB_ALPHA_EXT Zusätzlich, für WebGL2RenderingContext-Kontexte:
gl.RGBA8
gl.RGB8
gl.SRGB8
gl.RGB8_ALPHA8 Zusätzlich, für Kontexte mit der WEBGL_compressed_texture_etc-Erweiterung:
ext.COMPRESSED_RGB8_ETC2
ext.COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2
ext.COMPRESSED_RGBA8_ETC2_EAC
ext.COMPRESSED_SRGB8_ETC2
ext.COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2
ext.COMPRESSED_SRGB8_ALPHA8_ETC2_EAC Zusätzlich, für Kontexte mit der WEBGL_compressed_texture_astc-Erweiterung:
Alle der vom Erweiterung unterstützten Formate. Der Standardwert ist gl.RGBA.

depthFormat Optional

Ein GLenum, das den Datentyp der Tiefentexturdaten definiert, oder 0, was darauf hinweist, dass die Ebene keine Tiefentextur bereitstellen soll (in diesem Fall ist XRProjectionLayer.ignoreDepthValues true). Mögliche Werte innerhalb von WebGLRenderingContext-Kontexten mit der aktivierten WEBGL_depth_texture-Erweiterung oder innerhalb von WebGL2RenderingContext-Kontexten (ohne die Notwendigkeit einer Erweiterung):

gl.DEPTH_COMPONENT
gl.DEPTH_STENCIL Zusätzlich, für WebGL2RenderingContext-Kontexte:
gl.DEPTH_COMPONENT24
gl.DEPTH24_STENCIL24 Der Standardwert ist gl.DEPTH_COMPONENT.

isStatic Optional

Ein boolescher Wert, der, falls true, anzeigt, dass Sie nur dann auf diese Ebene zeichnen können, wenn needsRedraw true ist. Der Standardwert ist false.

layout Optional

Ein String, der das Layout der Ebene angibt. Mögliche Werte:

default: Die Ebene bietet Platz für alle Ansichten der Sitzung.
mono: Ein einzelnes XRSubImage wird erstellt und für beide Augen präsentiert.
stereo: Der User-Agent entscheidet, wie es das XRSubImage (eins oder zwei) anordnet und das Layout (oben/unten oder links/rechts).
stereo-left-right: Ein einzelnes XRSubImage wird erstellt. Das linke Auge erhält den linken Bereich der Textur, das rechte Auge den rechten.
stereo-top-bottom: Ein einzelnes XRSubImage wird erstellt. Das linke Auge erhält den oberen Bereich der Textur, das rechte Auge den unteren. Der Standardwert ist mono.

mipLevels Optional

Eine Zahl, die die gewünschte Anzahl der Mipmap-Level angibt. Der Standardwert ist 1.

radius Optional

Eine Zahl, die den Radius des Zylinders angibt. Standardwert: 2.0.

space Erforderlich

Ein XRSpace-Objekt, das die räumliche Beziehung der Ebene zur physischen Umgebung des Nutzers definiert.

textureType Optional

Ein String, der den Typ der Textur definiert, die die Ebene haben wird. Mögliche Werte:

texture: Die Texturen von XRWebGLSubImage werden vom Typ gl.TEXTURE_2D sein.
texture-array: die Texturen von XRWebGLSubImage werden vom Typ gl.TEXTURE_2D_ARRAY sein (nur für WebGL 2-Kontexte). Der Standardwert ist texture.

transform Optional

Ein XRRigidTransform-Objekt, das den Versatz und die Ausrichtung relativ zu space definiert.

viewPixelHeight Erforderlich

Eine Zahl, die die Pixelhöhe der Ebenenansicht angibt.

viewPixelWidth Erforderlich

Eine Zahl, die die Pixelbreite der Ebenenansicht angibt.

function onXRSessionStarted(xrSession) {
  const glCanvas = document.createElement("canvas");
  const gl = glCanvas.getContext("webgl2", { xrCompatible: true });
  const xrGlBinding = new XRWebGLBinding(xrSession, gl);
  const cylinderLayer = xrGlBinding.createCylinderLayer({
    space: xrReferenceSpace,
    viewPixelWidth: 1200,
    viewPixelHeight: 600,
    centralAngle: (60 * Math.PI) / 180,
    aspectRatio: 2,
    radius: 2,
    transform: new XRRigidTransform(/* … */),
  });

  xrSession.updateRenderState({
    layers: [cylinderLayer],
  });
}