Leadtools.MedicalViewer Requires Medical Imaging license | Send comments on this topic. | Back to Introduction - All Topics | Help Version 16.5.9.25
Calibrate(Double,MedicalViewerMeasurementUnit,Double,MedicalViewerMeasurementUnit,Int32,MedicalViewerCalibrationAxis) Method
See Also  Example
Leadtools.MedicalViewer Namespace > MedicalViewerCell Class > Calibrate Method : Calibrate(Double,MedicalViewerMeasurementUnit,Double,MedicalViewerMeasurementUnit,Int32,MedicalViewerCalibrationAxis) Method



sourceDistance
The old length to be calibrated.
sourceMeasurementUnit
The unit of measure.
targetDistance
The new length.
targetMeasurementUnit
The unit of measure.
subCellIndex
Index of the sub-cell being calibrated. Pass -1 to calibrate all the sub-cells; pass -2 to calibrate the active sub-cell.
axis
The calibration axis.
Calibrates sub-cells 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) 
Public Overloads Sub Calibrate( _
   ByVal sourceDistance As Double, _
   ByVal sourceMeasurementUnit As MedicalViewerMeasurementUnit, _
   ByVal targetDistance As Double, _
   ByVal targetMeasurementUnit As MedicalViewerMeasurementUnit, _
   ByVal subCellIndex As Integer, _
   ByVal axis As MedicalViewerCalibrationAxis _
)
Visual Basic (Usage)Copy Code
Dim instance As MedicalViewerCell
Dim sourceDistance As Double
Dim sourceMeasurementUnit As MedicalViewerMeasurementUnit
Dim targetDistance As Double
Dim targetMeasurementUnit As MedicalViewerMeasurementUnit
Dim subCellIndex As Integer
Dim axis As MedicalViewerCalibrationAxis
 
instance.Calibrate(sourceDistance, sourceMeasurementUnit, targetDistance, targetMeasurementUnit, subCellIndex, axis)

Parameters

sourceDistance
The old length to be calibrated.
sourceMeasurementUnit
The unit of measure.
targetDistance
The new length.
targetMeasurementUnit
The unit of measure.
subCellIndex
Index of the sub-cell being calibrated. Pass -1 to calibrate all the sub-cells; pass -2 to calibrate the active sub-cell.
axis
The calibration axis.

Example

Visual BasicCopy Code
Private Class MedicalViewerForm4 : 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()
      RasterCodecs.Startup()
      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)

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

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

      ' Load an image and then add it to the control.
      _image = _codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "xa.dcm")
      _medicalViewer.Cells.Add(New MedicalViewerCell(_image, True, 1, 1))

      ' 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(LeadtoolsExamples.Common.ImagesPath.Path + "mr.dcm")
      _medicalViewer.Cells.Add(New MedicalViewerCell(_image, True, 2, 2))

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


      RasterCodecs.Shutdown()
      Controls.Add(_medicalViewer)
   End Sub
   Public ReadOnly Property Viewer() As MedicalViewer
      Get
         Return _medicalViewer
      End Get
   End Property
End Class
Private Function GetMedicalControl4() As MedicalViewerForm4
   Return New MedicalViewerForm4()
End Function

' This example calibrates the x-axis only of the first frame of the first cell.

Public Sub MedicalViewerCalibrateCellExample4()
   Dim myForm As MedicalViewerForm4 = GetMedicalControl4()
   Dim medicalViewer As MedicalViewer = myForm.Viewer

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

   myForm.ShowDialog()
End Sub
C#Copy Code
class MedicalViewerForm4 : Form 
{ 
    private MedicalViewer _medicalViewer; 
    void MedicalViewerForm_SizeChanged(object sender, EventArgs e) 
    { 
        _medicalViewer.Size = new Size(this.ClientRectangle.Right, this.ClientRectangle.Bottom); 
    } 
 
    public MedicalViewerForm4() 
    { 
        RasterCodecs.Startup(); 
        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); 
 
        // add some action that will be used to change the properties of the images inside the control. 
        _medicalViewer.AddAction(MedicalViewerActionType.WindowLevel); 
        _medicalViewer.AddAction(MedicalViewerActionType.Alpha); 
        _medicalViewer.AddAction(MedicalViewerActionType.Offset); 
 
        // assign the added actions to a mouse button, meaning that when the user click and drag the mouse button, the associted action will be activated. 
        _medicalViewer.SetAction(MedicalViewerActionType.WindowLevel, MedicalViewerMouseButtons.Left, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime); 
        _medicalViewer.SetAction(MedicalViewerActionType.Alpha, MedicalViewerMouseButtons.Middle, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime); 
        _medicalViewer.SetAction(MedicalViewerActionType.Offset, MedicalViewerMouseButtons.Right, MedicalViewerActionFlags.Active | MedicalViewerActionFlags.RealTime); 
 
        // Load an image and then add it to the control. 
        _image = _codecs.Load(LeadtoolsExamples.Common.ImagesPath.Path + "xa.dcm"); 
        _medicalViewer.Cells.Add(new MedicalViewerCell(_image, true, 1, 1)); 
 
        // 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(LeadtoolsExamples.Common.ImagesPath.Path + "mr.dcm"); 
        _medicalViewer.Cells.Add(new MedicalViewerCell(_image, true, 2, 2)); 
 
        // 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); 
 
 
        RasterCodecs.Shutdown(); 
        Controls.Add(_medicalViewer); 
    } 
    public MedicalViewer Viewer 
    { 
        get { return _medicalViewer; } 
    } 
} 
MedicalViewerForm4 GetMedicalControl4() 
{ 
    return new MedicalViewerForm4(); 
} 
 
// This example calibrates the x-axis only of the first frame of the first cell. 
 
public void MedicalViewerCalibrateCellExample4() 
{ 
    MedicalViewerForm4 myForm = GetMedicalControl4(); 
    MedicalViewer medicalViewer = myForm.Viewer; 
 
    medicalViewer.Cells[0].Calibrate(1, MedicalViewerMeasurementUnit.Centimeters, 2, MedicalViewerMeasurementUnit.Centimeters, 0, MedicalViewerCalibrationAxis.XAxis); 
 
    myForm.ShowDialog(); 
}

Remarks

Requirements

Target Platforms: Microsoft .NET Framework 2.0, Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

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