Skip to content

ReadDICOMSeries

vtk-examples/CSharp/IO/ReadDICOMSeries

Description

This example demonstates how to read a series of DICOM images and how to scroll with the mousewheel or the up/down keys through all slices. Sample data are available as a zipped file (977 kB, 40 slices) here

A tutorial on how to setup a Windows Forms Application utilizing ActiViz.NET can be found here: Setup a Windows Forms Application to use ActiViz.NET

Other languages

See (Cxx), (Python)

Question

If you have a question about this example, please use the VTK Discourse Forum

Code

ReadDICOMSeries.cs

using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Windows.Forms;
using System.Diagnostics;
using System.IO;

using Kitware.VTK;

namespace ActiViz.Examples {
   public partial class Form1 : Form {

      // module wide accessible variables
      vtkImageViewer2 _ImageViewer;
      vtkTextMapper _SliceStatusMapper;
      int _Slice;
      int _MinSlice;
      int _MaxSlice;


      public Form1() {
         InitializeComponent();
      }


      private void renderWindowControl1_Load(object sender, EventArgs e) {
         try {
            ReadDICOMSeries();
         }
         catch(Exception ex) {
            MessageBox.Show(ex.Message, "Exception", MessageBoxButtons.OK);
         }
      }


       private void ReadDICOMSeries() {
         // Path to vtk data must be set as an environment variable
         // VTK_DATA_ROOT = "C:\VTK\vtkdata-5.8.0"
         vtkTesting test = vtkTesting.New();
         string root = test.GetDataRoot();
         // Read all the DICOM files in the specified directory.
         // Caution: folder "DicomTestImages" don't exists by default in the standard vtk data folder
         // sample data are available at http://www.vtk.org/Wiki/images/1/12/VTK_Examples_StandardFormats_Input_DicomTestImages.zip
         string folder = Path.Combine(root, @"Data\DicomTestImages");
         vtkDICOMImageReader reader = vtkDICOMImageReader.New();
         reader.SetDirectoryName(folder);
         reader.Update();
         // Visualize
         _ImageViewer = vtkImageViewer2.New();
         _ImageViewer.SetInputConnection(reader.GetOutputPort());
         // get range of slices (min is the first index, max is the last index)
         _ImageViewer.GetSliceRange(ref _MinSlice, ref _MaxSlice);
         Debug.WriteLine("slices range from : " + _MinSlice.ToString() + " to " + _MaxSlice.ToString());

         // slice status message
         vtkTextProperty sliceTextProp = vtkTextProperty.New();
         sliceTextProp.SetFontFamilyToCourier();
         sliceTextProp.SetFontSize(20);
         sliceTextProp.SetVerticalJustificationToBottom();
         sliceTextProp.SetJustificationToLeft();

         _SliceStatusMapper = vtkTextMapper.New();
         _SliceStatusMapper.SetInput("Slice No " + ( _Slice + 1 ).ToString() + "/" + ( _MaxSlice + 1 ).ToString());
         _SliceStatusMapper.SetTextProperty(sliceTextProp);

         vtkActor2D sliceStatusActor = vtkActor2D.New();
         sliceStatusActor.SetMapper(_SliceStatusMapper);
         sliceStatusActor.SetPosition(15, 10);

         // usage hint message
         vtkTextProperty usageTextProp = vtkTextProperty.New();
         usageTextProp.SetFontFamilyToCourier();
         usageTextProp.SetFontSize(14);
         usageTextProp.SetVerticalJustificationToTop();
         usageTextProp.SetJustificationToLeft();

         vtkTextMapper usageTextMapper = vtkTextMapper.New();
         usageTextMapper.SetInput("Slice with mouse wheel\nor Up/Down-Key");
         usageTextMapper.SetTextProperty(usageTextProp);

         vtkActor2D usageTextActor = vtkActor2D.New();
         usageTextActor.SetMapper(usageTextMapper);
         usageTextActor.GetPositionCoordinate().SetCoordinateSystemToNormalizedDisplay();
         usageTextActor.GetPositionCoordinate().SetValue(0.05, 0.95);

         vtkRenderWindow renderWindow = renderWindowControl1.RenderWindow;

         vtkInteractorStyleImage interactorStyle = vtkInteractorStyleImage.New();
         interactorStyle.MouseWheelForwardEvt += new vtkObject.vtkObjectEventHandler(interactor_MouseWheelForwardEvt);
         interactorStyle.MouseWheelBackwardEvt += new vtkObject.vtkObjectEventHandler(interactor_MouseWheelBackwardEvt);

         renderWindow.GetInteractor().SetInteractorStyle(interactorStyle);
         renderWindow.GetRenderers().InitTraversal();
         vtkRenderer ren;
         while(( ren = renderWindow.GetRenderers().GetNextItem() ) != null)
            ren.SetBackground(0.0, 0.0, 0.0);

         _ImageViewer.SetRenderWindow(renderWindow);
         _ImageViewer.GetRenderer().AddActor2D(sliceStatusActor);
         _ImageViewer.GetRenderer().AddActor2D(usageTextActor);
         _ImageViewer.SetSlice(_MinSlice);
         _ImageViewer.Render();
      }


      /// <summary>
      /// move forward to next slice
      /// </summary>
      private void MoveForwardSlice() {
         Debug.WriteLine(_Slice.ToString());
         if(_Slice < _MaxSlice) {
            _Slice += 1;
            _ImageViewer.SetSlice(_Slice);
            _SliceStatusMapper.SetInput("Slice No " + ( _Slice + 1 ).ToString() + "/" + ( _MaxSlice + 1 ).ToString());
            _ImageViewer.Render();
         }
      }


      /// <summary>
      /// move backward to next slice
      /// </summary>
      private void MoveBackwardSlice() {
         Debug.WriteLine(_Slice.ToString());
         if(_Slice > _MinSlice) {
            _Slice -= 1;
            _ImageViewer.SetSlice(_Slice);
            _SliceStatusMapper.SetInput("Slice No " + ( _Slice + 1 ).ToString() + "/" + ( _MaxSlice + 1 ).ToString());
            _ImageViewer.Render();
         }
      }


      /// <summary>
      /// eventhanndler to process keyboard input
      /// </summary>
      /// <param name="msg"></param>
      /// <param name="keyData"></param>
      /// <returns></returns>
      protected override bool ProcessCmdKey(ref System.Windows.Forms.Message msg, System.Windows.Forms.Keys keyData) {
         //Debug.WriteLine(DateTime.Now + ":" + msg.Msg + ", " + keyData);
         if(keyData == System.Windows.Forms.Keys.Up) {
            MoveForwardSlice();
            return true;
         }
         else if(keyData == System.Windows.Forms.Keys.Down) {
            MoveBackwardSlice();
            return true;
         }
         // don't forward the following keys
         // add all keys which are not supposed to get forwarded
         else if(
               keyData == System.Windows.Forms.Keys.F
            || keyData == System.Windows.Forms.Keys.L
         ) {
            return true;
         }
         return false;
      }

      /// <summary>
      /// event handler for mousewheel forward event
      /// </summary>
      /// <param name="sender"></param>
      /// <param name="e"></param>
      void interactor_MouseWheelForwardEvt(vtkObject sender, vtkObjectEventArgs e) {
         MoveForwardSlice();
      }


      /// <summary>
      /// event handler for mousewheel backward event
      /// </summary>
      /// <param name="sender"></param>
      /// <param name="e"></param>
      void interactor_MouseWheelBackwardEvt(vtkObject sender, vtkObjectEventArgs e) {
         MoveBackwardSlice();
      }
   }
}