MemoryEfficientSetFrame(RasterImage,Int32,Int32,Boolean) Method

Fills the 3D object with data from the specified Leadtools.RasterImage.

Syntax

C#
Visual Basic
Objective-C
Java
C++

public void MemoryEfficientSetFrame( 
   RasterImage image,
   int frameIndex,
   int instanceNumber,
   bool remove
)

'Declaration
 
Public Overloads Sub MemoryEfficientSetFrame( _
   ByVal image As RasterImage, _
   ByVal frameIndex As Integer, _
   ByVal instanceNumber As Integer, _
   ByVal remove As Boolean _
)

'Usage
 
Dim instance As Medical3DObject
Dim image As RasterImage
Dim frameIndex As Integer
Dim instanceNumber As Integer
Dim remove As Boolean
 
instance.MemoryEfficientSetFrame(image, frameIndex, instanceNumber, remove)

public:
void MemoryEfficientSetFrame( 
   RasterImage^ image,
   int frameIndex,
   int instanceNumber,
   bool remove
)

Parameters

image: Leadtools.RasterImage used to fill a portion of the object.
frameIndex: The index that represents the place of the image to set in the 3D object
instanceNumber: The instance number of the frame being set. Get this value from the DICOM file
remove: true to dispose of the image after copying its data and placing in the 3D object; false, otherwise.

Remarks

You must add the Medical3DObject to the Medical3DContainer before using this method. Refer to Medical3DContainer.Objects collection.
You must first initialize the memory efficient feature before using this method. To initialize the feature, use the MemoryEfficientInit method.
You need to call this method multiple times, each with different frameIndex, in order to fill the 3D object. The number of times is based on the depth

depth

The depth of the 3D object, or the number of frames used to create the 3D object.

parameter used when calling MemoryEfficientInit.
You do not need to set frames in order. However, you need to fill the entire object by covering all indexes from 0 to depth - 1. The area that was not filled will be black when rendering the object.
This overloaded method is used to sort the series of frames based on their instanceNumber DICOM tag.

Example

C#
Visual Basic
WinRT C#
WinRT JavaScript
Silverlight C#
Silverlight VB

Copy Code

Imports Leadtools
Imports Leadtools.Codecs
Imports Leadtools.MedicalViewer
Imports Leadtools.Medical3D
Imports Leadtools.Dicom

Public Sub Medical3DControlExample()
   Dim form As MainForm1 = New MainForm1()
   form.ShowDialog()
End Sub
' MainForm1 will be the owner of the medical viewer control.
Private Class MainForm1 : Inherits Form
   Private _medical3DControl As Medical3DControl

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

      Dim codecsInformation As CodecsImageInfo

      _medical3DControl = New Medical3DControl()
      AddHandler SizeChanged, AddressOf MainForm1_SizeChanged
      AddHandler FormClosing, AddressOf MainForm1_FormClosing

      _medical3DControl.ObjectsContainer.Objects.Add(New Medical3DObject())

      Dim index As Integer

      Dim LoadObject As Medical3DLoadDICOMSeriesExamples = New Medical3DLoadDICOMSeriesExamples()
      Dim output As MedicalViewerSeriesManager = LoadObject.LoadJamesHead()
      codecsInformation = _codecs.GetInformation(CStr(output.Stacks(0).Items(0).Data), True)

      Dim width As Integer = codecsInformation.Width
      Dim height As Integer = codecsInformation.Height
      Dim depth As Integer = 256

      _medical3DControl.ObjectsContainer.Objects(0).MemoryEfficientInit(depth)

      index = 0
      Do While index < depth

         _image = _codecs.Load(CStr(output.Stacks(0).Items(index).Data), 0, CodecsLoadByteOrder.BgrOrGrayOrRomm, 1, 1)
         _medical3DControl.ObjectsContainer.Objects(0).MemoryEfficientSetFrame(_image, index, output.Stacks(0).Items(index).ImagePosition, True)
         index += 1
      Loop

      Dim spearator As String = ("\")
      Dim test As String() = output.Stacks(0).Items(0).ImageOrientation.Split(spearator.ToCharArray())
      Dim orientation As Single() = New Single(5) {}
      Dim i As Integer
      For i = 0 To 5
         orientation(i) = CSng(Convert.ToDouble(test(i)))
      Next i

      _medical3DControl.ObjectsContainer.Objects(0).MemoryEfficientEnd(orientation, output.Stacks(0).PixelSpacing)

      _medical3DControl.ObjectsContainer.VolumeType = Medical3DVolumeType.VRT

      _medical3DControl.AddAction(MedicalViewerActionType.Rotate3DObject)
      _medical3DControl.SetAction(MedicalViewerActionType.Rotate3DObject, MedicalViewerMouseButtons.Left, MedicalViewerActionFlags.Active)

      _medical3DControl.AddAction(MedicalViewerActionType.WindowLevel)
      _medical3DControl.SetAction(MedicalViewerActionType.WindowLevel, MedicalViewerMouseButtons.Right, MedicalViewerActionFlags.Active)

      Controls.Add(_medical3DControl)
   End Sub

   Private Sub MainForm1_FormClosing(ByVal sender As Object, ByVal e As FormClosingEventArgs)
      _medical3DControl.Dispose()
   End Sub

   Private Sub MainForm1_SizeChanged(ByVal sender As Object, ByVal e As EventArgs)
      If Not _medical3DControl Is Nothing Then
         _medical3DControl.Size = New Size(Me.ClientRectangle.Right, Me.ClientRectangle.Bottom)
      End If
   End Sub

End Class

using Leadtools;
using Leadtools.Codecs;
using Leadtools.MedicalViewer;
using Leadtools.Medical3D;
using Leadtools.Dicom;

public void Medical3DControlExample()
{
   MainForm1 form = new MainForm1();
   form.ShowDialog();
}
// MainForm1 will be the owner of the medical viewer control.
class MainForm1 : Form
{
   private Medical3DControl _medical3DControl;

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

      CodecsImageInfo codecsInformation;

      _medical3DControl = new Medical3DControl();
      this.SizeChanged += new EventHandler(MainForm1_SizeChanged);
      this.FormClosing += new FormClosingEventHandler(MainForm1_FormClosing);

      _medical3DControl.ObjectsContainer.Objects.Add(new Medical3DObject());

      int index;

      Medical3DLoadDICOMSeriesExamples LoadObject = new Medical3DLoadDICOMSeriesExamples();
      MedicalViewerSeriesManager output = LoadObject.LoadJamesHead();
      codecsInformation = _codecs.GetInformation((string)output.Stacks[0].Items[0].Data, true);

      int width = codecsInformation.Width;
      int height = codecsInformation.Height;
      int depth = 256;

      _medical3DControl.ObjectsContainer.Objects[0].MemoryEfficientInit(depth);

      for (index = 0; index < depth; index++)
      {

         _image = _codecs.Load((string)output.Stacks[0].Items[index].Data, 0, CodecsLoadByteOrder.BgrOrGrayOrRomm, 1, 1);
         _medical3DControl.ObjectsContainer.Objects[0].MemoryEfficientSetFrame(_image, index, output.Stacks[0].Items[index].ImagePosition, true);
      }

      string spearator = ("\\");
      string[] test = output.Stacks[0].Items[0].ImageOrientation.Split(spearator.ToCharArray());
      float[] orientation = new float[6];
      int i;
      for (i = 0; i < 6; i++)
      {
         orientation[i] = (float)Convert.ToDouble(test[i]);
      }

      _medical3DControl.ObjectsContainer.Objects[0].MemoryEfficientEnd(orientation, output.Stacks[0].PixelSpacing);

      _medical3DControl.ObjectsContainer.VolumeType = Medical3DVolumeType.VRT;

      _medical3DControl.AddAction(MedicalViewerActionType.Rotate3DObject);
      _medical3DControl.SetAction(MedicalViewerActionType.Rotate3DObject, MedicalViewerMouseButtons.Left, MedicalViewerActionFlags.Active);

      _medical3DControl.AddAction(MedicalViewerActionType.WindowLevel);
      _medical3DControl.SetAction(MedicalViewerActionType.WindowLevel, MedicalViewerMouseButtons.Right, MedicalViewerActionFlags.Active);

      Controls.Add(_medical3DControl);
   }

   void MainForm1_FormClosing(object sender, FormClosingEventArgs e)
   {
      _medical3DControl.Dispose();
   }

   void MainForm1_SizeChanged(object sender, EventArgs e)
   {
      if (_medical3DControl != null)
         _medical3DControl.Size = new Size(this.ClientRectangle.Right, this.ClientRectangle.Bottom);
   }

}

Requirements

Target Platforms

Reference

Medical3DObject Class
Medical3DObject Members
Overload List