PreparePresStateMetadata Method

public static ImGearMetadataHead PreparePresStateMetadata( 
   ImGearRasterPage page,
   IImGearPageDisplay pageDisplay,
   ImGearMetadataHead userMetadata,
   ImGearPresStateOptions options
)

public: static ImGearMetadataHead* PreparePresStateMetadata( 
   ImGearRasterPage* page,
   IImGearPageDisplay* pageDisplay,
   ImGearMetadataHead* userMetadata,
   ImGearPresStateOptions options
)

public:
static ImGearMetadataHead^ PreparePresStateMetadata( 
   ImGearRasterPage^ page,
   IImGearPageDisplay^ pageDisplay,
   ImGearMetadataHead^ userMetadata,
   ImGearPresStateOptions options
)

'Declaration
 
Public Shared Function PreparePresStateMetadata( _
   ByVal page As ImGearRasterPage, _
   ByVal pageDisplay As IImGearPageDisplay, _
   ByVal userMetadata As ImGearMetadataHead, _
   ByVal options As ImGearPresStateOptions _
) As ImGearMetadataHead

'Usage
 
Dim page As ImGearRasterPage
Dim pageDisplay As IImGearPageDisplay
Dim userMetadata As ImGearMetadataHead
Dim options As ImGearPresStateOptions
Dim value As ImGearMetadataHead
 
value = ImGearDICOM.PreparePresStateMetadata(page, pageDisplay, userMetadata, options)

Parameters

page: Page from which presentation state settings shall be extracted.
pageDisplay: PageDisplay from which presentation state settings shall be extracted.
userMetadata: User supplied metadata.
options: Options structure telling which settings shall be extracted to the presentation state metadata.

Return Value

New instance of ImageGear.Core.ImGearMetadataTree class object, containing presentation state metadata.

This method prepares metadata for a presentation state object, based on page's DICOMDisplaySettings member, on pageDisplay settings, and on annotations that are attached to image, if any.

After that presentation state metadata has been prepared, application may add or edit it, and then save as presentation state object using SavePresState method.

The following features of the ImGearDICOMDisplaySettings class are saved to presentation state metadata:

VOI LUT
Modality LUT
Presentation LUT

The following settings of pageDisplay are saved to presentation state metadata:

Orientation
Image rectangle

The following annotations are saved to saved to presentation state metadata: Text, Callout, Polygon, Polyline, Point, Curve, Ellipse.

This method takes user metadata as a parameter. If this parameter is not null and contains a DICOM metadata tree, the method will use it as a base for building output metadata.

C#

ImGearRasterPage rasterPage = (ImGearRasterPage)igPage;
ImGearPresStateOptions opt = new ImGearPresStateOptions();
ImGearMetadataHead prepPresStateMetadata =
    ImGearDICOM.PreparePresStateMetadata(
        rasterPage, igPageView.Display, presStateOrigMetadata, opt);

Visual Basic

Dim rasterPage As ImGearRasterPage = igPage
Dim opt As ImGearPresStateOptions = New ImGearPresStateOptions()
Dim prepPresStateMetadata As ImGearMetadataHead = ImGearDICOM.PreparePresStateMetadata(rasterPage, igPageView.Display, presStateOrigMetadata, opt)

Reference

ImGearDICOM Class
ImGearDICOM Members
ImGearRasterPage Class
ImGearMetadataHead Class
ImGearPresStateOptions Structure
ImGearPageDisplay Class
ImGearMetadataTree Class