org.apache.tika.parser.pdf

Class PDFParserConfig

java.lang.Object

org.apache.tika.parser.pdf.PDFParserConfig

All Implemented Interfaces:

Serializable

public class PDFParserConfig
extends Object
implements Serializable

Config for PDFParser. This allows parameters to be set programmatically:

1. Calls to PDFParser, i.e. parser.getPDFParserConfig().setEnableAutoSpace() (as before)
2. Constructor of PDFParser
3. Passing to PDFParser through a ParseContext: context.set(PDFParserConfig.class, config);

Parameters can also be set by modifying the PDFParserConfig.properties file, which lives in the expected places, in trunk: tika-parsers/src/main/resources/org/apache/tika/parser/pdf Or, in tika-app-x.x.jar or tika-parsers-x.x.jar: org/apache/tika/parser/pdf

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
PDFParserConfig()
PDFParserConfig(InputStream is) Loads properties from InputStream and then tries to close InputStream.

Method Summary

Methods

Modifier and Type	Method and Description
void	configure(org.apache.tika.parser.pdf.PDF2XHTML pdf2XHTML) Configures the given pdf2XHTML.
boolean	equals(Object obj)
Float	getAverageCharTolerance()
boolean	getEnableAutoSpace()
boolean	getExtractAcroFormContent()
boolean	getExtractAnnotationText()
boolean	getSortByPosition()
Float	getSpacingTolerance()
boolean	getSuppressDuplicateOverlappingText()
boolean	getUseNonSequentialParser()
int	hashCode()
void	setAverageCharTolerance(Float averageCharTolerance) See PDFTextStripper.setAverageCharTolerance(float)
void	setEnableAutoSpace(boolean enableAutoSpace) If true (the default), the parser should estimate where spaces should be inserted between words.
void	setExtractAcroFormContent(boolean extractAcroFormContent) If true (the default), extract content from AcroForms at the end of the document.
void	setExtractAnnotationText(boolean extractAnnotationText) If true (the default), text in annotations will be extracted.
void	setSortByPosition(boolean sortByPosition) If true, sort text tokens by their x/y position before extracting text.
void	setSpacingTolerance(Float spacingTolerance) See PDFTextStripper.setSpacingTolerance(float)
void	setSuppressDuplicateOverlappingText(boolean suppressDuplicateOverlappingText) If true, the parser should try to remove duplicated text over the same region.
void	setUseNonSequentialParser(boolean useNonSequentialParser) If true, uses PDFBox's non-sequential parser.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PDFParserConfig

public PDFParserConfig()

PDFParserConfig

public PDFParserConfig(InputStream is)

Loads properties from InputStream and then tries to close InputStream. If there is an IOException, this silently swallows the exception and goes back to the default.

Parameters:

is -

Method Detail

configure

public void configure(org.apache.tika.parser.pdf.PDF2XHTML pdf2XHTML)

Configures the given pdf2XHTML.

Parameters:

pdf2XHTML -

setExtractAcroFormContent

public void setExtractAcroFormContent(boolean extractAcroFormContent)

If true (the default), extract content from AcroForms at the end of the document.

Parameters:

b -

getExtractAcroFormContent

public boolean getExtractAcroFormContent()

See Also:

setExtractAcroFormContent(boolean)

getEnableAutoSpace

public boolean getEnableAutoSpace()

See Also:

#setEnableAutoSpace.

setEnableAutoSpace

public void setEnableAutoSpace(boolean enableAutoSpace)

If true (the default), the parser should estimate where spaces should be inserted between words. For many PDFs this is necessary as they do not include explicit whitespace characters.

getSuppressDuplicateOverlappingText

public boolean getSuppressDuplicateOverlappingText()

See Also:

setSuppressDuplicateOverlappingText(boolean)

setSuppressDuplicateOverlappingText

public void setSuppressDuplicateOverlappingText(boolean suppressDuplicateOverlappingText)

If true, the parser should try to remove duplicated text over the same region. This is needed for some PDFs that achieve bolding by re-writing the same text in the same area. Note that this can slow down extraction substantially (PDFBOX-956) and sometimes remove characters that were not in fact duplicated (PDFBOX-1155). By default this is disabled.

getExtractAnnotationText

public boolean getExtractAnnotationText()

See Also:

setExtractAnnotationText(boolean)

setExtractAnnotationText

public void setExtractAnnotationText(boolean extractAnnotationText)

If true (the default), text in annotations will be extracted.

getSortByPosition

public boolean getSortByPosition()

See Also:

setSortByPosition(boolean)

setSortByPosition

public void setSortByPosition(boolean sortByPosition)

If true, sort text tokens by their x/y position before extracting text. This may be necessary for some PDFs (if the text tokens are not rendered "in order"), while for other PDFs it can produce the wrong result (for example if there are 2 columns, the text will be interleaved). Default is false.

getUseNonSequentialParser

public boolean getUseNonSequentialParser()

See Also:

setUseNonSequentialParser(boolean)

setUseNonSequentialParser

public void setUseNonSequentialParser(boolean useNonSequentialParser)

If true, uses PDFBox's non-sequential parser. The non-sequential parser should be much faster than the traditional full doc parser. However, until PDFBOX-XXX is fixed, the non-sequential parser fails to extract some document metadata.

Default is false (use the traditional parser)

Parameters:

useNonSequentialParser -

getAverageCharTolerance

public Float getAverageCharTolerance()

See Also:

setAverageCharTolerance(Float)

setAverageCharTolerance

public void setAverageCharTolerance(Float averageCharTolerance)

See PDFTextStripper.setAverageCharTolerance(float)

getSpacingTolerance

public Float getSpacingTolerance()

See Also:

setSpacingTolerance(Float)

setSpacingTolerance

public void setSpacingTolerance(Float spacingTolerance)

See PDFTextStripper.setSpacingTolerance(float)

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object