5.2.3. DirectViz Control Parameters

The SoDirectVizManager SoDirectVizManager SoDirectVizManager class manages several features for adapting DirectViz to the complexity of the scene and the performance of the hardware. They are controlled by different fields and can be accessed via the DirectViz control dialog, which allows the user to tune interaction and image quality. SoPreferences SoPreferences SoPreferences parameters are also available to control DirectViz behavior.

The control dialog appears automatically when DirectViz is launched, unless the SoPreferences SoPreferences SoPreferences DIRECTVIZ_CONTROL_DIALOG parameter is set to 0 or if the SoDirectVizManager SoDirectVizManager SoDirectVizManager controlDialog field is set to FALSE. It is also possible to show or hide the dialog with the method showDirectVizDialog () of the corresponding Open Inventor viewer or by pressing the Shift+F8 keyboard control keys.

The DirectViz control dialog

Figure 5.6. The DirectViz control dialog


The parameters available in the control dialog are summarized below and are detailed in subsequent sections.

Description Control dialog Related SoDirectVizManager SoDirectVizManager SoDirectVizManager fields

Turn on DirectViz rendering

rendering

Use acceleration structure cache file

fileCaching

Activate shadow casting globally

globalShadowing

Activate soft shadows

softShadows

Enable recursion on subsampling

Set recursion depth limit

subRecursion

recursionLimit

Enable accumulation oversampling

Set number of passes

accumulation

maxAccumulationValue

Enable adaptive oversampling

adaptiveOversampling

Enable fuzzy light effects

fuzzyLights

Enable glossy surfaces effects

glossySurfaces

Sets the number of environment lights and corresponding scale

numEnvLights

envLightIntensityScale

Enable progressive resolution rendering

Set number of steps

progressiveRendering

numProgressiveRenderingSteps

Enable resolution sub-sampling

Set sampling factor

subSampling

subSamplingFactor

The control dialog also provides information about:

  • Last rendered image – size in pixels, accumulation value, and generation time in seconds.

  • DirectViz structures – number of geometry objects, textures, surface shaders, and lights.