SoToVRML2Action Class

Note: This API is now obsolete.

Converts an Open Inventor scene graph into a VRML 2.0-style scene graph.

Inheritance Hierarchy

SystemObject
  OIV.InventorSoNetBase
    OIV.Inventor.ActionsSoAction
      OIV.Inventor.ActionsSoToVRMLAction
        OIV.Inventor.ActionsSoToVRML2Action
          OIV.Inventor.Gui.ViewPoToVRML2Action

Namespace: OIV.Inventor.Actions
Assembly: OIV.Inventor (in OIV.Inventor.dll) Version: 9.9.13.0 (9.9.13.0)

Syntax

C++

Copy

[ObsoleteAttribute("See documentation for more details")]
[EditorBrowsableAttribute(EditorBrowsableState.Never)]
public class SoToVRML2Action : SoToVRMLAction

<ObsoleteAttribute("See documentation for more details")>
<EditorBrowsableAttribute(EditorBrowsableState.Never)>
Public Class SoToVRML2Action
	Inherits SoToVRMLAction

[ObsoleteAttribute(L"See documentation for more details")]
[EditorBrowsableAttribute(EditorBrowsableState::Never)]
public ref class SoToVRML2Action : public SoToVRMLAction

[<ObsoleteAttribute("See documentation for more details")>]
[<EditorBrowsableAttribute(EditorBrowsableState.Never)>]
type SoToVRML2Action =  
    class
        inherit SoToVRMLAction
    end

The SoToVRML2Action type exposes the following members.

Constructors

	Name	Description
	SoToVRML2Action	Constructor.

Top

Methods

	Name	Description
	Apply(SoNode)	Apply action to the specified root node. (Overrides SoToVRMLActionApply(SoNode).)
	Apply(SoPath)	Apply action to the specified path. (Overrides SoToVRMLActionApply(SoPath).)
	Apply(SoPathList)	Calls Apply(path_list, false).
	Apply(SoPathList, Boolean)	Apply action to the specified list of path. (Overrides SoToVRMLActionApply(SoPathList, Boolean).)
	AreSoFileExpanded	Gets whether to read the contents of SoFile nodes into the new scene graph. (Inherited from SoToVRMLAction.)
	AreTexCoordWritten	Gets whether to put texture coordinates into the new scene graph. (Inherited from SoToVRMLAction.)
	AreTexture2NodeExpanded	Gets whether to bring the contents of texture files into the new scene graph , or to leave them as references to files. (Inherited from SoToVRMLAction.)
	AreTextureNodeExpanded
	AreUnknownNodeKept	Gets whether to preserve nodes of unknown type. (Inherited from SoToVRMLAction.)
	ClearApplyResult	When applied, an action may reference nodes or create objects (e.g. (Inherited from SoAction.)
	ConditionalConversion	Sets whether inline nodes are conditionally converted to VRML. (Inherited from SoToVRMLAction.)
	ConvertInlineNodes	Sets whether inline nodes are converted to VRML. (Inherited from SoToVRMLAction.)
	DoConditionalConversion	Gets whether inline nodes are conditionally converted to VRML. (Inherited from SoToVRMLAction.)
	DoConvertInlineNodes	Gets whether inline nodes are converted to VRML. (Inherited from SoToVRMLAction.)
	DoReuseAppearanceNodes	Returns whether shared materials should be organized into shared appearance nodes in the new scene graph.
	DoReuseGeometryNodes	Returns whether shared geometry nodes should be shared in the new scene graph.
	DoReusePropertyNodes	Returns whether shared properties should be organized into shared nodes in the new scene graph.
	EnableElement
	EnableElements	(Overrides SoToVRMLActionEnableElements.)
	Equals	Determines whether the specified Object is equal to the current Object. (Inherited from Object.)
	ExpandSoFile	Sets whether to read the contents of SoFile nodes into the new scene graph. (Inherited from SoToVRMLAction.)
	ExpandTexture2Node
	ForwardTraversal	Traverse a node that is not part of the current scenegraph. (Inherited from SoAction.)
	GetContinueActionInBranchFlag	This function indicates if the action must stop in the current branch. (Inherited from SoAction.)
	GetCurPath	(Inherited from SoAction.)
	GetHashCode	Overrides GetHashCode(). (Inherited from SoNetBase.)
	GetNodeAppliedTo	(Inherited from SoAction.)
	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. (Inherited from SoAction.)
	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. (Inherited from SoAction.)
	GetPathListAppliedTo	(Inherited from SoAction.)
	GetPipeId	Gets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration. (Inherited from SoAction.)
	GetSceneManager	Return the SoSceneManager associated with this action. (Inherited from SoAction.)
	GetState	(Inherited from SoAction.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	GetUrlName	Gets the directory in which to write VRMLInline files. (Inherited from SoToVRMLAction.)
	GetVRML2SceneGraph	Returns result as VRML 2.0 scene graph.
	GetVRMLSceneGraph	Returns result as VRML style scene graph. (Inherited from SoToVRMLAction.)
	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. (Inherited from SoAction.)
	IsBeingApplied	Returns true if this action is currently being applied. (Inherited from SoAction.)
	IsLastPathListAppliedTo	(Inherited from SoAction.)
	IsUsingAlternateRep	Returns true if current action is using alternate representations. (Inherited from SoAction.)
	KeepUnknownNodes	Sets whether to preserve nodes of unknown type. (Inherited from SoToVRMLAction.)
	PostDelayedTraversal	Method called by SoMultiPassManager after delayed pass traversals. (Inherited from SoAction.)
	PreDelayedTraversal	Method called by SoMultiPassManager before delayed pass traversals. (Inherited from SoAction.)
	ResetContinueActionInBranchFlag	This function resets the continue action flag. (Inherited from SoAction.)
	ReuseAppearanceNodes	Sets whether shared materials should be organized into shared appearance nodes in the new scene graph.
	ReuseGeometryNodes	Sets whether shared geometry nodes should be shared in the new scene graph.
	ReusePropertyNodes	Sets whether shared properties should be organized into shared nodes in the new scene graph.
	SetPipeId	Sets pipe identifier in the range [1..N] associated to this render action while running a ScaleViz Multipipe configuration. (Inherited from SoAction.)
	SetSceneManager	Set the scene manager associated with this action (if any ). (Inherited from SoAction.)
	SetUpState	(Inherited from SoAction.)
	SetUrlName	Sets the directory in which to write VRMLInline files. (Inherited from SoToVRMLAction.)
	StopActionInBranch	This function stops the action in the current Scene Graph branch. (Inherited from SoAction.)
	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. (Inherited from SoAction.)
	WriteTexCoords	Sets whether to put texture coordinates into the new scene graph. (Inherited from SoToVRMLAction.)

Top

Remarks

This action takes an Open Inventor scene graph and builds a new VRML 2.0-style scene graph. This scene graph can then be stored as a VRML file. The effect of this action is similar to the effect of the ivtovrml tool.

<font color="#0000FF">NOTE:</font> This class does not exist in Open Inventor 10.0 and later.

During the conversion process, a temporary intermediate copy of the scene graph may be created. If your input scene graph is large, the three copies of the scene graph (initial, intermediate, and final) may use a lot of memory.

There is not always an exact match between Open Inventor items and VRML 2.0 items. Some Open Inventor items, for example, 2D text (SoText2) do not exist in VRML 2.0 and will not be converted. Other items may be converted, but with subtle differences in behavior.

Texture Modeling : 3- and 4-component textures work differently in Open Inventor and VRML 2.0. In Open Inventor, by default, the texture color is multiplied by the material surface color ("modulate" mode). In VRML 2.0, a texture's RGB colors and transparency replace the material's current diffuse color and transparency (like "decal" mode). For example, if an object is red with a colored texture, in Open Inventor, the red would affect the appearance of the object. Once converted to VRML 2.0, the object would display the colors of the texture, without any influence of the red.

Texture Coordinates : Open Inventor and VRML 2.0 handle texture coordinates differently. If your scene graph uses texture coordinates for precise application of a texture to a shape, the visual results may be different after conversion to VRML 2.0.

Reference

OIV.Inventor.Actions Namespace

OIV.Inventor.ActionsSoAction