net.sourceforge.tess4j

Class Tesseract1

java.lang.Object

net.sourceforge.tess4j.TessAPI1

net.sourceforge.tess4j.Tesseract1

All Implemented Interfaces:

com.sun.jna.Library, ITessAPI, ITesseract

public class Tesseract1
extends TessAPI1
implements ITesseract

An object layer on top of TessAPI1, provides character recognition support for common image formats, and multi-page TIFF images beyond the uncompressed, binary TIFF format supported by Tesseract OCR engine. The extended capabilities are provided by the Java Advanced Imaging Image I/O Tools.

Support for PDF documents is available through Ghost4J, a JNA wrapper for GPL Ghostscript, which should be installed and included in system path.

Any program that uses the library will need to ensure that the required libraries (the .jar files for jna, jai-imageio, and ghost4j) are in its compile and run-time classpath.

Nested Class Summary

Nested classes/interfaces inherited from interface net.sourceforge.tess4j.ITesseract

ITesseract.RenderedFormat

Nested classes/interfaces inherited from interface com.sun.jna.Library

com.sun.jna.Library.Handler

Nested classes/interfaces inherited from interface net.sourceforge.tess4j.ITessAPI

ITessAPI.CANCEL_FUNC, ITessAPI.EANYCODE_CHAR, ITessAPI.ETEXT_DESC, ITessAPI.TessBaseAPI, ITessAPI.TessMutableIterator, ITessAPI.TessOcrEngineMode, ITessAPI.TessOrientation, ITessAPI.TessPageIterator, ITessAPI.TessPageIteratorLevel, ITessAPI.TessPageSegMode, ITessAPI.TessPolyBlockType, ITessAPI.TessResultIterator, ITessAPI.TessResultRenderer, ITessAPI.TessTextlineOrder, ITessAPI.TessWritingDirection, ITessAPI.TimeVal

Field Summary

Fields inherited from interface net.sourceforge.tess4j.ITesseract

htmlBeginTag, htmlEndTag

Fields inherited from interface com.sun.jna.Library

OPTION_ALLOW_OBJECTS, OPTION_CALLING_CONVENTION, OPTION_CLASSLOADER, OPTION_FUNCTION_MAPPER, OPTION_INVOCATION_MAPPER, OPTION_OPEN_FLAGS, OPTION_STRING_ENCODING, OPTION_STRUCTURE_ALIGNMENT, OPTION_TYPE_MAPPER

Fields inherited from interface net.sourceforge.tess4j.ITessAPI

FALSE, TRUE

Constructor Summary

Constructors

Constructor and Description
Tesseract1()

Method Summary

Modifier and Type	Method and Description
void	createDocuments(java.lang.String[] filenames, java.lang.String[] outputbases, java.util.List<ITesseract.RenderedFormat> formats) Creates documents.
void	createDocuments(java.lang.String filename, java.lang.String outputbase, java.util.List<ITesseract.RenderedFormat> formats) Creates documents for given renderer.
protected void	dispose() Releases all of the native resources used by this instance.
java.lang.String	doOCR(java.awt.image.BufferedImage bi) Performs OCR operation.
java.lang.String	doOCR(java.awt.image.BufferedImage bi, java.awt.Rectangle rect) Performs OCR operation.
java.lang.String	doOCR(java.io.File imageFile) Performs OCR operation.
java.lang.String	doOCR(java.io.File imageFile, java.awt.Rectangle rect) Performs OCR operation.
java.lang.String	doOCR(int xsize, int ysize, java.nio.ByteBuffer buf, java.awt.Rectangle rect, int bpp) Performs OCR operation.
java.lang.String	doOCR(int xsize, int ysize, java.nio.ByteBuffer buf, java.lang.String filename, java.awt.Rectangle rect, int bpp) Performs OCR operation.
java.lang.String	doOCR(java.util.List<javax.imageio.IIOImage> imageList, java.awt.Rectangle rect) Performs OCR operation.
java.lang.String	doOCR(java.util.List<javax.imageio.IIOImage> imageList, java.lang.String filename, java.awt.Rectangle rect) Performs OCR operation.
protected ITessAPI.TessBaseAPI	getHandle() Returns API handle.
protected java.lang.String	getOCRText(java.lang.String filename, int pageNum) Gets recognized text.
protected void	init() Initializes Tesseract engine.
void	setConfigs(java.util.List<java.lang.String> configs) Sets configs to be passed to Tesseract's Init method.
void	setDatapath(java.lang.String datapath) Sets path to tessdata.
void	setHocr(boolean hocr) Enables hocr output.
protected void	setImage(int xsize, int ysize, java.nio.ByteBuffer buf, java.awt.Rectangle rect, int bpp) Sets image to be processed.
protected void	setImage(java.awt.image.RenderedImage image, java.awt.Rectangle rect) A wrapper for setImage(int, int, ByteBuffer, Rectangle, int).
void	setLanguage(java.lang.String language) Sets language for OCR.
void	setOcrEngineMode(int ocrEngineMode) Sets OCR engine mode.
void	setPageSegMode(int mode) Sets page segmentation mode.
void	setTessVariable(java.lang.String key, java.lang.String value) Set the value of Tesseract's internal parameter.
protected void	setTessVariables() Sets Tesseract's internal parameters.

Methods inherited from class net.sourceforge.tess4j.TessAPI1

TessBaseAPIAdaptToWordStr, TessBaseAPIAllWordConfidences, TessBaseAPIAnalyseLayout, TessBaseAPIClear, TessBaseAPIClearAdaptiveClassifier, TessBaseAPIClearPersistentCache, TessBaseAPICreate, TessBaseAPIDelete, TessBaseAPIDumpPGM, TessBaseAPIEnd, TessBaseAPIGetAvailableLanguagesAsVector, TessBaseAPIGetBoolVariable, TessBaseAPIGetBoxText, TessBaseAPIGetDatapath, TessBaseAPIGetDoubleVariable, TessBaseAPIGetHOCRText, TessBaseAPIGetInitLanguagesAsString, TessBaseAPIGetInputName, TessBaseAPIGetIntVariable, TessBaseAPIGetIterator, TessBaseAPIGetLoadedLanguagesAsVector, TessBaseAPIGetMutableIterator, TessBaseAPIGetPageSegMode, TessBaseAPIGetSourceYResolution, TessBaseAPIGetStringVariable, TessBaseAPIGetTextDirection, TessBaseAPIGetThresholdedImageScaleFactor, TessBaseAPIGetUnichar, TessBaseAPIGetUNLVText, TessBaseAPIGetUTF8Text, TessBaseAPIInit1, TessBaseAPIInit2, TessBaseAPIInit3, TessBaseAPIInit4, TessBaseAPIInitForAnalysePage, TessBaseAPIInitLangMod, TessBaseAPIIsValidWord, TessBaseAPIMeanTextConf, TessBaseAPIPrintVariablesToFile, TessBaseAPIProcessPages, TessBaseAPIProcessPages1, TessBaseAPIReadConfigFile, TessBaseAPIRecognize, TessBaseAPIRecognizeForChopTest, TessBaseAPIRect, TessBaseAPISetImage, TessBaseAPISetInputName, TessBaseAPISetOutputName, TessBaseAPISetPageSegMode, TessBaseAPISetRectangle, TessBaseAPISetSourceResolution, TessBaseAPISetVariable, TessBoxTextRendererCreate, TessDeleteIntArray, TessDeleteResultRenderer, TessDeleteText, TessDeleteTextArray, TessHOcrRendererCreate, TessPageIteratorBaseline, TessPageIteratorBegin, TessPageIteratorBlockType, TessPageIteratorBoundingBox, TessPageIteratorCopy, TessPageIteratorDelete, TessPageIteratorIsAtBeginningOf, TessPageIteratorIsAtFinalElement, TessPageIteratorNext, TessPageIteratorOrientation, TessPDFRendererCreate, TessResultIteratorConfidence, TessResultIteratorCopy, TessResultIteratorDelete, TessResultIteratorGetPageIterator, TessResultIteratorGetPageIteratorConst, TessResultIteratorGetUTF8Text, TessResultIteratorSymbolIsDropcap, TessResultIteratorSymbolIsSubscript, TessResultIteratorSymbolIsSuperscript, TessResultIteratorWordFontAttributes, TessResultIteratorWordIsFromDictionary, TessResultIteratorWordIsNumeric, TessResultRendererAddError, TessResultRendererAddImage, TessResultRendererBeginDocument, TessResultRendererEndDocument, TessResultRendererExtention, TessResultRendererGetOutput, TessResultRendererImageNum, TessResultRendererInsert, TessResultRendererNext, TessResultRendererTitle, TessResultRendererTypename, TessTextRendererCreate, TessUnlvRendererCreate, TessVersion

Methods inherited from class java.lang.Object

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

Constructor Detail

Tesseract1

public Tesseract1()

Method Detail

getHandle

protected ITessAPI.TessBaseAPI getHandle()

Returns API handle.

Returns:

handle

setDatapath

public void setDatapath(java.lang.String datapath)

Sets path to tessdata.

Specified by:

setDatapath in interface ITesseract

Parameters:

datapath - the tessdata path to set

setLanguage

public void setLanguage(java.lang.String language)

Sets language for OCR.

Specified by:

setLanguage in interface ITesseract

Parameters:

language - the language code, which follows ISO 639-3 standard.

setOcrEngineMode

public void setOcrEngineMode(int ocrEngineMode)

Sets OCR engine mode.

Specified by:

setOcrEngineMode in interface ITesseract

Parameters:

ocrEngineMode - the OcrEngineMode to set

setPageSegMode

public void setPageSegMode(int mode)

Sets page segmentation mode.

Specified by:

setPageSegMode in interface ITesseract

Parameters:

mode - the page segmentation mode to set

setHocr

public void setHocr(boolean hocr)

Enables hocr output.

Parameters:

hocr - to enable or disable hocr output

setTessVariable

public void setTessVariable(java.lang.String key,
                            java.lang.String value)

Set the value of Tesseract's internal parameter.

Specified by:

setTessVariable in interface ITesseract

Parameters:

key - variable name, e.g., tessedit_create_hocr, tessedit_char_whitelist, etc.

value - value for corresponding variable, e.g., "1", "0", "0123456789", etc.

setConfigs

public void setConfigs(java.util.List<java.lang.String> configs)

Sets configs to be passed to Tesseract's Init method.

Specified by:

setConfigs in interface ITesseract

Parameters:

configs - list of config filenames, e.g., "digits", "bazaar", "quiet"

doOCR

public java.lang.String doOCR(java.io.File imageFile)
                       throws TesseractException

Performs OCR operation.

Specified by:

doOCR in interface ITesseract

Parameters:

imageFile - an image file

Returns:

the recognized text

Throws:

TesseractException

doOCR

public java.lang.String doOCR(java.io.File imageFile,
                              java.awt.Rectangle rect)
                       throws TesseractException

Performs OCR operation.

Specified by:

doOCR in interface ITesseract

Parameters:

imageFile - an image file

rect - the bounding rectangle defines the region of the image to be recognized. A rectangle of zero dimension or null indicates the whole image.

Returns:

the recognized text

Throws:

TesseractException

doOCR

public java.lang.String doOCR(java.awt.image.BufferedImage bi)
                       throws TesseractException

Performs OCR operation.

Specified by:

doOCR in interface ITesseract

Parameters:

bi - a buffered image

Returns:

the recognized text

Throws:

TesseractException

doOCR

public java.lang.String doOCR(java.awt.image.BufferedImage bi,
                              java.awt.Rectangle rect)
                       throws TesseractException

Performs OCR operation.

Specified by:

doOCR in interface ITesseract

Parameters:

bi - a buffered image

rect - the bounding rectangle defines the region of the image to be recognized. A rectangle of zero dimension or null indicates the whole image.

Returns:

the recognized text

Throws:

TesseractException

doOCR

public java.lang.String doOCR(java.util.List<javax.imageio.IIOImage> imageList,
                              java.awt.Rectangle rect)
                       throws TesseractException

Performs OCR operation.

Specified by:

doOCR in interface ITesseract

Parameters:

imageList - a list of IIOImage objects

rect - the bounding rectangle defines the region of the image to be recognized. A rectangle of zero dimension or null indicates the whole image.

Returns:

the recognized text

Throws:

TesseractException

doOCR

public java.lang.String doOCR(java.util.List<javax.imageio.IIOImage> imageList,
                              java.lang.String filename,
                              java.awt.Rectangle rect)
                       throws TesseractException

Performs OCR operation.

Specified by:

doOCR in interface ITesseract

Parameters:

imageList - a list of IIOImage objects

filename - input file name

rect - the bounding rectangle defines the region of the image to be recognized. A rectangle of zero dimension or null indicates the whole image.

Returns:

the recognized text

Throws:

TesseractException

doOCR

public java.lang.String doOCR(int xsize,
                              int ysize,
                              java.nio.ByteBuffer buf,
                              java.awt.Rectangle rect,
                              int bpp)
                       throws TesseractException

Performs OCR operation. Use SetImage, (optionally) SetRectangle, and one or more of the Get*Text functions.

Specified by:

doOCR in interface ITesseract

Parameters:

xsize - width of image

ysize - height of image

buf - pixel data

rect - the bounding rectangle defines the region of the image to be recognized. A rectangle of zero dimension or null indicates the whole image.

bpp - bits per pixel, represents the bit depth of the image, with 1 for binary bitmap, 8 for gray, and 24 for color RGB.

Returns:

the recognized text

Throws:

TesseractException

doOCR

public java.lang.String doOCR(int xsize,
                              int ysize,
                              java.nio.ByteBuffer buf,
                              java.lang.String filename,
                              java.awt.Rectangle rect,
                              int bpp)
                       throws TesseractException

Performs OCR operation. Use SetImage, (optionally) SetRectangle, and one or more of the Get*Text functions.

Specified by:

doOCR in interface ITesseract

Parameters:

xsize - width of image

ysize - height of image

buf - pixel data

filename - input file name. Needed only for training and reading a UNLV zone file.

rect - the bounding rectangle defines the region of the image to be recognized. A rectangle of zero dimension or null indicates the whole image.

bpp - bits per pixel, represents the bit depth of the image, with 1 for binary bitmap, 8 for gray, and 24 for color RGB.

Returns:

the recognized text

Throws:

TesseractException

init

protected void init()

Initializes Tesseract engine.

setTessVariables

protected void setTessVariables()

Sets Tesseract's internal parameters.

setImage

protected void setImage(java.awt.image.RenderedImage image,
                        java.awt.Rectangle rect)
                 throws java.io.IOException

A wrapper for setImage(int, int, ByteBuffer, Rectangle, int).

Parameters:

image - a rendered image

rect - region of interest

Throws:

java.io.IOException

setImage

protected void setImage(int xsize,
                        int ysize,
                        java.nio.ByteBuffer buf,
                        java.awt.Rectangle rect,
                        int bpp)

Sets image to be processed.

Parameters:

xsize - width of image

ysize - height of image

buf - pixel data

rect - the bounding rectangle defines the region of the image to be recognized. A rectangle of zero dimension or null indicates the whole image.

bpp - bits per pixel, represents the bit depth of the image, with 1 for binary bitmap, 8 for gray, and 24 for color RGB.

getOCRText

protected java.lang.String getOCRText(java.lang.String filename,
                                      int pageNum)

Gets recognized text.

Parameters:

filename - input file name. Needed only for reading a UNLV zone file.

pageNum - page number; needed for hocr paging.

Returns:

the recognized text

createDocuments

public void createDocuments(java.lang.String filename,
                            java.lang.String outputbase,
                            java.util.List<ITesseract.RenderedFormat> formats)
                     throws TesseractException

Creates documents for given renderer.

Specified by:

createDocuments in interface ITesseract

Parameters:

filename - input image

outputbase - output filename without extension

formats - types of renderer

Throws:

TesseractException

createDocuments

public void createDocuments(java.lang.String[] filenames,
                            java.lang.String[] outputbases,
                            java.util.List<ITesseract.RenderedFormat> formats)
                     throws TesseractException

Creates documents.

Specified by:

createDocuments in interface ITesseract

Parameters:

filenames - array of input files

outputbases - array of output filenames without extension

formats - types of renderer

Throws:

TesseractException

dispose

protected void dispose()

Releases all of the native resources used by this instance.