NOTE: This version of the documentation tracks unstable development happening on A-Frame’s
masterbranch. If you wish to try it out, grab the unstable build. Otherwise, head to the documentation for the current 0.8.0 version
renderer system configures a scene’s
<a-scene renderer="antialias: true;
|antialias||Whether to perform antialiasing. If
|colorManagement||Whether to use a color-managed linear workflow.||false|
|sortObjects||Whether to sort objects before rendering.||false|
|physicallyCorrectLights||Whether to use physically-correct light attenuation.||false|
|maxCanvasWidth||Maximum canvas width. Uses the size multiplied by device pixel ratio. Does not limit canvas width if set to -1.||1920|
|maxCanvasHeight||Maximum canvas height. Behaves the same as maxCanvasWidth.||1920|
|logarithmicDepthBuffer||Whether to use a logarithmic depth buffer.||auto|
NOTE: Once the scene is initialized, these properties may no longer be changed.
When enabled, smooths jagged edges on curved lines and diagonals at moderate performance cost. By default, antialiasing is disabled on mobile devices.
Color management provides more accurate rendering and reduces the likelihood that scenes will appear overlit or “washed out.” Enabling color management is recommended for precisely matching colors from texturing and modeling tools, but unofficial components may not always respond to color management properly at this time.
Managed and unmanaged color modes are similar to linear and gamma workflows, respectively, in other engines and tools.
NOTE: In three.js, and previous versions of A-Frame, a
gammaOutput: trueproperty was available. This is applied automatically when color management is enabled.
Sorting is used to attempt to properly render objects that have some degree of transparency.
Due to various limitations, proper transparency often requires some amount of careful setup.
By default, objects are not sorted, and the order of elements in the DOM determines order of
rendering. Re-ordering DOM elements provides one way of forcing a consistent behavior, whereas
renderer="sortObjects: true" may cause unwanted changes as the camera moves.
By default, point and spot lights attenuate (or, appear dimmer as they become farther away)
according to a model that is classically common, but physically inaccurate. For more realistic
light attenuation, set
renderer="physicallyCorrectLights: true". Light intensities may need to
be adjusted when making this change. Performance is not significantly affected in either mode.
NOTE: When glTF models contain lights, use the physically-correct lighting mode to match the results in the original modeling tool.
A logarithmic depth buffer may provide better sorting and rendering in scenes containing very large differences of scale and distance.