ImageGear Professional for Linux
MED_DCM_DS_update_file
| ImageGear Professional > 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.
|
Copy Code
|
|
|---|---|
AT_ERRCOUNT ACCUAPI MED_DCM_DS_update_file (
HIGEAR hIGear,
const LPSTR lpszFileNameSrc,
const LPSTR lpszFileNameDst
);
|
|
| 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. |
Returns the number of ImageGear errors that occurred during the function call.
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. |
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: