| SoBoxHighlightRenderAction Class |
A box highlight style.
Inheritance HierarchyOIV.InventorSoNetBase
OIV.Inventor.ActionsSoAction
OIV.Inventor.ActionsSoGLRenderAction
OIV.Inventor.ActionsSoHighlightRenderAction
OIV.Inventor.ActionsSoBoxHighlightRenderAction
Namespace: OIV.Inventor.Actions
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 2023.1.3.0 (2023.1.3)
SyntaxThe SoBoxHighlightRenderAction type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | SoBoxHighlightRenderAction | Constructor. |
| SoBoxHighlightRenderAction(SbViewportRegion) | Constructor which takes the normal OIV.Inventor.Actions.SoGLRenderAction parameters. |
Methods| Name | Description | |
|---|---|---|
| AbortNow | (Inherited from SoGLRenderAction.) |
| Apply(SoNode) | This renders the passed scene graph, and also renders wireframe boxes around selected objects as specified by the first OIV.Inventor.Nodes.SoSelection node found in the scene graph. |
| Apply(SoPath) | Initiates an action on the graph defined by a path. |
| Apply(SoPathList) | Calls Apply(pathList, false). (Inherited from SoGLRenderAction.) |
| 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. |
| EnableDepthPeeling3D | Use 3D texturing instead of 2D for the fixed functionality emulation in depth peeling. |
 | EnableElement | |
| EnableElements | (Overrides SoHighlightRenderActionEnableElements.) |
| Equals | Determines whether the specified Object is equal to the current Object. (Inherited from Object.) |
| ForwardTraversal(SoNode) | Traverse a node that is not part of the current scenegraph. |
| ForwardTraversal(SoPath) | Traverse a path that is not part of the current scenegraph. |
| GetCache | Returns the cache that has been set with OIV.Inventor.Actions.SoGLRenderAction.SetCache(OIV.Inventor.Caches.SoCache) |
| GetCacheContext | Returns the OpenGL cache context id for this action. |
| GetColor | Gets the color of the highlight. |
| GetContinueActionInBranchFlag | This function indicates if the action must stop in the current branch. |
| GetCurPass | (Inherited from SoGLRenderAction.) |
| GetCurPath | 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. |
| GetDecimationPercentage | Gets decimation percentage, the value should be a number between 0.0 and 1.0. |
| GetDecimationType | Gets decimation type. |
| GetDelayedObjDepthWrite | Returns whether delayed transparent objects update the depth buffer. |
| GetDepthPeelingPass | Get the current pass of depth peeling, -1 if not doing depth peeling. |
| GetDistribMode | Returns the distribution mode of this action across a cluster (ScaleViz-Cluster only). |
| GetFastEditSavePolicy | Returns fast editing save policy used when rendering. |
| GetFrameCounter | Returns the current frame counter. |
| GetHashCode |
Overrides GetHashCode().
(Inherited from SoNetBase.) |
| GetInvalidateCacheMode | Returns the current cache invalidation mode. |
| GetLinePattern | Gets the line pattern of the highlight. |
| GetLineWidth | Gets the line width of the highlight. |
| GetLogicalViewportRegion | Returns current logical viewport region. |
| GetNodeAppliedTo | Returns the node the action is being applied to. |
| GetNumPasses | Gets number of rendering passes for multipass rendering. |
| GetOriginalPathListAppliedTo | Returns the original path list the action is being applied to. |
| GetPathAppliedTo | Returns the path the action is being applied to. |
| 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 | Returns the path list the action is being applied to. |
| GetPipeId | Gets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration. |
| GetRenderingIsRemote | Returns true if remote rendering is being done. |
| GetSceneManager | Return the OIV.Inventor.SoSceneManager associated with this action. |
| GetSortedLayersNumPasses | Returns the number of rendering passes used when transparency type is OIV.Inventor.Actions.SoGLRenderAction.TransparencyTypes.SORTED_PIXEL. |
| GetState | Gets the state from the action. |
| GetTransparencyType | Returns transparency quality level to use when rendering. |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetUpdateArea | Returns the current update area. |
| GetViewportRegion | Returns viewport region to use for rendering. |
| GetWhatAppliedTo | Returns code indicating what action is being applied to. |
| HandleTransparency | Calls HandleTransparency(false, false). (Inherited from SoGLRenderAction.) |
| HandleTransparency(Boolean) | Calls HandleTransparency(isTransparent, false). (Inherited from SoGLRenderAction.) |
| HandleTransparency(Boolean, Boolean) | (Inherited from SoGLRenderAction.) |
| HasTerminated | Returns true if the traversal has reached a termination condition. |
| InvalidateState | Invalidate the state, forcing it to be recreated at the next apply. |
| IsAlphaTest | Returns whether the OpenGL alpha test is enabled for rendering. |
| IsBeingApplied | Returns true if this action is currently being applied. |
| IsDoingDepthPeeling | Return true if depth peeling is active. |
| IsLastPathListAppliedTo | Returns true if the current list is the last one from the original. |
| IsPassUpdate | Returns a flag indicating whether intermediate results are displayed after each antialiasing pass for progressive improvement. |
| IsSmoothing | Obsolete. Returns smoothing flag. |
| IsUsingAlternateRep | Returns true if current action is using alternate representations. |
| IsVisible | Returns whether highlights will be rendered or not. |
| 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. |
| ResetFrameCounter | Calls ResetFrameCounter(System.UInt32(0)). (Inherited from SoGLRenderAction.) |
| ResetFrameCounter(UInt32) | Reset the frame counter. |
| SetAlphaTest | Enable or disable the OpenGL alpha test for rendering. |
| SetCache | Sets the main cache to use with this render action. |
| SetCacheContext | Sets the OpenGL cache context. |
| SetColor | Sets the color of the highlight. |
| SetDecimationValue(SoDecimationTypeElementTypes) | Calls SetDecimationValue(type, 1.0). (Inherited from SoGLRenderAction.) |
| SetDecimationValue(SoDecimationTypeElementTypes, Single) | Sets decimation percentage, the value should be a number between 0.0 and 1.0 Useful for reducing the number of triangles rendered in the scene. |
| SetDelayedObjDepthWrite | Control whether delayed transparent objects update the depth buffer. |
| SetFastEditSavePolicy(SoGLRenderActionFastEditSavePolicies) | Calls SetFastEditSavePolicy(policy, false). (Inherited from SoGLRenderAction.) |
| SetFastEditSavePolicy(SoGLRenderActionFastEditSavePolicies, Boolean) | Sets fast editing save policy to use when rendering. |
| SetInvalidateCacheMode | Enables or disables the invalidation of render caches. |
| SetLinePattern | Sets the line pattern of the highlight. |
| SetLineWidth | Sets the line width of the highlight. |
| SetLogicalViewportRegion | Sets current logical viewport region to use for rendering. |
| SetNumPasses | Sets number of rendering passes for multipass antialiasing. |
| SetPassUpdate | Sets a flag indicating whether intermediate results are displayed after each antialiasing pass for progressive improvement (default is false). |
| SetPipeId | Sets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration. |
| SetRenderingIsRemote | Sets whether or not "remote" rendering is done. |
| SetSceneManager | Set the scene manager associated with this action (if any ). |
| SetSmoothing | Obsolete. Sets smoothing flag. |
| SetSortedLayersNumPasses | Sets the number of rendering passes used when transparency type is OIV.Inventor.Actions.SoGLRenderAction.TransparencyTypes.SORTED_PIXEL. |
| SetTransparencyType | Sets global transparency algorithm to use when rendering. |
| SetUpdateArea | Sets the current update area, which is the rectangular area of the viewport region that will actually be rendered into. |
| SetUpState | initialize the action state. |
| SetViewportRegion | Changes viewport region to use for rendering. |
| SetVisible | This provides a convenient mechanism for turning highlights off or on. |
| ShouldAutoCache | Called by nodes to say that they should/shouldn't be auto-cached (pass true if should, false if shouldn't, don't call this method at all if the node doesn't care): |
| 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 | Does traversal of a graph rooted by a node. |
| UseAlternateRep | Tell the action to use alternate representations during traversal when available. |
Properties| Name | Description | |
|---|---|---|
 | AbortCallback | Sets callback to call during rendering to test for an abort condition. |
| PassCallback | Sets a callback function to invoke between passes when antialiasing. |
RemarksOIV.Inventor.Actions.SoBoxHighlightRenderAction is a render action which renders the specified scene graph, then renders wireframe boxes surrounding each selected object. If an OIV.Inventor.Actions.SoGetBoundingBoxAction applied to a selected object produces an empty bounding box, no highlight is rendered for that object.
Selected objects are specified by the first selection node (OIV.Inventor.Nodes.SoSelection or OIV.Inventor.Nodes.SoExtSelection) node in the scene to which this action is applied. If there is no selection node in the scene graph, then no objects will be highlighted.
The application must explicitly tell Open Inventor to use a highlight render action in place of the default OIV.Inventor.Actions.SoGLRenderAction in the OIV.Inventor.SoSceneManager class using the setGLRenderAction() method. The viewer classes provide a convenience setGLRenderAction() method that calls OIV.Inventor.SoSceneManager (see e.g. OIV.Inventor.Win.SoWinRenderArea).
For convenience, the viewer classes also provide the redrawOnSelectionChange() method. This method attaches a sensor to the specified selection node and automatically schedules a redraw if the set of selected objects is modified.
Other highlight effects are available including "halo" highlighting.
EXAMPLE
Here is an example of how a box highlight can be specified for a particular selection node and viewer:
SoSelection selectionNode = new SoSelection(); . . . SoWinExaminerViewer viewer = new SoWinExaminerViewer(); viewer.SetSceneGraph( selectionNode ); viewer.SetGLRenderAction( new SoBoxHighlightRenderAction() ); viewer.RedrawOnSelectionChange( selectionNode );
See Also