DicomObjects Reference
DicomObjects Reference / DicomImage Object / CurrentToPresentationState Method
Controls whether additional private elements are included
CurrentToPresentationState Method
Description
Takes all current display information and creates a corresponding DICOM presentation state
Syntax
Visual Basic
Public Sub CurrentToPresentationState( _
   ByVal usePrivate As Boolean _
) 
Parameters
usePrivate
Controls whether additional private elements are included
Remarks

The presentation state created is immediately used as the image’s PresentationState property, so after this call, the display should not be visibly altered,  though small changes may be seen due to the reduced flexibility of colours etc. in DICOM presentation states compared with DicomObjects' DicomLabel objects.
The properties encapsulated into the presentation state include:

There are several properties of DicomLabel objects which do not have official DICOM equivalents, such as font details, RotationMode and RotationCentre.  If usePrivate is true, then private attribute in the range 6E15,7Axx are added to the presentation state to store them, but if usePrivate is false, then these properties must be discarded.

This method does have some limitations, and the following objects/properties are not currently converted:

  • Some label types – arrows, rulers, arcs and “special” labels
  • Mask subtraction information
  • ModalityLUT, VOILUT and PresentationLUT properties
  • ColourTable

These issues will be addressed in a future version of DicomObjects

See Also