DICOM: Просмотр DICOM-изображений в WinForms
В этом разделе
VintaSoft DICOM .NET Plug-in содержит WinForms UI-контрол
DicomSeriesManagerControl, который позволяет отображать информацию о DICOM-сериях, сгруппированных по пациентам и исследованиям, осуществлять навигацию по DICOM-сериям, асинхронно добавлять DICOM-файлы.
Также VintaSoft DICOM .NET Plug-in содержит 2 визуальных инструмента для DICOM-изображений в WinForms просмотрщике изображений:
DicomViewerTool,
EcgVisualTool.
DicomSeriesManagerControl UI-контрол
DicomSeriesManagerControl позволяет:
Вот скриншот UI-контрола DicomSeriesManagerControl в демо приложении "VintaSoft DICOM Viewer Demo":
Класс DicomViewerTool
Класс
DicomViewerTool позволяет масштабировать DICOM-кадры и выполнять навигацию по DICOM-кадрам в WinForms просмотрщике изображений. Также инструмент позволяет применять VOI LUT к DICOM-кадру в WinForms просмотрщике изображений. Также инструмент позволяет отображать метаданные DICOM-кадра в WinForms просмотрщике изображений.
Вот C#/VB.NET код, демонстрирующий, как просматривать DICOM-изображение и отображать метаданные DICOM-изображения в WinForms просмотрщике изображений:
/// <summary>
/// A visual tool that allows to show name and age of patient.
/// </summary>
public class CustomDicomViewerTool : Vintasoft.Imaging.Dicom.UI.VisualTools.DicomViewerTool
{
/// <summary>
/// Initializes a new instance of the <see cref="CustomDicomViewerTool"/> class.
/// </summary>
public CustomDicomViewerTool()
: this(true)
{
}
/// <summary>
/// Initializes a new instance of the <see cref="CustomDicomViewerTool" /> class.
/// </summary>
/// <param name="needUpdateViewerAfterApplyingVoiLut">
/// Determines that the image viewer must be updated after applying VOI lookup table to a DICOM image.
/// </param>
public CustomDicomViewerTool(bool needUpdateViewerAfterApplyingVoiLut)
: base(needUpdateViewerAfterApplyingVoiLut)
{
// clear the default text overlay
TextOverlay.Clear();
// create text overlay of VOI LUT
Vintasoft.Imaging.Dicom.UI.VisualTools.DicomImageVoiLutTextOverlay voiLutTextOverlay =
new Vintasoft.Imaging.Dicom.UI.VisualTools.DicomImageVoiLutTextOverlay();
// set the anchor of text
voiLutTextOverlay.Anchor = Vintasoft.Imaging.AnchorType.Left | Vintasoft.Imaging.AnchorType.Bottom;
// add text overlay to visual tool
TextOverlay.Add(voiLutTextOverlay);
// the text anchor
Vintasoft.Imaging.AnchorType textAnchor =
Vintasoft.Imaging.AnchorType.Bottom | Vintasoft.Imaging.AnchorType.Right;
// the text color
System.Drawing.Brush textBrush = System.Drawing.Brushes.Blue;
// create text overlay
Vintasoft.Imaging.Dicom.UI.VisualTools.StandardDicomDataElementTextOverlay patientNameTextOverlay =
new Vintasoft.Imaging.Dicom.UI.VisualTools.StandardDicomDataElementTextOverlay(
Vintasoft.Imaging.Codecs.ImageFiles.Dicom.DicomDataElementId.PatientName);
// set the anchor of text
patientNameTextOverlay.Anchor = textAnchor;
// set the color of text
patientNameTextOverlay.TextBrush = textBrush;
// set text format of text
patientNameTextOverlay.TextFormat = "Name: {0}";
// add text overlay to visual tool
TextOverlay.Add(patientNameTextOverlay);
// create text overlay
Vintasoft.Imaging.Dicom.UI.VisualTools.StandardDicomDataElementTextOverlay patientAgeTextOverlay =
new Vintasoft.Imaging.Dicom.UI.VisualTools.StandardDicomDataElementTextOverlay(
Vintasoft.Imaging.Codecs.ImageFiles.Dicom.DicomDataElementId.PatientAge);
// set the anchor of text
patientAgeTextOverlay.Anchor = textAnchor;
// set the color of text
patientAgeTextOverlay.TextBrush = textBrush;
// set text format of text
patientAgeTextOverlay.TextFormat = "Age: {0}";
// add text overlay to he visual tool
TextOverlay.Add(patientAgeTextOverlay);
}
}
''' <summary>
''' A visual tool that allows to show name and age of patient.
''' </summary>
Public Class CustomDicomViewerTool
Inherits Vintasoft.Imaging.Dicom.UI.VisualTools.DicomViewerTool
''' <summary>
''' Initializes a new instance of the <see cref="CustomDicomViewerTool"/> class.
''' </summary>
Public Sub New()
Me.New(True)
End Sub
''' <summary>
''' Initializes a new instance of the <see cref="CustomDicomViewerTool" /> class.
''' </summary>
''' <param name="needUpdateViewerAfterApplyingVoiLut">
''' Determines that the image viewer must be updated after applying VOI lookup table to a DICOM image.
''' </param>
Public Sub New(needUpdateViewerAfterApplyingVoiLut As Boolean)
MyBase.New(needUpdateViewerAfterApplyingVoiLut)
' clear the default text overlay
TextOverlay.Clear()
' create text overlay of VOI LUT
Dim voiLutTextOverlay As New Vintasoft.Imaging.Dicom.UI.VisualTools.DicomImageVoiLutTextOverlay()
' set the anchor of text
voiLutTextOverlay.Anchor = Vintasoft.Imaging.AnchorType.Left Or Vintasoft.Imaging.AnchorType.Bottom
' add text overlay to visual tool
TextOverlay.Add(voiLutTextOverlay)
' the text anchor
Dim textAnchor As Vintasoft.Imaging.AnchorType = Vintasoft.Imaging.AnchorType.Bottom Or Vintasoft.Imaging.AnchorType.Right
' the text color
Dim textBrush As System.Drawing.Brush = System.Drawing.Brushes.Blue
' create text overlay
Dim patientNameTextOverlay As New Vintasoft.Imaging.Dicom.UI.VisualTools.StandardDicomDataElementTextOverlay(Vintasoft.Imaging.Codecs.ImageFiles.Dicom.DicomDataElementId.PatientName)
' set the anchor of text
patientNameTextOverlay.Anchor = textAnchor
' set the color of text
patientNameTextOverlay.TextBrush = textBrush
' set text format of text
patientNameTextOverlay.TextFormat = "Name: {0}"
' add text overlay to visual tool
TextOverlay.Add(patientNameTextOverlay)
' create text overlay
Dim patientAgeTextOverlay As New Vintasoft.Imaging.Dicom.UI.VisualTools.StandardDicomDataElementTextOverlay(Vintasoft.Imaging.Codecs.ImageFiles.Dicom.DicomDataElementId.PatientAge)
' set the anchor of text
patientAgeTextOverlay.Anchor = textAnchor
' set the color of text
patientAgeTextOverlay.TextBrush = textBrush
' set text format of text
patientAgeTextOverlay.TextFormat = "Age: {0}"
' add text overlay to he visual tool
TextOverlay.Add(patientAgeTextOverlay)
End Sub
End Class
Класс EcgVisualTool
Класс
EcgVisualTool позволяет измерять электрокардиограмму в просмотрщике изображений.
Вот C#/VB.NET код, демонстрирующий, как отобразить информацию о выделении в визуальном инструменте электрокардиограммы:
/// <summary>
/// Helps to display information about selection in <see cref="Vintasoft.Imaging.Dicom.UI.VisualTools.EcgVisualTool"/>.
/// </summary>
public class EcgVisualToolHelper : System.IDisposable
{
#region Fields
/// <summary>
/// The image viewer.
/// </summary>
Vintasoft.Imaging.UI.ImageViewer _viewer;
/// <summary>
/// The label.
/// </summary>
System.Windows.Forms.Label _label;
#endregion
#region Constructors
/// <summary>
/// Initializes a new instance of the <see cref="EcgVisualToolHelper"/> class.
/// </summary>
/// <param name="viewer">The image viewer.</param>
/// <param name="label">The label.</param>
public EcgVisualToolHelper(Vintasoft.Imaging.UI.ImageViewer viewer, System.Windows.Forms.Label label)
{
_viewer = viewer;
_label = label;
// create visual tool
Vintasoft.Imaging.Dicom.UI.VisualTools.EcgVisualTool visualTool = new Vintasoft.Imaging.Dicom.UI.VisualTools.EcgVisualTool();
visualTool.SelectionChanged += EcgVisualTool_SelectionChanged;
// set the visual tool
_viewer.VisualTool = visualTool;
}
#endregion
#region Methods
/// <summary>
/// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
/// </summary>
public void Dispose()
{
if (_viewer.VisualTool is Vintasoft.Imaging.Dicom.UI.VisualTools.EcgVisualTool)
_viewer.VisualTool = null;
}
/// <summary>
/// Handles the SelectionChanged event of the EcgVisualTool control.
/// </summary>
/// <param name="sender">The source of the event.</param>
/// <param name="e">The <see cref="Vintasoft.Imaging.PropertyChangedEventArgs{Vintasoft.Primitives.VintasoftRect}"/> instance containing the event data.</param>
private void EcgVisualTool_SelectionChanged(object sender, Vintasoft.Imaging.PropertyChangedEventArgs<Vintasoft.Primitives.VintasoftRect> e)
{
// if value is specified
if (e.NewValue.Width != 0 || e.NewValue.Height != 0)
{
System.Text.StringBuilder stringBuilder = new System.Text.StringBuilder();
// add time information
stringBuilder.AppendFormat("{0:F0} ms", e.NewValue.Width * 1000);
if (e.NewValue.Height != 0)
// add voltage information
stringBuilder.AppendFormat(", {0:F0} μV", e.NewValue.Height * 1000);
// update text
_label.Text = stringBuilder.ToString();
}
else
{
// remove text
_label.Text = string.Empty;
}
}
#endregion
}
''' <summary>
''' Helps to display information about selection in <see cref="Vintasoft.Imaging.Dicom.UI.VisualTools.EcgVisualTool"/>.
''' </summary>
Public Class EcgVisualToolHelper
Implements System.IDisposable
#Region "Fields"
''' <summary>
''' The image viewer.
''' </summary>
Private _viewer As Vintasoft.Imaging.UI.ImageViewer
''' <summary>
''' The label.
''' </summary>
Private _label As System.Windows.Forms.Label
#End Region
#Region "Constructors"
''' <summary>
''' Initializes a new instance of the <see cref="EcgVisualToolHelper"/> class.
''' </summary>
''' <param name="viewer">The image viewer.</param>
''' <param name="label">The label.</param>
Public Sub New(viewer As Vintasoft.Imaging.UI.ImageViewer, label As System.Windows.Forms.Label)
_viewer = viewer
_label = label
' create visual tool
Dim visualTool As New Vintasoft.Imaging.Dicom.UI.VisualTools.EcgVisualTool()
AddHandler visualTool.SelectionChanged, AddressOf EcgVisualTool_SelectionChanged
' set the visual tool
_viewer.VisualTool = visualTool
End Sub
#End Region
#Region "Methods"
''' <summary>
''' Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
''' </summary>
Public Sub Dispose() Implements System.IDisposable.Dispose
If TypeOf _viewer.VisualTool Is Vintasoft.Imaging.Dicom.UI.VisualTools.EcgVisualTool Then
_viewer.VisualTool = Nothing
End If
End Sub
''' <summary>
''' Handles the SelectionChanged event of the EcgVisualTool control.
''' </summary>
''' <param name="sender">The source of the event.</param>
''' <param name="e">The <see cref="Vintasoft.Imaging.PropertyChangedEventArgs{Vintasoft.Primitives.VintasoftRect}"/> instance containing the event data.</param>
Private Sub EcgVisualTool_SelectionChanged(sender As Object, e As Vintasoft.Imaging.PropertyChangedEventArgs(Of Vintasoft.Primitives.VintasoftRect))
' if value is specified
If e.NewValue.Width <> 0 OrElse e.NewValue.Height <> 0 Then
Dim stringBuilder As New System.Text.StringBuilder()
' add time information
stringBuilder.AppendFormat("{0:F0} ms", e.NewValue.Width * 1000)
If e.NewValue.Height <> 0 Then
' add voltage information
stringBuilder.AppendFormat(", {0:F0} ?V", e.NewValue.Height * 1000)
End If
' update text
_label.Text = stringBuilder.ToString()
Else
' remove text
_label.Text = String.Empty
End If
End Sub
#End Region
End Class