ImageGear for C and C++ on Windows v19.4 - Updated
MED_PS_apply
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Presentation State Functions > MED_PS_apply

This function extracts PS data from DICOM DataSet of hIGearPresState, and adjusts display of hIGear based on this data.

Declaration:

 
Copy Code
AT_ERRCOUNT ACCUAPI MED_PS_apply (
        HIGEAR hIGear, 
        HIGEAR hIGearPresState, 
        DWORD dwFeatureFlags, 
        DWORD dwGrpID, 
        LPAT_MED_LUT_DESC lpGSDFLUT 
);

Arguments:

Name Type Description
hIGear HIGEAR Image to which Pres State shall be applied.
hIGearPresState HIGEAR Image containing Presentation State DataSet.
dwFeatureFlags DWORD Tells which features of PS to use - bit mask.
dwGrpID DWORD Display Group ID.
lpGSDFLUT LPAT_MED_LUT_DESC GSDF LUT info.

Return Value:

Returns the number of ImageGear errors that occurred during the function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

hIGearPresState must have a DICOM DataSet attached to it. Use MED_DCM_DS_exists to check whether the image contains a DataSet.

Remarks:

This function may result in the following:

If there are no VOI or Modality LUT in the hIGearPresState, the function tries to find them in the DataSet of hIGear. If there are no such LUTs in hIGear, default values are taken.

If MED_PS_FEATURE_PRES_LUT option is specified, the function assumes that MED_PS_FEATURE_CONTRAST is selected as well.