Working with Presentation State Objects

You can load Presentation State files in the same way as you load normal DICOM images. However, since such files do not contain an image, IGPage Object will be set to an empty image (DIB.biCompression |= IG_BI_EMPTY). The Data Set of such an image is accessible through Medical API. Such images can also be saved in the same way as normal DICOM images, resulting in a DICOM file containing only DataSet and no image.

An IGMedPage Object containing a Presentation State DataSet can be "applied" to another IGMedPage Object that contains an image. This operation applies display and annotation settings from Presentation state onto the target image. In the opposite way, display settings and annotations can be exported from an image into another IGMedPage Object.

When you apply Presentation State to an image, ImageGear updates its 16x8 or 8x8 LUT using the Presentation LUT. However, it does not store the Presentation LUT with that image. To work with Presentation LUT, allocate memory for it in your application. Pass Presentation LUT as a parameter to medical display functions. You can also save Presentation LUT to a Presentation State data set.

If a Characteristic Curve is available for a display, you can build a GSDF LUT from it, and use it in calls to medical Presentation State and Display functions. Otherwise, pass NULL to the GSDF LUT parameter.