Parameters
- sourceStream
- The data stream, containing source image.
- destinationStream
- The data stream to which to write result image.
- metadata
- Metadata to be saved to result file.
This method creates a new file with an exact copy of the source file's pixel data and with new metadata. Pixel data is not decoded but copied directly from source to destination file.
This method can be used for updating metadata in an image file without modifying the pixel data. To achieve this, delete the source file after calling this method, and rename result file to the source file name.
Tags that affect decoding of pixel data are transferred from the source file, and not replaced with tags from metadata.
Currently, the method only supports metadata updating in the DICOM file format.