com.itextpdf.pdfocr

Class OcrPdfCreator

java.lang.Object

com.itextpdf.pdfocr.OcrPdfCreator

public class OcrPdfCreator
extends Object

OcrPdfCreator is the class that creates PDF documents containing input images and text that was recognized using provided IOcrEngine. OcrPdfCreator provides possibilities to set list of input images to be used for OCR, to set scaling mode for images, to set color of text in output PDF document, to set fixed size of the PDF document's page and to perform OCR using given images and to return PdfDocument as result. OCR is based on the provided IOcrEngine (e.g. tesseract reader). This parameter is obligatory and it should be provided in constructor or using setter.

Constructor Summary

Constructors

Constructor and Description
OcrPdfCreator(IOcrEngine ocrEngine) Creates a new OcrPdfCreator instance.
OcrPdfCreator(IOcrEngine ocrEngine, OcrPdfCreatorProperties ocrPdfCreatorProperties) Creates a new OcrPdfCreator instance.

Method Summary

Modifier and Type	Method and Description
com.itextpdf.kernel.pdf.PdfDocument	createPdf(List<File> inputImages, com.itextpdf.kernel.pdf.PdfWriter pdfWriter) Performs OCR with set parameters using provided IOcrEngine and creates PDF using provided PdfWriter.
com.itextpdf.kernel.pdf.PdfDocument	createPdfA(List<File> inputImages, com.itextpdf.kernel.pdf.PdfWriter pdfWriter, com.itextpdf.kernel.pdf.PdfOutputIntent pdfOutputIntent) Performs OCR with set parameters using provided IOcrEngine and creates PDF using provided PdfWriter and PdfOutputIntent.
IOcrEngine	getOcrEngine() Gets used IOcrEngine.
OcrPdfCreatorProperties	getOcrPdfCreatorProperties() Gets properties for OcrPdfCreator.
void	setOcrEngine(IOcrEngine reader) Sets IOcrEngine reader object to perform OCR.
void	setOcrPdfCreatorProperties(OcrPdfCreatorProperties ocrPdfCreatorProperties) Sets properties for OcrPdfCreator.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

OcrPdfCreator

public OcrPdfCreator(IOcrEngine ocrEngine)

Creates a new OcrPdfCreator instance.

Parameters:

ocrEngine - IOcrEngine selected OCR Reader

OcrPdfCreator

public OcrPdfCreator(IOcrEngine ocrEngine,
                     OcrPdfCreatorProperties ocrPdfCreatorProperties)

Creates a new OcrPdfCreator instance.

Parameters:

ocrEngine - selected OCR Reader IOcrEngine

ocrPdfCreatorProperties - set of properties for OcrPdfCreator

Method Detail

getOcrPdfCreatorProperties

public final OcrPdfCreatorProperties getOcrPdfCreatorProperties()

Gets properties for OcrPdfCreator.

Returns:

set properties OcrPdfCreatorProperties

setOcrPdfCreatorProperties

public final void setOcrPdfCreatorProperties(OcrPdfCreatorProperties ocrPdfCreatorProperties)

Sets properties for OcrPdfCreator.

Parameters:

ocrPdfCreatorProperties - set of properties OcrPdfCreatorProperties for OcrPdfCreator

createPdfA

public final com.itextpdf.kernel.pdf.PdfDocument createPdfA(List<File> inputImages,
                                                            com.itextpdf.kernel.pdf.PdfWriter pdfWriter,
                                                            com.itextpdf.kernel.pdf.PdfOutputIntent pdfOutputIntent)
                                                     throws OcrException

Performs OCR with set parameters using provided IOcrEngine and creates PDF using provided PdfWriter and PdfOutputIntent. PDF/A-3u document will be created if provided PdfOutputIntent is not null.

Parameters:

inputImages - List of images to be OCRed

pdfWriter - the PdfWriter object to write final PDF document to

pdfOutputIntent - PdfOutputIntent for PDF/A-3u document

Returns:

result PDF/A-3u PdfDocument object

Throws:

OcrException - if it was not possible to read provided or default font

createPdf

public final com.itextpdf.kernel.pdf.PdfDocument createPdf(List<File> inputImages,
                                                           com.itextpdf.kernel.pdf.PdfWriter pdfWriter)
                                                    throws OcrException

Performs OCR with set parameters using provided IOcrEngine and creates PDF using provided PdfWriter.

Parameters:

inputImages - List of images to be OCRed

pdfWriter - the PdfWriter object to write final PDF document to

Returns:

result PdfDocument object

Throws:

OcrException - if provided font is incorrect

getOcrEngine

public final IOcrEngine getOcrEngine()

Gets used IOcrEngine. Returns IOcrEngine reader object to perform OCR.

Returns:

selected IOcrEngine instance

setOcrEngine

public final void setOcrEngine(IOcrEngine reader)

Sets IOcrEngine reader object to perform OCR.

Parameters:

reader - selected IOcrEngine instance