org.apache.tika.parser.ocr

Class TesseractOCRParser

java.lang.Object

org.apache.tika.parser.AbstractParser

org.apache.tika.parser.ocr.TesseractOCRParser

All Implemented Interfaces:

Serializable, Initializable, Parser

public class TesseractOCRParser
extends AbstractParser
implements Initializable

TesseractOCRParser powered by tesseract-ocr engine. To enable this parser, create a TesseractOCRConfig object and pass it through a ParseContext. Tesseract-ocr must be installed and on system path or the path to its root folder must be provided:

TesseractOCRConfig config = new TesseractOCRConfig();
//Needed if tesseract is not on system path
config.setTesseractPath(tesseractFolder);
parseContext.set(TesseractOCRConfig.class, config);

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
TesseractOCRParser()

Method Summary

Modifier and Type	Method and Description
void	checkInitialization(InitializableProblemHandler problemHandler)
Set<MediaType>	getSupportedTypes(ParseContext context) Returns the set of media types supported by this parser when used with the given parse context.
boolean	hasTesseract(TesseractOCRConfig config)
protected boolean	hasWarned()
void	initialize(Map<String,Param> params) no-op
void	parse(Image image, ContentHandler handler, Metadata metadata, ParseContext context)
void	parse(InputStream stream, ContentHandler handler, Metadata metadata, ParseContext parseContext) Parses a document stream into a sequence of XHTML SAX events.
void	parseInline(InputStream stream, XHTMLContentHandler xhtml, ParseContext parseContext, TesseractOCRConfig config) Use this to parse content without starting a new document.
void	parseInline(InputStream stream, XHTMLContentHandler xhtml, TesseractOCRConfig config) Deprecated. use parseInline(InputStream, XHTMLContentHandler, ParseContext, TesseractOCRConfig)
protected void	warn()

Methods inherited from class org.apache.tika.parser.AbstractParser

parse

Methods inherited from class java.lang.Object

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

Constructor Detail

TesseractOCRParser

public TesseractOCRParser()

Method Detail

getSupportedTypes

public Set<MediaType> getSupportedTypes(ParseContext context)

Description copied from interface: Parser

Returns the set of media types supported by this parser when used with the given parse context.

Specified by:

getSupportedTypes in interface Parser

Parameters:

context - parse context

Returns:

immutable set of media types

hasTesseract

public boolean hasTesseract(TesseractOCRConfig config)

parse

public void parse(Image image,
                  ContentHandler handler,
                  Metadata metadata,
                  ParseContext context)
           throws IOException,
                  SAXException,
                  TikaException

Throws:

IOException

SAXException

TikaException

parse

public void parse(InputStream stream,
                  ContentHandler handler,
                  Metadata metadata,
                  ParseContext parseContext)
           throws IOException,
                  SAXException,
                  TikaException

Description copied from interface: Parser

Parses a document stream into a sequence of XHTML SAX events. Fills in related document metadata in the given metadata object.

The given document stream is consumed but not closed by this method. The responsibility to close the stream remains on the caller.

Information about the parsing context can be passed in the context parameter. See the parser implementations for the kinds of context information they expect.

Specified by:

parse in interface Parser

Parameters:

stream - the document stream (input)

handler - handler for the XHTML SAX events (output)

metadata - document metadata (input and output)

parseContext - parse context

Throws:

IOException - if the document stream could not be read

SAXException - if the SAX events could not be processed

TikaException - if the document could not be parsed

parseInline

public void parseInline(InputStream stream,
                        XHTMLContentHandler xhtml,
                        TesseractOCRConfig config)
                 throws IOException,
                        SAXException,
                        TikaException

Deprecated. use parseInline(InputStream, XHTMLContentHandler, ParseContext, TesseractOCRConfig)

Use this to parse content without starting a new document. This appends SAX events to xhtml without re-adding the metadata, body start, etc.

Parameters:

stream - inputstream

xhtml - handler

config - TesseractOCRConfig to use for this parse

Throws:

IOException

SAXException

TikaException

parseInline

public void parseInline(InputStream stream,
                        XHTMLContentHandler xhtml,
                        ParseContext parseContext,
                        TesseractOCRConfig config)
                 throws IOException,
                        SAXException,
                        TikaException

Use this to parse content without starting a new document. This appends SAX events to xhtml without re-adding the metadata, body start, etc.

Parameters:

stream - inputstream

xhtml - handler

config - TesseractOCRConfig to use for this parse

Throws:

IOException

SAXException

TikaException

initialize

public void initialize(Map<String,Param> params)
                throws TikaConfigException

no-op

Specified by:

initialize in interface Initializable

Parameters:

params - params to use for initialization

Throws:

TikaConfigException

checkInitialization

public void checkInitialization(InitializableProblemHandler problemHandler)
                         throws TikaConfigException

Specified by:

checkInitialization in interface Initializable

Parameters:

problemHandler - if there is a problem and no custom initializableProblemHandler has been configured via Initializable parameters, this is called to respond.

Throws:

TikaConfigException

hasWarned

protected boolean hasWarned()

warn

protected void warn()