Class PDTrueTypeFont
- All Implemented Interfaces:
COSObjectable
,PDFontLike
,PDVectorFont
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate boolean
private CmapSubtable
private CmapSubtable
private CmapSubtable
private BoundingBox
private final boolean
private final boolean
private static final org.apache.commons.logging.Log
private static final int
private static final int
private static final int
private final TrueTypeFont
Fields inherited from class org.apache.pdfbox.pdmodel.font.PDSimpleFont
encoding, glyphList
Fields inherited from class org.apache.pdfbox.pdmodel.font.PDFont
DEFAULT_FONT_MATRIX, dict
-
Constructor Summary
ConstructorsModifierConstructorDescriptionPDTrueTypeFont
(COSDictionary fontDictionary) Creates a new TrueType font from a Font dictionary.private
PDTrueTypeFont
(PDDocument document, TrueTypeFont ttf, Encoding encoding, boolean closeTTF) Creates a new TrueType font for embedding. -
Method Summary
Modifier and TypeMethodDescriptionint
codeToGID
(int code) Returns the GID for the given character code.protected byte[]
encode
(int unicode) Encodes the given Unicode code point for use in a PDF content stream.private void
extract all useful "cmap" subtables.private BoundingBox
final String
Returns the PostScript name of the font.Returns the font's bounding box.Returns the embedded or system font used for rendering.Inverts the font's code -> GID mapping.float
getHeight
(int code) Returns the height of the given character, in glyph space.getName()
Returns the name of this font, either the PostScript "BaseName" or the Type 3 "Name".getPath
(int code) Returns the glyph path for the given character code in a PDF.Returns the path for the character with the given name.Returns the embedded or substituted TrueType font.float
getWidthFromFont
(int code) Returns the width of a glyph in the embedded font file.boolean
hasGlyph
(int code) Returns true if this font contains a glyph for the given character code in a PDF.boolean
Returns true if the font contains the character with the given name.boolean
Returns true if the embedded font file is damaged.boolean
Returns true if the font file is embedded in the PDF.static PDTrueTypeFont
load
(PDDocument doc, File file, Encoding encoding) Loads a TTF to be embedded into a document as a simple font.static PDTrueTypeFont
load
(PDDocument doc, InputStream input, Encoding encoding) Loads a TTF to be embedded into a document as a simple font.static PDTrueTypeFont
load
(PDDocument doc, TrueTypeFont ttf, Encoding encoding) Loads a TTF to be embedded into a document as a simple font.static PDTrueTypeFont
loadTTF
(PDDocument doc, File file) Deprecated.static PDTrueTypeFont
loadTTF
(PDDocument doc, InputStream input) Deprecated.UsePDType0Font.load(PDDocument, InputStream)
instead.int
readCode
(InputStream in) Reads a character code from a content stream string.protected Encoding
Called by readEncoding() if the encoding needs to be extracted from the font file.Methods inherited from class org.apache.pdfbox.pdmodel.font.PDSimpleFont
addToSubset, getEncoding, getGlyphList, getStandard14Width, getSymbolicFlag, hasExplicitWidth, isFontSymbolic, isStandard14, isSymbolic, isVertical, readEncoding, subset, toUnicode, toUnicode, willBeSubset
Methods inherited from class org.apache.pdfbox.pdmodel.font.PDFont
encode, equals, getAverageFontWidth, getCOSObject, getDisplacement, getFontDescriptor, getFontMatrix, getPositionVector, getSpaceWidth, getStandard14AFM, getStringWidth, getSubType, getToUnicodeCMap, getType, getWidth, getWidths, hashCode, readCMap, setFontDescriptor, toString
-
Field Details
-
LOG
private static final org.apache.commons.logging.Log LOG -
START_RANGE_F000
private static final int START_RANGE_F000- See Also:
-
START_RANGE_F100
private static final int START_RANGE_F100- See Also:
-
START_RANGE_F200
private static final int START_RANGE_F200- See Also:
-
INVERTED_MACOS_ROMAN
-
cmapWinUnicode
-
cmapWinSymbol
-
cmapMacRoman
-
cmapInitialized
private boolean cmapInitialized -
gidToCode
-
ttf
-
isEmbedded
private final boolean isEmbedded -
isDamaged
private final boolean isDamaged -
fontBBox
-
-
Constructor Details
-
PDTrueTypeFont
Creates a new TrueType font from a Font dictionary.- Parameters:
fontDictionary
- The font dictionary according to the PDF specification.- Throws:
IOException
-
PDTrueTypeFont
private PDTrueTypeFont(PDDocument document, TrueTypeFont ttf, Encoding encoding, boolean closeTTF) throws IOException Creates a new TrueType font for embedding.- Throws:
IOException
-
-
Method Details
-
load
Loads a TTF to be embedded into a document as a simple font.Note: Simple fonts only support 256 characters. For Unicode support, use
PDType0Font.load(PDDocument, File)
instead.- Parameters:
doc
- The PDF document that will hold the embedded font.file
- A TTF file.encoding
- The PostScript encoding vector to be used for embedding.- Returns:
- a PDTrueTypeFont instance.
- Throws:
IOException
- If there is an error loading the data.
-
load
public static PDTrueTypeFont load(PDDocument doc, InputStream input, Encoding encoding) throws IOException Loads a TTF to be embedded into a document as a simple font.Note: Simple fonts only support 256 characters. For Unicode support, use
PDType0Font.load(PDDocument, InputStream)
instead.- Parameters:
doc
- The PDF document that will hold the embedded font.input
- A TTF file streamencoding
- The PostScript encoding vector to be used for embedding.- Returns:
- a PDTrueTypeFont instance.
- Throws:
IOException
- If there is an error loading the data.
-
load
public static PDTrueTypeFont load(PDDocument doc, TrueTypeFont ttf, Encoding encoding) throws IOException Loads a TTF to be embedded into a document as a simple font.Note: Simple fonts only support 256 characters. For Unicode support, use
PDType0Font.load(PDDocument, InputStream)
instead.- Parameters:
doc
- The PDF document that will hold the embedded font.ttf
- A true type fontencoding
- The PostScript encoding vector to be used for embedding.- Returns:
- a PDTrueTypeFont instance.
- Throws:
IOException
- If there is an error loading the data.
-
loadTTF
Deprecated.UsePDType0Font.load(PDDocument, File)
instead.Loads a TTF to be embedded into a document as a simple font. Only supports WinAnsiEncoding.- Parameters:
doc
- The PDF document that will hold the embedded font.file
- A TTF file.- Returns:
- a PDTrueTypeFont instance.
- Throws:
IOException
- If there is an error loading the data.
-
loadTTF
@Deprecated public static PDTrueTypeFont loadTTF(PDDocument doc, InputStream input) throws IOException Deprecated.UsePDType0Font.load(PDDocument, InputStream)
instead.Loads a TTF to be embedded into a document as a simple font. Only supports WinAnsiEncoding.- Parameters:
doc
- The PDF document that will hold the embedded font.input
- A TTF file stream- Returns:
- a PDTrueTypeFont instance.
- Throws:
IOException
- If there is an error loading the data.
-
getBaseFont
Returns the PostScript name of the font. -
readEncodingFromFont
Description copied from class:PDSimpleFont
Called by readEncoding() if the encoding needs to be extracted from the font file.- Specified by:
readEncodingFromFont
in classPDSimpleFont
- Throws:
IOException
- if the font file could not be read.
-
readCode
Description copied from class:PDFont
Reads a character code from a content stream string. Codes may be up to 4 bytes long.- Specified by:
readCode
in classPDFont
- Parameters:
in
- string stream- Returns:
- character code
- Throws:
IOException
- if the CMap or stream cannot be read
-
getName
Description copied from interface:PDFontLike
Returns the name of this font, either the PostScript "BaseName" or the Type 3 "Name".- Specified by:
getName
in interfacePDFontLike
-
getBoundingBox
Description copied from interface:PDFontLike
Returns the font's bounding box.- Specified by:
getBoundingBox
in interfacePDFontLike
- Throws:
IOException
-
generateBoundingBox
- Throws:
IOException
-
isDamaged
public boolean isDamaged()Description copied from interface:PDFontLike
Returns true if the embedded font file is damaged.- Specified by:
isDamaged
in interfacePDFontLike
-
getTrueTypeFont
Returns the embedded or substituted TrueType font. -
getWidthFromFont
Description copied from interface:PDFontLike
Returns the width of a glyph in the embedded font file.- Specified by:
getWidthFromFont
in interfacePDFontLike
- Parameters:
code
- character code- Returns:
- width in glyph space
- Throws:
IOException
- if the font could not be read
-
getHeight
Description copied from interface:PDFontLike
Returns the height of the given character, in glyph space. This can be expensive to calculate. Results are only approximate.Warning: This method is deprecated in PDFBox 2.0 because there is no meaningful value which it can return. The
PDFontLike.getWidth(int)
method returns the advance width of a glyph, but there is no corresponding advance height. The logical height of a character is the same for every character in a font, so if you want that, retrieve the font bbox's height. Otherwise if you want the visual bounds of the glyph then call getPath(..) on the appropriate PDFont subclass to retrieve the glyph outline as a GeneralPath. See the cyan rectangles in the DrawPrintTextLocations.java example to see this in action.- Specified by:
getHeight
in interfacePDFontLike
- Parameters:
code
- character code- Throws:
IOException
-
encode
Description copied from class:PDFont
Encodes the given Unicode code point for use in a PDF content stream. Content streams use a multi-byte encoding with 1 to 4 bytes.This method is called when embedding text in PDFs and when filling in fields.
- Specified by:
encode
in classPDFont
- Parameters:
unicode
- Unicode code point.- Returns:
- Array of 1 to 4 PDF content stream bytes.
- Throws:
IOException
- If the text could not be encoded.
-
getGIDToCode
Inverts the font's code -> GID mapping. Any duplicate (GID -> code) mappings will be lost.- Throws:
IOException
-
isEmbedded
public boolean isEmbedded()Description copied from interface:PDFontLike
Returns true if the font file is embedded in the PDF.- Specified by:
isEmbedded
in interfacePDFontLike
-
getPath
Description copied from interface:PDVectorFont
Returns the glyph path for the given character code in a PDF.- Specified by:
getPath
in interfacePDVectorFont
- Parameters:
code
- character code in a PDF. Not to be confused with unicode.- Throws:
IOException
- if the font could not be read
-
getPath
Description copied from class:PDSimpleFont
Returns the path for the character with the given name. For some fonts, GIDs may be used instead of names when calling this method.- Specified by:
getPath
in classPDSimpleFont
- Returns:
- glyph path
- Throws:
IOException
- if the path could not be read
-
hasGlyph
Description copied from class:PDSimpleFont
Returns true if the font contains the character with the given name.- Specified by:
hasGlyph
in classPDSimpleFont
- Throws:
IOException
- if the path could not be read
-
getFontBoxFont
Description copied from class:PDSimpleFont
Returns the embedded or system font used for rendering. This is never null.- Specified by:
getFontBoxFont
in classPDSimpleFont
-
hasGlyph
Description copied from interface:PDVectorFont
Returns true if this font contains a glyph for the given character code in a PDF.- Specified by:
hasGlyph
in interfacePDVectorFont
- Parameters:
code
- character code in a PDF. Not to be confused with unicode.- Throws:
IOException
-
codeToGID
Returns the GID for the given character code.- Parameters:
code
- character code- Returns:
- GID (glyph index)
- Throws:
IOException
-
extractCmapTable
extract all useful "cmap" subtables.- Throws:
IOException
-
PDType0Font.load(PDDocument, File)
instead.