Has node been attached into the tree of an ImageFile.
Nodes are attached into an ImageFile tree by inserting them as children (directly or indirectly) of the ImageFile's root node. Nodes can also be attached to an ImageFile if they are used in the codecs
or prototype
trees of an CompressedVectorNode that is attached. Attached nodes will be saved to disk when the ImageFile is closed, and restored when the ImageFile is read back in from disk. Unattached nodes will not be saved to disk. It is not recommended to create nodes that are not eventually attached to the ImageFile.
- Precondition:
- The destination ImageFile must be open (i.e. destImageFile().isOpen()).
- Postcondition:
- No visible object state is modified.
- Returns:
true
if node is child of (or in codecs or prototype of a child CompressedVectorNode of) the root node of an ImageFile.
- Exceptions:
-
- See also:
- NodeFunctions.cpp example, Node::destImageFile, ImageFile::root