Package com.itextpdf.text.pdf
Class Type3Font
- java.lang.Object
-
- com.itextpdf.text.pdf.BaseFont
-
- com.itextpdf.text.pdf.Type3Font
-
public class Type3Font extends BaseFont
A class to support Type3 fonts.
-
-
Nested Class Summary
-
Nested classes/interfaces inherited from class com.itextpdf.text.pdf.BaseFont
BaseFont.StreamFont
-
-
Field Summary
Fields Modifier and Type Field Description private java.util.HashMap<java.lang.Integer,Type3Glyph>
char2glyph
private boolean
colorized
private float
llx
private float
lly
private PageResources
pageResources
private float
urx
private float
ury
private boolean[]
usedSlot
private IntHashtable
widths3
private PdfWriter
writer
-
Fields inherited from class com.itextpdf.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, DEFAULT_FONT_MATRIX, 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, FONT_WEIGHT, fontCache, fontSpecific, fontType, forceWidthsOutput, HELVETICA, HELVETICA_BOLD, HELVETICA_BOLDOBLIQUE, HELVETICA_OBLIQUE, IDENTITY_H, IDENTITY_V, ITALICANGLE, MACROMAN, NOT_CACHED, NOT_EMBEDDED, notdef, PARAGRAPH_SEPARATOR, RESOURCE_PATH, 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, vertical, WEIGHT_CLASS, WIDTH_CLASS, widths, WINANSI, ZAPFDINGBATS
-
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description boolean
charExists(int c)
Checks if a character exists in this font.(package private) byte[]
convertToBytes(int char1)
Converts achar
to a byte array according to the font's encoding.byte[]
convertToBytes(java.lang.String text)
Converts aString
to a byte array according to the font's encoding.PdfContentByte
defineGlyph(char c, float wx, float llx, float lly, float urx, float ury)
Defines a glyph.java.lang.String[][]
getAllNameEntries()
Gets all the entries of the names-table.int[]
getCharBBox(int c)
Gets the smallest box enclosing the character contours.java.lang.String[][]
getFamilyFontName()
Gets the family name of the font.float
getFontDescriptor(int key, float fontSize)
Gets the font parameter identified bykey
.java.lang.String[][]
getFullFontName()
Gets the full name of the font.PdfStream
getFullFontStream()
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.java.lang.String
getPostscriptFontName()
Gets the postscript font name.protected int[]
getRawCharBBox(int c, java.lang.String name)
(package private) int
getRawWidth(int c, java.lang.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
getWidth(java.lang.String text)
Gets the width of aString
in normalized 1000 units.boolean
hasKernPairs()
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(java.lang.String name)
Sets the font name that will appear in the pdf font dictionary.(package private) void
writeFont(PdfWriter writer, PdfIndirectReference ref, java.lang.Object[] params)
Outputs to the writer the font dictionaries and streams.-
Methods inherited from class com.itextpdf.text.pdf.BaseFont
addSubsetRange, correctArabicAdvance, createBuiltInFontDictionary, 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, getFontMatrix, getFontType, getFullFontName, getSubfamily, getUnicodeDifferences, getUnicodeDifferences, getUnicodeEquivalent, getWidthPoint, getWidthPoint, getWidthPointKerned, getWidths, isDirectTextToByte, isEmbedded, isFontSpecific, isForceWidthsOutput, isSubset, isVertical, normalizeEncoding, setCompressionLevel, setDirectTextToByte, setFontDescriptor, setForceWidthsOutput, setSubset
-
-
-
-
Field Detail
-
usedSlot
private boolean[] usedSlot
-
widths3
private IntHashtable widths3
-
char2glyph
private java.util.HashMap<java.lang.Integer,Type3Glyph> char2glyph
-
writer
private PdfWriter writer
-
llx
private float llx
-
lly
private float lly
-
urx
private float urx
-
ury
private float ury
-
pageResources
private PageResources pageResources
-
colorized
private boolean colorized
-
-
Constructor Detail
-
Type3Font
public Type3Font(PdfWriter writer, char[] chars, boolean colorized)
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
public Type3Font(PdfWriter writer, boolean colorized)
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 Detail
-
defineGlyph
public PdfContentByte defineGlyph(char c, float wx, float llx, float lly, float urx, float ury)
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
public java.lang.String[][] 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
public java.lang.String[][] 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
public java.lang.String[][] 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
public java.lang.String getPostscriptFontName()
Description copied from class:BaseFont
Gets the postscript font name.- Specified by:
getPostscriptFontName
in classBaseFont
- Returns:
- the postscript font name
-
getRawCharBBox
protected int[] getRawCharBBox(int c, java.lang.String name)
- Specified by:
getRawCharBBox
in classBaseFont
-
getRawWidth
int getRawWidth(int c, java.lang.String name)
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
-
setPostscriptFontName
public void setPostscriptFontName(java.lang.String name)
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
-
writeFont
void writeFont(PdfWriter writer, PdfIndirectReference ref, java.lang.Object[] params) throws DocumentException, java.io.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 objectjava.io.IOException
- on error
-
getFullFontStream
public PdfStream 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
public byte[] convertToBytes(java.lang.String text)
Description copied from class:BaseFont
Converts aString
to a byte 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 a byte 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
public int getWidth(java.lang.String text)
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
-
-