jp2_input_box::transplant

This function may be called only if the src object represents an open box, and the present object does not currently represent an open box. It opens the present object so as to present the same state and read position as the src object. The only difference between the present object's new state and the old src object's new state is that the present object will not retain any connection with a containing super-box. The src object is then closed.

The function sees a lot of use in the implementation of the jpx_source object and its offspring.

src [jp2_input_box &]