public class SoInteractiveComplexity extends SoNode
Note: The values specified in SoInteractiveComplexity
override the values in the fields of the specified nodes during rendering. But calling getValue() on the fields still returns the value set directly into the field (or the default value if none was set).
This is a powerful technique for maintaining an interactive framerate when interacting with GPU intensive datasets or rendering effects, while still getting a final image with very high quality and giving the user a "progressive refinement" effect while transitioning from interaction back to "still".
These settings are applied to all instances of the node class containing the specified field and are declared with a specially formatted string set in the fieldSettings
field. For scalar fields like SoSFInt, the string looks like this:
"ClassName FieldName InteractionValue StillValue [IncrementPerSecond]"
If IncrementPerSecond is omitted, StillValue is applied as soon as interaction stops. Else the transition from InteractionValue to StillValue is automatically animated. Because incrementing is actually done at each redraw, and redraw happens many times per second, IncrementPerSecond is allowed to be greater than StillValue.
In the following code, the field named
value belonging to the class SoComplexity
will be set to 0.1 during an interaction. When the interaction stops,
value will be increased by 2 every second until it reaches 0.5. Effectively this means that the StillValue (0.5) will be reached in (0.5 - 0.1) / 2 = 0.2 seconds.
SoInteractiveComplexity icplx = new SoInteractiveComplexity(); icplx.fieldSettings.set1Value( 0, "SoComplexity value 0.1 0.5 2" ); root.addChild(icplx);
A time delay before changing the value, or starting the animation, can be set using the refinementDelay
field.
The field interactiveMode
allows to force the use of the InteractionValue or the StillValue.
Only a limited number of fields are supported by this node:
SoComplexity
SoOrthoSlice
SoShadowGroup
SoVolumeGroup
SoVolumeRender
SoVolumeRenderingQuality
SoVolumeSkin
File format/default:
InteractiveComplexity {
fieldSettings | [] |
refinementDelay | 0.5 |
interactiveMode | AUTO |
See also:
Modifier and Type | Class and Description |
---|---|
static class |
SoInteractiveComplexity.InteractiveModes
Interactive mode.
|
SoNode.RenderModes
Inventor.ConstructorCommand
Modifier and Type | Field and Description |
---|---|
SoMFString |
fieldSettings
Each string in this field specifies the interactionValue and stillValue for a specific field of a specific node class.
|
SoSFEnum<SoInteractiveComplexity.InteractiveModes> |
interactiveMode
Interactive mode.
|
SoSFFloat |
refinementDelay
Time in seconds after interaction stops before field values start to be increased.
|
VERBOSE_LEVEL, ZeroHandle
Constructor and Description |
---|
SoInteractiveComplexity() |
affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write
copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults
dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable
getNativeResourceHandle
public final SoMFString fieldSettings
For scalar fields (SoSFInt32 , SoSFFloat ...) | ClassName FieldName InteractionValue StillValue [IncrementPerSecond] |
For SoSFBool fields (NumberOfSeconds = delay before switching state) | ClassName FieldName InteractionValue [StillValue] [NumberOfSeconds] |
For SoSFEnum fields | ClassName FieldName InteractionValue StillValue |
The following example defines values for a SoSFFloat
, a SoSFBool
and a SoSFEnum
:
SoInteractiveComplexity icplx = new SoInteractiveComplexity(); icplx.fieldSettings.set1Value( 0, "SoComplexity value 0.1 0.5 2" ); // isActive will switch to true 2 seconds after stopping interaction icplx.fieldSettings.set1Value( 1, "SoShadowGroup isActive false 2" ); icplx.fieldSettings.set1Value( 2, "SoVolumeRenderingQuality gradientQuality LOW HIGH" );
public final SoSFFloat refinementDelay
public final SoSFEnum<SoInteractiveComplexity.InteractiveModes> interactiveMode
Generated on July 31, 2019, Copyright © Thermo Fisher Scientific. All rights reserved. http://www.openinventor.com