Class IronTesseract

IronTesseract is a comprehensive managed class for performing Tesseract OCR in .Net applications.

IronTesseract natively supports Tesseract 3, 4 and 5 engines, and will automatically install all required binaries and language packs (tessdata) files.

Inheritance

System.Object

IronTesseract

Inherited Members

System.Object.Equals(System.Object)

System.Object.Equals(System.Object, System.Object)

System.Object.GetHashCode()

System.Object.GetType()

System.Object.MemberwiseClone()

System.Object.ToString()

System.Object.ReferenceEquals(System.Object, System.Object)

Namespace: IronOcr

Assembly: IronOcr.dll

Syntax

public class IronTesseract

Constructors

IronTesseract()

Public constructor. Creates a default instance of IronTesseract

Declaration

public IronTesseract()

IronTesseract(TesseractConfiguration)

Public constructor. Creates an instance of IronTesseract with a customized TesseractConfiguration.

This allows advanced developers to fine tune Tesseract behavior.

Declaration

public IronTesseract(TesseractConfiguration Configuration)

Parameters

Type	Name	Description
TesseractConfiguration	Configuration

Fields

Configuration

An instance of TesseractConfiguration which allows fine-grained control of the underlying Tesseract OCR Engine.

Options include: Tesseract Engine 4 or 5. Language file detail level. Page Segmentation Mode and access to the entire API of tesseract settings variables.

Declaration

public TesseractConfiguration Configuration

Field Value

Type	Description
TesseractConfiguration

Properties

AzureFunctionWebRootPath

set Azure Function Web Root Path by using ExecutionContext class EX. ExecutionContext executionContext; var engine = new IronTesseract(); engine.AzureFunctionWebRootPath = executionContext.FunctionAppDirectory;

Declaration

public string AzureFunctionWebRootPath { get; set; }

Property Value

Type	Description
System.String

Language

The Natural Language of the documents Which IronTesseract will read.

Default is English. Additional languages can be installed easily using Nuget https://www.nuget.org/packages?q=IronOcr.Languages or downloaded from https://ironsoftware.com/csharp/ocr/languages/

We may use multiple languages packs simultaneously with the UseMultipleLanguages method.

We can use custom Tesseract .tessdata language packs with the UseCustomTesseractLanguageFile(String) method.

Declaration

public OcrLanguage Language { get; set; }

Property Value

Type	Description
OcrLanguage

See Also

OcrLanguage

Methods

AddSecondaryLanguage(OcrLanguage)

IronTesseract will use multiple tesseract language files simultaneously. MultilingualOCR.

Any number of secondary languages may be added. Speed and performance may be affected.

Declaration

public void AddSecondaryLanguage(OcrLanguage SecondaryLanguage)

Parameters

Type	Name	Description
OcrLanguage	SecondaryLanguage	An additional OcrLanguage

AddSecondaryLanguage(String)

IronTesseract will use multiple tesseract language files simultaneously. MultilingualOCR using a custom .traineddata tesseract 3,4 or 5 language file.

Any number of secondary languages may be added. Speed and performance may be affected.

Declaration

public void AddSecondaryLanguage(string CustomLanguagePath)

Parameters

Type	Name	Description
System.String	CustomLanguagePath	File path to a .traineddata tesseract language pack.

ClearSecondaryLanguages()

Removes all languages add by AddSecondaryLanguage(OcrLanguage) or AddSecondaryLanguage(String)

Declaration

public void ClearSecondaryLanguages()

Read(OcrInput)

Reads text from an OcrInput object and returns an OcrResult object.

OcrInput is the preferred input type because it allows for OCR of multi-paged documents, and allows images to be enhanced before OCR to obtain faster, more accurate results.

There are also other overloads of this method that allow for Images and PDFs to be read directly as File paths and Bitmaps.

Declaration

public OcrResult Read(OcrInput Input)

Parameters

Type	Name	Description
OcrInput	Input	An OcrInput document which can contain one or more images and PDFs

Returns

Type	Description
OcrResult	A OcrResult object containing text, and detailed, structured information about the extracted text content.

Read(Image)

Reads text from a System.Drawing.Image Image file and returns an OcrResult object.

Declaration

public OcrResult Read(Image Image)

Parameters

Type	Name	Description
System.Drawing.Image	Image	A System.Drawing.Image or Bitmap

Returns

Type	Description
OcrResult	A OcrResult object containing text, and detailed, structured information about the extracted text content.

Read(Image, Rectangle)

Reads text from a region of a System.Drawing.Image Image file and returns an OcrResult object.

Declaration

public OcrResult Read(Image Image, Rectangle ContentArea)

Parameters

Type	Name	Description
System.Drawing.Image	Image	A System.Drawing.Image or Bitmap
System.Drawing.Rectangle	ContentArea	Specifies a region within the image to extract text from as a System.Drawing.Rectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

Returns

Type	Description
OcrResult	A OcrResult object containing text, and detailed, structured information about the extracted text content.

Read(String)

Reads text from an Image file and returns an OcrResult object.

Declaration

public OcrResult Read(string ImagePath)

Parameters

Type	Name	Description
System.String	ImagePath	Path to an image file.

Returns

Type	Description
OcrResult	A OcrResult object containing text, and detailed, structured information about the extracted text content.

Read(String, Rectangle)

Reads text from a region of an Image file and returns an OcrResult object.

Declaration

public OcrResult Read(string ImagePath, Rectangle ContentArea)

Parameters

Type	Name	Description
System.String	ImagePath	Path to an image file.
System.Drawing.Rectangle	ContentArea	Specifies a region within the image to extract text from as a System.Drawing.Rectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

Returns

Type	Description
OcrResult	A OcrResult object containing text, and detailed, structured information about the extracted text content.

ReadAsync(OcrInput)

Reads text from an OcrInput object and returns an OcrResult object.

OcrInput is the preferred input type because it allows for OCR of multi-paged documents, and allows images to be enhanced before OCR to obtain faster, more accurate results.

There are also other overloads of this method that allow for Images and PDFs to be read directly as File paths and Bitmaps.

Declaration

public Task<OcrResult> ReadAsync(OcrInput Input)

Parameters

Type	Name	Description
OcrInput	Input	An OcrInput document which can contain one or more images and PDFs

Returns

Type	Description
System.Threading.Tasks.Task<OcrResult>	A task that represents the asynchronous read operation. The value of the System.Threading.Tasks.Task`1.Result property contains an OcrResult object containing text, and detailed, structured information about the extracted text content.

ReadAsync(Image, Nullable<Rectangle>)

Reads text from an System.Drawing.Image object and returns an OcrResult object.

Declaration

public Task<OcrResult> ReadAsync(Image Image, Rectangle? ContentArea = default(Rectangle? ))

Parameters

Type	Name	Description
System.Drawing.Image	Image	An System.Drawing.Image object
System.Nullable<System.Drawing.Rectangle>	ContentArea	Specifies a region within the image to extract text from as a System.Drawing.Rectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

Returns

Type	Description
System.Threading.Tasks.Task<OcrResult>	A task that represents the asynchronous read operation. The value of the System.Threading.Tasks.Task`1.Result property contains an OcrResult object containing text, and detailed, structured information about the extracted text content.

ReadAsync(String, Nullable<Rectangle>)

Reads text from an Image file and returns an OcrResult object.

Declaration

public Task<OcrResult> ReadAsync(string ImagePath, Rectangle? ContentArea = default(Rectangle? ))

Parameters

Type	Name	Description
System.String	ImagePath	Path to an image file.
System.Nullable<System.Drawing.Rectangle>	ContentArea	Specifies a region within the image to extract text from as a System.Drawing.Rectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

Returns

Type	Description
System.Threading.Tasks.Task<OcrResult>	A task that represents the asynchronous read operation. The value of the System.Threading.Tasks.Task`1.Result property contains an OcrResult object containing text, and detailed, structured information about the extracted text content.

ReadMultithreaded(OcrInput[])

Reads multiple multiple OcrInput documents in parallel multithreading for enhanced performance.

Declaration

public OcrResult[] ReadMultithreaded(params OcrInput[] Inputs)

Parameters

Type	Name	Description
OcrInput[]	Inputs	Any number of OcrInput documents.

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original OcrInput documents.

ReadMultithreaded(Byte[][])

Reads multiple byte arrays (byte[]) containing image file data in parallel multithreading for enhanced performance.

Reads Jpeg, TIFF, Png, Gif, BMP, WBMP, PDF and many more.

Declaration

public OcrResult[] ReadMultithreaded(params byte[][] ByteArrays)

Parameters

Type	Name	Description
System.Byte[][]	ByteArrays	Any number of images as byte arrays.

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original binary input.

ReadMultithreaded(IEnumerable<OcrInput>)

Reads multiple multiple OcrInput documents in parallel multithreading for enhanced performance.

Declaration

public OcrResult[] ReadMultithreaded(IEnumerable<OcrInput> Inputs)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<OcrInput>	Inputs	Any number of OcrInput documents.

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original OcrInput documents.

ReadMultithreaded(IEnumerable<Byte[]>)

Reads multiple byte arrays (byte[]) containing image file data in parallel multithreading for enhanced performance.

Reads Jpeg, TIFF, Png, Gif, BMP, WBMP, PDF and many more.

Declaration

public OcrResult[] ReadMultithreaded(IEnumerable<byte[]> ByteArrays)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Byte[]>	ByteArrays	Any number of images as byte arrays.

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original binary input.

ReadMultithreaded(IEnumerable<Bitmap>)

Reads multiple bitmaps in parallel multithreading for enhanced performance.

Declaration

public OcrResult[] ReadMultithreaded(IEnumerable<Bitmap> Bitmaps)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Drawing.Bitmap>	Bitmaps	An IEnumerable of Bitmap

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original Bitmap input.

ReadMultithreaded(IEnumerable<Image>)

Reads multiple System.Drawing.Image in parallel multithreading for enhanced performance.

Declaration

public OcrResult[] ReadMultithreaded(IEnumerable<Image> Images)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Drawing.Image>	Images	An IEnumerable of System.Drawing.Image

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original System.Drawing.Image input.

ReadMultithreaded(IEnumerable<Stream>)

Reads multiple System.IO.Streams containing image file data in parallel multithreading for enhanced performance.

Reads Jpeg, TIFF, Png, Gif, BMP, WBMP, PDF and many more.

Declaration

public OcrResult[] ReadMultithreaded(IEnumerable<Stream> Streams)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.IO.Stream>	Streams	Any number of images as System.IO.Streams

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original System.IO.Stream input.

ReadMultithreaded(IEnumerable<String>)

Reads multiple multiple images files (given as file paths) in parallel multithreading for enhanced performance.

Declaration

public OcrResult[] ReadMultithreaded(IEnumerable<string> Paths)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.String>	Paths	Any number of image file paths.

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original input.

ReadMultithreaded(Bitmap[])

Reads multiple bitmaps in parallel multithreading for enhanced performance.

Declaration

public OcrResult[] ReadMultithreaded(params Bitmap[] Bitmaps)

Parameters

Type	Name	Description
System.Drawing.Bitmap[]	Bitmaps	Any number of Bitmaps

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original Bitmap input.

ReadMultithreaded(Image[])

Reads multiple System.Drawing.Image in parallel multithreading for enhanced performance.

Declaration

public OcrResult[] ReadMultithreaded(params Image[] Images)

Parameters

Type	Name	Description
System.Drawing.Image[]	Images	Any number of System.Drawing.Images

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original System.Drawing.Image input.

ReadMultithreaded(Stream[])

Reads multiple System.IO.Streams containing image file data in parallel multithreading for enhanced performance.

Reads Jpeg, TIFF, Png, Gif, BMP, WBMP, PDF and many more.

Declaration

public OcrResult[] ReadMultithreaded(params Stream[] Streams)

Parameters

Type	Name	Description
System.IO.Stream[]	Streams	Any number of images as System.IO.Streams

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original System.IO.Stream input.

ReadMultithreaded(String[])

Reads multiple multiple images files (given as file paths) in parallel multithreading for enhanced performance.

Declaration

public OcrResult[] ReadMultithreaded(params string[] ImagePaths)

Parameters

Type	Name	Description
System.String[]	ImagePaths	Any number of image file paths.

Returns

Type	Description
OcrResult[]	An array of OcrResult objects in the order of the original input.

UseCustomTesseractLanguageFile(String)

IronTesseract will use a tesseract .traineddata language file as its only OCR language.

https://github.com/tesseract-ocr/tessdata

Declaration

public void UseCustomTesseractLanguageFile(string TrainedDataPath)

Parameters

Type	Name	Description
System.String	TrainedDataPath	File path to a .traineddata file. These can be downloaded from https://github.com/tesseract-ocr/tessdata or generated using Tesseract command line.