jpx_metanode::get_existing

Provides the location of the box associated with this node. For intermediate nodes, this is the first sub-box of the association box, whose type is returned via get_box_type. The location of the association box itself will not be returned by any member function here.

For the root node, and for intermediate nodes which are created to represent metadata contained within codestream header and compositing layer header boxes, this function returns a null locator (one whose jp2_locator::is_null function returns true).

The function also returns a null locator if the present node has been created using one of the add_... interfaces, rather than by parsing an input JPX data source.

src [jp2_family_src * &]