jpx_metanode::add_copy

Use this function to add a descendant to the present node, assigning the descendant to represent a box whose type and contents are obtained by copying those of the src object.

Note carefully that src may be an interface to a different metadata tree. Its contents might not be explicitly copied here; we might only preserve references. As a result, you must make sure that the underlying jp2_family_src object, from which the contents of src might have been read, remains open until after the present box has been written using jpx_target::write_metadata. However, it is safe to invoke jpx_metanode::delete on the src object after it has been copied. This operation can be particularly useful during editing operations.

src [jpx_metanode]

recursive [bool]