This function obtains a new copy of a specified LUT from either presentation state HIGEAR (hIGearPresState), or the image HIGEAR (hIGear).
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI MED_DCM_DS_LUT_copy_get(
HIGEAR hIGear,
HIGEAR hIGearPresstate,
AT_DCM_TAG lutSqTag,
HIGLUT* lpLUT
);
|
|
Arguments:
| Name | Type | Description |
| hIGear | HIGEAR | Image whose dataset is checked for presence of the LUT. |
| hIGearPresstate | HIGEAR | Presentation state HIGEAR whose dataset is checked for presence of the LUT. Set to NULL if no presentation state HIGEAR is available. |
| lutSqTag | AT_DCM_TAG | Specifies the LUT sequence. |
| lpLUT | HIGLUT* | Returns new HIGLUT object with the LUT obtained from a DataSet. |
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:
If the LUT exists in both the Presentation state HIGEAR, and in the image HIGEAR, the function returns the LUT from Presentation State HIGEAR.
Use IG_LUT_destroy() to destroy the LUT returned from this function when it is no longer needed.
This function supports the following LUT sequences:
- DCM_TAG_ModalityLUTSequence
- DCM_TAG_VOILUTSequence
- DCM_TAG_PresentationLUTSequence