Purpose

This node represents a subgraph that was read from a named input file. When an SoFile node is written out, just the field containing the name of the file is written; no children are written out. When an SoFile is encountered during reading, reading continues from the named file, and all nodes read from the file are added as hidden children of the file node.

Whenever the name field changes, any existing children are removed and the contents of the new file is read in. The file node remembers what directory the last file was read from and will read 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>

Name of file from which to read children.