ImageKit.NET2: Frequently Asked Questions

A. The ImageKit.NET2 assemblies are digitally signed. To validate an application using a digitally signed assembly, a PC may try to download the CRL (certificate revocation list). If the PC is not connected to the internet, the application will not start up until after the attempt to download the CRL has timed out.

To avoid this problem you can set the PC (that is not connected to the internet) so that it will not download the CRL in the following way:

     1. From the Control Panel, choose Internet Options
     2. In the Internet Properties Dialog, select the Advanced tab
     3. Uncheck the box called "Check for Publisher's Certificate Revocation"

Another way to avoid this problem for PCs (that are not connected to the internet) and have .NET Framework 2.0 Service Pack 1 or above, you can set the following in the application's exe.config:

     <configuration>
       <runtime>
         <generatePublisherEvidence enabled="false"/>
       </runtime>
     </configuration>

This will disable the check to CRL when the application starts up.

A. Please refer to the following example.

When using an image set in the Image property:

In VB.NET:
     Dim inchX, inchY As Single
     Dim cmX, cmY As Single

     Dim bmp As System.Drawing.Bitmap = ImageKit1.Image

     If bmp.HorizontalResolution <> 0 Then
          'into inches
          inchX = bmp.Width / bmp.HorizontalResolution
          'from inches to centimeters
          cmX = inchX * 2.54
     End If

     If bmp.VerticalResolution <> 0 Then
          'into inches
          inchY = bmp.Height / bmp.VerticalResolution
          'from inches to centimeters
          cmY = inchY * 2.54
     End If

In C#:
     float inchX, inchY;
     float cmX, cmY;

     System.Drawing.Bitmap bmp = (System.Drawing.Bitmap)imageKit1.Image;
     if (bmp.HorizontalResolution != 0)
     {
          //into inches
          inchX = bmp.Width / bmp.HorizontalResolution;
          //from inches to centimeters
          cmX = inchX * (float)2.54;
     }

     if (bmp.VerticalResolution != 0)
     {
          //into inches
          inchY = bmp.Height / bmp.VerticalResolution;
          //from inches to centimeters
          cmY = inchY * (float)2.54;
     }

A. Yes, but it has to run as a 32 bit application. Also, the target platform must be (x86). If the application is built with a target platform of (x64) or (Any CPU), then the TWAIN application will not run.

A. You will need to disable your Managed Debug Assistant (MDA). For details, please refer to:

http://msdn.microsoft.com/en-us/library/d21c150d.aspx

A. Use the Effect interface's Rotation method and set the angle parameter to 0. To create a mirror image, set the xTurn parameter to True. To flip the image, set the yTurn parameter to True.

A. It is not possible to scan multiple areas simultaneously. For that reason, you must execute multiple scans to scan different areas of the document. See example code below:

To perform multiple scans of the document plate:

In 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 use a negative number

     'the first scan area
     'set the area to be scanned
     ImageKit1.Scan.Rect = New RectangleF(0, 0, 1, 1)
     'set other necessary scan properties here
     ImageKit1.Scan.Execute()

     'the second scan area
     'set the area to be scanned
     ImageKit1.Scan.Rect = New RectangleF(3, 3, 1, 1)
     'set other necessary scan properties here
     ImageKit1.Scan.Execute()

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

In 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 use a negative number

     //the first scan area
     //set the area to be scanned
     imageKit1.Scan.Rect = new RectangleF(0, 0, 1, 1)
     //set other necessary scan properties here
     imageKit1.Scan.Execute();

     //the second scan area
     //set the area to be scanned
     imageKit1.Scan.Rect = new RectangleF(3, 3, 1, 1);
     //set other necessary scan properties here
     imageKit1.Scan.Execute();

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

Be sure to any necessary codein the AfterScan event.

If using an ADF, it will not be possible to scan multiple times for each sheet of paper. You will have to scan all the paper setting the first area, then place the paper into the ADF again and scan for the second area, and so on.

A. Confirm that your datasource supports automatic paper detection by using the IsCapabilitySupported method. If your datasource supports automatic paper detection then set the PaperSize property to UndefinedSize and set the BorderDetection property to True. Note that there are some datasources that work regardless of what value is set in the BorderDetection property.

A.
1) If the datasource supports pre-determined sizes:
Set the scan area and set the PaperSize property to UserSize (or to a negative number).

2) If the datasource does not support pre-determined sizes: Set the scan area and set the PaperSize property to UserSize.

A. The ImageKit.NET2 Scan control supports the custom capabilities of 3 scanner manufacturers; Canon, Epson, and Panasonic. Below is a list of the custom capabilites:

Canon (DR Scanner):

Dropout Color
Auto Detect Paper Size
Moire Filter
Autodetect Color/B&W
Rotate Image
Autodetect Text Orientation
Highlight Edge
Skip Blank Page
Punch Hole Removal

Epson:

Extended UI Mode (Automatic, Home, Office, Professional, etc.)
Rotate Back Of Page
Adjust Scan Speed
Unsharp Mask
Moire Filter
Autodetect Paper Size
Gamma Correction
Autodetect Color/B&W
Skip Blank Page
Punch Hole Removal

Panasonic:

Autodetect Color/B&W
Multi-stream
Dynamic Threshold
Adjust Scan Speed
Image Quality
Deskew Smoothing
Skip Blank Page
Punch Hole Removal

A. In your project, please make sure that all of the necessary ImageKit.NET2 assemblies are properly referenced. Listed below is the control name and the assemblies that must be referenced.

WinForm
(1) When using the ImageKit control (Newtone.ImageKit.Win.ImageKit.dll):
Newtone.ImageKit.Common.dll, Newtone.ImageKit.Effect.dll, Newtone.ImageKit.File.dll, Newtone.ImageKit.Scan.dll
(2) When using the Thumbnail control (Newtone.ImageKit.Win.Thumbnail.dll):
Newtone.ImageKit.Common.dll, Newtone.ImageKit.File.dll
(3) When using the Play, Preview, or Record controls (Newtone.ImageKit.Win.WebCamera.dll):
Newtone.ImageKit.Common.dll

WebForm
(1) When using the ImageKit control (Newtone.ImageKit.Web.ImageKit.dll):
Newtone.ImageKit.Common.dll, Newtone.ImageKit.File.dll
(2)When using the Thumbnail control (Newtone.ImageKit.Web.Thumbnail.dll):
Newtone.ImageKit.Common.dll, Newtone.ImageKit.File.dll