LEADTOOLS Medical (Leadtools.MedicalViewer assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.31
Calibrate(Double,MedicalViewerMeasurementUnit,Double,MedicalViewerMeasurementUnit,MedicalViewerCalibrationAxis) Method
See Also 
Leadtools.MedicalViewer Namespace > MedicalViewerBaseCell Class > Calibrate Method : Calibrate(Double,MedicalViewerMeasurementUnit,Double,MedicalViewerMeasurementUnit,MedicalViewerCalibrationAxis) Method



sourceDistance
The old length to be calibrated.
sourceMeasurementUnit
The unit of measure.
targetDistance
The new length.
targetMeasurementUnit
The unit of measure.
axis
The calibration axis.

The Calibrate(Double,MedicalViewerMeasurementUnit,Double,MedicalViewerMeasurementUnit,MedicalViewerCalibrationAxis) Method is available as an add-on to the LEADTOOLS Medical Imaging toolkits.

sourceDistance
The old length to be calibrated.
sourceMeasurementUnit
The unit of measure.
targetDistance
The new length.
targetMeasurementUnit
The unit of measure.
axis
The calibration axis.
Calibrates the cell along the specified axis based on information provided by the user. This allows the user to calibrate a cell without using an annotation ruler.

Syntax

Visual Basic (Declaration) 
Overloads Public Sub Calibrate( _
   ByVal sourceDistance As Double, _
   ByVal sourceMeasurementUnit As MedicalViewerMeasurementUnit, _
   ByVal targetDistance As Double, _
   ByVal targetMeasurementUnit As MedicalViewerMeasurementUnit, _
   ByVal axis As MedicalViewerCalibrationAxis _
) 
Visual Basic (Usage)Copy Code
Dim instance As MedicalViewerBaseCell
Dim sourceDistance As Double
Dim sourceMeasurementUnit As MedicalViewerMeasurementUnit
Dim targetDistance As Double
Dim targetMeasurementUnit As MedicalViewerMeasurementUnit
Dim axis As MedicalViewerCalibrationAxis
 
instance.Calibrate(sourceDistance, sourceMeasurementUnit, targetDistance, targetMeasurementUnit, axis)

Parameters

sourceDistance
The old length to be calibrated.
sourceMeasurementUnit
The unit of measure.
targetDistance
The new length.
targetMeasurementUnit
The unit of measure.
axis
The calibration axis.

Example

Visual BasicCopy Code
Private Class MedicalViewerForm2 : 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)

         ' 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)

         _medicalViewer.Cells.Add(cell)

         ' 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 GetMedicalControl2() As MedicalViewerForm2
      Return New MedicalViewerForm2()
   End Function

   ' This example calibrates the first frame of the first cell.
   Public Sub MedicalViewerCalibrateCellExample2()
      Dim myForm As MedicalViewerForm2 = GetMedicalControl2()
      Dim medicalViewer As MedicalViewer = myForm.Viewer

      medicalViewer.Cells(0).Calibrate(1, MedicalViewerMeasurementUnit.Centimeters, 2, MedicalViewerMeasurementUnit.Centimeters, 0)

      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 MedicalViewerForm2 : Form
     {
         private MedicalViewer _medicalViewer;
         void MedicalViewerForm_SizeChanged(object sender, EventArgs e)
         {
             _medicalViewer.Size = new Size(this.ClientRectangle.Right, this.ClientRectangle.Bottom);
         }

         public MedicalViewerForm2()
         {
             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);

             // 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);

             _medicalViewer.Cells.Add(cell);

             // 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; }
         }
     }
     MedicalViewerForm2 GetMedicalControl2()
     {
         return new MedicalViewerForm2();
     }

     // This example calibrates the first frame of the first cell.
     public void MedicalViewerCalibrateCellExample2()
     {
         MedicalViewerForm2 myForm = GetMedicalControl2();
         MedicalViewer medicalViewer = myForm.Viewer;

         medicalViewer.Cells[0].Calibrate(1, MedicalViewerMeasurementUnit.Centimeters, 2, MedicalViewerMeasurementUnit.Centimeters, 0);

         myForm.ShowDialog();
     }

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

Remarks

For more information, refer to Image Viewer Cells.

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