checkInvariant childCount destImageFile dump elementName get get isAttached isDefined isRoot operator Node parent pathName set StructureNode StructureNode

ustring pathName ( ) const Get absolute pathname of node. Nodes are organized into trees (acyclic graphs) by a parent-child relationship between nodes. Each parent-child relationship has an associated elementName string that is unique for a given parent. Any node in a given tree can be identified by a sequence of elementNames of how to get to the node from the root of the tree. An absolute pathname string that is formed by arranging this sequence of elementNames separated by the "/" character with a leading "/" prepended. Some example absolute pathNames: "/data3D/0/points/153/cartesianX", "/data3D/0/points", "/cameraImages/1/pose/rotation/w", and "/". These examples have probably been attached to an ImageFile. Here is an example absolute pathName of a node in a pose tree that has not yet been attached to an ImageFile: "/pose/rotation/w". A technical aside: the elementName of a root node does not appear in absolute pathnames, since the "path" is between the staring node (the root) and the ending node. By convention, in this API, a root node has the empty string ("") as its elementName. Precondition: The destination ImageFile must be open (i.e. destImageFile().isOpen()). Postcondition: No visible state is modified. Returns: The absolute path name of the node. Exceptions: E57_ERROR_IMAGEFILE_NOT_OPEN E57_ERROR_INTERNAL All objects in undocumented state See also: NodeFunctions.cpp example, Node::elementName, Node::parent, Node::isRoot