Secure context
This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.
The Boolean antialias
property, if present and set to true
in the XRWebGLLayerInit
object provided as the XRWebGLLayer()
constructor's layerInit
parameter, requests that the new WebGL rendering layer support anti-aliasing. If this property is missing or is false
, anti-aliasing is not desired.
There is no way to request a specific anti-aliasing format or level; this decision is left up to the user agent.
Syntax
let layerInit = { antialias: boolValue }; let glLayer = new XRWebGLLayer(xrSession, gl, layerInit); let glLayer = new XRWebGLLayer(xrSession, gl, { antialias: boolValue });
Value
A Boolean value which can be set to true
to request anti-aliasing support in the new WebGL rendering layer. If false
, anti-aliasing is not desired.
Usage notes
The state of anti-aliasing for the context after being created can be read from the XRWebGLLayer
property antialias
.
Example
In this example, before creating a new XRWebGLLayer
to use for rendering, the value of a user preference from a configuration interface is obtained using a function called getPreferenceValue()
to determine whether the user has enabled or disabled anti-aliasing support; this is passed into the constructor.
let options = { antialias: getPreferenceValue("antialiasing") }; let glLayer = new XRWebGLLayer(xrSession, gl, options); if (glLayer) { xrSession.updateRenderState({ baseLayer: glLayer }); }
Offering the user features such as the ability to enable or disable things like anti-aliasing can provide them with optiions to try when your app isn't performing as well as they'd like. Disabling anti-aliasing may improve performance to some extent.
Specifications
Specification | Status | Comment |
---|---|---|
WebXR Device API The definition of 'XRWebGLLayerInit.antialias' in that specification. |
Working Draft | Initial definition. |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
antialias | Chrome Full support 79 | Edge Full support 79 | Firefox No support No | IE No support No | Opera No support No | Safari No support No | WebView Android Full support 79 | Chrome Android Full support 79 | Firefox Android No support No | Opera Android No support No | Safari iOS No support No | Samsung Internet Android Full support 11.2 |
Legend
- Full support
- Full support
- No support
- No support