PDFlib Text Extraction Toolkit (TET) Manual

Table 10.10 Page options for TET_open_page( ) and TET_process_page( )
option
docstyle
excludebox
granularity
includebox
fontsizerange
ignoreinvisibletext
imageanalysis
layoutanalysis
description
(Keyword) A hint which will be used by the layout detection engine to select various parameters. These
parameters optimize layout detection for situations where the document belongs to one of the classes
below. If the document is known to fall into one of these classes layout detection results can be improved
significantly by supplying a suitable value for this option. This option activates advanced layout recognition
(default: none):
book Typical book
business Business documents
cad Technical or architectural drawings which are typically heavily fragmented
fancy Fancy pages with complex layout
forms Structured forms
generic The most general document class without any further qualification.
magazines Magazine articles
none No specific document style is known and advanced layout recognition will be disabled.
papers Newspaper
science Scientific article
searchengine
The application is a search engine indexer or similar application, and mainly interested in
retrieving the word list for the page as fast as possible. Table and page structure recognition
are disabled.
spacegrid List-oriented report (often generated on mainframe systems) where the visual layout is
generated using space characters. Since many heuristics like shadow detection and
sophisticated word boundary detection are not required for this class of documents text
extraction can be accelerated with this option.
(List of rectangles) Exclude the combined area of the specified rectangles from text extraction. Default:
empty
(List of two floats) Two numbers specifying the minimum and maximum font size of text. Text with a size
outside of this interval will be ignored. The maximum can be specified with the keyword unlimited,
which means that no upper limit will be active. Default: { 0 unlimited }
(Keyword) The granularity of the text fragments returned by TET_get_text( ); all modes except glyph will
enable the Wordfinder. See »Text granularity«, page 84, for more details (default: word).
glyph
word
line
page
A fragment contains the result of mapping one glyph, but may contain more than one
character (e.g. for ligatures).
A fragment contains a word as determined by the Wordfinder.
A fragment contains a line of text, or the closest approximation thereof. Word separators will
be inserted between two consecutive words.
A fragment contains the contents of a single page. Word, line, and zone separators will be
inserted as appropriate.
(Boolean) If true, text with rendering mode 3 (invisible) will be ignored. Default: false (since invisible
text is mainly used for image+text PDFs containing scanned pages and the corresponding OCR text)
(Option list) List of suboptions according to Table 10.13 for controlling high-level image processing.
(List of rectangles) Restrict text extraction to the combined area of the specified rectangles. Default: the
complete clipping area
(Option list; not for granularity=glyph) List of suboptions according to Table 10.12 for controlling layout
detection features.
170 Chapter 10: TET Library API Reference