This function adds Presentation State tags to the DataSet of hIGearPresState, based on the display settings of hIGear, an ART marks attached to it.
Declaration:
 Copy Code |
|
|---|---|
AT_ERRCOUNT ACCUAPI MED_PS_extract (
HIGEAR hIGear,
HIGEAR hIGearPresState,
DWORD dwFeatureFlags,
DWORD dwGrpID
);
|
|
Arguments:
| Name | Type | Description |
| hIGear | HIGEAR | Image whose settings should be exported to PS. |
| hIGearPresState | HIGEAR | Image that will contain Presentation State DataSet. |
| dwFeatureFlags | DWORD | Tells which features of PS to export - bit mask. |
| dwGrpID | DWORD | Display Group ID. |
Return Value:
Returns the number of ImageGear errors that occurred during the function call.
Supported Raster Image Formats:
All pixel formats supported by ImageGear Professional.
Remarks:
If any of the tags are already present in the hIGearPresState, they are overwritten.
This function may add/update the following tags/sequences in the hIGearPresState:
- DCM_TAG_DisplayedAreaSelectionSequence
- DCM_TAG_GraphicAnnotationSequence
- DCM_TAG_GraphicLayerSequence
- DCM_TAG_ImageHorizontalFlip
- DCM_TAG_ImageRotation
To create a new presentation state DataSet, use the following steps:
- Call IG_image_create_DIB_ex() with lCompression set to IG_BI_EMPTY.
- Call MED_PS_extract() to add Presentation State tags.
- Add the other tags required by the Presentation State module using general DataSet access functions.
- Save Presentation State to file using IG_fltr_save_file() or similar functions.
To modify an existing Presentation State DataSet, use the following steps:
- Load a Presentation State DataSet using IG_fltr_load_file() or similar functions.
- Apply the Presentation State to a DICOM image, using MED_PS_apply().
- Change display settings or ART marks.
- Extract Presentation Data from DICOM image back to Presentation State DataSet.
- Save Presentation State to file using IG_fltr_save_file() or similar functions.
Use MED_PS_pres_LUT_set() to add Presentation LUT to the Presentation State HIGEAR.
Use general DataSet functions to add VOI and Modality LUT to the Presentation State HIGEAR.
Use ImageGear image saving functions (nFormat=IG_FORMAT_DCM) to save lphIGearPresState into a presentation state file (.pre).