Package com.lowagie.text.pdf
Class Type3Font
java.lang.Object
com.lowagie.text.pdf.BaseFont
com.lowagie.text.pdf.Type3Font
A class to support Type3 fonts.
-
Nested Class Summary
Nested classes/interfaces inherited from class com.lowagie.text.pdf.BaseFont
BaseFont.StreamFont
-
Field Summary
FieldsModifier and TypeFieldDescriptionprivate Map
<Integer, Type3Glyph> private boolean
private float
private float
private PageResources
private float
private float
private boolean[]
private IntHashtable
private PdfWriter
Fields inherited from class com.lowagie.text.pdf.BaseFont
ASCENT, AWT_ASCENT, AWT_DESCENT, AWT_LEADING, AWT_MAXADVANCE, BBOXLLX, BBOXLLY, BBOXURX, BBOXURY, BuiltinFonts14, CACHED, CAPHEIGHT, CHAR_RANGE_ARABIC, CHAR_RANGE_CYRILLIC, CHAR_RANGE_HEBREW, CHAR_RANGE_LATIN, charBBoxes, CID_NEWLINE, compressionLevel, COURIER, COURIER_BOLD, COURIER_BOLDOBLIQUE, COURIER_OBLIQUE, CP1250, CP1252, CP1257, DESCENT, differences, directTextToByte, embedded, EMBEDDED, encoding, fastWinansi, FONT_TYPE_CJK, FONT_TYPE_DOCUMENT, FONT_TYPE_T1, FONT_TYPE_T3, FONT_TYPE_TT, FONT_TYPE_TTUNI, fontCache, fontSpecific, fontType, forceWidthsOutput, HELVETICA, HELVETICA_BOLD, HELVETICA_BOLDOBLIQUE, HELVETICA_OBLIQUE, IDENTITY_H, IDENTITY_V, includeCidSet, ITALICANGLE, MACROMAN, NOT_CACHED, NOT_EMBEDDED, notdef, RESOURCE_PATH, secureRandom, specialMap, STRIKETHROUGH_POSITION, STRIKETHROUGH_THICKNESS, SUBSCRIPT_OFFSET, SUBSCRIPT_SIZE, subset, subsetRanges, SUPERSCRIPT_OFFSET, SUPERSCRIPT_SIZE, SYMBOL, TIMES_BOLD, TIMES_BOLDITALIC, TIMES_ITALIC, TIMES_ROMAN, UNDERLINE_POSITION, UNDERLINE_THICKNESS, unicodeDifferences, widths, WINANSI, ZAPFDINGBATS
-
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionboolean
charExists
(int c) Checks if a character exists in this font.(package private) byte[]
convertToBytes
(int char1) Converts achar
to abyte
array according to the font's encoding.(package private) byte[]
convertToBytes
(String text) Converts aString
to abyte
array according to the font's encoding.defineGlyph
(char c, float wx, float llx, float lly, float urx, float ury) Defines a glyph.String[][]
Gets all the entries of the names-table.int[]
getCharBBox
(int c) Gets the smallest box enclosing the character contours.String[][]
Gets the family name of the font.float
getFontDescriptor
(int key, float fontSize) Gets the font parameter identified bykey
.String[][]
Gets the full name of the font.Always returns null, because you can't get the FontStream of a Type3 font.int
getKerning
(int char1, int char2) Gets the kerning between two Unicode chars.Gets the postscript font name.protected int[]
getRawCharBBox
(int c, String name) (package private) int
getRawWidth
(int c, String name) Gets the width from the font according to the Unicode charc
or thename
.int
getWidth
(int char1) Gets the width of achar
in normalized 1000 units.int
Gets the width of aString
in normalized 1000 units.boolean
Checks if the font has any kerning pairs.boolean
setCharAdvance
(int c, int advance) Sets the character advance.boolean
setKerning
(int char1, int char2, int kern) Sets the kerning between two Unicode chars.void
setPostscriptFontName
(String name) Sets the font name that will appear in the pdf font dictionary.(package private) void
writeFont
(PdfWriter writer, PdfIndirectReference ref, Object[] params) Outputs to the writer the font dictionaries and streams.Methods inherited from class com.lowagie.text.pdf.BaseFont
addSubsetRange, correctArabicAdvance, createEncoding, createFont, createFont, createFont, createFont, createFont, createFont, createFont, createSubsetPrefix, enumerateTTCNames, enumerateTTCNames, getAllFontNames, getAllNameEntries, getAscent, getAscentPoint, getBaseName, getCidCode, getCodePagesSupported, getCompressionLevel, getDescent, getDescentPoint, getDifferences, getDocumentFonts, getDocumentFonts, getEncoding, getFontType, getFullFontName, getResourceStream, getResourceStream, getSecureRandom, getUnicodeDifferences, getUnicodeDifferences, getUnicodeEquivalent, getWidthPoint, getWidthPoint, getWidthPointKerned, getWidths, isDirectTextToByte, isEmbedded, isFontSpecific, isForceWidthsOutput, isIncludeCidSet, isSubset, normalizeEncoding, setCompressionLevel, setDirectTextToByte, setForceWidthsOutput, setIncludeCidSet, setSecureRandom, setSubset
-
Field Details
-
usedSlot
private boolean[] usedSlot -
widths3
-
char2glyph
-
writer
-
llx
private float llx -
lly
private float lly -
urx
private float urx -
ury
private float ury -
pageResources
-
colorized
private boolean colorized
-
-
Constructor Details
-
Type3Font
Creates a Type3 font.- Parameters:
writer
- the writerchars
- an array of chars corresponding to the glyphs used (not used, present for compatibility only)colorized
- iftrue
the font may specify color, iffalse
no color commands are allowed and only images as masks can be used
-
Type3Font
Creates a Type3 font. This implementation assumes that the /FontMatrix is [0.001 0 0 0.001 0 0] or a 1000-unit glyph coordinate system. An example:Document document = new Document(PageSize.A4); PdfWriter writer = PdfWriter.getInstance(document, new FileOutputStream("type3.pdf")); document.open(); Type3Font t3 = new Type3Font(writer, false); PdfContentByte g = t3.defineGlyph('a', 1000, 0, 0, 750, 750); g.rectangle(0, 0, 750, 750); g.fill(); g = t3.defineGlyph('b', 1000, 0, 0, 750, 750); g.moveTo(0, 0); g.lineTo(375, 750); g.lineTo(750, 0); g.fill(); Font f = new Font(t3, 12); document.add(new Paragraph("ababab", f)); document.close();
- Parameters:
writer
- the writercolorized
- iftrue
the font may specify color, iffalse
no color commands are allowed and only images as masks can be used
-
-
Method Details
-
defineGlyph
Defines a glyph. If the character was already defined it will return the same content- Parameters:
c
- the character to match this glyph.wx
- the advance this character will havellx
- the X lower left corner of the glyph bounding box. If thecolorize
option istrue
the value is ignoredlly
- the Y lower left corner of the glyph bounding box. If thecolorize
option istrue
the value is ignoredurx
- the X upper right corner of the glyph bounding box. If thecolorize
option istrue
the value is ignoredury
- the Y upper right corner of the glyph bounding box. If thecolorize
option istrue
the value is ignored- Returns:
- a content where the glyph can be defined
-
getFamilyFontName
Description copied from class:BaseFont
Gets the family name of the font. If it is a True Type font each array element will have {Platform ID, Platform Encoding ID, Language ID, font name}. The interpretation of this values can be found in the Open Type specification, chapter 2, in the 'name' table.
For the other fonts the array has a single element with {"", "", "", font name}.- Specified by:
getFamilyFontName
in classBaseFont
- Returns:
- the family name of the font
-
getFontDescriptor
public float getFontDescriptor(int key, float fontSize) Description copied from class:BaseFont
Gets the font parameter identified bykey
. Valid values forkey
areASCENT
,AWT_ASCENT
,CAPHEIGHT
,DESCENT
,AWT_DESCENT
,ITALICANGLE
,BBOXLLX
,BBOXLLY
,BBOXURX
andBBOXURY
.- Specified by:
getFontDescriptor
in classBaseFont
- Parameters:
key
- the parameter to be extractedfontSize
- the font size in points- Returns:
- the parameter in points
-
getFullFontName
Description copied from class:BaseFont
Gets the full name of the font. If it is a True Type font each array element will have {Platform ID, Platform Encoding ID, Language ID, font name}. The interpretation of this values can be found in the Open Type specification, chapter 2, in the 'name' table.
For the other fonts the array has a single element with {"", "", "", font name}.- Specified by:
getFullFontName
in classBaseFont
- Returns:
- the full name of the font
-
getAllNameEntries
Description copied from class:BaseFont
Gets all the entries of the names-table. If it is a True Type font each array element will have {Name ID, Platform ID, Platform Encoding ID, Language ID, font name}. The interpretation of this values can be found in the Open Type specification, chapter 2, in the 'name' table.
For the other fonts the array has a single element with {"4", "", "", "", font name}.- Specified by:
getAllNameEntries
in classBaseFont
- Returns:
- the full name of the font
- Since:
- 2.0.8
-
getKerning
public int getKerning(int char1, int char2) Description copied from class:BaseFont
Gets the kerning between two Unicode chars.- Specified by:
getKerning
in classBaseFont
- Parameters:
char1
- the first charchar2
- the second char- Returns:
- the kerning to be applied in normalized 1000 units
-
getPostscriptFontName
Description copied from class:BaseFont
Gets the postscript font name.- Specified by:
getPostscriptFontName
in classBaseFont
- Returns:
- the postscript font name
-
setPostscriptFontName
Description copied from class:BaseFont
Sets the font name that will appear in the pdf font dictionary. Use with care as it can easily make a font unreadable if not embedded.- Specified by:
setPostscriptFontName
in classBaseFont
- Parameters:
name
- the new font name
-
getRawCharBBox
- Specified by:
getRawCharBBox
in classBaseFont
-
getRawWidth
Description copied from class:BaseFont
Gets the width from the font according to the Unicode charc
or thename
. If thename
is null it's a symbolic font.- Specified by:
getRawWidth
in classBaseFont
- Parameters:
c
- the unicode charname
- the glyph name- Returns:
- the width of the char
-
hasKernPairs
public boolean hasKernPairs()Description copied from class:BaseFont
Checks if the font has any kerning pairs.- Specified by:
hasKernPairs
in classBaseFont
- Returns:
true
if the font has any kerning pairs
-
setKerning
public boolean setKerning(int char1, int char2, int kern) Description copied from class:BaseFont
Sets the kerning between two Unicode chars.- Specified by:
setKerning
in classBaseFont
- Parameters:
char1
- the first charchar2
- the second charkern
- the kerning to apply in normalized 1000 units- Returns:
true
if the kerning was applied,false
otherwise
-
writeFont
void writeFont(PdfWriter writer, PdfIndirectReference ref, Object[] params) throws DocumentException, IOException Description copied from class:BaseFont
Outputs to the writer the font dictionaries and streams.- Specified by:
writeFont
in classBaseFont
- Parameters:
writer
- the writer for this documentref
- the font indirect referenceparams
- several parameters that depend on the font type- Throws:
DocumentException
- error in generating the objectIOException
- on error
-
getFullFontStream
Always returns null, because you can't get the FontStream of a Type3 font.- Specified by:
getFullFontStream
in classBaseFont
- Returns:
- null
- Since:
- 2.1.3
-
convertToBytes
Description copied from class:BaseFont
Converts aString
to abyte
array according to the font's encoding.- Overrides:
convertToBytes
in classBaseFont
- Parameters:
text
- theString
to be converted- Returns:
- an array of
byte
representing the conversion according to the font's encoding
-
convertToBytes
byte[] convertToBytes(int char1) Description copied from class:BaseFont
Converts achar
to abyte
array according to the font's encoding.- Overrides:
convertToBytes
in classBaseFont
- Parameters:
char1
- thechar
to be converted- Returns:
- an array of
byte
representing the conversion according to the font's encoding
-
getWidth
public int getWidth(int char1) Description copied from class:BaseFont
Gets the width of achar
in normalized 1000 units. -
getWidth
Description copied from class:BaseFont
Gets the width of aString
in normalized 1000 units. -
getCharBBox
public int[] getCharBBox(int c) Description copied from class:BaseFont
Gets the smallest box enclosing the character contours. It will returnnull
if the font has not the information or the character has no contours, as in the case of the space, for example. Characters with no contours may also return [0,0,0,0].- Overrides:
getCharBBox
in classBaseFont
- Parameters:
c
- the character to get the contour bounding box from- Returns:
- an array of four floats with the bounding box in the format [llx,lly,urx,ury] or
null
-
charExists
public boolean charExists(int c) Description copied from class:BaseFont
Checks if a character exists in this font.- Overrides:
charExists
in classBaseFont
- Parameters:
c
- the character to check- Returns:
true
if the character has a glyph,false
otherwise
-
setCharAdvance
public boolean setCharAdvance(int c, int advance) Description copied from class:BaseFont
Sets the character advance.- Overrides:
setCharAdvance
in classBaseFont
- Parameters:
c
- the characteradvance
- the character advance normalized to 1000 units- Returns:
true
if the advance was set,false
otherwise
-