MemoryEfficientSetFrame(RasterImage,int,Point3D,bool) Method

Summary
Fills the 3D object with data from the specified Leadtools.RasterImage.
Syntax
C#
VB
C++
public void MemoryEfficientSetFrame( 
   RasterImage image, 
   int frameIndex, 
   Point3D imagePosition, 
   bool remove 
) 
  
Public Overloads Sub MemoryEfficientSetFrame( _ 
   ByVal image As RasterImage, _ 
   ByVal frameIndex As Integer, _ 
   ByVal imagePosition As Point3D, _ 
   ByVal remove As Boolean _ 
)  
public: 
void MemoryEfficientSetFrame(  
   RasterImage^ image, 
   int frameIndex, 
   Point3D imagePosition, 
   bool remove 
)  

Parameters

image
Leadtools.RasterImageused to fill a portion of the object.

frameIndex
The index that represents the place of the image to set in the 3D object.

imagePosition
the position 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 it into 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 whole object by covering all the indexes from 0 to depth - 1. The area that was not filled will be black when rendering the object.

  • This overloaded method is used when you want to sort the series frames based on their ImagePositionPatient Dicom tag.
Example
C#
VB
using Leadtools; 
using Leadtools.Codecs; 
using Leadtools.MedicalViewer; 
using Leadtools.Medical3D; 
 
public void Medical3DControlExample() 
{ 
   Medical3DLoadDICOMSeriesExamples LoadObject = new Medical3DLoadDICOMSeriesExamples(); 
   MedicalViewerSeriesManager output = LoadObject.LoadJamesHead(); 
 
   MainForm1 form = new MainForm1(output); 
   form.ShowDialog(); 
} 
 
// MainForm1 will be the owner of the medical viewer control. 
class MainForm1 : Form 
{ 
   private Medical3DControl _medical3DControl; 
 
   public MainForm1(MedicalViewerSeriesManager output) 
   { 
      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; 
 
      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); 
 
      // set the object scale to 20% 
      _medical3DControl.ObjectsContainer.Objects[0].ScaleXYZ(20); 
 
 
      _medical3DControl.AddAction(MedicalViewerActionType.Scale); 
      _medical3DControl.SetAction(MedicalViewerActionType.Scale, MedicalViewerMouseButtons.Left, 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); 
   } 
} 
Imports Leadtools 
Imports Leadtools.Codecs 
Imports Leadtools.MedicalViewer 
Imports Leadtools.Medical3D 
 
Public Sub Medical3DControlExample() 
   Dim LoadObject As Medical3DLoadDICOMSeriesExamples = New Medical3DLoadDICOMSeriesExamples() 
   Dim output As MedicalViewerSeriesManager = LoadObject.LoadJamesHead() 
 
   Dim form As MainForm1 = New MainForm1(output) 
   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(ByVal output As MedicalViewerSeriesManager) 
      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 
 
      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.AddAction(MedicalViewerActionType.Scale) 
      _medical3DControl.SetAction(MedicalViewerActionType.Scale, MedicalViewerMouseButtons.Left, 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 
Requirements

Target Platforms

Help Version 21.0.2021.6.30
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.

Leadtools.Medical3D Assembly
Products | Support | Contact Us | Intellectual Property Notices
© 1991-2021 LEAD Technologies, Inc. All Rights Reserved.