RenderingOptions

RenderingOptions

is an option for Style, Cell and related constructs that specifies options related to 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
    "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
    "HardwareDepthBuffer"use a hardware-based depth buffer to sort polygons back to front; this method is the fastest, but will not render transparency correctly
    "HardwareDepthPeeling"use hardware-accelerated depth peeling to sort polygons and render transparency
    "BSPTree"sort polygons in software by splitting them at their intersections and inserting them into a BSP tree; this method is slow, but can be used without modern graphical hardware
  • 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.
  • "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 or WARP to render the scene:

In[1]:=
Click for copyable input
Out[1]=

Applications  (1)

Introduced in 1999
(4.0)