RenderingOptions

RenderingOptions

is an option for Style, Cell and related constructs that specifies options related to 3D rendering.

Details

  • The typical usage is RenderingOptions->{opt1->val1,opt2->val2,}.
  • The following suboptions can be specified:
  • "3DRenderingEngine"Automaticplatform for 3D scene rendering
    "3DRenderingMethod"Automaticpreferred rendering methodology
    "DepthPeelingLayers"8number of layers to split the scene into
    "HardwareAntialiasingQuality"1.specifies the level of anitialiasing for scene
    "LegacyAlphaChannelMethod"Falsemethod for generating transparency
    "ShowFrameRateCounter"Falsewhether to show the 3D frame rate in the window title bar
  • "3DRenderingEngine" specifies the rendering engine for 3D graphics. The following values may be given:
  • Automaticautomatically determine the best rendering engine
    "Direct3D"use the system's Direct3D driver, available only on Windows systems
    "Mesa"use the bundled Mesa implementation of OpenGL, available on all systems
    "Metal"use the system's Metal driver, available only on macOS systems
    "OpenGL"use the system's OpenGL driver, available only on non-Windows systems
  • "3DRenderingMethod" is used to determine how to sort polygons and render transparency. The following values may be given:
  • Automaticautomatically determine the best rendering method based upon the graphic's contents and the available rendering hardware and drivers
  • When the 3D rendering method is using depth peeling, "DepthPeelingLayers" specifies the number of layers the 3D scene is rendered into before the final image is composed.
  • "HardwareAntialiasingQuality" maps the range [0, 1] to the number of antialiasing samples used to render a scene. Which antialiasing sample rate is chosen for a given value is dependent on the particular rendering hardware and driver.
  • The global setting of "HardwareAntialiasingQuality" corresponds to the Antialiasing Quality slider located in the Appearance Graphics pane of the Preferences dialog.
  • "LegacyAlphaChannelMethod" specifies how transparency is generated when rasterizing an expression. By default, the system renders the graphic into a 3D rendering context to compute the alpha channel. "LegacyAlphaChannelMethod"->True instead creates two images with different background colors and computes the alpha channel by comparing the pixels of each image.
  • "ShowFrameRateCounter"->True will add text to the window's title bar indicating the current frame rate. The number is updated periodically as 3D graphics are re-rendered, either via interactive rotation or through animation.
  • "ShowFrameRateCounter" may be set on notebooks, but is ignored when set on cells or individual Style constructs.

Examples

open allclose all

Basic Examples  (1)

Use Mesa to render the scene:

Applications  (1)

Nearly coplanar polygons may be rendered inconsistently by default rendering methods:

Using a BSP tree, while slower, produces more predictable sorting of polygons:

Introduced in 1999
 (4.0)
 |
Updated in 2020
 (12.1)