Sub RunJobAsync( _
   ByVal job As IOcrAutoRecognizeJob _
) 

Visual Basic (Usage)	Copy Code
Dim instance As IOcrAutoRecognizeManager Dim job As IOcrAutoRecognizeJob   instance.RunJobAsync(job)

void RunJobAsync( 
   IOcrAutoRecognizeJob job
)

void RunJobAsync( 
   IOcrAutoRecognizeJob^ job
) 

Parameters

job

The IOcrAutoRecognizeJob to run this parameter cannot be null (Nothing in Visual Basic). Use IOcrAutoRecognizeManager.CreateJob to create a job.

This method will create an internal worker thread and return control immediatly to the called. When the job is completed, the IOcrAutoRecognizeJob.Errors member of job will contain any errors that might have occured during the recognition process. To get notification when the job is completed (whether successfully or with aborted due to errors or through user action), subscribe to the IOcrAutoRecognizeManager.JobCompleted events.

To run a job synchronously, use IOcrAutoRecognizeManager.RunJob.

To use this method, initialize a new OcrAutoRecognizeJobData object with the job's parameters (input image file name, pages, output document format, output document name, optional zones file name, etc.), then use IOcrAutoRecognizeManager.CreateJob to create the IOcrAutoRecognizeJob object passed as job to this method. Finally, call IOcrAutoRecognizeManager.RunJobAsync passing the IOcrAutoRecognizeJob object.

This method will perform the following operations:

1. The IOcrAutoRecognizeManager.JobStarted event is triggered.

2. Creates one ore more IOcrDocument object to store the pages into. The number of OCR documents created is dependant on MaximumThreadsPerJob. If this value is 0 (maximum CPUs/cores) or is greater than 1 and multiple threads is supported by this engine, then more than one document might be created to participate in the recognition process.

3. Loops through the pages specified in OcrAutoRecognizeJobData.FirstPageNumber and in OcrAutoRecognizeJobData.LastPageNumber in OcrAutoRecognizeJobData.ImageFileName and for each page:

   The page is added to its document using IOcrPageCollection.AddPage.

   If OcrAutoRecognizeJobData.ZonesFileName contains a valid multi-page zone file name and has an entry for the current page, then the zones are loaded with IOcrPage.LoadZones(fileName, pageNumber) and applied to the page. If OcrAutoRecognizeJobData.ZonesFileName is a null (Nothing in Visual Basic) reference or it does not contain an equivalant page number, auto-decomposing of the page is performed instead with IOcrPage.AutoZone.

   IOcrPage.Recognize is called to get the OCR data of the page.

   If multiple documents are used or current number of recognized pages is greater than the maximum specified in MaximumPagesBeforeLtd, then current recognition data is saved to a temporary LTD file and the OCR document is cleared.

4. When all pages are processed their saved to result file name specified in OcrAutoRecognizeJobData.DocumentFileName using the format specified OcrAutoRecognizeJobData.Format If LTD was used, the temporary file is converted to the final document using DocumentWriter.Convert and optionally DocumentWriter.AppendLtd.

5. All OCR documents and temporary files are deleted.

6. The IOcrAutoRecognizeManager.JobCompleted event is triggered.

7. You can use the IOcrAutoRecognizeManager.JobProgress event to show the operation progress or to abort it if threading is not used. For more information and an example, refer to Leadtools.Forms.Ocr.OcrProgressCallback.

8. You can use the IOcrAutoRecognizeManager.JobOperation event to get information regarding the current operation being performed. For more information and an example, refer to IOcrAutoRecognizeManager.JobOperation.

The IOcrAutoRecognizeManager interface also has the following options to use with this method:

Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7

Reference