PresentationStateToCurrent(Matrix,PresentationStateFeatures) Method

In This Topic

Modifies current display properties to match the DICOM presentation state.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Sub PresentationStateToCurrent( _
   ByVal Matrix As System.Drawing.Drawing2D.Matrix, _
   ByVal Features As PresentationStateFeatures _
)

public void PresentationStateToCurrent( 
   System.Drawing.Drawing2D.Matrix Matrix,
   PresentationStateFeatures Features
)

Parameters

Matrix: A matrix defining how the image is to be displayed.
Features: Controls which properties are updated from the presentation state.

Remarks

This is essentially the reverse of CurrentToPresentationState. DicomObjects. properties such as Scroll, Zoom and Labels are set to reflect as accurately as possible the data in the current PresentationState property. If private attributes have been added by CurrentToPresentationState, then they are utilized in this method.

The Matrix is used to determine the scroll values.

Properties which are not updated from the presentation state continue to use the presentation state itself, as the PresentationStateFeaturesUsed property is updated to unset only the bits in the Features parameter

Example

DicomImage image = new DicomImage("your_dicom_image.dcm");
image.PresentationState = new DicomDataSet("presentation_state_dataset.dcm);      
                    
Matrix imageMatrix = image.Matrix(image.Size);
PresentationStateFeatures all = PresentationStateFeatures.All;
PresentationStateFeatures mLUT = PresentationStateFeatures.ModalityTransform;
                    
image.PresentationStateToCurrent(imageMatrix, all); // Example 1
image.PresentationStateToCurrent(imageMatrix, mLUT); // Example 2

Requirements

Target Platforms: .NET CLR 4.8 or higher

Reference

DicomImage Class
DicomImage Members
Overload List

Send Feedback