Click or drag to resize
SoGlobalSimplifyAction Class

Traverses the scene graph and collects all the triangles in a single list.

Inheritance Hierarchy
SystemObject
  OIV.InventorSoNetBase
    OIV.Inventor.ActionsSoAction
      OIV.Inventor.ActionsSoSimplifyAction
        OIV.Inventor.ActionsSoGlobalSimplifyAction

Namespace: OIV.Inventor.Actions
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 10.12.3.0 (10.12.3.0)
Syntax
public class SoGlobalSimplifyAction : SoSimplifyAction

The SoGlobalSimplifyAction type exposes the following members.

Constructors
  NameDescription
Public methodSoGlobalSimplifyAction

Constructor.

Top
Methods
  NameDescription
Public methodAddShapeHintsNode

Sets whether a shape hints node is added.

Public methodApply(SoNode)

Initiates an action on the graph defined by a node.

(Overrides SoActionApply(SoNode).)
Public methodApply(SoPath)

Initiates an action on the graph defined by a path.

(Overrides SoActionApply(SoPath).)
Public methodApply(SoPathList)
Calls Apply(pathList, false).
Public methodApply(SoPathList, Boolean)

Initiates an action on the graph defined by a list of paths.

(Overrides SoActionApply(SoPathList, Boolean).)
Public methodAreAllShapesCatched

Gets the flag that specifies whether simple shapes are simplified.

Public methodAreNormalGenerated

Gets the normal generation flag.

Public methodClearApplyResult

When applied, an action may reference nodes or create objects (e.g.

(Overrides SoActionClearApplyResult.)
Public methodStatic memberEnableElement
Public methodEnableElements

(Overrides SoSimplifyActionEnableElements.)
Public methodEquals
Determines whether the specified Object is equal to the current Object.
(Inherited from Object.)
Public methodForwardTraversal(SoNode)

Traverse a node that is not part of the current scenegraph.

(Inherited from SoAction.)
Public methodForwardTraversal(SoPath)

Traverse a path that is not part of the current scenegraph.

(Inherited from SoAction.)
Public methodGenerateNormals

Sets the normal generation flag.

Public methodGetContinueActionInBranchFlag

This function indicates if the action must stop in the current branch.

(Inherited from SoAction.)
Public methodGetCurPath

Returns the path accumulated during traversal, i.e., the chain of nodes from the root of the traversed graph to the current node being traversed.

(Inherited from SoAction.)
Public methodGetDistribMode

Returns the distribution mode of this action across a cluster (ScaleViz-Cluster only).

(Inherited from SoAction.)
Public methodGetHashCode
Overrides GetHashCode().
(Inherited from SoNetBase.)
Public methodGetMinTriangles

Gets the minimum number of triangles for a simplified child.

(Inherited from SoSimplifyAction.)
Public methodGetNodeAppliedTo

Returns the node the action is being applied to.

(Inherited from SoAction.)
Public methodGetNumRanges

Gets the number of ranges that will be used in the LevelOfSimplification node to decide which level of detail to display.

(Inherited from SoSimplifyAction.)
Public methodGetNumSimplificationLevels

Gets number of levels of detail to produce.

(Inherited from SoSimplifyAction.)
Public methodGetOriginalPathListAppliedTo

Returns the original path list the action is being applied to.

(Inherited from SoAction.)
Public methodGetPathAppliedTo

Returns the path the action is being applied to.

(Inherited from SoAction.)
Public methodGetPathCode

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.

(Inherited from SoAction.)
Public methodGetPathListAppliedTo

Returns the path list the action is being applied to.

(Inherited from SoAction.)
Public methodGetPipeId

Gets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration.

(Inherited from SoAction.)
Public methodGetRanges

Gets the ranges that will be used in the LevelOfSimplification node to decide which level of detail to display.

(Inherited from SoSimplifyAction.)
Public methodGetSceneManager

Return the OIV.Inventor.SoSceneManager associated with this action.

(Inherited from SoAction.)
Public methodGetSimplificationLevels

Gets percentages to produce at each level of detail.

(Inherited from SoSimplifyAction.)
Public methodGetSimplificationStrategy

Gets the strategy used to determine how to group triangles into the simplified shapes.

Public methodGetSimplifiedSceneGraph

This returns the new scene graph which contains the simplified result.

Public methodGetSizeFactor

Gets the scale factor to use to decide what values of ranges to use in the LevelOfSimplification node.

(Inherited from SoSimplifyAction.)
Public methodGetState

Gets the state from the action.

(Inherited from SoAction.)
Public methodGetType
Gets the Type of the current instance.
(Inherited from Object.)
Public methodGetUrlName

Gets the name used when creating Inline files for each simplified child.

(Inherited from SoSimplifyAction.)
Public methodGetWhatAppliedTo

Returns code indicating what action is being applied to.

(Inherited from SoAction.)
Public methodHasTerminated

Returns true if the traversal has reached a termination condition.

(Inherited from SoAction.)
Public methodInvalidateState

Invalidates the current traversal state in the action, forcing it to be recreated when the action is next applied.

(Inherited from SoAction.)
Public methodIsBeingApplied

Returns true if this action is currently being applied.

(Inherited from SoAction.)
Public methodIsInlineLOD

Gets inlineLOD flag.

(Inherited from SoSimplifyAction.)
Public methodIsLastPathListAppliedTo

Returns true if the current list is the last one from the original.

(Inherited from SoAction.)
Public methodIsRenderCulling

Gets render culling flag.

(Inherited from SoSimplifyAction.)
Public methodIsShapeHintAdded

Gets whether a shape hints node will be added.

Public methodIsUsingAlternateRep

Returns true if current action is using alternate representations.

(Inherited from SoAction.)
Public methodIsVerbose

Gets verbosity flag.

(Inherited from SoSimplifyAction.)
Public methodPostDelayedTraversal

Method called by SoMultiPassManager after delayed pass traversals.

(Inherited from SoAction.)
Public methodPreDelayedTraversal

Method called by SoMultiPassManager before delayed pass traversals.

(Inherited from SoAction.)
Public methodResetContinueActionInBranchFlag

This function resets the continue action flag.

(Inherited from SoAction.)
Public methodSetCatchAllShapesFlag

Sets the flag that specifies whether simple shapes are simplified.

Public methodSetInlineLOD

Sets inlineLOD flag.

(Inherited from SoSimplifyAction.)
Public methodSetMinTriangles

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.

(Inherited from SoSimplifyAction.)
Public methodSetPipeId

Sets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration.

(Inherited from SoAction.)
Public methodSetRanges

Sets the ranges that will be used in the LevelOfSimplification node to decide which level of detail to display.

(Inherited from SoSimplifyAction.)
Public methodSetRenderCulling

Sets render culling flag.

(Inherited from SoSimplifyAction.)
Public methodSetSceneManager

Set the scene manager associated with this action (if any ).

(Inherited from SoAction.)
Public methodSetSimplificationLevels

Sets number of levels of detail to produce and what percentage to produce at each level.

(Inherited from SoSimplifyAction.)
Public methodSetSimplificationStrategy

Sets the strategy used to determine how to group triangles into the simplified shapes.

Public methodSetSizeFactor

Sets the scale factor to use to decide what values of ranges to use in the LevelOfSimplification node.

(Inherited from SoSimplifyAction.)
Public methodSetUpState

Creates state if it is NULL or it is no longer valid because new elements have been enabled since it was created.

(Inherited from SoAction.)
Public methodSetUrlName

Sets the name used when creating Inline files for each simplified child.

(Inherited from SoSimplifyAction.)
Public methodSetVerbosity

Sets verbosity flag.

(Inherited from SoSimplifyAction.)
Public methodStopActionInBranch

This function stops the action in the current Scene Graph branch.

(Inherited from SoAction.)
Public methodToString
Returns a string that represents the current object.
(Inherited from Object.)
Public methodTraverse

Does traversal of a graph rooted by a node.

(Inherited from SoAction.)
Public methodUseAlternateRep

Tell the action to use alternate representations during traversal when available.

(Inherited from SoAction.)
Top
Remarks

This 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 OIV.Inventor.Actions.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 OIV.Inventor.Nodes.SoShapeHints node to the result scene graph that will cause normals to be computed during the next render traversal.

By default the OIV.Inventor.Actions.SoGlobalSimplifyAction collects all the triangles even if they are part of a simple shape (cube, cone, sphere, text3...). Setting the OIV.Inventor.Actions.SoGlobalSimplifyAction.SetCatchAllShapesFlag(System.Boolean) flag to false tells the action to collect triangles only if they belong to a complex shape.

The OIV.Inventor.Actions.SoGlobalSimplifyAction.GetSimplifiedSceneGraph() method returns the root of the new scene graph after applying the OIV.Inventor.Actions.SoGlobalSimplifyAction.

Typically you will pass an instance of OIV.Inventor.Simplifier.SoDecimator to the constructor. Please see OIV.Inventor.Simplifier.SoDecimator for info about which geometry objects can be simplified.

See Also