Package org.apache.pdfbox.pdmodel.font
Class Standard14Fonts
java.lang.Object
org.apache.pdfbox.pdmodel.font.Standard14Fonts
The "Standard 14" PDF fonts, also known as the "base 14" fonts.
There are 14 font files, but Acrobat uses additional names for compatibility, e.g. Arial.
-
Nested Class Summary
Nested ClassesModifier and TypeClassDescriptionstatic enumEnum for the names of the 14 standard fonts. -
Field Summary
FieldsModifier and TypeFieldDescriptionprivate static final Map<String, Standard14Fonts.FontName> Contains all base names and alias names for the known fonts.private static final Map<Standard14Fonts.FontName, FontMetrics> Contains the font metrics for the standard 14 fonts.private static final Map<Standard14Fonts.FontName, FontBoxFont> Contains the mapped fonts for the standard 14 fonts. -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionstatic booleancontainsName(String fontName) Returns true if the given font name is one of the known names, including alias.static FontMetricsReturns the metrics for font specified by fontName.private static GlyphListgetGlyphList(Standard14Fonts.FontName baseName) static GeneralPathgetGlyphPath(Standard14Fonts.FontName baseName, String glyphName) Returns the path for the character with the given name for the specified Standard 14 font.private static FontBoxFontgetMappedFont(Standard14Fonts.FontName baseName) Returns the mapped font for the specified Standard 14 font.static Standard14Fonts.FontNamegetMappedFontName(String fontName) Returns the base name of the font which the given font name maps to.getNames()Returns the set of known font names, including aliases.private static voidloadMetrics(Standard14Fonts.FontName fontName) Loads the metrics for the base font specified by name.private static voidmapName(String alias, Standard14Fonts.FontName baseName) Adds an alias name for a standard font to the map of known aliases to the map of aliases (alias as key, standard name as value).private static voidmapName(Standard14Fonts.FontName baseName) Adds a standard font name to the map of known aliases, to simplify the logic of finding font metrics by name.
-
Field Details
-
ALIASES
Contains all base names and alias names for the known fonts. For base fonts both the key and the value will be the base name. For aliases, the key is an alias, and the value is a FontName. We want a single lookup in the map to find the font both by a base name or an alias. -
FONTS
Contains the font metrics for the standard 14 fonts. The key is the font name, value is a FontMetrics instance. Metrics are loaded into this map on demand, only if needed.- See Also:
-
GENERIC_FONTS
Contains the mapped fonts for the standard 14 fonts. The key is the font name, value is a FontBoxFont instance. FontBoxFont are loaded into this map on demand, only if needed.
-
-
Constructor Details
-
Standard14Fonts
private Standard14Fonts()
-
-
Method Details
-
loadMetrics
Loads the metrics for the base font specified by name. Metric file must exist in the pdfbox jar under /org/apache/pdfbox/resources/afm/- Parameters:
fontName- one of the standard 14 font names for which to load the metrics.- Throws:
IOException- if no metrics exist for that font.
-
mapName
Adds a standard font name to the map of known aliases, to simplify the logic of finding font metrics by name. We want a single lookup in the map to find the font both by a base name or an alias.- Parameters:
baseName- the font name of the Standard 14 font- See Also:
-
mapName
Adds an alias name for a standard font to the map of known aliases to the map of aliases (alias as key, standard name as value). We want a single lookup in tbaseNamehe map to find the font both by a base name or an alias.- Parameters:
alias- an alias for the fontbaseName- the font name of the Standard 14 font
-
getAFM
Returns the metrics for font specified by fontName. Loads the font metrics if not already loaded.- Parameters:
fontName- name of font; either a base name or alias- Returns:
- the font metrics or null if the name is not one of the known names
- Throws:
IllegalArgumentException- if no metrics exist for that font.
-
containsName
Returns true if the given font name is one of the known names, including alias.- Parameters:
fontName- the name of font, either a base name or alias- Returns:
- true if the name is one of the known names
-
getNames
Returns the set of known font names, including aliases.- Returns:
- the set of known font names
-
getMappedFontName
Returns the base name of the font which the given font name maps to.- Parameters:
fontName- name of font, either a base name or an alias- Returns:
- the base name or null if this is not one of the known names
-
getMappedFont
Returns the mapped font for the specified Standard 14 font. The mapped font is cached.- Parameters:
baseName- name of the standard 14 font- Returns:
- the mapped font
-
getGlyphPath
public static GeneralPath getGlyphPath(Standard14Fonts.FontName baseName, String glyphName) throws IOException Returns the path for the character with the given name for the specified Standard 14 font. The mapped font is cached. The path may differ in different environments as it depends on the mapped font.- Parameters:
baseName- name of the standard 14 fontglyphName- name of glyph- Returns:
- the mapped font
- Throws:
IOException- if the data could not be read
-
getGlyphList
-