Package org.apache.pdfbox.pdmodel.font
Class PDType1Font
java.lang.Object
org.apache.pdfbox.pdmodel.font.PDFont
org.apache.pdfbox.pdmodel.font.PDSimpleFont
org.apache.pdfbox.pdmodel.font.PDType1Font
- All Implemented Interfaces:
COSObjectable
,PDFontLike
- Direct Known Subclasses:
PDMMType1Font
A PostScript Type 1 Font.
-
Field Summary
FieldsModifier and TypeFieldDescriptionto improve encoding speed.static final PDType1Font
static final PDType1Font
static final PDType1Font
static final PDType1Font
private BoundingBox
private Matrix
private final AffineTransform
private final FontBoxFont
embedded or system font for rendering.static final PDType1Font
static final PDType1Font
static final PDType1Font
static final PDType1Font
private final boolean
private final boolean
private static final org.apache.commons.logging.Log
private static final int
static final PDType1Font
static final PDType1Font
static final PDType1Font
static final PDType1Font
static final PDType1Font
private final Type1Font
embedded font.static final PDType1Font
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
ConstructorsModifierConstructorDescriptionprivate
PDType1Font
(String baseFont) Creates a Type 1 standard 14 font for embedding.PDType1Font
(COSDictionary fontDictionary) Creates a Type 1 font from a Font dictionary in a PDF.PDType1Font
(PDDocument doc, InputStream pfbIn) Creates a new Type 1 font for embedding.PDType1Font
(PDDocument doc, InputStream pfbIn, Encoding encoding) Creates a new Type 1 font for embedding. -
Method Summary
Modifier and TypeMethodDescriptioncodeToName
(int code) protected byte[]
encode
(int unicode) Encodes the given Unicode code point for use in a PDF content stream.private static int
findBinaryOffsetAfterExec
(byte[] bytes, int startOffset) private BoundingBox
float
This will get the average font width for all characters.final String
Returns the PostScript name of the font.Returns the font's bounding box.Returns the embedded or system font used for rendering.final Matrix
Returns the font matrix, which represents the transformation from glyph space to text space.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".private String
getNameInFont
(String name) Maps a PostScript glyph name to the name in the underlying font, for example when using a TTF font we might map "W" to "uni0057".Returns the path for the character with the given name.Returns the embedded or substituted Type 1 font, or null if there is none.float
getWidthFromFont
(int code) Returns the width of a glyph in the embedded font file.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.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.private int
repairLength1
(byte[] bytes, int length1) Some Type 1 fonts have an invalid Length1, which causes the binary segment of the font to be truncated, see PDFBOX-2350, PDFBOX-3677.private int
repairLength2
(byte[] bytes, int length1, int length2) Some Type 1 fonts have an invalid Length2, see PDFBOX-3475.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, getCOSObject, getDisplacement, getFontDescriptor, 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 -
ALT_NAMES
-
PFB_START_MARKER
private static final int PFB_START_MARKER- See Also:
-
TIMES_ROMAN
-
TIMES_BOLD
-
TIMES_ITALIC
-
TIMES_BOLD_ITALIC
-
HELVETICA
-
HELVETICA_BOLD
-
HELVETICA_OBLIQUE
-
HELVETICA_BOLD_OBLIQUE
-
COURIER
-
COURIER_BOLD
-
COURIER_OBLIQUE
-
COURIER_BOLD_OBLIQUE
-
SYMBOL
-
ZAPF_DINGBATS
-
type1font
embedded font. -
genericFont
embedded or system font for rendering. -
isEmbedded
private final boolean isEmbedded -
isDamaged
private final boolean isDamaged -
fontMatrix
-
fontMatrixTransform
-
fontBBox
-
codeToBytesMap
to improve encoding speed.
-
-
Constructor Details
-
PDType1Font
Creates a Type 1 standard 14 font for embedding.- Parameters:
baseFont
- One of the standard 14 PostScript names
-
PDType1Font
Creates a new Type 1 font for embedding.- Parameters:
doc
- PDF document to write topfbIn
- PFB file stream- Throws:
IOException
-
PDType1Font
Creates a new Type 1 font for embedding.- Parameters:
doc
- PDF document to write topfbIn
- PFB file streamencoding
-- Throws:
IOException
-
PDType1Font
Creates a Type 1 font from a Font dictionary in a PDF.- Parameters:
fontDictionary
- font dictionary.- Throws:
IOException
- if there was an error initializing the font.IllegalArgumentException
- if /FontFile3 was used.
-
-
Method Details
-
repairLength1
private int repairLength1(byte[] bytes, int length1) Some Type 1 fonts have an invalid Length1, which causes the binary segment of the font to be truncated, see PDFBOX-2350, PDFBOX-3677.- Parameters:
bytes
- Type 1 stream byteslength1
- Length1 from the Type 1 stream- Returns:
- repaired Length1 value
-
findBinaryOffsetAfterExec
private static int findBinaryOffsetAfterExec(byte[] bytes, int startOffset) -
repairLength2
private int repairLength2(byte[] bytes, int length1, int length2) Some Type 1 fonts have an invalid Length2, see PDFBOX-3475. A negative /Length2 brings an IllegalArgumentException in Arrays.copyOfRange(), a huge value eats up memory because of padding.- Parameters:
bytes
- Type 1 stream byteslength1
- Length1 from the Type 1 streamlength2
- Length2 from the Type 1 stream- Returns:
- repaired Length2 value
-
getBaseFont
Returns the PostScript name of the font. -
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.- 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.
-
getWidthFromFont
Description copied from interface:PDFontLike
Returns the width of a glyph in the embedded font file.- Parameters:
code
- character code- Returns:
- width in glyph space
- Throws:
IOException
- if the font could not be read
-
isEmbedded
public boolean isEmbedded()Description copied from interface:PDFontLike
Returns true if the font file is embedded in the PDF. -
getAverageFontWidth
public float getAverageFontWidth()Description copied from class:PDFont
This will get the average font width for all characters.- Specified by:
getAverageFontWidth
in interfacePDFontLike
- Overrides:
getAverageFontWidth
in classPDFont
- Returns:
- The width is in 1000 unit of text space, ie 333 or 777
-
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
-
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.
-
getType1Font
Returns the embedded or substituted Type 1 font, or null if there is none. -
getFontBoxFont
Description copied from class:PDSimpleFont
Returns the embedded or system font used for rendering. This is never null.- Specified by:
getFontBoxFont
in classPDSimpleFont
-
getName
Description copied from interface:PDFontLike
Returns the name of this font, either the PostScript "BaseName" or the Type 3 "Name". -
getBoundingBox
Description copied from interface:PDFontLike
Returns the font's bounding box.- Throws:
IOException
-
generateBoundingBox
- Throws:
IOException
-
codeToName
- Throws:
IOException
-
getNameInFont
Maps a PostScript glyph name to the name in the underlying font, for example when using a TTF font we might map "W" to "uni0057".- Throws:
IOException
-
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
-
getFontMatrix
Description copied from interface:PDFontLike
Returns the font matrix, which represents the transformation from glyph space to text space.- Specified by:
getFontMatrix
in interfacePDFontLike
- Overrides:
getFontMatrix
in classPDFont
-
isDamaged
public boolean isDamaged()Description copied from interface:PDFontLike
Returns true if the embedded font file is damaged.
-