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