ImageGear for C and C++ on Windows v19.4 - Updated
MED_DCM_DS_update_file
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Functions > MED_DCM_DS_update_file

This function creates a new file with an exact copy of the source file's pixel data and with new metadata (File Meta Information header and DataSet) taken from HIGEAR image handle.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_DCM_DS_update_file (
        HIGEAR hIGear, 
                const LPSTR lpszFileNameSrc,
        const LPSTR lpszFileNameDst
);

Arguments:

Name Type Description
hIGear HIGEAR HIGEAR handle containing metadata to be saved to result file.
lpszFileNameSrc const LPSTR Source file name.
lpszFileNameDst const LPSTR Result file name.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

This function does not process image pixels.

The image must have a DICOM DataSet attached to it. Use MED_DCM_DS_exists to check whether the image contains a DataSet.

Remarks:

Pixel data is not decoded, but copied directly from source to destination file.

This function 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 function, and rename the result file to the source file name.

The function does not change the tags that affect decoding of pixel data.

The function takes into account the following DICOM filter control parameters: