ImageGear Professional DLL v17.1 for Windows Accusoft
MED_DCM_DS_update_file
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Functions > MED_DCM_DS_update_file

Glossary Item Box

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:

hIGear HIGEAR handle containing metadata to be saved to result file.
lpszFileNameSrc Source file name.
lpszFileNameDst 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:

©2012. Accusoft Corporation. All Rights Reserved.