LEADTOOLS Medical (Leadtools.MedicalViewer assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.31
LoadRegion Method
See Also 
Leadtools.MedicalViewer Namespace > MedicalViewerCell Class : LoadRegion Method



fileName
A string that contains the path to the file that contains the region(s) to load.

The LoadRegion Method is available as an add-on to the LEADTOOLS Medical Imaging toolkits.

fileName
A string that contains the path to the file that contains the region(s) to load.
Loads regions from a file.

Syntax

Visual Basic (Declaration) 
Public Sub LoadRegion( _
   ByVal fileName As String _
) 
Visual Basic (Usage)Copy Code
Dim instance As MedicalViewerCell
Dim fileName As String
 
instance.LoadRegion(fileName)
C# 
public void LoadRegion( 
   string fileName
)
C++/CLI 
public:
void LoadRegion( 
   String^ fileName
) 

Parameters

fileName
A string that contains the path to the file that contains the region(s) to load.

Example

Visual BasicCopy Code
Private Class MedicalViewerForm7 : Inherits Form
      Private _medicalViewer As MedicalViewer
      Private Sub MedicalViewerForm_SizeChanged(ByVal sender As Object, ByVal e As EventArgs)
         _medicalViewer.Size = New Size(Me.ClientRectangle.Right, Me.ClientRectangle.Bottom)
      End Sub

      Public Sub New()
         Dim _codecs As RasterCodecs = New RasterCodecs()
         Dim _image As RasterImage

         AddHandler SizeChanged, AddressOf MedicalViewerForm_SizeChanged

         ' Create the medical viewer and adjust the size and the location.
         _medicalViewer = New MedicalViewer(1, 2)
         _medicalViewer.Location = New Point(0, 0)
         _medicalViewer.Size = New Size(Me.ClientRectangle.Right, Me.ClientRectangle.Bottom)

         ' Load an image and then add it to the control.
         _image = _codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "xa.dcm"))
         Dim cell As MedicalViewerMultiCell = New MedicalViewerMultiCell(_image, True, 1, 1)
         _medicalViewer.Cells.Add(cell)

         ' add some action that will be used to change the properties of the images inside the control.
         cell.AddAction(MedicalViewerActionType.WindowLevel)
         cell.AddAction(MedicalViewerActionType.Alpha)
         cell.AddAction(MedicalViewerActionType.Offset)

         ' assign the added actions to a mouse button, meaning that when the user click and drag the mouse button, the associated action will be activated.
         cell.SetAction(MedicalViewerActionType.WindowLevel, MedicalViewerMouseButtons.Left, MedicalViewerActionFlags.Active Or MedicalViewerActionFlags.RealTime)
         cell.SetAction(MedicalViewerActionType.Alpha, MedicalViewerMouseButtons.Middle, MedicalViewerActionFlags.Active Or MedicalViewerActionFlags.RealTime)
         cell.SetAction(MedicalViewerActionType.Offset, MedicalViewerMouseButtons.Right, MedicalViewerActionFlags.Active Or MedicalViewerActionFlags.RealTime)

         ' adjust some properties to the cell and add some tags.
         _medicalViewer.Cells(0).SetTag(2, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.UserData, "EX. ID 230-36-5448")
         _medicalViewer.Cells(0).SetTag(4, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Frame)
         _medicalViewer.Cells(0).SetTag(6, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Scale)
         _medicalViewer.Cells(0).SetTag(2, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.WindowLevelData)
         _medicalViewer.Cells(0).SetTag(1, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.FieldOfView)


         ' Load another image and then add it to the control.
         _image = _codecs.Load(Path.Combine(LEAD_VARS.ImagesDir, "mr.dcm"))
         _medicalViewer.Cells.Add(New MedicalViewerMultiCell(_image, True, 2, 2))

         ' add some action that will be used to change the properties of the images inside the control.
         _medicalViewer.Cells(1).AddAction(MedicalViewerActionType.WindowLevel)
         _medicalViewer.Cells(1).AddAction(MedicalViewerActionType.Alpha)
         _medicalViewer.Cells(1).AddAction(MedicalViewerActionType.Offset)

         ' assign the added actions to a mouse button, meaning that when the user click and drag the mouse button, the associated action will be activated.
         _medicalViewer.Cells(1).SetAction(MedicalViewerActionType.WindowLevel, MedicalViewerMouseButtons.Left, MedicalViewerActionFlags.Active Or MedicalViewerActionFlags.RealTime)
         _medicalViewer.Cells(1).SetAction(MedicalViewerActionType.Alpha, MedicalViewerMouseButtons.Middle, MedicalViewerActionFlags.Active Or MedicalViewerActionFlags.RealTime)
         _medicalViewer.Cells(1).SetAction(MedicalViewerActionType.Offset, MedicalViewerMouseButtons.Right, MedicalViewerActionFlags.Active Or MedicalViewerActionFlags.RealTime)

         ' adjust some properties to the cell and add some tags.
         _medicalViewer.Cells(1).SetTag(2, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.UserData, "EX. ID 230-36-5448")
         _medicalViewer.Cells(1).SetTag(4, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Frame)
         _medicalViewer.Cells(1).SetTag(6, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Scale)
         _medicalViewer.Cells(1).SetTag(2, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.WindowLevelData)
         _medicalViewer.Cells(1).SetTag(1, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.FieldOfView)


         Controls.Add(_medicalViewer)
         _medicalViewer.Dock = DockStyle.Fill
      End Sub
      Public ReadOnly Property Viewer() As MedicalViewer
         Get
            Return _medicalViewer
         End Get
      End Property
   End Class
   Private Function GetMedicalControl7() As MedicalViewerForm7
      Return New MedicalViewerForm7()
   End Function

   ' This example will create a bitmap region on the first frame of the first image and save it.
   <Test> _
   Public Sub MedicalViewerSaveRegionExample()
      Dim myForm As MedicalViewerForm7 = GetMedicalControl7()
      Dim medicalViewer As MedicalViewer = myForm.Viewer
      Dim cell As MedicalViewerMultiCell = CType(medicalViewer.Cells(0), MedicalViewerMultiCell)

      Dim width As Integer = cell.Image.Width
      Dim height As Integer = cell.Image.Height
      Dim centerX As Integer = (width \ 2)
      Dim centerY As Integer = (height \ 2)

      Dim region As Region = New Region(New Rectangle(centerX - width \ 4, centerY - height \ 4, centerX + width \ 4, centerY + height \ 4))

      RasterRegionConverter.AddGdiPlusDataToRegion(cell.Image, Nothing, region.GetRegionData(), RasterRegionCombineMode.Set)
      cell.SaveRegion(Path.Combine(LEAD_VARS.ImagesDir, "Test.rgn"))

      myForm.ShowDialog()
   End Sub


Public NotInheritable Class LEAD_VARS
   Public Const ImagesDir As String = "C:\Users\Public\Documents\LEADTOOLS Images"
End Class
C#Copy Code
class MedicalViewerForm7 : Form
     {
         private MedicalViewer _medicalViewer;
         void MedicalViewerForm_SizeChanged(object sender, EventArgs e)
         {
             _medicalViewer.Size = new Size(this.ClientRectangle.Right, this.ClientRectangle.Bottom);
         }

         public MedicalViewerForm7()
         {
             RasterCodecs _codecs = new RasterCodecs();
             RasterImage _image;

             this.SizeChanged += new EventHandler(MedicalViewerForm_SizeChanged);

             // Create the medical viewer and adjust the size and the location.
             _medicalViewer = new MedicalViewer(1, 2);
             _medicalViewer.Location = new Point(0, 0);
             _medicalViewer.Size = new Size(this.ClientRectangle.Right, this.ClientRectangle.Bottom);

             // Load an image and then add it to the control.
             _image = _codecs.Load(Path.Combine(LEAD_VARS.ImagesDir,"xa.dcm"));
             MedicalViewerMultiCell cell = new MedicalViewerMultiCell(_image, true, 1, 1);
             _medicalViewer.Cells.Add(cell);

             // add some action that will be used to change the properties of the images inside the control.
             cell.AddAction(MedicalViewerActionType.WindowLevel);
             cell.AddAction(MedicalViewerActionType.Alpha);
             cell.AddAction(MedicalViewerActionType.Offset);

             // assign the added actions to a mouse button, meaning that when the user click and drag the mouse button, the associated action will be activated.
             cell.SetAction(MedicalViewerActionType.WindowLevel, MedicalViewerMouseButtons.Left, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime);
             cell.SetAction(MedicalViewerActionType.Alpha, MedicalViewerMouseButtons.Middle, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime);
             cell.SetAction(MedicalViewerActionType.Offset, MedicalViewerMouseButtons.Right, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime);

             // adjust some properties to the cell and add some tags.
             _medicalViewer.Cells[0].SetTag(2, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.UserData, "EX. ID 230-36-5448");
             _medicalViewer.Cells[0].SetTag(4, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Frame);
             _medicalViewer.Cells[0].SetTag(6, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Scale);
             _medicalViewer.Cells[0].SetTag(2, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.WindowLevelData);
             _medicalViewer.Cells[0].SetTag(1, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.FieldOfView);


             // Load another image and then add it to the control.
             _image = _codecs.Load(Path.Combine(LEAD_VARS.ImagesDir,"mr.dcm"));
             _medicalViewer.Cells.Add(new MedicalViewerMultiCell(_image, true, 2, 2));

             // add some action that will be used to change the properties of the images inside the control.
             _medicalViewer.Cells[1].AddAction(MedicalViewerActionType.WindowLevel);
             _medicalViewer.Cells[1].AddAction(MedicalViewerActionType.Alpha);
             _medicalViewer.Cells[1].AddAction(MedicalViewerActionType.Offset);

             // assign the added actions to a mouse button, meaning that when the user click and drag the mouse button, the associated action will be activated.
             _medicalViewer.Cells[1].SetAction(MedicalViewerActionType.WindowLevel, MedicalViewerMouseButtons.Left, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime);
             _medicalViewer.Cells[1].SetAction(MedicalViewerActionType.Alpha, MedicalViewerMouseButtons.Middle, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime);
             _medicalViewer.Cells[1].SetAction(MedicalViewerActionType.Offset, MedicalViewerMouseButtons.Right, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime);

             // adjust some properties to the cell and add some tags.
             _medicalViewer.Cells[1].SetTag(2, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.UserData, "EX. ID 230-36-5448");
             _medicalViewer.Cells[1].SetTag(4, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Frame);
             _medicalViewer.Cells[1].SetTag(6, MedicalViewerTagAlignment.TopLeft, MedicalViewerTagType.Scale);
             _medicalViewer.Cells[1].SetTag(2, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.WindowLevelData);
             _medicalViewer.Cells[1].SetTag(1, MedicalViewerTagAlignment.BottomLeft, MedicalViewerTagType.FieldOfView);


             Controls.Add(_medicalViewer);
             _medicalViewer.Dock = DockStyle.Fill;
         }
         public MedicalViewer Viewer
         {
             get { return _medicalViewer; }
         }
     }
     MedicalViewerForm7 GetMedicalControl7()
     {
         return new MedicalViewerForm7();
     }

     // This example will create a bitmap region on the first frame of the first image and save it.

     public void MedicalViewerSaveRegionExample()
     {
         MedicalViewerForm7 myForm = GetMedicalControl7();
         MedicalViewer medicalViewer = myForm.Viewer;
         MedicalViewerMultiCell cell = (MedicalViewerMultiCell)(medicalViewer.Cells[0]);

         int width = cell.Image.Width;
         int height = cell.Image.Height;
         int centerX = (width / 2);
         int centerY = (height / 2);

         Region region = new Region(new Rectangle(centerX - width / 4, centerY - height / 4, centerX + width / 4, centerY + height / 4));

         RasterRegionConverter.AddGdiPlusDataToRegion(cell.Image, null, region.GetRegionData(), RasterRegionCombineMode.Set);
         cell.SaveRegion(Path.Combine(LEAD_VARS.ImagesDir,"Out_Test.rgn"));

         myForm.ShowDialog();
     }


static class LEAD_VARS
{
   public const string ImagesDir = @"C:\Users\Public\Documents\LEADTOOLS Images";
}

Remarks

  • This method will load the region from the file created by the MedicalViewerMultiCell.SaveRegion method.
  • If the file contains more than one region, the control will load the new region in the next sub-cell, then it will move to the next cell and load the rest of the regions.
  • For more information, refer to Working With Regions.

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

See Also

Leadtools.MedicalViewer requires a Medical Imaging license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features