There are cases when an application needs to update the metadata of an image file while leaving its pixel data unchanged. For example, if the image is compressed using a Lossy compression scheme, this avoids degradation of image quality.

Use ImGearFileFormats.LoadPageMetadata or ImGearFileFormats.LoadDocumentMetadata methods to load metadata from a document or an individual page.

Use regular Metadata API to edit the values in the loaded metadata tree.

Use ImGearFileFormats.UpdatePageMetadata or ImGearFileFormats.UpdateDocumentMetadata methods to save the new metadata to an image file without changing its pixel data.

ImGearFileFormats.UpdatePageMetadata and ImGearFileFormats.UpdateDocumentMetadata are not supported for some formats. Please refer to the file format reference guide to see if the metadata update is supported for a given format.

ImGearFileFormats.UpdatePageMetadata and ImGearFileFormats.UpdateDocumentMetadata methods are not supported for DICOM vector waveform files.