Copies the metadata, and
only the metadata linked to
a Pixels object into a new Pixels 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.