Class TX3DRootNode

This item has no description.

This item has no description. Showing description inherited from TX3DNode.DeepCopyCore.

Does actual DeepCopy work. You can override this to copy some more properties for descendants.

Root node never saves/restores the traversing state. This means that all state changes "leak out" from a root node. This is a good thing: if root node isn't used as a final TCastleSceneCore.RootNode, then it is placed inside Inline node, which will do save/restore anyway. And this way VRML 1.0 WWWInline with separate=FALSE may also work too.

This item has no description. Showing description inherited from TX3DNode.Create.

Constructor. Initializes various properties:

• Name, BaseUrl are initialized from given parameters.

• The Fields, Events lists are filled in every descendant, to have all the fields/events defined by the specification.

• DefaultContainerField, and other node-specific stuff, is filled in descendants. This is actually implemented in CreateNode, that is called at the end of this constructor.

This item has no description.

This item has no description.

Save contents to the stream.

If SaveAsRootNode then this is saved in a special way, such that only the contents are written, without surrounding braces (for classic encoding) or XML element (for xml encoding). This way, when saving, we hide the fact that everything was wrapped in an artificial TX3DRootNode.

Set properties to force saving this node graph as X3D. If we're already configured to save as X3D (current major version >= 3) then do nothing. Otherwise, sets major/minor versions (by default: for X3D 4.0, Interchange profile).

Provided AMajor must be >= 3, since X3D version is always >= 3.

This works to indicate convert VRML 2.0 to X3D. We simply change ForceVersion used to save to indicate X3D version. This is a reasonable conversion of VRML 2 -> X3D (except NURBS nodes, which are incompatible between VRML 2.0 and X3D and at this point not dealt by this conversion correctly).

This should not be used if the original file version indicates that it's an old VRML 1.0 or Inventor file, as we have not implemented convertion from VRML 1.0/Inventor to X3D. So it wil result in VRML 1.0/Inventor nodes saved using the X3D (XML or classic) encoding, which is not a format supported by any X3D reader (even our own). We will display a warning if you attempt this.

Export node, to have its name known by X3D graph that includes this graph by "Inline" node.

Use this if you build X3D graph by hand, and you want do add the EXPORT X3D clause. It adds the clause (using AddExport, so it can be saved back to X3D file reliably) and also makes it immediately working (adding it to the proper namespace).

This item has no description.

Should SaveToStream take care to nicely save us, treating as a root node of whole VRML file or prototype.

If this node isn't a root node, you should set this to False (or saving this node may generate dumb contents). Although, generally, you should avoid using the TX3DRootNode class at all for non-root nodes.

Set HasForceVersion to True to force saving this model with given ForceVersion.

Profile required for this X3D file. See X3D spec about profiles. Every X3D file must always define a profile. (However, we use this class also for VRML 1.0 and 2.0 root nodes, where profile is empty.) Relevant only if this node is the root of X3D file.

Components and levels required for this X3D file. Relevant if this node is the root of X3D file.

Meta keys and values of this X3D file. Relevant if this node is the root of X3D file.

Global prototype namespace at the end of parsing the file. Useful for things like EXTERNPROTO implementation.

Node names exported from the file by EXPORT keyword. Useful for importing them later, to handle IMPORT/EXPORT X3D mechanism.

Node names imported into this file by the IMPORT keyword. You may want to take this into account when searching nodes by name, this allows the user to rename nodes from Inlined files.

Scale of the model. When loading, this is set to honor "UNIT length ..." declaration in X3D 3.3. It scales model such that 1 unit = 1 meter. When one model is inlined inside another (e.g. using X3D Inline node), this is adjusted to the existing scale of the outer model (always to make the resulting complete node graph keep the assumption 1 unit = 1 meter).