PDFlib Text Extraction Toolkit (TET) Manual

Table 10.10 Members of the TET_char_info structure (C and C++), equivalent public fields (Java, PHP), keys (Perl) or
properties (COM and .NET) with their type and meaning. See »Glyph metrics«, page 64, for more details.
property/
field name
uv
type
unknown
explanation
(Integer) UTF-32 Unicode value of the current character. It will be 0 if the corresponding UTF-16 value is
the trailing value of a surrogate pair (i.e. if type=11).
(Integer) Type of the character. The following types describe real characters which correspond to a glyph
on the page. The values of all other properties/fields are determined by the corresponding glyph:
0 Normal character which corresponds to exactly one glyph
1 Start of a sequence (e.g. ligature)
The following types describe artificial characters which do not correspond to a glyph on the page. The x
and y fields will specify the most recent real character’s endpoint, the width field will be 0, and all other
fields except uv will contain the values corresponding to the most recent real character:
10 Continuation of a sequence (e.g. ligature)
11 Trailing value of a surrogate pair; the leading value has type=0, 1, or 10.
12 Inserted word, line, or zone separator
(Boolean, in C and C++: integer) Usually false (0), but will be true (1) if the original glyph could not be
mapped to Unicode and has been replaced with the character specified as unknownchar.
x, y (Double) Position of the glyph’s reference point. The reference point is the lower left corner of the glyph
box for horizontal writing mode, and the top center point for vertical writing mode. For artificial characters
the x, y coordinates will be those of the end point of the most recent real character.
width
alpha
beta
fontid
fontsize
textrendering
(Double) Width of the corresponding glyph (for both horizontal and vertical writing mode). For artificial
characters the width will be 0.
(Double) Direction of inline text progression in degrees measured counter-clockwise. For horizontal writing
mode this is the direction of the text baseline; for vertical writing mode it is the digression from the
standard -90° direction. The angle will be in the range -180° < alpha ³ +180°. For standard horizontal
text as well as for standard text in vertical writing mode the angle will be 0°.
(Double) Text slanting angle in degrees (counter-clockwise), relative to the perpendicular of alpha. The
angle will be 0° for upright text, and negative for italicized (slanted) text. The angle will be in the range
-180° < beta ³ 180°, but different from ±90°. If abs(beta) > 90° the text is mirrored at the baseline.
(Integer) Index of the font in the fonts[] pseudo object (see Table 9.5). fontid is never negative.
(Double) Size of the font (always positive); the relation of this value to the actual height of glyphs is not
fixed, but may vary with the font design. For most fonts the font size is chosen such that it encompasses
all ascenders (including accented characters) and descenders.
(Integer) Text rendering mode:
0 fill text
1 stroke text (outline)
2 fill and stroke text
3 invisible text (often used for OCR results)
4 fill text and add it to the clipping path
5 stroke text and add it to the clipping path
6 fill and stroke text and add it to the clipping path
7 add text to the clipping path
144 Chapter 10: TET Library API Reference