Class OcrInput

OcrInput provides a robust class for preparing one or more Image Files, PDFs, System.Drawing Objects, Streams and Binary Image data for OCR. Instances of OcrInput can be read by the IronTesseract class.

We recognise that much of the quality of OCR results depends on preparing images to be read. This class allows developers to enhance their scanned documents provide faster, more accurate OCR results using filters such as: EnhanceResolution(Int32), DeNoise(), ToGrayScale(), Deskew(OcrLanguage, Int32, OrientationConfidence), Rotate(Double) and Sharpen().

Supports for multi-paged OCR input.

Inheritance

System.Object

OcrInput

Implements

System.IDisposable

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 OcrInput : IDisposable

Constructors

OcrInput(CropRectangle, Object[])

Create a new OcrInput object populated with one or more images sharing a common crop area.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public OcrInput(CropRectangle ContentArea, params object[] Inputs)

Parameters

Type	Name	Description
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Object[]	Inputs	Any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap.

OcrInput(Byte[])

Create a new OcrInput object populated with an Image file as binary data.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(byte[] Bytes)

Parameters

Type	Name	Description
System.Byte[]	Bytes	Bytes of an Image or PDF file.

OcrInput(Byte[], CropRectangle)

Create a new OcrInput object populated with an Image file as binary data.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(byte[] Bytes, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Byte[]	Bytes	Bytes of an Image or PDF file.
CropRectangle	ContentArea	Specifies a region of each image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

OcrInput(IEnumerable<Byte[]>)

Create a new OcrInput object populated with the binary data of multiple Images with a common ContentArea.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<byte[]> Bytes)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Byte[]>	Bytes	An IEnumerable of byte arrays containing Image or PDF files.

OcrInput(IEnumerable<Byte[]>, CropRectangle)

Create a new OcrInput object populated with the binary data of multiple Images with a common ContentArea.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<byte[]> Bytes, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Byte[]>	Bytes	An IEnumerable of byte arrays containing Image or PDF files.
CropRectangle	ContentArea	Specifies a region of each image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

OcrInput(IEnumerable<Bitmap>)

Create a new OcrInput object populated with multiple System.Drawing.Bitmap.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<Bitmap> Bitmaps)

Parameters

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

OcrInput(IEnumerable<Bitmap>, CropRectangle)

Create a new OcrInput object populated with multiple System.Drawing.Bitmaps sharing a common ContentArea.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<Bitmap> Bitmaps, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Drawing.Bitmap>	Bitmaps	An IEnumerable of System.Drawing.Bitmap.
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

OcrInput(IEnumerable<Image>)

Create a new OcrInput object populated with any number of System.Drawing.Image.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<Image> Images)

Parameters

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

OcrInput(IEnumerable<Image>, CropRectangle)

Create a new OcrInput object populated with any number of System.Drawing.Image sharing a common ContentArea.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<Image> Images, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Drawing.Image>	Images	Any Number of System.Drawing.Image
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

OcrInput(IEnumerable<Stream>)

Create a new OcrInput object populated with multiple images as Streams.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<Stream> Streams)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.IO.Stream>	Streams	Steam containing an Image or PDF file.

OcrInput(IEnumerable<Stream>, CropRectangle)

Create a new OcrInput object populated with multiple images as Streams sharing a common ContentArea.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<Stream> Streams, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.IO.Stream>	Streams	Steam containing an Image or PDF file.
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

OcrInput(IEnumerable<String>)

Create a new OcrInput object populated with multiple Image files.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<string> FilePaths)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.String>	FilePaths	An IEnumerable of paths to Image or PDF files.

OcrInput(IEnumerable<String>, CropRectangle)

Create a new OcrInput object populated with multiple Image files with a common ContentArea.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(IEnumerable<string> FilePaths, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.String>	FilePaths	An IEnumerable of paths to Image or PDF files.
CropRectangle	ContentArea	Specifies a region of each image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

OcrInput(Bitmap)

Create a new OcrInput object populated with a System.Drawing.Bitmap.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(Bitmap Bitmap)

Parameters

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

OcrInput(Bitmap, CropRectangle)

Create a new OcrInput object populated with a System.Drawing.Bitmap.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(Bitmap Bitmap, CropRectangle ContentArea)

Parameters

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

OcrInput(Image)

Create a new OcrInput object populated with a System.Drawing.Image.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(Image Image)

Parameters

Type	Name	Description
System.Drawing.Image	Image	System.Drawing.Image

OcrInput(Image, CropRectangle)

Create a new OcrInput object populated with a specified region of a System.Drawing.Image.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(Image Image, CropRectangle ContentArea)

Parameters

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

OcrInput(Stream)

Create a new OcrInput object populated with image data as a Stream.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(Stream Stream)

Parameters

Type	Name	Description
System.IO.Stream	Stream	Steam containing an Image or PDF file.

OcrInput(Stream, CropRectangle)

Create a new OcrInput object populated with image data as a Stream.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(Stream Stream, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.IO.Stream	Stream	Steam containing an Image or PDF file.
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

OcrInput(Object[])

Create a new OcrInput object to which images and PDF pages may be added.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(params object[] Inputs)

Parameters

Type	Name	Description
System.Object[]	Inputs	Any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap.

OcrInput(String)

Create a new OcrInput object populated with an Image file or PDF document.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(string FilePath)

Parameters

Type	Name	Description
System.String	FilePath	Path to an Image or PDF file.

OcrInput(String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with an Image file.

This class is IDisposable and is best initiated with a 'using' statement.

Declaration

public OcrInput(string FilePath, CropRectangle ContentArea, int? DPI = null)

Parameters

Type	Name	Description
System.String	FilePath	Path to an Image or PDF file.
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Optional target DPI for the input content

Fields

TargetDPI

The resolution that low resolution images will be enhanced to. To disable upscaling, set this to 0 (will affect read quality). See .

TargetDPI also determines the resolution at which PDF documents will be sampled.

Declaration

public int TargetDPI

Field Value

Type	Description
System.Int32

Properties

Pages

Access to every OcrInput.Page within this OcrInput

Declaration

public List<OcrInput.Page> Pages { get; }

Property Value

Type	Description
System.Collections.Generic.List<OcrInput.Page>

Title

A title for the OcrInput document. This is relevant as it becomes metadata when exporting searchable PDFs and HOCR files from IronTesseract results.

See SaveAsSearchablePdf(String) and SaveAsHocrFile(String)

Declaration

public string Title { get; set; }

Property Value

Type	Description
System.String

Methods

Add(OcrInput, CropRectangle)

Adds all pages of an OcrInput to this OcrInput.

Declaration

public void Add(OcrInput imageAsOcrInput, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
OcrInput	imageAsOcrInput	OcrInput object to be added to this OcrInput.
CropRectangle	ContentArea	Area to use of each page of the OcrInput object.

Add(OcrInput.Page, CropRectangle)

Adds a OcrInput OcrInput.Page to this OcrInput.

Declaration

public void Add(OcrInput.Page imageAsOcrInputPage, CropRectangle ContentArea)

Parameters

Type	Name	Description
OcrInput.Page	imageAsOcrInputPage	Page to be added.
CropRectangle	ContentArea	Area of the page to be added.

Add(Byte[], CropRectangle)

Adds a byte array containing the binary data of an image to this OcrInput.

Declaration

public void Add(byte[] imageAsByteArray, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.Byte[]	imageAsByteArray	A byte[] containing an image. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.
CropRectangle	ContentArea	Area of the image to use with IronOCR.

Add(IEnumerable<OcrInput.Page>, CropRectangle)

Adds a IEnumerable of OcrInput OcrInput.Page to this OcrInput.

Declaration

public void Add(IEnumerable<OcrInput.Page> imagesAsOcrInputPages, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<OcrInput.Page>	imagesAsOcrInputPages	Pages to be added.
CropRectangle	ContentArea	Area of every page to be added.

Add(IEnumerable<Byte[]>, CropRectangle)

Adds a IEnumerable of byte array containing the binary data of images to this OcrInput.

Declaration

public void Add(IEnumerable<byte[]> imagesAsByteArrays, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Byte[]>	imagesAsByteArrays
CropRectangle	ContentArea	Area of the every image to use with IronOCR.

Add(IEnumerable<Bitmap>, CropRectangle)

Adds a IEnumerable of System.Drawing.Bitmaps to this OcrInput.

Declaration

public void Add(IEnumerable<Bitmap> imageAsBitmaps, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Drawing.Bitmap>	imageAsBitmaps	An IEnumerable of managed Bitmap objects.
CropRectangle	ContentArea	Area of the every image to use with IronOCR.

Add(IEnumerable<Image>, CropRectangle)

Adds an IEnumerable of System.Drawing.Images to this OcrInput.

Declaration

public void Add(IEnumerable<Image> images, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.Drawing.Image>	images	IEnumerable of managed Image objects.
CropRectangle	ContentArea	Area of the every image to use with IronOCR.

Add(IEnumerable<Stream>, CropRectangle)

Adds an IEnumerable of System.IO.Stream of image raw data to this OcrInput.

Declaration

public void Add(IEnumerable<Stream> sourceStreams, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.IO.Stream>	sourceStreams	A IEnumerable of Streams containing raw data of images. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.
CropRectangle	ContentArea	Area of the every image to use with IronOCR.

Add(IEnumerable<String>, CropRectangle)

Adds images to this this OcrInput.

Declaration

public void Add(IEnumerable<string> imageFilePaths, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.Collections.Generic.IEnumerable<System.String>	imageFilePaths	IEnumerable of image file paths. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.
CropRectangle	ContentArea	Area of the every image to use with IronOCR.

Add(Bitmap, CropRectangle)

Adds a System.Drawing.Bitmap to this OcrInput.

Declaration

public void Add(Bitmap imageAsBitmap, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.Drawing.Bitmap	imageAsBitmap	A managed Bitmap object.
CropRectangle	ContentArea	Area of the image to use with IronOCR.

Add(Image, CropRectangle)

Adds a System.Drawing.Image to this OcrInput.

Declaration

public void Add(Image image, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.Drawing.Image	image	A managed Image object.
CropRectangle	ContentArea	Area of the image to use with IronOCR.

Add(Stream, CropRectangle)

Adds a System.IO.Stream containing the raw data of an image to this OcrInput.

Declaration

public void Add(Stream sourceStream, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.IO.Stream	sourceStream	A Stream containing an image. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.
CropRectangle	ContentArea	Area of the image to use with IronOCR.

Add(String, CropRectangle)

Adds an image to this this OcrInput.

Declaration

public void Add(string imageFilePath, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.String	imageFilePath	File path to an image file. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.
CropRectangle	ContentArea	Area of the image to use with IronOCR.

AddFrameFromTiff(Byte[], Int32, CropRectangle)

Adds a single frame (a page) from a Multi-frame TIFF file to the OcrInput document. The Tiff may be input as a file, byte array or stream.

Each Frame will become a page of this OcrInput

Declaration

public void AddFrameFromTiff(byte[] TiffBytes, int FrameIndex, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.Byte[]	TiffBytes	A byte[] containing a TIFF file.
System.Int32	FrameIndex	Zero based frame number.
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddFrameFromTiff(Stream, Int32, CropRectangle)

Adds a single frame (a page) from a Multi-frame TIFF file to the OcrInput document. The Tiff may be input as a file, byte array or stream.

Each Frame will become a page of this OcrInput

Declaration

public void AddFrameFromTiff(Stream TiffStream, int FrameIndex, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.IO.Stream	TiffStream	A Stream containing a TIFF file.
System.Int32	FrameIndex	Zero based frame number.
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddFrameFromTiff(String, Int32, CropRectangle)

Adds a single frame (a page) from a Multi-frame TIFF file to the OcrInput document. The Tiff may be input as a file, byte array or stream.

Each Frame will become a page of this OcrInput

Declaration

public void AddFrameFromTiff(string TiffPath, int FrameIndex, CropRectangle ContentArea = null)

Parameters

Type	Name	Description
System.String	TiffPath	A file path to a TIFF image.
System.Int32	FrameIndex	Zero based frame number.
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddImage(Byte[])

Adds a byte array containing the binary data of an image to this OcrInput.

Declaration

public void AddImage(byte[] ImageBytes)

Parameters

Type	Name	Description
System.Byte[]	ImageBytes	A byte[] containing an image. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.

AddImage(Byte[], CropRectangle)

Adds a byte array containing the binary data of an image to this OcrInput.

Declaration

public void AddImage(byte[] ImageBytes, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Byte[]	ImageBytes	A byte[] containing an image. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddImage(Bitmap)

Adds a System.Drawing.Bitmap to this OcrInput.

Declaration

public void AddImage(Bitmap Bitmap)

Parameters

Type	Name	Description
System.Drawing.Bitmap	Bitmap	A managed Bitmap object.

AddImage(Bitmap, CropRectangle)

Adds a System.Drawing.Bitmap to this OcrInput.

Declaration

public void AddImage(Bitmap Bitmap, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Drawing.Bitmap	Bitmap	A managed Bitmap object.
CropRectangle	ContentArea	Optionally specifies a region of the bitmap to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddImage(Bitmap, CropRectangle[])

Adds a System.Drawing.Bitmap to this OcrInput with many content area regions. If an empty array is supplied, will use whole image instead.

Note: Output PDF of SaveAsSearchablePdf when using multiple Crop Rectangles will generate one page per Rectangle/>

Declaration

public void AddImage(Bitmap Bitmap, CropRectangle[] Rectangles)

Parameters

Type	Name	Description
System.Drawing.Bitmap	Bitmap	A managed Bitmap object.
CropRectangle[]	Rectangles	Array of crop rectangles of various content regions.

AddImage(Image)

Adds a System.Drawing.Image to this OcrInput.

Declaration

public void AddImage(Image Image)

Parameters

Type	Name	Description
System.Drawing.Image	Image	A managed Image object.

AddImage(Image, CropRectangle)

Adds a System.Drawing.Image to this OcrInput.

Declaration

public void AddImage(Image Image, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Drawing.Image	Image	A managed Image object.
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddImage(Image, CropRectangle[])

Adds a System.Drawing.Image to this OcrInput with many content area regions. If an empty array is supplied, will use whole image instead.

Note: Output PDF of SaveAsSearchablePdf when using multiple Crop Rectangles will generate one page per Rectangle/>

Declaration

public void AddImage(Image Image, CropRectangle[] Rectangles)

Parameters

Type	Name	Description
System.Drawing.Image	Image	A managed Image object.
CropRectangle[]	Rectangles	Array of crop rectangles of various content regions.

AddImage(Stream)

Adds a System.IO.Stream containing the raw data of an image to this OcrInput.

Declaration

public void AddImage(Stream ImageStream)

Parameters

Type	Name	Description
System.IO.Stream	ImageStream	A Stream containing an image. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.

AddImage(Stream, CropRectangle)

Adds a System.IO.Stream containing the raw data of an image to this OcrInput.

Declaration

public void AddImage(Stream ImageStream, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.IO.Stream	ImageStream	A Stream containing an image. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddImage(String)

Adds an image file to this OcrInput.

Declaration

public void AddImage(string ImagePath)

Parameters

Type	Name	Description
System.String	ImagePath	File path to an image file. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.

AddImage(String, CropRectangle)

Adds an image file to this OcrInput.

Declaration

public void AddImage(string ImagePath, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.String	ImagePath	File path to an image file. Supported formats include JPEG, TIFF, GIF, PNG, PDF, BMP.
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddMultiFrameTiff(Byte[])

Adds a byte[] containing the binary data of a TIFF image with multiple pages to this OcrInput.

Declaration

public void AddMultiFrameTiff(byte[] TiffBytes)

Parameters

Type	Name	Description
System.Byte[]	TiffBytes	A byte[] containing a TIFF file.

AddMultiFrameTiff(Byte[], CropRectangle)

Adds a byte[] containing the binary data of a TIFF image with multiple pages to this OcrInput.

Declaration

public void AddMultiFrameTiff(byte[] TiffBytes, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.Byte[]	TiffBytes	A byte[] containing a TIFF file.
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddMultiFrameTiff(Stream)

Adds a Stream containing the binary data of a TIFF image with multiple pages to this OcrInput.

Declaration

public void AddMultiFrameTiff(Stream TiffStream)

Parameters

Type	Name	Description
System.IO.Stream	TiffStream	A System.IO.Stream containing a TIFF file .

AddMultiFrameTiff(Stream, CropRectangle)

Adds a Stream containing the binary data of a TIFF image with multiple pages to this OcrInput.

Declaration

public void AddMultiFrameTiff(Stream TiffStream, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.IO.Stream	TiffStream	A System.IO.Stream containing a TIFF file .
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddMultiFrameTiff(String)

Adds a Multi-frame TIFF file to the OcrInput document.

Each Frame will become a page of this OcrInput

Declaration

public void AddMultiFrameTiff(string ImagePath)

Parameters

Type	Name	Description
System.String	ImagePath	A file path to a TIFF image.

AddMultiFrameTiff(String, CropRectangle)

Adds a Multi-frame TIFF file to the OcrInput document.

Each Frame will become a page of this OcrInput

Declaration

public void AddMultiFrameTiff(string ImagePath, CropRectangle ContentArea)

Parameters

Type	Name	Description
System.String	ImagePath	A file path to a TIFF image.
CropRectangle	ContentArea	Optionally specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.

AddPdf(Byte[], String, CropRectangle, Nullable<Int32>)

Adds all pages of a PDF document to this OcrInput.

Declaration

public void AddPdf(byte[] PdfBytes, string Password = null, CropRectangle ContentArea = null, int? DPI = 0)

Parameters

Type	Name	Description
System.Byte[]	PdfBytes	Binary data of a PDF file
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

AddPdf(Stream, String, CropRectangle, Nullable<Int32>)

Adds all pages of a PDF document to this OcrInput.

Declaration

public void AddPdf(Stream PdfStream, string Password = null, CropRectangle ContentArea = null, int? DPI = 0)

Parameters

Type	Name	Description
System.IO.Stream	PdfStream	System.IO.Stream containing a PDF
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

AddPdf(String, Int32, String)

Adds all pages of a PDF document to this OcrInput.

Declaration

public void AddPdf(string PdfPath, int DPI, string Password = null)

Parameters

Type	Name	Description
System.String	PdfPath	String file path to the PDF
System.Int32	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI
System.String	Password	Optional Password to unlock an encrypted or protected PDF

AddPdf(String, String, CropRectangle, Nullable<Int32>)

Adds all pages of a PDF document to this OcrInput.

Declaration

public void AddPdf(string PdfPath, string Password = null, CropRectangle ContentArea = null, int? DPI = 0)

Parameters

Type	Name	Description
System.String	PdfPath	String file path to the PDF
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

AddPdfPage(Byte[], Int32, String, CropRectangle, Nullable<Int32>)

Adds one page of a PDF document to this OcrInput.

Declaration

public void AddPdfPage(byte[] PdfBytes, int Page, string Password = null, CropRectangle ContentArea = null, int? DPI = 0)

Parameters

Type	Name	Description
System.Byte[]	PdfBytes	Binary data of a PDF file
System.Int32	Page	The page number within the PDF to read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

AddPdfPage(Stream, Int32, String, CropRectangle, Nullable<Int32>)

Adds one page of a PDF document to this OcrInput.

Declaration

public void AddPdfPage(Stream PdfStream, int Page, string Password = null, CropRectangle ContentArea = null, int? DPI = 0)

Parameters

Type	Name	Description
System.IO.Stream	PdfStream	System.IO.Stream containing a PDF
System.Int32	Page	The page number within the PDF to read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

AddPdfPage(String, Int32, String, CropRectangle, Nullable<Int32>)

Adds one page of a PDF document to this OcrInput.

Declaration

public void AddPdfPage(string PdfPath, int Page, string Password = null, CropRectangle ContentArea = null, int? DPI = 0)

Parameters

Type	Name	Description
System.String	PdfPath	String file path to the PDF
System.Int32	Page	The page number within the PDF to read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

AddPdfPages(Byte[], IEnumerable<Int32>, String, CropRectangle, Nullable<Int32>)

Adds selected pages of a PDF document to this OcrInput.

Declaration

public void AddPdfPages(byte[] PdfBytes, IEnumerable<int> Pages, string Password = null, CropRectangle ContentArea = null, int? DPI = 0)

Parameters

Type	Name	Description
System.Byte[]	PdfBytes	Binary data of a PDF file
System.Collections.Generic.IEnumerable<System.Int32>	Pages	The page numbers within the PDF to read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

AddPdfPages(Stream, IEnumerable<Int32>, String, CropRectangle, Nullable<Int32>)

Adds selected pages of a PDF document to this OcrInput.

Declaration

public void AddPdfPages(Stream PdfStream, IEnumerable<int> Pages, string Password = null, CropRectangle ContentArea = null, int? DPI = 0)

Parameters

Type	Name	Description
System.IO.Stream	PdfStream	System.IO.Stream containing a PDF
System.Collections.Generic.IEnumerable<System.Int32>	Pages	The page numbers within the PDF to read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

AddPdfPages(String, IEnumerable<Int32>, String, CropRectangle, Nullable<Int32>)

Adds selected pages from a PDF document into this OcrInput.

Declaration

public void AddPdfPages(string PdfPath, IEnumerable<int> Pages, string Password = null, CropRectangle ContentArea = null, int? DPI = 0)

Parameters

Type	Name	Description
System.String	PdfPath	String file path to the PDF
System.Collections.Generic.IEnumerable<System.Int32>	Pages
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

AddRange(OcrInput)

Combines 2 instances of OcrInput, appending pages to the end of this OcrInput document.

Declaration

public void AddRange(OcrInput Range)

Parameters

Type	Name	Description
OcrInput	Range	An Ocr Input to be appended to this instance.

ApplyMultipleFilters(OcrFilters, Double, Int32, Int32, Int32, Boolean)

Apply multiple imaging filters using the specified paramaeters

Declaration

public void ApplyMultipleFilters(OcrFilters filters, double Rotation = 0, int Snap = 45, int MaxWidth = 0, int MaxHeight = 0, bool Use3x3 = false)

Parameters

Type	Name	Description
OcrFilters	filters	Filters to apply
System.Double	Rotation	Rotation amount. Required when using the Rotation filter. Rotate
System.Int32	Snap	Optional snap amount when using the Deskew filter. Defaults to 45 degrees.Deskew
System.Int32	MaxWidth	Maximum width. Required when using the Scale filter. Scale
System.Int32	MaxHeight	Maximum height. Required when using the Scale filter. Scale
System.Boolean	Use3x3	Optional morphology when using the Dilate or Erode filter. Dilate

Remarks

This method serves as an alternative way to apply multiple filters. Filters are applied in what is typically the optimal order.

Exceptions

Type	Condition
System.ArgumentOutOfRangeException

Binarize()

This image filter turns every pixel black or white with no middle ground. May Improve OCR performance cases of very low contrast of text to background.

Declaration

public OcrInput Binarize()

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

Contrast()

Increases contrast automatically. This filter often improves OCR speed and accuracy in low contrast scans. Flattens Alpha channels to white.

Declaration

public OcrInput Contrast()

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

DeepCleanBackgroundNoise()

Heavy background noise removal. Only use this filter in case extreme document background noise is known, because this filter will also risk reducing OCR accuracy of clean documents, and is very CPU expensive.

Declaration

public OcrInput DeepCleanBackgroundNoise()

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

DeNoise()

Removes digital noise. This filter should only be used where noise is expected. Flattens Alpha channels to white.

Declaration

public OcrInput DeNoise()

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

Deskew(IronTesseract, Int32, OrientationConfidence)

Rotates an image so it is the right way up and orthogonal . This is very useful for OCR because Tesseract tolerance for skewed scans can be as low as 5 degrees.

This also helps when producing searchable PDF documents from IronTesseract because the pages will likely all be the right way up.

This version of Deskew combines two strategies: OSD character orientation recognition and Hough transform in combination with smart default settings.

Declaration

public bool Deskew(IronTesseract TesseractInstance, int Snap = 45, OrientationConfidence Confidence = null)

Parameters

Type	Name	Description
IronTesseract	TesseractInstance	Reads OcrLanguage settings from your IronTesseract instance to help detect letters and numbers to straighten pages. If you wish to use multiple languages please use the Deskew(IronTesseract, Int32, OrientationConfidence) overload.
System.Int32	Snap	As the OSD strategy can only orient a page by multiples of 90 degrees, this parameter will use a Hugh Transform to straighten pages to true orthogonality.
OrientationConfidence	Confidence	Optional OrientationConfidence class used to control and measure OSD by way of confidence thresholds.

Returns

Type	Description
System.Boolean	Returns a boolean result of whether or not IronOCR was able to detect image orientation. True = Deskew was applied. False = Failed to detect image orientation and image remains unchanged.

Deskew(OcrLanguage, Int32, OrientationConfidence)

Rotates an image so it is the right way up and orthogonal . This is very useful for OCR because Tesseract tolerance for skewed scans can be as low as 5 degrees.

This also helps when producing searchable PDF documents from IronTesseract because the pages will likely all be the right way up.

This version of Deskew combines two strategies: OSD character orientation recognition and Hough transform in combination with smart default settings.

Declaration

public bool Deskew(OcrLanguage CharacterDetectionLanguage = OcrLanguage.English, int Snap = 45, OrientationConfidence Confidence = null)

Parameters

Type	Name	Description
OcrLanguage	CharacterDetectionLanguage	An OcrLanguage used to help detect letters and numbers to straighten pages. If you wish to use multiple languages please use the Deskew(IronTesseract, Int32, OrientationConfidence) overload.
System.Int32	Snap	As the OSD strategy can only orient a page by multiples of 90 degrees, this parameter will use a Hugh Transform to straighten pages to true orthogonality.
OrientationConfidence	Confidence	Optional OrientationConfidence class used to control and measure OSD by way of confidence thresholds.

Returns

Type	Description
System.Boolean	Returns a boolean result of whether or not IronOCR was able to detect image orientation. True = Deskew was applied. False = Failed to detect image orientation and image remains unchanged.

Deskew(Int32)

Rotates an image so it is the right way up and orthogonal . This is very useful for OCR because Tesseract tolerance for skewed scans can be as low as 5 degrees.

This also helps when producing searchable PDF documents from IronTesseract because the pages will likely all be the right way up.

This version uses only Hough transform to make minor correction. Example: pages that where put in a scanner at a slight angle.

Declaration

public bool Deskew(int Snap)

Parameters

Type	Name	Description
System.Int32	Snap	As the OSD strategy can only orient a page by multiples of 90 degrees, this parameter will use a Hugh Transform to straighten pages

Returns

Type	Description
System.Boolean	Returns a boolean result of whether or not IronOCR was able to detect image orientation. True = Deskew was applied. False = Failed to detect image orientation and image remains unchanged.

Dilate(Boolean)

Advanced Morphology. Opposite of Erode(Boolean).

Declaration

public OcrInput Dilate(bool use3x3 = false)

Parameters

Type	Name	Description
System.Boolean	use3x3	2x2 is default morphology

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

Dispose()

OcrInput is IDisposable. For best practice and to avoid memory leaks, remember to dispose, or initialize instances with a "using" statement.

Declaration

public void Dispose()

EnhanceResolution(Int32)

Enhances the resolution of low quality images. This filter is not often needed because and TargetDPI will automatically catch and resolve low resolution inputs.

May not work for all images if their metadata is corrupted.

Declaration

public OcrInput EnhanceResolution(int TargetDPI = 225)

Parameters

Type	Name	Description
System.Int32	TargetDPI	The target DPI to resample to.

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

Erode(Boolean)

Advanced Morphology. Opposite of Dilate(Boolean).

Declaration

public OcrInput Erode(bool use3x3 = false)

Parameters

Type	Name	Description
System.Boolean	use3x3	2x2 is default morphology

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

Finalize()

OcrInput has a safe finaliser that cleans up undisposed native images in memory.

Declaration

protected void Finalize()

FindMultipleTextRegions(Double, Int32, Boolean, Boolean)

Use computer vision to detect areas which contain text elements and divide the input into separate images based on text regions.

Declaration

public void FindMultipleTextRegions(double Scale = 0, int DilationAmount = -1, bool Binarize = true, bool Invert = false)

Parameters

Type	Name	Description
System.Double	Scale	(Only used during text region detection) Resolution scale factor. Image width and height will be multiplied by this value.
System.Int32	DilationAmount	(Only used during text region detection) Dilation amount, in pixels. Text areas width and height will be increased by this value.
System.Boolean	Binarize	(Only used during text region detection) True to convert the image to black and white, False otherwise
System.Boolean	Invert	(Only used during text region detection) True to invert image colors during binarization, False otherwise

Remarks

Useful for generating several OCR results from a single image/page

FindTextRegion(Double, Int32, Boolean, Boolean)

Use computer vision to detect regions which contain text elements on each page

Declaration

public void FindTextRegion(double Scale = 0, int DilationAmount = -1, bool Binarize = true, bool Invert = false)

Parameters

Type	Name	Description
System.Double	Scale	(Only used during text region detection) Resolution scale factor. Image width and height will be multiplied by this value.
System.Int32	DilationAmount	(Only used during text region detection) Dilation amount, in pixels. Text areas width and height will be increased by this value.
System.Boolean	Binarize	(Only used during text region detection) True to convert the image to black and white, False otherwise
System.Boolean	Invert	(Only used during text region detection) True to invert image colors when binarizing, False otherwise

FromPdf(Byte[], String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with a PDF as binary data.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdf(byte[] PdfBytes, string Password = null, CropRectangle ContentArea = null, int? DPI = null)

Parameters

Type	Name	Description
System.Byte[]	PdfBytes	The PDF document as binary data in memory.
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

Returns

Type	Description
OcrInput

FromPdf(Stream, String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with a PDF as a Stream.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdf(Stream PdfStream, string Password = null, CropRectangle ContentArea = null, int? DPI = null)

Parameters

Type	Name	Description
System.IO.Stream	PdfStream	The PDF document as a System.IO.Stream.
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

Returns

Type	Description
OcrInput

FromPdf(String, Int32, String)

Create a new OcrInput object populated with a PDF.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdf(string PdfPath, int DPI, string Password = null)

Parameters

Type	Name	Description
System.String	PdfPath	File path to the PDF
System.Int32	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI
System.String	Password	Optional Password to unlock an encrypted or protected PDF

Returns

Type	Description
OcrInput

FromPdf(String, String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with a PDF.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdf(string PdfPath, string Password = null, CropRectangle ContentArea = null, int? DPI = null)

Parameters

Type	Name	Description
System.String	PdfPath	File path to the PDF
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

Returns

Type	Description
OcrInput

FromPdfPage(Byte[], Int32, String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with a single page from a PDF as binary data.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdfPage(byte[] PdfBytes, int Page, string Password = null, CropRectangle ContentArea = null, int? DPI = null)

Parameters

Type	Name	Description
System.Byte[]	PdfBytes	The PDF document as binary data in memory.
System.Int32	Page	The page number within the PDF to read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

Returns

Type	Description
OcrInput

FromPdfPage(Stream, Int32, String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with a single page from a PDF as a Stream.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdfPage(Stream PdfStream, int Page, string Password = null, CropRectangle ContentArea = null, int? DPI = null)

Parameters

Type	Name	Description
System.IO.Stream	PdfStream	The PDF document as a System.IO.Stream.
System.Int32	Page	The page number within the PDF to read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

Returns

Type	Description
OcrInput

FromPdfPage(String, Int32, String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with a single page of a PDF.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdfPage(string PdfPath, int Page, string Password = null, CropRectangle ContentArea = null, int? DPI = null)

Parameters

Type	Name	Description
System.String	PdfPath	File path to the PDF
System.Int32	Page	Which page of the PDF to read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

Returns

Type	Description
OcrInput

FromPdfPages(Byte[], IEnumerable<Int32>, String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with multiple pages from a PDF as binary data.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdfPages(byte[] PdfBytes, IEnumerable<int> Pages, string Password = null, CropRectangle ContentArea = null, int? DPI = null)

Parameters

Type	Name	Description
System.Byte[]	PdfBytes	The PDF document as binary data in memory.
System.Collections.Generic.IEnumerable<System.Int32>	Pages	List which pages of the PDF which will be read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

Returns

Type	Description
OcrInput

FromPdfPages(Stream, IEnumerable<Int32>, String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with multiple selected pages from a PDF as a Stream.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdfPages(Stream PdfStream, IEnumerable<int> Pages, string Password = null, CropRectangle ContentArea = null, int? DPI = null)

Parameters

Type	Name	Description
System.IO.Stream	PdfStream	The PDF document as a System.IO.Stream.
System.Collections.Generic.IEnumerable<System.Int32>	Pages	The pages of the PDF to read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

Returns

Type	Description
OcrInput

FromPdfPages(String, IEnumerable<Int32>, String, CropRectangle, Nullable<Int32>)

Create a new OcrInput object populated with multiple pages from a PDF.

This class is IDisposable and is best initiated with a 'using' statement.

This constructor accepts any number of images as File Paths, Streams, Byte Arrays, System.Drawing.Image and System.Drawing.Bitmap. Each will become a OcrInput.Page.

Declaration

public static OcrInput FromPdfPages(string PdfPath, IEnumerable<int> Pages, string Password = null, CropRectangle ContentArea = null, int? DPI = null)

Parameters

Type	Name	Description
System.String	PdfPath	File path to the PDF
System.Collections.Generic.IEnumerable<System.Int32>	Pages	List which pages of the PDF will be read. Zero based (first page is number 0)
System.String	Password	Optional Password to unlock an encrypted or protected PDF
CropRectangle	ContentArea	Specifies a region of the image to extract text from as a CropRectangle with X, Y Width and Height in pixels. Setting a ContentArea can improve OCR speed.
System.Nullable<System.Int32>	DPI	Resolution at which to sample the PDF. If null or zero will use TargetDPI

Returns

Type	Description
OcrInput

HoughTransformStraighten(Int32)

Uses a Hough Transform to rotate and image to the nearest 90 degrees of straightness. This is very useful for OCR because Tesseract tolerance for skewed scans can be as low as 5 degrees.

You may also find the Deskew(IronTesseract, Int32, OrientationConfidence) method of useful as it can use cOCR character detection to get a more accurate page straightening.

Declaration

public OcrInput HoughTransformStraighten(int MaxAngle = 45)

Parameters

Type	Name	Description
System.Int32	MaxAngle	Maximum angle of skew to correct for. Higher values can lead to more opportunity for correction, but may be slower and more prone to error including upside down pages.

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

Invert(Boolean)

Inverts every color. E.g. White becomes black : black becomes white.

Declaration

public OcrInput Invert(bool GrayScale = true)

Parameters

Type	Name	Description
System.Boolean	GrayScale	Optionally remove all color channels and return a GrayScale image.

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

OrientPagesWithOSD(IronTesseract, OrientationConfidence)

Declaration

public OcrInput OrientPagesWithOSD(IronTesseract TesseractInstance, OrientationConfidence Confidence = null)

Parameters

Type	Name	Description
IronTesseract	TesseractInstance	Reads OcrLanguage settings from your IronTesseract instance to help detect letters and numbers to straighten pages. If you wish to use multiple languages please use the Deskew(IronTesseract, Int32, OrientationConfidence) overload.
OrientationConfidence	Confidence	Optional OrientationConfidence class used to control and measure OSD by way of confidence thresholds.

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

OrientPagesWithOSD(OcrLanguage, OrientationConfidence)

Uses Tesseract "Orientation & Script Detection: to turn OcrInput pages the right way up in multiples of 90 degress.

Declaration

public OcrInput OrientPagesWithOSD(OcrLanguage CharacterDetectionLanguage = OcrLanguage.English, OrientationConfidence Confidence = null)

Parameters

Type	Name	Description
OcrLanguage	CharacterDetectionLanguage	An OcrLanguage used to help detect letters and numbers to straighten pages. If you wish to use multiple languages please use the Deskew(IronTesseract, Int32, OrientationConfidence) overload.
OrientationConfidence	Confidence	Optional OrientationConfidence class used to control and measure OSD by way of confidence thresholds.

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

PageCount()

The number of OcrInput.Pages currently present in this OcrInput

Declaration

public int PageCount()

Returns

Type	Description
System.Int32

ReplaceColor(Color, Color, Int32)

Declaration

public OcrInput ReplaceColor(Color currentColor, Color newColor, int tolerance = 10)

Parameters

Type	Name	Description
System.Drawing.Color	currentColor	Current Color
System.Drawing.Color	newColor	New Color
System.Int32	tolerance	Tolerance Value

Returns

Type	Description
OcrInput

Rotate(Double)

Rotates images by a number of degrees clockwise. For anti-clockwise, use negative numbers. Also see IronOcr.OcrInput.Deskew(System.Int32,System.Boolean)

Declaration

public OcrInput Rotate(double Degrees)

Parameters

Type	Name	Description
System.Double	Degrees	A number of clockwise degrees.

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

SaveAsImages(String, OcrInput.ImageType)

Exports an OcrInput object as Images

Declaration

public string[] SaveAsImages(string Prefix = "export_of_page", OcrInput.ImageType Extension = OcrInput.ImageType.PNG)

Parameters

Type	Name	Description
System.String	Prefix	Will save images at {Prefix}_(page_number).{Extension}. May include a fully qualified file path.
OcrInput.ImageType	Extension	Output file extension in lower-case.

Returns

Type	Description
System.String[]	Array of saved image file names. Can be multiple if OcrInput used has multiple pages.

Exceptions

Type	Condition
System.Exception	Throws an exception if there are no pages. See OcrInput.Page

Scale(Int32, Boolean)

Scales OCRInput pages proportionally.

Declaration

public OcrInput Scale(int Percentage, bool ScaleCropArea = true)

Parameters

Type	Name	Description
System.Int32	Percentage	The percentage scale. 100 = no effect.
System.Boolean	ScaleCropArea	Should associated crop areas also be scaled proportionally (recommended true)

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

Scale(Int32, Int32, Boolean)

Scales the OCRInput pages up in size.

Declaration

public OcrInput Scale(int MaxWidth, int MaxHeight, bool ScaleCropArea = true)

Parameters

Type	Name	Description
System.Int32	MaxWidth	Maximum width in pixels.
System.Int32	MaxHeight	Maximum height in pixels.
System.Boolean	ScaleCropArea	Should associated crop areas also be scaled proportionally (recommended true)

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

Sharpen()

Sharpens blurred OCR Documents. Flattens Alpha channels to white.

Declaration

public OcrInput Sharpen()

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

StampCropRectangleAndSaveAs(CropRectangle, Color, String, OcrInput.ImageType)

Saves a copy of the image with a rectangle applied and to visualize and debug where CropRectangle will be applied when using CropRectangle on your image.

Declaration

public string[] StampCropRectangleAndSaveAs(CropRectangle cropRectangle, Color rectangleColor, string Prefix = "rectangle_on_page", OcrInput.ImageType extension = OcrInput.ImageType.PNG)

Parameters

Type	Name	Description
CropRectangle	cropRectangle	Use a CropRectangle to debug the area that will be scanned on an image.
System.Drawing.Color	rectangleColor	Color of rectangle drawn. Red is recommended for easy contrast.
System.String	Prefix	Will save images at {Prefix}_(page_number).{Extension}. May include a fully qualified file path.
OcrInput.ImageType	extension	Output file extension in lower-case.

Returns

Type	Description
System.String[]	Array of saved image file names. Can be multiple if OcrInput used has multiple pages.

Exceptions

Type	Condition
System.Exception	Throws an exception if there are no pages. See OcrInput.Page

ToGrayScale()

This image filter turns every pixel into a shade of grayscale. Unlikely to improve OCR accuracy but may improve speed.

Declaration

public OcrInput ToGrayScale()

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

WithTitle(String)

Adds a Title to the OcrInput Document. This title will be used when calling SaveAsHocrFile(String) and SaveAsSearchablePdf(String)

Declaration

public OcrInput WithTitle(string Title)

Parameters

Type	Name	Description
System.String	Title	The document title as a string.

Returns

Type	Description
OcrInput	This OcrInput object allowing for LINQ style fluent notation.

Implements

System.IDisposable

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)