WebXR Device API
The createCylinderLayer() method of the XRWebGLBinding interface returns an XRCylinderLayer object, which is a layer that takes up a curved rectangular space in the virtual environment.
Syntax
createCylinderLayer(init)
Parameters
init- : An object to configure the XRCylinderLayer. It must have the
space,viewPixelHeight, andviewPixelWidthproperties.inithas the following properties:aspectRatio- : A number indicating the ratio of the visible cylinder section. It is the ratio of the width of the visible section of the cylinder divided by its height. The width is calculated by multiplying the
radiuswith thecentralAngle. The default value is2.0.
- : A number indicating the ratio of the visible cylinder section. It is the ratio of the width of the visible section of the cylinder divided by its height. The width is calculated by multiplying the
centralAngle- : A number indicating the angle in radians of the visible section of the cylinder. Default value:
0.78539(π / 4).
- : A number indicating the angle in radians of the visible section of the cylinder. Default value:
colorFormat- : A WebGL_API/Types defining the data type of the color texture data. Possible values:
gl.RGBgl.RGBAAdditionally, for contexts with the EXT_sRGB extension enabled:ext.SRGB_EXText.SRGB_ALPHA_EXTAdditionally, for WebGL2RenderingContext contexts:gl.RGBA8gl.RGB8gl.SRGB8gl.RGB8_ALPHA8Additionally, for contexts with the WEBGL_compressed_texture_etc extension enabled:ext.COMPRESSED_RGB8_ETC2ext.COMPRESSED_RGB8_PUNCHTHROUGH_ALPHA1_ETC2ext.COMPRESSED_RGBA8_ETC2_EACext.COMPRESSED_SRGB8_ETC2ext.COMPRESSED_SRGB8_PUNCHTHROUGH_ALPHA1_ETC2ext.COMPRESSED_SRGB8_ALPHA8_ETC2_EACAdditionally, for contexts with the WEBGL_compressed_texture_astc extension enabled:Allof the formats the extension supports. The default value isgl.RGBA.
- : A WebGL_API/Types defining the data type of the color texture data. Possible values:
depthFormat- : A WebGL_API/Types defining the data type of the depth texture data or
0indicating that the layer should not provide a depth texture (in that case XRProjectionLayer.ignoreDepthValues will betrue). Possible values within WebGLRenderingContext contexts with the WEBGL_depth_texture extension enabled, or within WebGL2RenderingContext contexts (no extension required):gl.DEPTH_COMPONENTgl.DEPTH_STENCILAdditionally, for WebGL2RenderingContext contexts:gl.DEPTH_COMPONENT24gl.DEPTH24_STENCIL24The default value isgl.DEPTH_COMPONENT.
- : A WebGL_API/Types defining the data type of the depth texture data or
isStatic- : A boolean that, if true, indicates you can only draw to this layer when XRCompositionLayer.needsRedraw is
true. The default value isfalse.
- : A boolean that, if true, indicates you can only draw to this layer when XRCompositionLayer.needsRedraw is
layout- : A string indicating the layout of the layer. Possible values:
default- : The layer accommodates all views of the session.
mono- : A single XRSubImage is allocated and presented to both eyes.
stereo- : The user agent decides how it allocates the XRSubImage (one or two) and the layout (top/bottom or left/right).
stereo-left-right- : A single XRSubImage is allocated. Left eye gets the left area of the texture, right eye the right.
stereo-top-bottom- : A single XRSubImage is allocated. Left eye gets the top area of the texture, right eye the bottom.
The default value is
mono.
- : A single XRSubImage is allocated. Left eye gets the top area of the texture, right eye the bottom.
The default value is
- : A string indicating the layout of the layer. Possible values:
mipLevels- : A number specifying desired number of mip levels. The default value is
1.
- : A number specifying desired number of mip levels. The default value is
radius- : A number indicating the radius of the cylinder. Default value:
2.0.
- : A number indicating the radius of the cylinder. Default value:
spaceRequired- : An XRSpace object defining the layer's spatial relationship with the user's physical environment.
textureType- : A string defining the type of texture the layer will have. Possible values:
texture: The textures of XRWebGLSubImage will be of typegl.TEXTURE_2D.texture-array: the textures of XRWebGLSubImage will be of typegl.TEXTURE_2D_ARRAY(WebGL 2 contexts only). The default value istexture.
- : A string defining the type of texture the layer will have. Possible values:
transform- : An XRRigidTransform object defining the offset and orientation relative to
space.
- : An XRRigidTransform object defining the offset and orientation relative to
viewPixelHeightRequired- : A number specifying the pixel height of the layer view.
viewPixelWidthRequired- : A number specifying the pixel width of the layer view.
- : An object to configure the XRCylinderLayer. It must have the
Return value
An XRCylinderLayer object.
Examples
Creating an XRCylinderLayer
Configure the cylinder layer using the properties listed above in a call to createCylinderLayer(). To present layers to the XR device, add them to the layers render state using XRSession.updateRenderState().
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],
});
}
Specifications
Browser compatibility
See also
- XRCylinderLayer
- WebGL constants
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
