<= /p>

Users Guide=

File InnovationR= 17;s [OCRTools]

OCR.Net Text API/SDK 5.0=

<= /span>

Last revise= d April 25^th, 2009

Table of Contents

1. Introduction = PAGEREF _Toc228411261 \h 3

1.1. = About OCR.Net Text Component_________________________________________ 3

1.2. = Essential Components__________________________________________________ = 3

2. = Installation = PAGEREF _Toc228411264 \h 3

2.1. = Uninstall Old Versions__________________________________________________ 3

2.2. = UnZip Installation File__________________________________________________ <= !--[if supportFields]> = PAGEREF _Toc228411266 \h 3

2.3. = Run Installation_______________________________________________________ 3

2.4. = Verify Installation______________________________________________________ 4

3. = Setup Development Environment_____________________________________________ 4

3.1. = Add the OCR.Net Component to Toolbox__________________________________ <= /span>4

3.2. = Drag the OCR.Net Component to your Windows Form<= span style=3D'mso-tab-count:1 lined'>________________________ 5

3.3. = Modify Component Properties____________________________________________ 6

3.4. = Registering the Component______________________________________________ 7

3.5. = Obtain Activation Key__________________________________________________ 7

3.6. = Activate your License__________________________________________________ 8

4. = Programming the OCR.Net Component_______________________________________ 9

4.1. = Basic Examples_______________________________________________________ <= !--[if supportFields]> = PAGEREF _Toc228411277 \h 9

4.2. = Threaded Examples____________________________________________________ <= !--[if supportFields]> = PAGEREF _Toc228411278 \h 9

4.3. = Programming the OCR.Net PictureBox___________________________________ = 12

4.4. = Retrieving Processed Results___________________________________________ 16

5. = More Programming Examples_______________________________________________ 16

5.1. = Process using ASP.Net_________________________________________________ = 16

5.2. = Process All Files in a Folder____________________________________________ 17

5.3. = Distributing the OCR.Net Component____________________________________ 17

1.&n= bsp; Introductio= n

1.1. = About OCR.Net Text Component

The OCR.Net Component is a Microsoft Visual Studio .Net component developed entirely within the Microsoft Visual Studio .Net framew= ork and compiled as safe and managed code in the Microsoft 2.0 Framework. =

1.2. = Essential Components

1.2.1.The OCR.Net Component requires CharacterSet Files, Recognition Engine Files, and Tra= ining Files. And these files must be distributed with your application.

Each language has its own set of files, prefixed with the language name, e.g. English_CharacterSet.eng. Only the files for each desired la= nguage are required for processing. = So for example, if processing only for Spanish, then only the corresponding Spanish files are required.

Place the required files in the folder designated in the DefaultFolder property. If the DefaultFolder property is set to blank, then= the files should reside in the working folder (e.g. /bin).

For a complete list of required files, see section 5.3 Distributing the OCR.Net Component.

2.      = Installatio= n

2.1.      = Uninstall Old Versions

If a previous version of the OCRTools Text Component API= /SDK has already been installed and currently exists on your system, uninstall t= he previous installations from the Control Panel using the Add or Remove Programs option.

·      =    OCRTools Text Component API/S= DK 5.0

·      =    Verify that the following folder is deleted from the Program Files folder: \Program Files\OCRTools\OCR=

2.2.      = UnZip Installation File

If the installation file is zipped it, will be named, OCRTools.Zip. The zip file contain= s one installation file called OCRTools_OCR_COM.exe

2.3.      = Run Installation

Execute the installation file: OCRTools_OCR_COM.exe. Follow the instructions provided during the installation. Recommend using the defa= ult values and that the installation is performed as Administrator.<= /span>

2.4.      = Verify Installation

If the OCRTools Text Component API/SDK was successfully installed, the sample applications and demo source code will reside in \Program Files\OCRTools\OCR<= /i>

<= ![endif]>        &= nbsp;

       &n= bsp;

If the OCRTools Text Component API/SDK was successfully installed, the sample applications and demo source code is accessible from = the desktop in the Start/All Programs list

=

<= ![endif]>

3.      = Setup Devel= opment Environment

3.1.      = Add the OCR.Net Component to Toolbox<= /a>

1.      = Right click on the Visual Stud= io Toolbox

2.      = Select the Choose Items option from the Popup Menu

3.      = Browse to the Folder that cont= ains the OCR.Net Component. The file name is OCRTools.dll,

C:\Program Files\OCRTools\OCR\OCR.Net Component\2.0 Framework\OCRToo= ls.dll.

=

<= ![endif]>

3.2.      = Drag the OCR.Net Component to your Windows F= orm

The OCR.Net Component should now appear in the Toolbox, = it will be named OCR. Drag the component to your Form. The Default value will = be OCR1.

=

<= ![endif]>

3.3.      = Modify Component Properties

The OCR.Net Components properties can be changed in the = IDE at design time, or you can set the properties programmatically within your application.

<= ![endif]>

3.4.      = Registering the Component

Registration information is sent via a confirmation email after purchase. Registration information can be entered to the OCR.Net Component Properties from the IDE= at design-time or programmatically in your source code.

Enter the ProductName, CustomerName, OrderID, and Regist= ration Codes into the OCR.Net Component via the component’s Properties Box. = If developing a console application or an ASP.Net webpage, then the registrati= on information can be entered programmatically in your source code:=

=

<= ![endif]>

=

<= ![endif]>

3.5.      = Obtain Activation Key

An Activation Key is required to use the OCR.Net Compone= nt within the Visual Studio 2005 Integrated Development Environment (IDE). The Activate License utility will generate an ActivationKey for your PC.

To obtain an Activation Key, run the ActivateLicense application that installed with your download. = It is located in your Start Menu under= , All Programs/OCRTools 5.0/ActivateLicense 5.0.

Note: An Activat= ionKey is specific to a PC and you must run the Activate License utility from the = PC that you want to activate. The ComputerID displayed in the Activate License utility is the Unique Identifier that is used to specifically identify your= PC. Using your ComputerID and your Registration Information, the Activate Licen= se utility will generate an ActivationKey for your PC.

<= ![endif]>

=

The Activation License utility will return your Activation Key. Enter your Registration Information, and click the Obtain Acti= vation Key automatically via Internet button. Note that you must be connected to the internet, and that it may take a few minutes to obtain the key. You can also retrieve an ActivationKey via the Internet at http://www.OCRTools.com/f= i/Activate.aspx

=

<= ![endif]>

3.6.      = Activate your License

To complete registration, enter the Activation Key into = your OCR.Net Component along with your Registration Information. See 3.4 Registering the Component.

4.&n= bsp;       Programming= the OCR.Net Component

The OCR.Net component can be run in either normal process mode or in threaded mode. Threaded mode allows your application to run with= out locking all resources and allows the user to continue with other operations while the application is processing.

4.1.      = Basic Examples

4.1.1.   Process a File

<= ![endif]>

4.1.2.   Process a Bitmap

<= ![endif]>

4.1.3.   Process a Region of a Bitmap
<= ![endif]>

4.2.      = Threaded Examples

To ru= n the component in threaded mode, execute Process_Start. Threading requires the importing of the System.Threading = namespace.

4.2.1.   Process a File

4.2.2.   Process a Bitmap

4.2.3.   Process a Region of a Bitmap

4.2.4.   Using the Progress Bar

    Private Sub ProcessProgressBar()

<= /span>

        <= /span>OCR1.BitmapImageFile =3D "Sample1.TIF"

<= /span>

        myThread =3D OCR1.Process_Start()

<= /span>

        <= /span>Do While (myThread.IsAlive())

       &n= bsp;    Application.DoEvents()

       &n= bsp;    ProgressBar1.Value =3D = OCR1.Progress

        <= /span>Loop

&n= bsp;

        MsgBox(OCR1.Text)

<= /span>

    End Sub

4.2.5.   Abort Process

4.3.      = Programming the OCR.Net PictureBox

4.3.1.   Assigning a PictureBox to the OCR.Net Component

The OCR.Net Component extends the functionality of the standard PictureBox. The PictureBo= x is NOT required by the OCR.Net Compon= ent. If assigned to the OCR.Net Component, the PictureBox will provide extended image functions such as Lasso/Selection, Resize, and Copy.

The following assigns a PictureBox control to the OCR.Net Component.

<= ![endif]>

4.3.2.   Scaling PictureBox

To utilize the OCR.Net Component PictureBox resize functions, enclose a standard PictureBox control inside a Panel control. Pl= ace the PictureBox control in the upper left hand corner of the Panel, and set = the AutoScroll option to true in the Panel Control.

<= ![endif]>

4.3.3.   Select an Area of the PictureBox

Use the OCR.Net Copy() Function to copy the selected reg= ion of the PictureBox. You can then assign the cropped image to the OCR.Net Component for processing.

<= ![endif]>

4.3.4.   Processing a selection from PictureBox Selection

To process a selection from the PictureBox, Copy the hig= hlighted selection to the OCR.Net Component via the BitmapImage property and Process= the image.

4.3.5.   Retrieving (X,Y) coordinates from PictureBox Selection

The user can select an area of the PictureBox to process. The selected area is highlighted with a dashed box. OCR.Net Component will provide coordinates of the selected box. You can use these coordinates to identify and process select regions of a bitmap. See Example 3 of Demo Sour= ce Code.

<= ![endif]>

The coordinate provided by the OCR.Net Component is the (X,Y) coordinate of the upper left hand corner of the selected box. Also provided is the Width and Height of the Box in Pixels. These values can be retrieved in the PictureBox MouseUp Event.

Prior to processing, set the OCR.Net Components bitmap to the PictureBox original image. SetRegion will set the OCR.Net Components bi= tmap to a defined subset of the original image.

4.3.6.   Closing the PictureBox

To re-assign a new PictureBox to the OCR.Net component at runtime, you will need to Close the existing PictureBox refere= nce, and then reassign the new PictureBox. This is only necessary if you need to reassign another PictureBox control to the OCR.Net component at runtime.

    Private Sub Form1_Activated(ByVal sender As Object, ByVal e As

System.EventArgs) Handles My= Base.Activated

        <= /span>If Not (O= CR1 Is Nothing) Then

       &n= bsp;    OCR1.SetPictureBox(PictureBox1)

            OCR1.PictureB= ox.LoadPictureBox("Sample1.TIF")

        <= /span>End If

&n= bsp;

    End Sub

&n= bsp;

&n= bsp;

    Private Sub Form1_Deactivate(ByVal sender As<= /span> Object, ByVal e As

System.EventArgs) Handles MyBase.Deactivate

        <= /span>If Not (O= CR1 Is Nothing) Then

       &n= bsp;    OCR1.PictureBox.Close()=

        <= /span>End If

&n= bsp;

    End Sub

4.4.      = Retrieving Processed Results

4.4.1.   Retrieving Text Results

Processed text results can be retrieved with either the = Text or ToString() options. The Count property returns the number of processed A= SCII characters.

5.&n= bsp;       More Progra= mming Examples

5.1.      = Process using ASP.Net

You can use the OCR Component in a Web Page or Web Servi= ce using ASP.Net.

·         Copy all the required OCR.Net Component Files to your WebPage bin folder. <= /o:p>

·         Add the OCR.Net Component (OCRTools.dll= ) as a reference in your ASP.Net proj= ect

·         Create an instance of the OCR.Net Component in your source code<= /p>
o&nb= sp;       private OCRTools.OCR OCR1 =3D new OCRTo= ols.OCR();

=

·         Set the DefaultFolder property to your working folder. For example:<= /span>

OCR1.= DefaultFolder =3D Server.MapPath(“.”);

·         Set any other desired OCR.Net Component properties, such as registration codes,= in your source code.

5.2.      = Process All Files in a Folder

5.3.      = Distributing the OCR.Net Component

5.3.1.   The OCR.Net Component

The OCR.Net Component consists of the following DLL. It = must be referenced in your project and distributed with your application.

·         OCRTools.DLL=

·         OCRTools Properties. To distri= bute the OCRTools.DLL with your application, the following component properties = must be assigned.

o&nb= sp;       ProductName<= /i>

o&nb= sp;       CustomerName=

o&nb= sp;       OrderID<= /p>
o&nb= sp;       RegistrationCodes

5.3.2.   Files that must be distributed with your application

The OCR.Net Component requires CharacterSet Files (.chr), Recognition Engine Files (.eng), and Training Files (.trn). And these files must be distributed with your application.

Each language has its own set of files, prefixed with the language name, e.g. English_CharacterSet.eng. Only the files for each desired la= nguage are required for processing. = So for example, if processing only for Spanish, then only the corresponding Spanis= h files are required.

Place the required files in the folder designated in the DefaultFolder property. If the DefaultFolder property is set to blank, then= the files should reside in the working folder (e.g. /bin).

5.3.2.1.        Recognition Engine Files

·         English_CharacterSet.eng<= /o:p>

·         English_UpperCase.eng

·         English_LowerCase.eng

·         English_Numeric.eng=

·         English_Special.eng=

·         Spanish_CharacterSet.eng<= /o:p>

·         Spanish _UpperCase.eng

·         Spanish _LowerCase.eng

·         Spanish _Numeric.eng

·         Spanish _Special.eng

·         Italian_CharacterSet.eng<= /o:p>

·         Italian _UpperCase.eng

·         Italian_LowerCase.eng

·         Italian _Numeric.eng

·         Italian _Special.eng

·         German_CharacterSet.eng

·         German _UpperCase.eng

·         German _LowerCase.eng

·         German _Numeric.eng=

·         German _Special.eng=

·         French_CharacterSet.eng

·         French _UpperCase.eng

·         French _LowerCase.eng

·         French _Numeric.eng=

·         French _Special.eng=

·         Swedish_CharacterSet.eng<= /o:p>

·         Swedish _UpperCase.eng

·         Swedish _LowerCase.eng

·         Swedish _Numeric.eng

·         Swedish _Special.eng

5.3.2.2.        CharacterSet Files

·         English_CharacterSet.chr<= /o:p>

·         Spanish_CharacterSet.chr<= /o:p>

·         Italian_CharacterSet.chr<= /o:p>

·         German_CharacterSet.chr

·         French_CharacterSet.chr

·         Swedish_CharacterSet.chr<= /o:p>

5.3.2.3.        Training Files

·         English_Training.trn

·         Spanish_ Training.trn

·         Italian_ Training.trn

·         German_ Training.trn

·         French_ Training.trn

·         Swedish_ Training.trn

· = OCRTools Text Component API/S= DK 5.0

· = Verify that the following folder is deleted from the Program Files folder: \Program Files\OCRTools\OCR=

4.1.1. Process a File

4.1.2. Process a Bitmap

4.1.3. Process a Region of a Bitmap <= ![endif]>

4.2.1. Process a File

4.2.2. Process a Bitmap

4.2.3. Process a Region of a Bitmap

4.2.4. Using the Progress Bar

4.2.5. Abort Process

4.3.1. Assigning a PictureBox to the OCR.Net Component

4.3.2. Scaling PictureBox

4.3.3. Select an Area of the PictureBox

4.3.4. Processing a selection from PictureBox Selection

4.3.5. Retrieving (X,Y) coordinates from PictureBox Selection

4.3.6. Closing the PictureBox

4.4.1. Retrieving Text Results

5.3.1. The OCR.Net Component

5.3.2. Files that must be distributed with your application

5.3.2.1. Recognition Engine Files

5.3.2.2. CharacterSet Files

5.3.2.3. Training Files

4.1.3. Process a Region of a Bitmap
<= ![endif]>