SoSimplifyAction Class |
Abstract base class for simplifying scene graphs.
Namespace: OIV.Inventor.Actions
The SoSimplifyAction type exposes the following members.
Name | Description | |
---|---|---|
SoSimplifyAction | Constructor. |
Name | Description | |
---|---|---|
Apply(SoNode) | Initiates an action on the graph defined by a node. | |
Apply(SoPath) | Initiates an action on the graph defined by a path. | |
Apply(SoPathList) | Calls Apply(pathList, false). (Inherited from SoAction.) | |
Apply(SoPathList, Boolean) | Initiates an action on the graph defined by a list of paths. | |
ClearApplyResult | When applied, an action may reference nodes or create objects (e.g. | |
EnableElement | ||
EnableElements | (Overrides SoActionEnableElements.) | |
Equals | (Inherited from Object.) | |
ForwardTraversal | Traverse a node that is not part of the current scenegraph. | |
GetContinueActionInBranchFlag | This function indicates if the action must stop in the current branch. | |
GetCurPath | (Inherited from SoAction.) | |
GetDistribMode | Returns the distribution mode of this action across a cluster (ScaleViz-Cluster only) Default is LOCAL_ONLY. | |
GetHashCode |
Overrides GetHashCode().
(Inherited from SoNetBase.) | |
GetMinTriangles | Gets the minimum number of triangles for a simplified child. | |
GetNodeAppliedTo | (Inherited from SoAction.) | |
GetNumRanges | Gets the number of ranges that will be used in the LevelOfSimplification node to decide which level of detail to display. | |
GetNumSimplificationLevels | Gets number of levels of detail to produce. | |
GetOriginalPathListAppliedTo | (Inherited from SoAction.) | |
GetPathAppliedTo | (Inherited from SoAction.) | |
GetPathCode | Returns path code based on where current node (the node at the end of the current path) lies with respect to the path(s) the action is being applied to. | |
GetPathListAppliedTo | (Inherited from SoAction.) | |
GetPipeId | Gets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration. | |
GetRanges | Gets the ranges that will be used in the LevelOfSimplification node to decide which level of detail to display. | |
GetSceneManager | Return the OIV.Inventor.SoSceneManager associated with this action. | |
GetSimplificationLevels | Gets percentages to produce at each level of detail. | |
GetSizeFactor | Gets the scale factor to use to decide what values of ranges to use in the LevelOfSimplification node. | |
GetState | (Inherited from SoAction.) | |
GetType | Gets the Type of the current instance. (Inherited from Object.) | |
GetUrlName | Gets the name used when creating Inline files for each simplified child. | |
GetWhatAppliedTo | (Inherited from SoAction.) | |
HasTerminated | (Inherited from SoAction.) | |
InvalidateState | Invalidates the current traversal state in the action, forcing it to be recreated when the action is next applied. | |
IsBeingApplied | Returns true if this action is currently being applied. | |
IsInlineLOD | Gets inlineLOD flag. | |
IsLastPathListAppliedTo | (Inherited from SoAction.) | |
IsRenderCulling | Gets render culling flag. | |
IsUsingAlternateRep | Returns true if current action is using alternate representations. | |
IsVerbose | Gets verbosity flag. | |
PostDelayedTraversal | Method called by SoMultiPassManager after delayed pass traversals. | |
PreDelayedTraversal | Method called by SoMultiPassManager before delayed pass traversals. | |
ResetContinueActionInBranchFlag | This function resets the continue action flag. | |
SetInlineLOD | Sets inlineLOD flag. | |
SetMinTriangles | Sets the minimum number of triangles for a simplified child; if a given percentage would create a simplified version that went below this minimum, no simplified chld is produced for this level. | |
SetPipeId | Sets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration. | |
SetRanges | Sets the ranges that will be used in the LevelOfSimplification node to decide which level of detail to display. | |
SetRenderCulling | Sets render culling flag. | |
SetSceneManager | Set the scene manager associated with this action (if any ). | |
SetSimplificationLevels | Sets number of levels of detail to produce and what percentage to produce at each level. | |
SetSizeFactor | Sets the scale factor to use to decide what values of ranges to use in the LevelOfSimplification node. | |
SetUpState | (Inherited from SoAction.) | |
SetUrlName | Sets the name used when creating Inline files for each simplified child. | |
SetVerbosity | Sets verbosity flag. | |
StopActionInBranch | This function stops the action in the current Scene Graph branch. | |
ToString | Returns a string that represents the current object. (Inherited from Object.) | |
Traverse | (Inherited from SoAction.) | |
UseAlternateRep | Tell the action to use alternate representations during traversal when available. |
This class is the base class of the simplify actions that produce versions of a scene graph with fewer triangles. The simplify actions can generate either several simplified levels of the original geometry, grouped by a LevelOfSimplification node, or just one reduced level of detail. If a single level is computed, the action creates a single IndexedTriangleFaceSet.
Each simplified sub-levels can be stored in regular separators or in WWWInline nodes. In this case, the urlName defines the full url to use for each WWWInline. For instance if urlName = "dir/file", the action will generate "dir/file_1.wrl","dir/file_2.wrl", and so on. When a simplify action generates Level of Simplification nodes, the range field of each Level of Simplification node can be given globally in the range field of the simplify action. If the simplify action range field is not set, the simplify action computes it automatically for each LevelOfSimplification node. In this case, the sizeFactor field can be used to customize the range computation.
A minimum number of triangles can be set to stop the simplification when the object becomes too small. Specifying 0.0 for the last level inserts an empty node in the scene graph. This allows you to avoid rendering an object that is too small or too far from the viewer.
Available simplification actions are:
OIV.Inventor.Actions.SoGlobalSimplifyAction Traverses the scene graph and collects all the triangles into a single shape which is then simplified.
OIV.Inventor.Actions.SoShapeSimplifyAction Traverses the scene graph and simplifies each shape independently.
OIV.Inventor.Actions.SoReorganizeAction Reorganizes the scene graph by grouping shapes with common properties, then combines those shapes in a single shape and runs the simplifier on it.