LEADTOOLS OCR (Leadtools.Forms.Ocr assembly)
LEAD Technologies, Inc

MaximumThreadsPerJob Property






Gets or sets a value that indicates the maximum number of threads to use when recognizing a document. .NET support
Syntax
int MaximumThreadsPerJob {get; set;}
'Declaration
 
Property MaximumThreadsPerJob As Integer
'Usage
 
Dim instance As IOcrAutoRecognizeManager
Dim value As Integer
 
instance.MaximumThreadsPerJob = value
 
value = instance.MaximumThreadsPerJob
int MaximumThreadsPerJob {get; set;}
get_MaximumThreadsPerJob();
set_MaximumThreadsPerJob(value);
property int MaximumThreadsPerJob {
   int get();
   void set (    int value);
}

Property Value

An System.Int32 value that indicates the maximum number of threads to use when recognizing a document. Must be greater than or equals to 0 and less than or equals to 64. Default value is 0.
Remarks

A value of 0 means use maximum number of CPUs/cores available to the machine. The engine will read this value from System.Environment.ProcessorCount.

The IOcrAutoRecognizeManager supports converting a single document using multiple threads using the Run, RunJob and RunJobAsync methods. You can enable this feature by setting MaximumThreadsPerJob to 0 (for maximum CPUs/cores) or a value greater than 1.

Not all OCR engines support multi-threading in this fashion. If multi-threading supported, then IsMultiThreadedSupported will be true and the value of MaximumThreadsPerJob is used.

If the OCR engine does not support multi-threading, then IsMultiThreadedSupported will be false and the value of MaximumThreadsPerJob is not used (ignored).

The following table lists the LEADTOOLS OCR engines and whether they support multi-threading in IOcrAutoRecognizeManager:

OCR Engine

Multi-threaded supported in IOcrAutoRecognizeManager
OcrEngineType.Advantage/> Win32 (x86) version Yes
OcrEngineType.Advantage/> x64 version Yes
OcrEngineType.Professional/> Win32 (x86) version Yes
OcrEngineType.Professional/> x64 version No
OcrEngineType.Plus/> Win32 (x86) version No
OcrEngineType.Plus/> x64 version No
OcrEngineType.Arabic/> Win32 (x86) version No
OcrEngineType.Arabic/> x64 version No

Note: This property is not used and will be ignored when using engine native format (DocumentFormat.User and IOcrDocumentManager.EngineFormat).

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.

Example
For an example, refer to RunJob.
Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

Reference

IOcrAutoRecognizeManager Interface
IOcrAutoRecognizeManager Members
Programming with the LEADTOOLS .NET OCR
Multi-Threading with LEADTOOLS OCR
LEADTOOLS OCR Thunk Server

 

 


Products | Support | Contact Us | Copyright Notices

© 2006-2012 All Rights Reserved. LEAD Technologies, Inc.

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