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:

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