| SoGlobalSimplifyAction Class |
Traverses the scene graph and collects all the triangles in a single list.
Inheritance HierarchyOIV.InventorSoNetBase
OIV.Inventor.ActionsSoAction
OIV.Inventor.ActionsSoSimplifyAction
OIV.Inventor.ActionsSoGlobalSimplifyAction
Namespace: OIV.Inventor.Actions
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 9.9.13.0 (9.9.13.0)
SyntaxThe SoGlobalSimplifyAction type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | SoGlobalSimplifyAction | Constructor. |
Methods| Name | Description | |
|---|---|---|
| AddShapeHintsNode | Sets whether a shape hints node is added. |
| 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). |
| Apply(SoPathList, Boolean) | Initiates an action on the graph defined by a list of paths. |
| AreAllShapesCatched | Gets the flag that specifies whether simple shapes are simplified. |
| AreNormalGenerated | Gets the normal generation flag. |
| ClearApplyResult | When applied, an action may reference nodes or create objects (e.g. |
 | EnableElement | |
| EnableElements | (Overrides SoSimplifyActionEnableElements.) |
| Equals | (Inherited from Object.) |
| ForwardTraversal | Traverse a node that is not part of the current scenegraph. |
| GenerateNormals | Sets the normal generation flag. |
| GetContinueActionInBranchFlag | This function indicates if the action must stop in the current branch. |
| GetCurPath | (Inherited from SoAction.) |
| 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(SbNativeArrayInt32) | 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. |
| GetPathCode(SbNativeInt32Array) | Obsolete. 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 SoSceneManager associated with this action. |
| GetSimplificationLevels | Gets percentages to produce at each level of detail. |
| GetSimplificationStrategy | Gets the strategy used to determine how to group triangles into the simplified shapes. |
| GetSimplifiedSceneGraph | This returns the new scene graph which contains the simplified result. |
| 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. |
| IsShapeHintAdded | Gets whether a shape hints node will be added. |
| 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. |
| SetCatchAllShapesFlag | Sets the flag that specifies whether simple shapes are simplified. |
| 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. |
| SetSimplificationStrategy | Sets the strategy used to determine how to group triangles into the simplified shapes. |
| 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. |
RemarksThis list is then simplified and the result is stored in a new scene graph.
This class traverses the scene graph and collects all the triangles in a single list. This list is then simplified and the result is stored in a new scene graph.
The SoGlobalSimplifyAction provides two simplification strategies:
SIMPLIFY_GLOBALLY: all the triangles found in the scene graph are collected in a single object. Then this object is simplified.
SIMPLIFY_BY_SUBGROUP: triangles are collected until a material change or a separator is found.
The default strategy is SIMPLIFY_BY_SUBGROUP.
NOTE: Colors and normal vectors in the existing shapes are not preserved!
Calling generateNormals(true), which is the default, tells Open Inventor to compute per-vertex normal during this action. When disabled (calling generateNormals(false)), objects may appear faceted instead of appearing smooth.
If generateNormals is false, it may be useful to call addShapeHints(true). This tells Open Inventor to add an SoShapeHints node to the result scene graph that will cause normals to be computed during the next render traversal.
By default the SoGlobalSimplifyAction collects all the triangles even if they are part of a simple shape (cube, cone, sphere, text3...). Setting the setCatchAllShapesFlag() flag to false tells the action to collect triangles only if they belong to a complex shape.
The getSimplifiedSceneGraph() method returns the root of the new scene graph after applying the SoGlobalSimplifyAction.
Typically you will pass an instance of SoDecimator to the constructor. Please see SoDecimator for info about which geometry objects can be simplified.
SoAction, SoLevelOfSimplification, SoShapeSimplifyAction, SoSimplifyAction
See Also