org.apache.tika.parser.ocr

Class TesseractOCRParser

java.lang.Object

org.apache.tika.parser.AbstractParser

org.apache.tika.parser.AbstractExternalProcessParser

org.apache.tika.parser.ocr.TesseractOCRParser

All Implemented Interfaces:

Serializable, org.apache.tika.config.Initializable, org.apache.tika.parser.Parser

public class TesseractOCRParser
extends org.apache.tika.parser.AbstractExternalProcessParser
implements org.apache.tika.config.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

Field Summary

Fields

Modifier and Type	Field and Description
static org.apache.tika.metadata.Property	IMAGE_MAGICK
static org.apache.tika.metadata.Property	IMAGE_ROTATION
static org.apache.tika.metadata.Property	PSM0_ORIENTATION
static org.apache.tika.metadata.Property	PSM0_ORIENTATION_CONFIDENCE
static org.apache.tika.metadata.Property	PSM0_PAGE_NUMBER
static org.apache.tika.metadata.Property	PSM0_ROTATE
static org.apache.tika.metadata.Property	PSM0_SCRIPT
static org.apache.tika.metadata.Property	PSM0_SCRIPT_CONFIDENCE
static String	TESS_META

Constructor Summary

Constructors

Constructor and Description
TesseractOCRParser()

Method Summary

Modifier and Type	Method and Description
void	checkInitialization(org.apache.tika.config.InitializableProblemHandler problemHandler)
String	getColorspace()
TesseractOCRConfig	getDefaultConfig()
int	getDensity()
int	getDepth()
String	getFilter()
String	getImageMagickPath()
static String	getImageMagickProg()
Set<String>	getLangs()
String	getLanguage()
long	getMaxFileSizeToOcr()
long	getMinFileSizeToOcr()
List<String>	getOtherTesseractSettings()
String	getOutputType()
String	getPageSegMode()
int	getResize()
Set<org.apache.tika.mime.MediaType>	getSupportedTypes(org.apache.tika.parser.ParseContext context)
String	getTessdataPath()
String	getTesseractPath()
static String	getTesseractProg()
int	getTimeout()
boolean	hasTesseract()
protected boolean	hasWarned()
void	initialize(Map<String,org.apache.tika.config.Param> params)
boolean	isApplyRotation()
boolean	isEnableImagePreprocessing()
boolean	isPreloadLangs()
boolean	isPreserveInterwordSpacing()
boolean	isSkipOCR()
void	parse(Image image, ContentHandler handler, org.apache.tika.metadata.Metadata metadata, org.apache.tika.parser.ParseContext context)
void	parse(InputStream stream, ContentHandler handler, org.apache.tika.metadata.Metadata metadata, org.apache.tika.parser.ParseContext parseContext)
void	setApplyRotation(boolean applyRotation)
void	setColorspace(String colorspace)
void	setDensity(int density)
void	setDepth(int depth)
void	setEnableImagePreprocessing(boolean enableImagePreprocessing)
void	setFilter(String filter)
void	setImageMagickPath(String imageMagickPath) Set the path to the ImageMagick executable directory, needed if it is not on system path.
void	setLanguage(String language)
void	setMaxFileSizeToOcr(long maxFileSizeToOcr)
void	setMinFileSizeToOcr(long minFileSizeToOcr)
void	setOtherTesseractSettings(List<String> settings)
void	setOutputType(String outputType)
void	setPageSegMode(String pageSegMode)
void	setPreloadLangs(boolean preloadLangs) If set to true and if tesseract is found, this will load the langs that result from --list-langs.
void	setPreserveInterwordSpacing(boolean preserveInterwordSpacing)
void	setResize(int resize)
void	setSkipOCR(boolean skipOCR)
void	setTessdataPath(String tessdataPath) Set the path to the 'tessdata' folder, which contains language files and config files.
void	setTesseractPath(String tesseractPath) Set the path to the Tesseract executable's directory, needed if it is not on system path.
void	setTimeout(int timeout) Set default timeout in seconds.
protected void	warn()

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

register, release

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

Field Detail

TESS_META

public static final String TESS_META

See Also:

Constant Field Values

IMAGE_ROTATION

public static final org.apache.tika.metadata.Property IMAGE_ROTATION

IMAGE_MAGICK

public static final org.apache.tika.metadata.Property IMAGE_MAGICK

PSM0_PAGE_NUMBER

public static final org.apache.tika.metadata.Property PSM0_PAGE_NUMBER

PSM0_ORIENTATION

public static final org.apache.tika.metadata.Property PSM0_ORIENTATION

PSM0_ROTATE

public static final org.apache.tika.metadata.Property PSM0_ROTATE

PSM0_ORIENTATION_CONFIDENCE

public static final org.apache.tika.metadata.Property PSM0_ORIENTATION_CONFIDENCE

PSM0_SCRIPT

public static final org.apache.tika.metadata.Property PSM0_SCRIPT

PSM0_SCRIPT_CONFIDENCE

public static final org.apache.tika.metadata.Property PSM0_SCRIPT_CONFIDENCE

Constructor Detail

TesseractOCRParser

public TesseractOCRParser()

Method Detail

getImageMagickProg

public static String getImageMagickProg()

getTesseractProg

public static String getTesseractProg()

getSupportedTypes

public Set<org.apache.tika.mime.MediaType> getSupportedTypes(org.apache.tika.parser.ParseContext context)

Specified by:

getSupportedTypes in interface org.apache.tika.parser.Parser

hasTesseract

public boolean hasTesseract()
                     throws org.apache.tika.exception.TikaConfigException

Throws:

org.apache.tika.exception.TikaConfigException

parse

public void parse(Image image,
                  ContentHandler handler,
                  org.apache.tika.metadata.Metadata metadata,
                  org.apache.tika.parser.ParseContext context)
           throws IOException,
                  SAXException,
                  org.apache.tika.exception.TikaException

Throws:

IOException

SAXException

org.apache.tika.exception.TikaException

parse

public void parse(InputStream stream,
                  ContentHandler handler,
                  org.apache.tika.metadata.Metadata metadata,
                  org.apache.tika.parser.ParseContext parseContext)
           throws IOException,
                  SAXException,
                  org.apache.tika.exception.TikaException

Specified by:

parse in interface org.apache.tika.parser.Parser

Throws:

IOException

SAXException

org.apache.tika.exception.TikaException

initialize

public void initialize(Map<String,org.apache.tika.config.Param> params)
                throws org.apache.tika.exception.TikaConfigException

Specified by:

initialize in interface org.apache.tika.config.Initializable

Throws:

org.apache.tika.exception.TikaConfigException

checkInitialization

public void checkInitialization(org.apache.tika.config.InitializableProblemHandler problemHandler)
                         throws org.apache.tika.exception.TikaConfigException

Specified by:

checkInitialization in interface org.apache.tika.config.Initializable

Throws:

org.apache.tika.exception.TikaConfigException

getLangs

public Set<String> getLangs()

hasWarned

protected boolean hasWarned()

warn

protected void warn()

getTesseractPath

public String getTesseractPath()

setTesseractPath

@Field
public void setTesseractPath(String tesseractPath)

Set the path to the Tesseract executable's directory, needed if it is not on system path.

Note that if you set this value, it is highly recommended that you also set the path to (and including) the 'tessdata' folder using setTessdataPath(java.lang.String).

getTessdataPath

public String getTessdataPath()

setTessdataPath

@Field
public void setTessdataPath(String tessdataPath)

Set the path to the 'tessdata' folder, which contains language files and config files. In some cases (such as on Windows), this folder is found in the Tesseract installation, but in other cases (such as when Tesseract is built from source), it may be located elsewhere.

Make sure to include the 'tessdata' folder in this path: '/blah/de/blah/tessdata'

getImageMagickPath

public String getImageMagickPath()

setImageMagickPath

@Field
public void setImageMagickPath(String imageMagickPath)

Set the path to the ImageMagick executable directory, needed if it is not on system path.

Parameters:

imageMagickPath - to ImageMagick executable directory.

setOtherTesseractSettings

@Field
public void setOtherTesseractSettings(List<String> settings)
                                      throws org.apache.tika.exception.TikaConfigException

Throws:

org.apache.tika.exception.TikaConfigException

getOtherTesseractSettings

public List<String> getOtherTesseractSettings()

setSkipOCR

@Field
public void setSkipOCR(boolean skipOCR)

isSkipOCR

public boolean isSkipOCR()

setLanguage

@Field
public void setLanguage(String language)

getLanguage

public String getLanguage()

setPageSegMode

@Field
public void setPageSegMode(String pageSegMode)

getPageSegMode

public String getPageSegMode()

setMaxFileSizeToOcr

@Field
public void setMaxFileSizeToOcr(long maxFileSizeToOcr)

getMaxFileSizeToOcr

public long getMaxFileSizeToOcr()

setMinFileSizeToOcr

@Field
public void setMinFileSizeToOcr(long minFileSizeToOcr)

getMinFileSizeToOcr

public long getMinFileSizeToOcr()

setTimeout

@Field
public void setTimeout(int timeout)

Set default timeout in seconds. This can be overridden per parse with TikaTaskTimeout sent in via the ParseContext at parse time.

Parameters:

timeout -

getTimeout

public int getTimeout()

setOutputType

@Field
public void setOutputType(String outputType)

getOutputType

public String getOutputType()

setPreserveInterwordSpacing

@Field
public void setPreserveInterwordSpacing(boolean preserveInterwordSpacing)

isPreserveInterwordSpacing

public boolean isPreserveInterwordSpacing()

setEnableImagePreprocessing

@Field
public void setEnableImagePreprocessing(boolean enableImagePreprocessing)

isEnableImagePreprocessing

public boolean isEnableImagePreprocessing()

setDensity

@Field
public void setDensity(int density)

getDensity

public int getDensity()

setDepth

@Field
public void setDepth(int depth)

getDepth

public int getDepth()

setColorspace

@Field
public void setColorspace(String colorspace)

getColorspace

public String getColorspace()

setFilter

@Field
public void setFilter(String filter)

getFilter

public String getFilter()

setResize

@Field
public void setResize(int resize)

getResize

public int getResize()

setApplyRotation

@Field
public void setApplyRotation(boolean applyRotation)

isApplyRotation

public boolean isApplyRotation()

setPreloadLangs

@Field
public void setPreloadLangs(boolean preloadLangs)

If set to true and if tesseract is found, this will load the langs that result from --list-langs. At parse time, the parser will verify that tesseract has the requested lang available.

If set to false (the default) and tesseract is found, if a user requests a language that tesseract does not have data for, a TikaException will be thrown with tesseract's native exception message, which is a bit less readable.

Parameters:

preloadLangs -

isPreloadLangs

public boolean isPreloadLangs()

getDefaultConfig

public TesseractOCRConfig getDefaultConfig()