E57 Foundation API v1.1.312
Aug. 10, 2011
|
Create a new empty Vector node.
A VectorNode is a ordered container of E57 nodes. The destImageFile indicates which ImageFile the VectorNode will eventually be attached to. A node is attached to an ImageFile by adding it underneath the predefined root of the ImageFile (gotten from ImageFile::root). It is not an error to fail to attach the VectorNode to the destImageFile. It is an error to attempt to attach the VectorNode to a different ImageFile. If allowHeteroChildren is false, then the children that are appended to the VectorNode must be identical in every visible characteristic except the stored values. These visible characteristics include number of children (for StructureNode and VectorNode descendents), number of records/prototypes/codecs (for CompressedVectorNode), minimum/maximum attributes (for IntegerNode, ScaledIntegerNode, FloatNode), byteCount (for BlobNode), scale/offset (for ScaledIntegerNode), and all elementNames. The enforcement of this homogeneity rule begins when the second child is appended to the VectorNode, thus it is not an error to modify a child of a homogeneous VectorNode containing only one child. If allowHeteroChildren is true, then the types of the children of the VectorNode are completely unconstrained.
|