ImageKit.NET: Frequently Asked Questions

A. Yes, but it must run as a 32 bit application. What is more, in applications developed in Visual Studio 2005 and 2008, it is necessary to build the application with the target format set to "x86". If the target format is set to "any CPU", the application will not run on a 64 bit OS.

A. Disable the Managed Debugging Assistant (MDA). For more information, please refer to the following MSDN article:
http://msdn.microsoft.com/en-us/library/d21c150d.aspx

A. Use the Effect.Rotation method. Set the angle parameter to 0. Then, to "mirror" the image, set the xTurn parameter to true. This will reverse the image along the X axis. To "flip" the image, set the yTurn parameter to true. This will reverse the image along its Y axis.

A. It is not possible to scan multiple areas simultaneously so you must execute the scan multiple times:

Example: Scanning multiple times from the document plate

VB.NET:

If ImageKit1.Scan.Initialize(Me.Handle, 1, 0, "1.00", "NEWTONE Corp.", "ImageKit", "ImageKit.NET Scan Sample") = False Then Exit Sub
ImageKit1.Scan.ClearProperty()
ImageKit1.Scan.DataSourceName = "xxxxxxx"  'Datasource name
If ImageKit1.Scan.OpenDataSource() = False Then
   ImageKit1.Scan.Terminate()
   Exit Sub
End If

ImageKit1.Scan.TransferMode = ScanTransfer.Memory
ImageKit1.Scan.Compression = ScanCompression.None
ImageKit1.Scan.UserInterface = ScanUserInterface.Suppress
ImageKit1.Scan.Mode = ScanMode.DocumentPlate
ImageKit1.Scan.Unit = ScanUnit.Inch
ImageKit1.Scan.PaperSize = ScanPaperSize.UserSize  'or default value

'First scan
'set the scanning area
ImageKit1.Scan.Rect = New RectangleF(0, 0, 1, 1)
'set other necessary properties here
ImageKit1.Scan.Execute()

'Second scan
'set the scanning area
ImageKit1.Scan.Rect = New RectangleF(3, 3, 1, 1)
'set other necessary properties here
ImageKit1.Scan.Execute()

ImageKit1.Scan.CloseDataSource()
ImageKit1.Scan.Terminate()

C#:

if (imageKit1.Scan.Initialize(this.Handle, 1, 0, "1.00", "NEWTONE Corp.", "ImageKit", "ImageKit.NET Scan Sample") == false) return;
imageKit1.Scan.ClearProperty();
imageKit1.Scan.DataSourceName = 'xxxxxxx';  //Datasource name
if (imageKit1.Scan.OpenDataSource() == false)
{
   imageKit1.Scan.Terminate();
   return;
}

imageKit1.Scan.TransferMode = ScanTransfer.Memory;
imageKit1.Scan.Compression = ScanCompression.None;
imageKit1.Scan.UserInterface = ScanUserInterface.Suppress;
imageKit1.Scan.Mode = ScanMode.DocumentPlate;
imageKit1.Scan.Unit = ScanUnit.Inch;
imageKit1.Scan.PaperSize = ScanPaperSize.UserSize;  //or default value

//First scan
//set the scanning area
imageKit1.Scan.Rect = new RectangleF(0, 0, 1, 1);
//set other necessary properties here
imageKit1.Scan.Execute();

//Second scan
//set the scanning area
imageKit1.Scan.Rect = new RectangleF(3, 3, 1, 1);
//set other necessary properties here
imageKit1.Scan.Execute();

imageKit1.Scan.CloseDataSource();
imageKit1.Scan.Terminate();

Note: Appropriate code to display or save scanned data should be written in the AfterScan event.

A. To confirm that your scanner supports automatic paper detection, use the IsCapSupported method. If the scan datasource supports automatic detection, set the PaperSize to UndefinedSize and the BorderDetection to True. For some datasources, the BorderDetection property value is ignored.

A. Please refer to the following code:

1) To draw text to the ImageKit control:

VB.NET:
Dim g As Graphics = ImageKit1.CreateGraphics()
Dim drawFont As Font = new Font("Arial", 16)
Dim drawBrush As SolidBrush = new SolidBrush(Color.Black)
g.DrawString("Sample Text", drawFont, drawBrush, 150.0, 50.0)
g.Dispose()
Note: When the image is redisplayed, the text will disappear

C#:
Graphics g = imageKit1.CreateGraphics();
Font drawFont = new Font("Arial", 16);
SolidBrush drawBrush = new SolidBrush(Color.Black);
g.DrawString("Sample Text", drawFont, drawBrush, 150.0F, 50.0F);
g.Dispose();
Note: When the image is redisplayed, the text will disappear

2) To draw text to the image:

VB.NET:

Dim newGraphics As Graphics = Graphics.FromImage(newImage)
Dim drawFont As Font = New Font("Arial", 16)
Dim drawBrush As SolidBrush = New SolidBrush(Color.Black)
newGraphics.DrawString("Sample Text", drawFont, drawBrush, 150.0, 50.0)
newGraphics.Dispose()
ImageKit1.Image = newImage
If bitCount < = 8 Then
   ImageKit1.Effect.ConvertColor(bitCount, False, False, 128)
End If

C#:

int bitCount = imageKit1.BitCount;
if (bitCount < = 8)
{
   imageKit1.Effect.SourceMask = null;
   imageKit1.Effect.ConvertColor(24, false, false, 128);
}
Image newImage = imageKit1.Image;
Graphics newGraphics = Graphics.FromImage(newImage);
Font drawFont = new Font("Arial", 16);
SolidBrush drawBrush = new SolidBrush(Color.Black);
newGraphics.DrawString("Sample Text", drawFont, drawBrush, 150.0F, 50.0F);
newGraphics.Dispose();
imageKit1.Image = newImage;
if (bitCount < = 8)
   imageKit1.Effect.ConvertColor(bitCount, false, false, 128);
imageKit1.Refresh();

A. Please refer to the following code:

To change the resolution value to 300 for the image set in the Image property:

VB.NET:
Dim bmp As System.Drawing.Bitmap = ImageKit1.Image.Clone()
bmp.SetResolution(300, 300)
ImageKit1.Image = bmp.Clone()

C#:
System.Drawing.Bitmap bmp = (System.Drawing.Bitmap)imageKit1.Image.Clone();
bmp.SetResolution(300, 300);

A. The total display area of the Thumbnail control is divided by the number of rows and number of columns to get size of an individual thumbnail cell (minus border width, cell spacing, etc). The display area within this thumbnail cell will have a width of 80% of the thumbnail cell's width and a height of 80% of the thumbnail cell's height. The thumbnail image will be scaled to fit within this display area and centered within the thumbnail cell. This is the maximum size of the thumbnail image. To adjust the thumbnail image size (up to this maximum size), use the ImageSize property.

A. Please refer to the following VB.NET and C# code:

VB.NET:

Private Sub Thumbnail1_DragDrop(ByVal sender As Object, ByVal e As System.Windows.Forms.DragEventArgs) Handles Thumbnail1.DragDrop

     Dim FileName As String() = DirectCast(e.Data.GetData(DataFormats.FileDrop), String())
End Sub

C#:

private void thumbnail1_Private Sub Thumbnail1_DragDrop(object sender, System.Windows.Forms.DragEventArgs e)
{
     string[] FileName = (string [])e.Data.GetData(DataFormats.FileDrop);
}