ImageGear for C and C++ on Windows v19.1 - Updated
MED_PS_pres_state_GSDF_apply
API Reference Guide > MD Component API Reference > MD Component Functions Reference > Presentation State Functions > MED_PS_pres_state_GSDF_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_pres_state_GSDF_apply( 
        HIGEAR hIGear,
        HIGEAR hIGearPresState,
        DWORD dwFeatureFlags,
        DWORD dwGrpID,
        HIGLUT GSDFLUT 
);

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.
GSDFLUT HIGLUT GSDF LUT.

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 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.

This function replaces MED_PS_apply(). It provides the same functionality as MED_PS_apply(), but uses a more general type HIGLUT for GSDFLUT parameter.