Javadoc
Copies the metadata, and only the metadata linked to a Image
object into a new Image object of equal or differing size across one
or many of its three physical dimensions or temporal dimension.
It is beyond the scope of this method to handle updates or changes to
the raw pixel data available through
RawPixelsStore or to add
and link
PlaneInfo and/or other Pixels set specific metadata.
It is also assumed that the caller wishes the pixels dimensions and
PixelsType to remain the same;
changing these is outside the scope of this method. NOTE: As
Channel objects are only able to apply to a single set of
Pixels any annotations or linkage to these objects will be lost.