| SoBoxHighlightRenderAction Class |
A selection highlight style.
Inheritance HierarchyOIV.InventorSoNetBase
OIV.Inventor.ActionsSoAction
OIV.Inventor.ActionsSoGLRenderAction
OIV.Inventor.ActionsSoBoxHighlightRenderAction
Namespace: OIV.Inventor.Actions
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 10.3.0.0 (10.3.0.0)
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) | Applies action to the graph defined by a path. |
| Apply(SoPathList) | Calls Apply(pathList, false). |
| Apply(SoPathList, Boolean) | Applies action to the graph defined by a path list. |
| 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 SoGLRenderActionEnableElements.) |
| Equals | (Inherited from Object.) |
| ForwardTraversal | Traverse a node that is not part of the current scenegraph. |
| 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 | (Inherited from SoAction.) |
| 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) Default is LOCAL_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 | (Inherited from SoAction.) |
| GetNumPasses | Gets number of rendering passes for multipass rendering. |
| 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. |
| 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 | (Inherited from SoAction.) |
| 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 | (Inherited from SoAction.) |
| HandleTransparency | Calls HandleTransparency(false, false). (Inherited from SoGLRenderAction.) |
| HandleTransparency(Boolean) | Calls HandleTransparency(isTransparent, false). (Inherited from SoGLRenderAction.) |
| HandleTransparency(Boolean, Boolean) | (Inherited from SoGLRenderAction.) |
| HasTerminated | (Inherited from SoAction.) |
| 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 | (Inherited from SoAction.) |
| IsPassUpdate | Returns a flag indicating whether intermediate results are displayed after each antialiasing pass for progressive improvement. |
| IsSmoothing | 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. |
| 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 | 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 | (Inherited from SoAction.) |
| 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. Selected objects are specified by the first OIV.Inventor.Nodes.SoSelection node in the scene to which this action is applied. If an OIV.Inventor.Actions.SoGetBoundingBoxAction applied to a selected object produces an empty bounding box, no highlight is rendered for that object. A highlight render action can be passed to the setGLRenderAction() method of render area and viewer classes to have an effect on scene graphs.
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