| SoSplitGeometryAction Class |
Split large geometry into smaller objects to improve culling for multi-pipe rendering.
Inheritance HierarchyOIV.InventorSoNetBase
OIV.Inventor.ActionsSoAction
OIV.Inventor.ActionsSoSplitGeometryAction
Namespace: OIV.Inventor.Actions
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 9.9.13.0 (9.9.13.0)
SyntaxThe SoSplitGeometryAction type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | SoSplitGeometryAction(Int32, Int32) | Constructor for splitting geometry along 2 dimensions. |
| SoSplitGeometryAction(Int32, Int32, Int32) | Constructor for splitting geometry along 3 dimensions. |
Methods| 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). |
| 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.) |
| GetHashCode |
Overrides GetHashCode().
(Inherited from SoNetBase.) |
| GetNodeAppliedTo | (Inherited from SoAction.) |
| GetNumDivisions(Int32, Int32) | Returns the current division values to split an object in 2D. |
| GetNumDivisions(Int32, Int32, Int32) | Returns the current division values to split an object in 3D. |
| GetNumObjFound | Returns how many objects the action has split. |
| 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. |
| GetSceneManager | Return the SoSceneManager associated with this action. |
| GetState | (Inherited from SoAction.) |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| 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. |
| IsDistinguishSplitParts | Returns true if distinguish split parts is enabled. |
| IsKeepOriginalGeometry | Returns true if keep original geometry is enabled. |
| IsLastPathListAppliedTo | (Inherited from SoAction.) |
| IsMaintainVertexOrdering | Returns true if the option to maintain initial vertex ordering is on. |
| IsSmartSplitting | Returns true if smart splitting is enabled. |
| IsTraverseAllSoSwitchChildren | Returns true if traverse all SoSwitch children is enabled. |
| IsUsingAlternateRep | Returns true if current action is using alternate representations. |
| 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. |
| SetDistinguishSplitParts | Calling this method before applying the action allows you to see how the action has split the objects. |
| SetKeepOriginalGeometry | By default, the action modifies the scene graph by replacing the original node it has split with a new separator containing all the new nodes. |
| SetMaintainVertexOrdering | If the initial geometry is composed of SoIndexedTriangleStripSet and uses an SoShapeHints with a known vertex ordering (SoShapeHints.CLOCKWISE or SoShapeHints.COUNTERCLOCKWISE), the action has to maintain the initial vertex ordering or problems with normals will appear. |
| SetMaximumDivisionWarning | There is a maximum number of division to divide an object because this object is composed by some primitives (triangles) that cannot be split without changing the geometry. |
| SetNumDivisions(Int32, Int32) | Specifies the number of divisions for splitting an object in 2D. |
| SetNumDivisions(Int32, Int32, Int32) | Specifies the number of divisions for splitting an object in 3D. |
| SetPipeId | Sets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration. |
| SetPreCallback(SoSplitGeometryActionPreCallback) | Obsolete.
Use PreTraversal property instead.
These add a delegate to invoke when a node of the given type is encountered during traversal.
The PreCallback is called just before the node is traversed. For each node to split, you can
"customize" how to split it by enabling, or disabling options, changing the division values, etc.
|
| SetPreCallback(SoSplitGeometryActionPreUserDataCallback, Object) | Obsolete.
Use PreTraversal property instead.
|
| SetSceneManager | Set the scene manager associated with this action (if any ). |
| SetSmartSplitting | If this option is set before the action is applied, objects will be split by dividing the greatest bounding box side into the largest number of divisions, the next largest side by the next largest number of divisions, and so on. |
| SetTraverseAllSoSwitchChildren | By default the action will only traverse the active child of SoSwitch nodes. |
| SetUpState | (Inherited from SoAction.) |
| 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. |
Properties| Name | Description | |
|---|---|---|
 | PreTraversal | These add a callback function to call when a node of the given type is encountered during traversal. |
RemarksView frustum culling, for example using the SoOctreeOrdering node, is an important optimization, especially for multi-pipe rendering. However, a large object implemented as a single geometry node cannot be effectively culled. For each pipe where the object is partially visible, the entire object must be rendered.
This action splits a large object into multiple geometry nodes, without changing the appearance of the object. Culling can then applied to the new nodes individually.
The scene does not need to be subdivided into a large number of parts. Usually, 5 by 5 is enough to reasonably divide work between the threads. The new objects use the same vertex coordinates (and normals, materials,... if specified) as the original geometry. No triangles are added, removed, or split. A small amount of additional memory is required for the coordinate indices in the new objects.
Note: Currently this action applies only to SoIndexedFaceSet and SoIndexedTriangleStripSet nodes. The new object is the same type of node as the original.
Texture Mapping: If the original geometry has explicit texture coordinates, the result will be correct. If texture coordinates are computed by Open Inventor, the texture will be applied separately to each new object.
See Also