The MaximumThreadsPerJob Property is available as an add-on to the LEADTOOLS Document and Medical Imaging toolkits.
Gets or sets a value that indicates the maximum number of threads to use when recognizing a document.
Syntax
| Visual Basic (Declaration) | |
|---|---|
Property MaximumThreadsPerJob As Integer | |
| Visual Basic (Usage) |  Copy Code |
|---|---|
Dim instance As IOcrAutoRecognizeManager Dim value As Integer instance.MaximumThreadsPerJob = value value = instance.MaximumThreadsPerJob | |
| C# | |
|---|---|
int MaximumThreadsPerJob {get; set;} | |
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.Example
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, IOcrAutoRecognizeManager.RunJob and IOcrAutoRecognizeManager.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.
Requirements
Target Platforms: Microsoft .NET Framework 2.0, Windows 2000, Windows XP, Windows Server 2003 family, Windows Server 2008 family, Windows Vista, Windows 7