This function creates a Data Set.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI MED_DCM_DS_create(
HIGEAR hIGear,
const AT_MODE Transfer_syntax);
|
|
Arguments:
| hIGear | HIGEAR handle to the image. |
| Transfer_syntax | Set this variable to the desired Transfer Syntax (TS) with which to create the Data Set. Use one of the ImageGear defined constants defined in enumIGMedTS, such as: MED_DCM_TS_IMPLICIT_VR_LE, MED_DCM_TS_EXPLICIT_VR_LE, MED_DCM_TS_EXPLICIT_VR_BE. |
Return Value:
Returns the number of ImageGear errors that occurred during the function call.
Supported Raster Image Formats:
All pixel formats supported by ImageGear Professional.
 |
The image must have a DICOM DataSet attached to it. Use MED_DCM_DS_exists to check whether the image contains a DataSet. |
Example:
| Copy Code |
|
|---|---|
HIGEAR hIGear;
AT_MODE Transfer_syntax;
IG_load_file("image1.tif", &hIGear);
Transfer_syntax = MED_DCM_TS_IMPLICIT_VR_LE;
MED_DCM_DS_create(hIGear, Transfer_syntax);
|
|
Remarks:
If there is already a Data Set that is associated with the HIGEAR image, it will be replaced. In addition, the absolute minimum of Critical DEs (Data Elements), such as Pixel Representation and Samples per Pixel will be automatically added to the Data Set.
Below is a list of those Mandatory DEs that will be filled out automatically by this function. See Part 6:Data Dictionary of the DICOM Specification for the definitions of these DEs.
Note that there are two different Group Numbers listed below, and that the Tag numbers (the second numbers shown in the parentheses) identify which Data Element will be filled in:
| Copy Code |
|
|---|---|
Affected DEs from Tag.group = 0x0028:
(0028,0010) /* Rows */
(0028,0011) /* Columns */
(0028,0100) /* Bits Allocated */
(0028,0101) /* Bits Stored */
(0028,0102) /* High Bit */
(0028,0004) /* Photometric Interpretation */
(0028,0103) /* Pixel Representation */
(0028,0002) /* Samples per pixel */
(0028,0006) /* Planar Configuration */
Affected DEs from Tag.group = 0x7FE0;
(7FE0,0010) /* Pixel Data */
|
|
See Working With DICOM Data Structures section for more information.