A Presentation State is an independent DICOM SOP Instance that contains information on how a particular image should be displayed. The Presentation State may contain label information(types of Label and Positions), windowing values, zoom value, scrolling (panning) values, rotations or any other visual display element that is defined within the DICOM standard.
However Presentation States contain no Pixel Data as they are intended for use with an existing Dicom Image. A presentation state can be applied to an image so that the image is displayed with all the visual specifications defined by that presentation state. The advantage of using presentation states is that you can always revert back to the original image as the underlying pixel data is not modified but rather displayed differently. Presentation states can be sent to a PACS (Provided the PACS supports the Presentations state SOP classes) and retrieved when required.
DicomObjects fully supports presentation states. DicomObjects can be used to create Presentations states from scratch or to apply an existing presentation states to an image. After all the necessary display changes have been made to an image you can create a Presentation state.
To save Presentation State after display changes have been made to the image.
dicomViewer1.CurrentImage.CurrentToPresentationState(dicomViewer1, true); dicomViewer1.CurrentImage.PresentationState.Write(@"C:\MyPS.dcm", TransferSyntaxes.ExplicitVRLittleEndian);
Dicomviewer1.CurrentImage.CurrentToPresentationState True PImage.PresentationState.WriteFile "c:\MyPS.dcm", True, "1.2.840.10008.1.2.1"
The presentation state can then be used in conjunction with the original image as and when required. If so desired the presentation state could be sent to a server using the Send method for retrieval at a later time.
And to apply an existing Presentation State to an Image with DicomObjects:
DicomDataSet ps = new DicomDataSet(@"C:\MyPS.dcm"); dicomViewer1.CurrentImage.PresentationState = ps;
Dim g As New DicomGlobal Dim ps As New DicomDataSet ' The Presentation State does not have to be read from disk ' it could be retrieved from a server. Set ps = g.ReadFile("c:\MyPS.dcm") DicomViewer1.CurrentImage.PresentationState = ps
Normally, a Presentation State completely controls the display of an image, so PresentationStateToCurrent is required if you wish to modify display settings after a presentation state is applied to the DicomImage. This modifies all the current properties of the image and its labels collection to match those of the presentation state, then sets the actual PresentationState to null, allowing changes to be made.
An example showing how to use Presentation States with DicomObjects is available on request from Medical Connections.
According to the following table taken from the part 3 of DICOM Standard, one Presentation State can be applied to more than one images in the Series.
Following sample C# code demonstrates how to make a Presentation State which can apply to 2 different images. Slight modification will be required if using COM version of DicomObjects.
DicomDataSet PSObject; DicomImage Image1 = new DicomImage(); DicomImage Image2 = new DicomImage(); Image1.CurrentToPresentationState(Image1.Size, true); //Create Presentation State Object PSObject = Image1.PresentationState; DicomDataSetCollection Referenced_Series_Sequence; DicomDataSetCollection Referenced_Image_Sequence; DicomDataSet Referenced_Series_Sequence_Item; DicomDataSet Referenced_Image_Sequence_Item = new DicomDataSet(); //Find existing series sequence to add new item to PSObject = Image1.PresentationState; Referenced_Series_Sequence = PSObject[Keyword.ReferencedSeriesSequence].Value as DicomDataSetCollection; Referenced_Series_Sequence_Item = Referenced_Series_Sequence; Referenced_Image_Sequence = Referenced_Series_Sequence_Item[Keyword.ReferencedImageSequence].Value as DicomDataSetCollection; // Create new item for new image to add to that sequence Referenced_Image_Sequence_Item.Add(Keyword.ReferencedSOPClassUID, Image2.SOPClass); Referenced_Image_Sequence_Item.Add(Keyword.ReferencedSOPInstanceUID, Image2.InstanceUID); // Add the new dataset to the sequence Referenced_Image_Sequence.Add(Referenced_Image_Sequence_Item); // Save Presentation State to File PSObject.Write(@"c:\PS1", "1.2.840.10008.1.2.1");
To apply Presentation States to Multiple Series in the Study, just add one or more new Series into the “Referenced Series Sequence (0008, 1115)”, with each of the new Series containing its own list of instances in the “Referenced Image Sequence (0008, 1140)”.