| SoSTLWriteAction Class |
Class for exporting a scene graph to an STL file.
Inheritance HierarchyOIV.InventorSoNetBase
OIV.Inventor.ActionsSoAction
OIV.Inventor.ActionsSoCallbackAction
OIV.Inventor.IO.STLSoSTLWriteAction
Namespace: OIV.Inventor.IO.STL
Assembly: OIV.Inventor.IO.STL (in OIV.Inventor.IO.STL.dll) Version: 2023.1.3.0 (2023.1.3)
SyntaxThe SoSTLWriteAction type exposes the following members.
Constructors| Name | Description | |
|---|---|---|
 | SoSTLWriteAction | Constructor. |
Methods| Name | Description | |
|---|---|---|
| AddLineSegmentCallback | Routine to add callbacks for generated primitives (line segments) for all shapes of the given type. |
| AddPointCallback | Routine to add callbacks for generated primitives (points) for all shapes of the given type. |
| AddPostCallback | Adds a callback function to call when a node of the given type is encountered during traversal. |
| AddPreCallback | Adds a callback function to call when a node of the given type is encountered during traversal. |
| AddTriangleCallback | Routine to add callbacks for generated primitives (triangles) for all shapes of the given type. |
| 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 SoCallbackActionEnableElements.) |
| 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 node that is not part of the current scenegraph. |
| GetComplexity | Returns complexity information from the state. |
| GetComplexityType | Returns complexity information from the state. |
| GetContinueActionInBranchFlag | This function indicates if the action must stop in the current branch. |
| GetCoordinate3 | Returns the current coordinates from the state. |
| GetCoordinate4 | Returns the current coordinates from the state. |
| GetCreaseAngle | Returns the current shape hints from the state. |
| 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. |
| GetCurrentResponse | (Inherited from SoCallbackAction.) |
| GetDecimationPercentage | Returns the current decimation percentage from the state. |
| GetDecimationType | Returns the current decimation type from the state. |
| GetDistribMode | Returns the distribution mode of this action across a cluster (ScaleViz-Cluster only). |
| GetDrawStyle | Returns the current drawing style information from the state. |
| GetFaceType | Returns the current shape hints from the state. |
| GetFocalDistance | Returns the current camera and viewing information from the state. |
| GetFontName | Returns the current font information from the state. |
| GetFontRenderStyle | Returns the current font information from the state. |
| GetFontSize | Returns the current font information from the state. |
| GetHashCode |
Overrides GetHashCode().
(Inherited from SoNetBase.) |
| GetLightAttenuation | Returns the current lighting model information from the state. |
| GetLightModel | Returns the current lighting model information from the state. |
| GetLinePattern | Returns the current drawing style information from the state. |
| GetLinePatternScaleFactor | Returns the current drawing style information from the state. |
| GetLineWidth | Returns the current drawing style information from the state. |
| GetMaterial(SbColor, SbColor, SbColor, SbColor, Single, Single) | Calls GetMaterial(ambient, diffuse, specular, emission, shininess, transparency, System.Int32(0)). (Inherited from SoCallbackAction.) |
| GetMaterial(SbColor, SbColor, SbColor, SbColor, Single, Single, Int32) | Returns the current material information from the state. |
| GetMaterialBinding | Returns the current material information from the state. |
| GetModelMatrix | Returns the current modeling transformation from the state. |
| GetNodeAppliedTo | Returns the node the action is being applied to. |
| GetNormal | Returns the current normal information from the state. |
| GetNormalBinding | Returns the current normal information from the state. |
| GetNumCoordinates | Returns the current coordinates from the state. |
| GetNumNormals | Returns the current normal information from the state. |
| GetNumProfileCoordinates | Returns the current profiles and their coordinates from the state. |
| GetNumTextureCoordinates | Returns texture information from the state. |
| 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. |
| GetPickStyle | Returns the current picking style. |
| GetPipeId | Gets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration. |
| GetPointSize | Returns the current drawing style information from the state. |
| GetProfile | Returns the current profiles and their coordinates from the state. |
| GetProfileCoordinate2 | Returns the current profiles and their coordinates from the state. |
| GetProfileCoordinate3 | Returns the current profiles and their coordinates from the state. |
| GetProjectionMatrix | Returns the current camera and viewing information from the state. |
| GetSceneManager | Return the OIV.Inventor.SoSceneManager associated with this action. |
| GetShapeType | Returns the current shape hints from the state. |
| GetState | Gets the state from the action. |
| GetSwitch | Returns the current switch value. |
| GetTextureBlendColor | Returns texture information from the state. |
| GetTextureCoordinate2 | Returns texture information from the state. |
| GetTextureCoordinate4 | Returns texture information from the state. |
| GetTextureCoordinateBinding | Returns texture information from the state. |
| GetTextureFileName | Returns texture information from the state. |
| GetTextureImage(SbVec2i32, Int32) | Returns texture information from the state. |
| GetTextureImage(SbVec2s, Int32) | Obsolete. Returns texture information from the state. |
| GetTextureMatrix | Returns the current texture mapping information from the state. |
| GetTextureModel | Returns the current texture mapping information from the state. |
| GetTextureTransformNode | Returns the current texture mapping information from the state. |
| GetTextureWrapS | Returns the current texture mapping information from the state. |
| GetTextureWrapT | Returns the current texture mapping information from the state. |
| GetTransparencyType | Returns the current Transparency Type information from the state. |
| GetType | Gets the Type of the current instance. (Inherited from Object.) |
| GetUnits | Returns the current units from the state. |
| GetVertexOrdering | Returns the current shape hints from the state. |
| GetViewingMatrix | Returns the current camera and viewing information from the state. |
| GetViewVolume | Returns the current camera and viewing information from the state. |
| GetWhatAppliedTo | Returns code indicating what action is being applied to. |
| HasTerminated | Returns true if the traversal has reached a termination condition. |
| InvalidateState | Invalidates the current traversal state in the action, forcing it to be recreated when the action is next applied. |
| InvokePostCallbacks | (Inherited from SoCallbackAction.) |
| InvokePreCallbacks | (Inherited from SoCallbackAction.) |
| IsBeingApplied | Returns true if this action is currently being applied. |
| IsBinaryOutput | Returns current state of binary flag. |
| IsCallbackAll | Returns whether the callback uses normal traversal (switches, etc.) or whether it traverses every single node. |
| IsLastPathListAppliedTo | Returns true if the current list is the last one from the original. |
| 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. |
| SetBinaryOutput | Sets whether output should be ASCII (default) or binary. |
| SetCallbackAll | Sets whether the callback uses normal traversal (switches, etc.) or whether it traverses every single node. |
| SetOutputFileName | Set the output filename to write to. |
| SetPipeId | Sets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration. |
| SetSceneManager | Set the scene manager associated with this action (if any ). |
| SetUpState | Creates state if it is NULL or it is no longer valid because new elements have been enabled since it was created. |
| ShouldGeneratePrimitives | (Inherited from SoCallbackAction.) |
| 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. |
Events| Name | Description | |
|---|---|---|
 | PostTailTraversal | (Inherited from SoCallbackAction.) |
| PreTailTraversal | (Inherited from SoCallbackAction.) |
RemarksThis class exports an Open Inventor scenegraph into an STL format (.stl) file.
ASCII and binary file formats are supported (see OIV.Inventor.IO.STL.SoSTLWriteAction.SetBinaryOutput(System.Boolean) method).
Limitations:
The STL format does not support color or texture information (and this class does not support any of the non-standard extensions for specifying color).
The application is responsible for checking if the specified file can be created (see OIV.Inventor.Helpers.SbFileHelper).
See Also