Control for 3d Scanning More...

Inheritance diagram for Simple3DScan.UI.ScanControl:

Collaboration diagram for Simple3DScan.UI.ScanControl:

Public Member Functions
delegate void	StartScan ()

delegate void	StopScan ()

	ScanControl ()
	Initializes a new instance of the ScanControl class. More...

void	Init (ArduinoCommands arduino)
	Initializes the control. More...

Protected Member Functions
void	InitiateCameraDropdown ()
	Initiates the camera dropdown. More...

override void	Dispose (bool disposing)
	Verwendete Ressourcen bereinigen. More...

void	ScanWorker_DoWork (object sender, DoWorkEventArgs e)
	Handles the DoWork event of the scanWorker control. More...

void	ScanWorker_ProgressChanged (object sender, ProgressChangedEventArgs e)
	Handles the ProgressChanged event of the ScanWorker control. More...

virtual void	ScanWorker_RunWorkerCompleted (object sender, RunWorkerCompletedEventArgs e)
	Handles the RunWorkerCompleted event of the ScanWorker control. More...

void	ToggleButtonCapture_Click (object sender, EventArgs e)
	Handles the Click event of the toggleButtonCapture control. More...

void	ComboBoxCameras_SelectedIndexChanged (object sender, EventArgs e)
	Handles the SelectedIndexChanged event of the comboBoxCameras control. More...

IEnumerable< ColorPoint3D >	ScanImage (int actualSteps, string imageFolder, int steps, int sweep, ArduinoCommands arduino, CameraControl imaging, Information configuration)
	Scans the image. More...

bool	PerformScan (ArduinoCommands arduino, CameraControl cameraControl, Information configuration, int numberOfTotalSteps, Resolution resolution, string imageFolder, IPointWriter writer)
	Performs the scan. More...

bool	InitiateWriter (ArduinoCommands arduino, Information configuration, out IPointWriter writer)
	Initiates the writer. More...

Static Protected Member Functions
static void	MoveLaserToLeftStartPosition (ArduinoCommands arduino, CameraControl cameraControl, Information configuration)
	Moves the laser to left start position. More...

static void	GetResolutionAndSteps (Precision precision, Information configuration, out int numberOfTotalSteps, out Resolution resolution)
	Gets the resolution and steps. More...

static string	ResetImageFolder (Information configuration)
	Resets the image folder. More...

static void	SavePoints (Control control, IPointWriter writer, Information configuration)
	Saves the points. More...

Protected Attributes
readonly BackgroundWorker	ScanWorker = new BackgroundWorker()
	The scan worker More...

readonly Information	ConfigurationInformation = Singleton<Config>.Instance.Information
	The configuration information More...

readonly Dictionary< string, string >	VideoSources = new Dictionary<string, string>()
	The video sources More...

System.Windows.Forms.Label	LabelSelectCamera

Syncfusion.Windows.Forms.Gauge.RadialGauge	RadialGaugeProgress

System.Windows.Forms.ComboBox	ComboBoxCameras

Syncfusion.Windows.Forms.Tools.RadialSlider	RadialSliderPrecision

System.Windows.Forms.Label	LabelCapture

Syncfusion.Windows.Forms.Tools.ToggleButton	ToggleButtonCapture

System.Windows.Forms.Label	labelPrecision

CameraControl	ImagingControl

Package Functions
void	Stop ()
	Stops this instance. More...

void	Start ()
	Starts this instance. More...

Properties
ArduinoCommands	Arduino `[get, set]`
	The arduino command connection More...

Events
StartScan	StartScanning
	Occurs when [start scanning]. More...

StopScan	StopScanning
	Occurs when [stop scanning]. More...

Detailed Description

Control for 3d Scanning

Definition at line 20 of file ScanControl.cs.

Constructor & Destructor Documentation

Simple3DScan.UI.ScanControl.ScanControl ( )

Initializes a new instance of the ScanControl class.

Definition at line 72 of file ScanControl.cs.

         {
             this.InitializeComponent();
         }

Member Function Documentation

void Simple3DScan.UI.ScanControl.ComboBoxCameras_SelectedIndexChanged	(	object	sender,
		EventArgs	e
	)

protected

Handles the SelectedIndexChanged event of the comboBoxCameras control.

Parameters

sender	The source of the event.
e	The EventArgs instance containing the event data.

Definition at line 259 of file ScanControl.cs.

         {
             if (!this.VideoSources.ContainsKey(this.ComboBoxCameras.SelectedItem.ToString()))
                 return;
 
             this.ConfigurationInformation.Camera.Name = this.ComboBoxCameras.SelectedItem.ToString();
             this.ConfigurationInformation.Camera.Moniker = this.VideoSources[this.ComboBoxCameras.SelectedItem.ToString()];
 
             this.SetMaxFrameSizes(this.ConfigurationInformation.Camera.Moniker);
 
             this.ImagingControl.LaserMotorEnabled = this.ConfigurationInformation.Laser.MotorEnabled;
             this.ImagingControl.LaserLeftPosition = this.ConfigurationInformation.Laser.SwipeMin * this.ConfigurationInformation.Camera.Width / 100;
             this.ImagingControl.LaserRightPosition = this.ConfigurationInformation.Laser.SwipeMax * this.ConfigurationInformation.Camera.Width / 100;
 
             this.ImagingControl.StartImaging(this.ConfigurationInformation.Camera.Name);
         }

override void Simple3DScan.UI.ScanControl.Dispose ( bool disposing )

protected

Verwendete Ressourcen bereinigen.

Parameters

disposing True, wenn verwaltete Ressourcen gelöscht werden sollen; andernfalls False.

Definition at line 151 of file ScanControl.cs.

         {
             if (disposing)
             {
                 this.components?.Dispose();
             }
             this.ImagingControl.StopImaging();
 
             base.Dispose(disposing);
         }

static void Simple3DScan.UI.ScanControl.GetResolutionAndSteps	(	Precision	precision,
		Information	configuration,
		out int	numberOfTotalSteps,
		out Resolution	resolution
	)

staticprotected

Gets the resolution and steps.

Parameters

precision	The precision.
configuration	The configuration.
numberOfTotalSteps	The number of total steps.
resolution	The resolution.

Definition at line 479 of file ScanControl.cs.

         {
             numberOfTotalSteps = configuration.Motor.MicroStepsEnabled
                 ? configuration.Motor.MicroSteps*configuration.Motor.Steps
                 : configuration.Motor.Steps;
 
             resolution = configuration.Resolutions.First(x => x.Precision == precision);
         }

void Simple3DScan.UI.ScanControl.Init ( ArduinoCommands arduino )

Initializes the control.

Parameters

arduino The arduino.

Definition at line 95 of file ScanControl.cs.

         {
             this.Arduino = arduino;
             this.Arduino.ActivateLaser(false);
 
             ButtonRenderer styleRenderer = new ButtonRenderer();
             this.ToggleButtonCapture.Renderer = styleRenderer;
 
             this.RadialSliderPrecision.ValueChanged += this.RadialSliderPrecision_ValueChanged;
            
         }

void Simple3DScan.UI.ScanControl.InitiateCameraDropdown ( )

protected

Initiates the camera dropdown.

Definition at line 112 of file ScanControl.cs.

         {
             int i = 0;
             foreach (FilterInfo filterInfo in new FilterInfoCollection(FilterCategory.VideoInputDevice))
             {
                 this.ComboBoxCameras.Items.Add(filterInfo.Name);
                 this.VideoSources.Add(filterInfo.Name, filterInfo.MonikerString);
                 if (!String.IsNullOrEmpty(this.ConfigurationInformation.Camera.Name) &&
                     filterInfo.Name == this.ConfigurationInformation.Camera.Name)
                     this.ComboBoxCameras.SelectedIndex = i;
                 i++;
             }
         }

bool Simple3DScan.UI.ScanControl.InitiateWriter	(	ArduinoCommands	arduino,
		Information	configuration,
		out IPointWriter	writer
	)

protected

Initiates the writer.

Parameters

arduino	The arduino.
configuration	The configuration.
writer	The writer.

Returns

Definition at line 519 of file ScanControl.cs.

         {
             switch (configuration.Places.FileFormat)
             {
                 case FileFormat.Ascii:
                     arduino.ActivateLaser();
                     writer = new WriterAsc();
                     break;
                 case FileFormat.Pcd:
                     writer = new WriterPcd();
                     break;
                 default:
                     writer = null;
                     return false;
             }
             return true;
         }

Here is the call graph for this function:

static void Simple3DScan.UI.ScanControl.MoveLaserToLeftStartPosition	(	ArduinoCommands	arduino,
		CameraControl	cameraControl,
		Information	configuration
	)

staticprotected

Moves the laser to left start position.

Parameters

arduino	The arduino.
cameraControl	The camera control.
configuration	The configuration.

Definition at line 449 of file ScanControl.cs.

         {
             if (!configuration.Laser.MotorEnabled)
                 return;
             arduino.ActivateLaser();
 
             float actualX = TransformImage.GetLaserLinePosition(cameraControl.GetNextPicture(), configuration.Filter);
 
             while (actualX > configuration.Laser.SwipeMin*configuration.Camera.Width/100)
             {
                 arduino.RotateLaserCcw(4);
                 actualX = TransformImage.GetLaserLinePosition(cameraControl.GetNextPicture(), configuration.Filter);
             }
             arduino.RotateLaserCcw(4);
             arduino.ActivateLaser(false);
         }

Here is the call graph for this function:

bool Simple3DScan.UI.ScanControl.PerformScan	(	ArduinoCommands	arduino,
		CameraControl	cameraControl,
		Information	configuration,
		int	numberOfTotalSteps,
		Resolution	resolution,
		string	imageFolder,
		IPointWriter	writer
	)

protected

Performs the scan.

Parameters

arduino	The arduino.
cameraControl	The camera control.
configuration	The configuration.
numberOfTotalSteps	The number of total steps.
resolution	The resolution.
imageFolder	The image folder.
writer	The writer.

Returns

Definition at line 417 of file ScanControl.cs.

         {
             for (int actualSteps = 0; actualSteps <= numberOfTotalSteps; actualSteps += resolution.Steps)
             {
                 if (this.ScanWorker.CancellationPending)
                     return true;
 
                 int percentage = actualSteps*100/numberOfTotalSteps;
 
                 IEnumerable<ColorPoint3D> points = this.ScanImage(actualSteps, imageFolder, resolution.Steps, resolution.SweepSteps, arduino, cameraControl, configuration);
 
                 if(null != points)
                     foreach (ColorPoint3D point in points)
                         writer.AddPoint(point);
 
                 this.ScanWorker.ReportProgress(percentage);
             }
             return false;
         }

Here is the call graph for this function:

static string Simple3DScan.UI.ScanControl.ResetImageFolder ( Information configuration )

staticprotected

Resets the image folder.

Parameters

configuration The configuration.

Returns

Definition at line 499 of file ScanControl.cs.

         {
             string imageFolder = Path.Combine(AppDomain.CurrentDomain.BaseDirectory,
                 configuration.Places.ImageSubPath);
 
             FileHelper.CreatePathIfNotExisting(imageFolder);
 
             FileHelper.DeleteAllFilesInFolder(imageFolder);
             return imageFolder;
         }

Here is the call graph for this function:

static void Simple3DScan.UI.ScanControl.SavePoints	(	Control	control,
		IPointWriter	writer,
		Information	configuration
	)

staticprotected

Saves the points.

Parameters

control	The control.
writer	The writer.
configuration	The configuration.

Definition at line 545 of file ScanControl.cs.

         {
             control.Invoke((MethodInvoker) delegate
             {
                 SaveFileDialog saveDialog = new SaveFileDialog();
                 if (!String.IsNullOrEmpty(configuration.Places.ImageSubPath))
                     saveDialog.InitialDirectory = configuration.Places.ImageSubPath;
 
                 switch (configuration.Places.FileFormat)
                 {
 
                     case FileFormat.Pcd:
                         saveDialog.DefaultExt = ".PLY";
                         saveDialog.Filter = "PLY (.ply)|*.ply";
                         saveDialog.FileName = "ColoredPoints" + DateTime.Now.ToFileTime();
                         break;
                     default:
                         saveDialog.DefaultExt = ".asc";
                         saveDialog.Filter = "Ascii (.asc)|*.asc";
                         saveDialog.FileName = "Points" + DateTime.Now.ToFileTime();
                         break;
                 }
 
                 DialogResult result = saveDialog.ShowDialog();
 
                 if (result != DialogResult.OK)
                     return;
 
                 string filename = saveDialog.FileName;
                 configuration.Places.LastFilePath = Path.GetDirectoryName(filename);
                 writer.Write(filename);
             });
         }

Here is the call graph for this function:

IEnumerable<ColorPoint3D> Simple3DScan.UI.ScanControl.ScanImage	(	int	actualSteps,
		string	imageFolder,
		int	steps,
		int	sweep,
		ArduinoCommands	arduino,
		CameraControl	imaging,
		Information	configuration
	)

protected

Scans the image.

Parameters

actualSteps	The actual steps.
imageFolder	The image folder.
steps	The steps.
sweep	The sweep.
arduino	The arduino.
imaging	The imaging.
configuration	The configuration.

Returns

Definition at line 311 of file ScanControl.cs.

         {
             Image image;
             Image imageOff = null;
             List<ColorPoint3D> points = new List<ColorPoint3D>();
 
             if (!configuration.Laser.MotorEnabled)
             {
                 if (configuration.Places.FileFormat == FileFormat.Pcd)
                 {
                     arduino.ActivateLaser(false);
 
                     image = imaging.GetNextPicture();
 
                     imageOff = (Image) image.Clone();
                     imageOff.SaveImage(imageFolder, "OffLaserLight", actualSteps, configuration); // for autodesk 123d
 
                     arduino.ActivateLaser();
                 }
 
                 image = imaging.GetNextPicture();
 
                 if (configuration.Places.FileFormat == FileFormat.Pcd)
                     arduino.ActivateLaser(false);
 
                 image.SaveImage(imageFolder, "OnLaserLight", actualSteps, configuration);
 
                 image = TransformImage.CreateGrayImageOfLaser((Bitmap) image, configuration.Filter);
                 image.SaveImage(imageFolder, "LaserLight", actualSteps, configuration);
 
                 Image skeletonImage = TransformImage.SimpleSkeletonizationImage((Bitmap) image);
                 skeletonImage.SaveImage(imageFolder, "Skeleton", actualSteps, configuration);
 
                 points = TransformImage.TransformStepImage(skeletonImage, imageOff, actualSteps,
                     configuration.Motor.MicroStepsEnabled, configuration);
             }
 
             if (configuration.Laser.MotorEnabled)
             {
                 if (configuration.Places.FileFormat == FileFormat.Pcd)
                     arduino.ActivateLaser();
 
                 image = imaging.GetNextPicture();
 
                 float actualX = TransformImage.GetLaserLinePosition(image, configuration.Filter);
                 bool swipeRight = actualX <= configuration.Laser.SwipeMin*configuration.Camera.Width/100;
 
                 if (swipeRight)
                 {
                     while (TransformImage.GetLaserLinePosition(image, configuration.Filter) <
                            configuration.Laser.SwipeMax*configuration.Camera.Width/100)
                     {
                         if (this.ScanWorker.CancellationPending)
                             return null;
 
                         arduino.RotateLaserCw(sweep);
                         
                         image = CaptureSweepImage(actualSteps, imaging, configuration, ref points);
                     }
                 }
                 else
                 {
                     while (TransformImage.GetLaserLinePosition(image, configuration.Filter) >
                            configuration.Laser.SwipeMin*configuration.Camera.Width/100)
                     {
                         if (this.ScanWorker.CancellationPending)
                             return null;
 
                         arduino.RotateLaserCcw(sweep);
 
                         image = CaptureSweepImage(actualSteps, imaging, configuration, ref points);
                     }
                 }
             }
             arduino.RotateTurnTableCw(steps);
 
             return points;
         }

Here is the call graph for this function:

void Simple3DScan.UI.ScanControl.ScanWorker_DoWork	(	object	sender,
		DoWorkEventArgs	e
	)

protected

Handles the DoWork event of the scanWorker control.

Parameters

sender	The source of the event.
e	The DoWorkEventArgs instance containing the event data.

Definition at line 171 of file ScanControl.cs.

         {
             this.StartScanning?.Invoke();
             Precision precision = (Precision)e.Argument;
 
             string imageFolder = ResetImageFolder(this.ConfigurationInformation);
 
             int numberOfTotalSteps;
             Resolution resolution;
             GetResolutionAndSteps(precision, this.ConfigurationInformation, out numberOfTotalSteps, out resolution);
 
             MoveLaserToLeftStartPosition(this.Arduino, this.ImagingControl, this.ConfigurationInformation);
 
             IPointWriter writer;
             if (!this.InitiateWriter(this.Arduino, this.ConfigurationInformation, out writer))
                 return;
 
             if (this.PerformScan(this.Arduino, this.ImagingControl, this.ConfigurationInformation, numberOfTotalSteps, resolution, imageFolder, writer)) return;
 
             if (this.ConfigurationInformation.Places.FileFormat == FileFormat.Ascii)
                 this.Arduino.ActivateLaser(false);
 
             SavePoints(this, writer, this.ConfigurationInformation);
         }

void Simple3DScan.UI.ScanControl.ScanWorker_ProgressChanged	(	object	sender,
		ProgressChangedEventArgs	e
	)

protected

Handles the ProgressChanged event of the ScanWorker control.

Parameters

sender	The source of the event.
e	The ProgressChangedEventArgs instance containing the event data.

Definition at line 202 of file ScanControl.cs.

         {
             this.RadialGaugeProgress.Value = e.ProgressPercentage;
         }

virtual void Simple3DScan.UI.ScanControl.ScanWorker_RunWorkerCompleted	(	object	sender,
		RunWorkerCompletedEventArgs	e
	)

protectedvirtual

Handles the RunWorkerCompleted event of the ScanWorker control.

Parameters

sender	The source of the event.
e	The RunWorkerCompletedEventArgs instance containing the event data.

Definition at line 214 of file ScanControl.cs.

         {
             this.StopScanning?.Invoke();
 
             this.ToggleButtonCapture.ToggleState = ToggleButtonState.Inactive;
             this.ScanWorker.DoWork -= this.ScanWorker_DoWork;
             this.ScanWorker.ProgressChanged -= this.ScanWorker_ProgressChanged;
             this.ScanWorker.RunWorkerCompleted -= this.ScanWorker_RunWorkerCompleted;
             this.Arduino.ActivateLaser(false);
         }

void Simple3DScan.UI.ScanControl.Start ( )

package

Starts this instance.

Definition at line 599 of file ScanControl.cs.

         {
             this.ImagingControl.StartImaging(this.ConfigurationInformation.Camera.Name);
         }

delegate void Simple3DScan.UI.ScanControl.StartScan ( )

void Simple3DScan.UI.ScanControl.Stop ( )

package

Stops this instance.

Definition at line 587 of file ScanControl.cs.

         {
             this.ImagingControl.StopImaging();
             if (this.ScanWorker.IsBusy)
                 this.ScanWorker.CancelAsync();
         }

delegate void Simple3DScan.UI.ScanControl.StopScan ( )

void Simple3DScan.UI.ScanControl.ToggleButtonCapture_Click	(	object	sender,
		EventArgs	e
	)

protected

Handles the Click event of the toggleButtonCapture control.

Parameters

sender	The source of the event.
e	The EventArgs instance containing the event data.

Definition at line 235 of file ScanControl.cs.

         {
             this.RadialGaugeProgress.Value = 0;
 
             if (this.ScanWorker.IsBusy != true)
             {
                 this.ScanWorker.DoWork += this.ScanWorker_DoWork;
                 this.ScanWorker.ProgressChanged += this.ScanWorker_ProgressChanged;
                 this.ScanWorker.RunWorkerCompleted += this.ScanWorker_RunWorkerCompleted;
                 this.ScanWorker.WorkerReportsProgress = true;
                 this.ScanWorker.WorkerSupportsCancellation = true;
                 this.ScanWorker.RunWorkerAsync((Precision)this.RadialSliderPrecision.Value);
             }
             else
                 this.ScanWorker.CancelAsync();
         }

Member Data Documentation

System.Windows.Forms.ComboBox Simple3DScan.UI.ScanControl.ComboBoxCameras

protected

Definition at line 219 of file ScanControl.Designer.cs.

readonly Information Simple3DScan.UI.ScanControl.ConfigurationInformation = Singleton<Config>.Instance.Information

protected

The configuration information

Definition at line 32 of file ScanControl.cs.

CameraControl Simple3DScan.UI.ScanControl.ImagingControl

protected

Definition at line 224 of file ScanControl.Designer.cs.

System.Windows.Forms.Label Simple3DScan.UI.ScanControl.LabelCapture

protected

Definition at line 221 of file ScanControl.Designer.cs.

System.Windows.Forms.Label Simple3DScan.UI.ScanControl.labelPrecision

protected

Definition at line 223 of file ScanControl.Designer.cs.

System.Windows.Forms.Label Simple3DScan.UI.ScanControl.LabelSelectCamera

protected

Definition at line 217 of file ScanControl.Designer.cs.

Syncfusion.Windows.Forms.Gauge.RadialGauge Simple3DScan.UI.ScanControl.RadialGaugeProgress

protected

Definition at line 218 of file ScanControl.Designer.cs.

Syncfusion.Windows.Forms.Tools.RadialSlider Simple3DScan.UI.ScanControl.RadialSliderPrecision

protected

Definition at line 220 of file ScanControl.Designer.cs.

readonly BackgroundWorker Simple3DScan.UI.ScanControl.ScanWorker = new BackgroundWorker()

protected

The scan worker

Definition at line 27 of file ScanControl.cs.

Syncfusion.Windows.Forms.Tools.ToggleButton Simple3DScan.UI.ScanControl.ToggleButtonCapture

protected

Definition at line 222 of file ScanControl.Designer.cs.

readonly Dictionary<string, string> Simple3DScan.UI.ScanControl.VideoSources = new Dictionary<string, string>()

protected

The video sources

Definition at line 42 of file ScanControl.cs.

Property Documentation

ArduinoCommands Simple3DScan.UI.ScanControl.Arduino

getset

The arduino command connection

Definition at line 37 of file ScanControl.cs.

Event Documentation

StartScan Simple3DScan.UI.ScanControl.StartScanning

Occurs when [start scanning].

Definition at line 54 of file ScanControl.cs.

StopScan Simple3DScan.UI.ScanControl.StopScanning

Occurs when [stop scanning].

Definition at line 62 of file ScanControl.cs.

The documentation for this class was generated from the following files:

C:/Entwicklung/Simple3DScan/Simple3DScan/Simple3DScan/UI/ScanControl.cs
C:/Entwicklung/Simple3DScan/Simple3DScan/Simple3DScan/UI/ScanControl.Designer.cs

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Package Functions

Properties

Events

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation

Property Documentation

Event Documentation