Purpose

The node SoFile represents a subgraph read from a named input file. When a SoFile node is written out, only the field containing the name of the file is included; no children are written. When a SoFile node is encountered during reading, the process continues from the named file, and all nodes read from the file are added as hidden children of the file node.

Whenever the Filename field changes, any existing children are removed, and the contents of the new file are read in. The file node remembers the directory from which the last file was read and will load the new file from the same directory after checking the standard list of directories, assuming the field is not set to an absolute path name.

Output Fields

self

name: self, type: SoNode

Parameter Fields

Visible Fields

Filename

name: name, type: String, default: <Undefined file>

Sets the name of the file from which to read children.