MED_PS_pres_state_GSDF

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:

Adjust Display LUT associated with the image, using
- VOI and Modality LUTs found in the presentation state DataSet
- Presentation LUT found in the presentation state DataSet
- GSDF LUT parameter
Change display layout, including image rectangle, zoom and orientation
Add ART objects

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.