LEADTOOLS OCR (Leadtools.Forms.Ocr assembly) Send comments on this topic. | Back to Introduction - All Topics | Help Version 17.0.3.29
IOcrAutoRecognizeManager Interface
See Also  Members  
Leadtools.Forms.Ocr Namespace : IOcrAutoRecognizeManager Interface



Provides support for the one shot "fire and forget" approach to OCR suitable for unattended recognition.

Syntax

Visual Basic (Declaration) 
Public Interface IOcrAutoRecognizeManager
Visual Basic (Usage)Copy Code
Dim instance As IOcrAutoRecognizeManager
C# 
public interface IOcrAutoRecognizeManager
C++/CLI 
public interface class IOcrAutoRecognizeManager

Example

This example will convert TIF files in a source folder to PDF in a destination folder

For an example on how to run multiple jobs simultaneously in multiple threads with synchronization and aborting support, refer to IOcrAutoRecognizeManager.RunJob.

Remarks

You can access the instance of the IOcrAutoRecognizeManager used by an IOcrEngine through the IOcrEngine.AutoRecognizeManager property.

The members of this interface will let you create a document from an image file on disk with optional progress and status monitors.

You can use the Run methods to convert in one line of code an image on disk to a final document with any of the document formats supported by this IOcrEngine.

You can also create jobs using the IOcrAutoRecognizeManager.CreateJob method and then run them synchronously through IOcrAutoRecognizeManager.RunJob or asynchronously through IOcrAutoRecognizeManager.RunJobAsync.

The IOcrAutoRecognizeManager interface also has the following options to use with the Run, IOcrAutoRecognizeManager.RunJob and IOcrAutoRecognizeManager.RunJobAsync methods:

Member Description
MaximumPagesBeforeLtd

Add support for converting a document with unlimited number of pages. An OCR recognition operation on a document that contains a large amount of pages (10 and more) might result in an out of memory error.

All of the LEADTOOLS OCR engines supports saving the intermediate recognition results to a temporary LTD file (DocumentFormat.LTD). The result of subsequent pages will be appended to this temporary file. When all the pages of the document have been recognized, the engine will convert the temporary LTD file to the desired output format.

The MaximumPagesBeforeLtd property defines the maximum number of pages processed as a whole. For example, if the original document has 20 pages and the value of this property is 8, the engine will recognize the first 8 pages and saves the result to a temporary file, recognizes the second 8 pages and append the results, and finally, recognize the last 4 pages and convert the temporary documentto the final format.
PreprocessPageCommands

Holds an array of OcrAutoPreprocessPageCommand items to control what auto-preprocess operation to perform on each page document prior to recognition.
MaximumThreadsPerJob

Maximum number of threads to use per job. You can instruct IOcrAutoRecognizeManager to use all available machine CPUs/cores when recognizing a document. This will greatly reduce the time required to finish the OCR operation.
JobErrorMode

Ability to resume on none critical errors. For example, if a source document has a page that could not be recognized. The offending page will be added to the final document as a graphics images and recognition will continue to the next page.
IOcrAutoRecognizeManager.JobStarted, IOcrAutoRecognizeManager.JobProgress, IOcrAutoRecognizeManager.JobOperation and IOcrAutoRecognizeManager.JobCompleted events

Events to track when both synchronous and asynchronous jobs has started, being run and completed.
AbortAllJobs

Aborts all running and pending jobs.
EnableTrace

Output debug messages to the standard .NET trace listeners.

Some OCR engine types support creating multi-threaded documents by creating one IOcrEngine and multiple IOcrDocument or IOcrAutoRecognizeJob each in its own dedicated threads. For more information, refer to Multi-Threading with LEADTOOLS OCR.

Requirements

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

See Also

IOcrAutoRecognizeManager requires an OCR module license and unlock key. For more information, refer to: Imaging Pro/Document/Medical Features