ImageGear for C and C++ on Windows v19.1 - Updated
MED_DCM_DS_LUT_copy_get
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Data Set Functions > MED_DCM_DS_LUT_copy_get

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: