添加链接
link管理
链接快照平台
  • 输入网页链接,自动生成快照
  • 标签化管理网页链接
相关文章推荐
踏实的柳树  ·  [Solved] Asynchronous ...·  2 月前    · 
static BaseFont createFont ( String name, String encoding, boolean embedded, boolean forceRead) Creates a new font. static BaseFont createFont ( String name, String encoding, boolean embedded, boolean cached, byte[] ttfAfm, byte[] pfb) Creates a new font. static BaseFont createFont ( String name, String encoding, boolean embedded, boolean cached, byte[] ttfAfm, byte[] pfb, boolean noThrow) Creates a new font. static BaseFont createFont ( String name, String encoding, boolean embedded, boolean cached, byte[] ttfAfm, byte[] pfb, boolean noThrow, boolean forceRead) Creates a new font. static String createSubsetPrefix () Creates a unique subset prefix to be added to the font name when the font is embedded and subset. static String [] enumerateTTCNames (byte[] ttcArray) Enumerates the postscript font names present inside a True Type Collection. static String [] enumerateTTCNames ( String ttcFile) Enumerates the postscript font names present inside a True Type Collection. static Object [] getAllFontNames ( String name, String encoding, byte[] ttfAfm) Gets all the names from the font. abstract String [][] getAllNameEntries () Gets all the entries of the names-table. static String [][] getAllNameEntries ( String name, String encoding, byte[] ttfAfm) Gets all the entries of the namestable from the font. getAscent ( String text) Gets the ascent of a String in normalized 1000 units. float getAscentPoint ( String text, float fontSize) Gets the ascent of a String in points. protected static String getBaseName ( String name) Gets the name without the modifiers Bold, Italic or BoldItalic. int[] getCharBBox (int c) Gets the smallest box enclosing the character contours. getCidCode (int c) Gets the CID code given an Unicode. String [] getCodePagesSupported () Gets the code pages supported by the font. getCompressionLevel () Returns the compression level used for the font streams. getDescent ( String text) Gets the descent of a String in normalized 1000 units. float getDescentPoint ( String text, float fontSize) Gets the descent of a String in points. String [] getDifferences () Gets the array with the names of the characters. static ArrayList < Object []> getDocumentFonts ( PdfReader reader) Gets a list of all document fonts. static ArrayList < Object []> getDocumentFonts ( PdfReader reader, int page) Gets a list of the document fonts in a particular page. String getEncoding () Gets the encoding used to convert String into byte[] . abstract String [][] getFamilyFontName () Gets the family name of the font. abstract float getFontDescriptor (int key, float fontSize) Gets the font parameter identified by key . double[] getFontMatrix () get default array of six numbers specifying the font matrix, mapping glyph space to text space getFontType () Gets the font type. abstract String [][] getFullFontName () Gets the full name of the font. static String [][] getFullFontName ( String name, String encoding, byte[] ttfAfm) Gets the full name of the font. abstract int getKerning (int char1, int char2) Gets the kerning between two Unicode chars. abstract String getPostscriptFontName () Gets the postscript font name. protected abstract int[] getRawCharBBox (int c, String name) String getSubfamily () char[] getUnicodeDifferences () Gets the array with the unicode characters. getUnicodeEquivalent (int c) Gets the Unicode equivalent to a CID. getWidth (int char1) Gets the width of a char in normalized 1000 units. getWidth ( String text) Gets the width of a String in normalized 1000 units. float getWidthPoint (int char1, float fontSize) Gets the width of a char in points. float getWidthPoint ( String text, float fontSize) Gets the width of a String in points. float getWidthPointKerned ( String text, float fontSize) Gets the width of a String in points taking kerning into account. int[] getWidths () Gets the font width array. abstract boolean hasKernPairs () Checks if the font has any kerning pairs. boolean isDirectTextToByte () Gets the direct conversion of char to byte . boolean isEmbedded () Gets the embedded flag. boolean isFontSpecific () Gets the symbolic flag of the font. boolean isForceWidthsOutput () Gets the state of the property. boolean isSubset () Indicates if all the glyphs and widths for that particular encoding should be included in the document. boolean isVertical () Indicates whether the font is used for verticl writing or not. protected static String normalizeEncoding ( String enc) Normalize the encoding names. boolean setCharAdvance (int c, int advance) Sets the character advance. setCompressionLevel (int compressionLevel) Sets the compression level to be used for the font streams. setDirectTextToByte (boolean directTextToByte) Sets the conversion of char directly to byte by casting. setFontDescriptor (int key, float value) Sets the font parameter identified by key . setForceWidthsOutput (boolean forceWidthsOutput) Set to true to force the generation of the widths array. abstract boolean setKerning (int char1, int char2, int kern) Sets the kerning between two Unicode chars. abstract void setPostscriptFontName ( String name) Sets the font name that will appear in the pdf font dictionary. setSubset (boolean subset) Indicates if all the glyphs and widths for that particular encoding should be included in the document.
  • COURIER

    public static final String COURIER
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • COURIER_BOLD

    public static final String COURIER_BOLD
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • COURIER_OBLIQUE

    public static final String COURIER_OBLIQUE
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • COURIER_BOLDOBLIQUE

    public static final String COURIER_BOLDOBLIQUE
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • HELVETICA

    public static final String HELVETICA
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • HELVETICA_BOLD

    public static final String HELVETICA_BOLD
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • HELVETICA_OBLIQUE

    public static final String HELVETICA_OBLIQUE
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • HELVETICA_BOLDOBLIQUE

    public static final String HELVETICA_BOLDOBLIQUE
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • SYMBOL

    public static final String SYMBOL
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • TIMES_ROMAN

    public static final String TIMES_ROMAN
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • TIMES_BOLD

    public static final String TIMES_BOLD
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • TIMES_ITALIC

    public static final String TIMES_ITALIC
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • TIMES_BOLDITALIC

    public static final String TIMES_BOLDITALIC
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • ZAPFDINGBATS

    public static final String ZAPFDINGBATS
    This is a possible value of a base 14 type 1 font
    See Also:
    Constant Field Values
  • ASCENT

    public static final int ASCENT
    The maximum height above the baseline reached by glyphs in this font, excluding the height of glyphs for accented characters.
    See Also:
    Constant Field Values
  • CAPHEIGHT

    public static final int CAPHEIGHT
    The y coordinate of the top of flat capital letters, measured from the baseline.
    See Also:
    Constant Field Values
  • DESCENT

    public static final int DESCENT
    The maximum depth below the baseline reached by glyphs in this font. The value is a negative number.
    See Also:
    Constant Field Values
  • ITALICANGLE

    public static final int ITALICANGLE
    The angle, expressed in degrees counterclockwise from the vertical, of the dominant vertical strokes of the font. The value is negative for fonts that slope to the right, as almost all italic fonts do.
    See Also:
    Constant Field Values
  • UNDERLINE_POSITION

    public static final int UNDERLINE_POSITION
    The underline position. Usually a negative value.
    See Also:
    Constant Field Values
  • STRIKETHROUGH_POSITION

    public static final int STRIKETHROUGH_POSITION
    The strikethrough position.
    See Also:
    Constant Field Values
  • STRIKETHROUGH_THICKNESS

    public static final int STRIKETHROUGH_THICKNESS
    The strikethrough thickness.
    See Also:
    Constant Field Values
  • SUBSCRIPT_SIZE

    public static final int SUBSCRIPT_SIZE
    The recommended vertical size for subscripts for this font.
    See Also:
    Constant Field Values
  • SUBSCRIPT_OFFSET

    public static final int SUBSCRIPT_OFFSET
    The recommended vertical offset from the baseline for subscripts for this font. Usually a negative value.
    See Also:
    Constant Field Values
  • SUPERSCRIPT_SIZE

    public static final int SUPERSCRIPT_SIZE
    The recommended vertical size for superscripts for this font.
    See Also:
    Constant Field Values
  • SUPERSCRIPT_OFFSET

    public static final int SUPERSCRIPT_OFFSET
    The recommended vertical offset from the baseline for superscripts for this font.
    See Also:
    Constant Field Values
  • WEIGHT_CLASS

    public static final int WEIGHT_CLASS
    The weight class of the font, as defined by the font author
    Since: 5.0.2
    See Also:
    Constant Field Values
  • WIDTH_CLASS

    public static final int WIDTH_CLASS
    The width class of the font, as defined by the font author
    Since: 5.0.2
    See Also:
    Constant Field Values
  • FONT_WEIGHT

    public static final int FONT_WEIGHT
    The entry of PDF FontDescriptor dictionary. (Optional; PDF 1.5; strongly recommended for Type 3 fonts in Tagged PDF documents) The weight (thickness) component of the fully-qualified font name or font specifier. A value larger than 500 indicates bold font-weight.
    See Also:
    Constant Field Values
  • FONT_TYPE_TT

    public static final int FONT_TYPE_TT
    The font is True Type with a standard encoding.
    See Also:
    Constant Field Values
  • FONT_TYPE_TTUNI

    public static final int FONT_TYPE_TTUNI
    The font is True Type with a Unicode encoding.
    See Also:
    Constant Field Values
  • FONT_TYPE_DOCUMENT

    public static final int FONT_TYPE_DOCUMENT
    A font already inside the document.
    See Also:
    Constant Field Values
  • IDENTITY_H

    public static final String IDENTITY_H
    The Unicode encoding with horizontal writing.
    See Also:
    Constant Field Values
  • IDENTITY_V

    public static final String IDENTITY_V
    The Unicode encoding with vertical writing.
    See Also:
    Constant Field Values
  • NOT_EMBEDDED

    public static final boolean NOT_EMBEDDED
    if the font doesn't have to be embedded
    See Also:
    Constant Field Values
  • CID_NEWLINE

    public static final char CID_NEWLINE
    The fake CID code that represents a newline.
    See Also:
    Constant Field Values
  • PARAGRAPH_SEPARATOR

    public static final char PARAGRAPH_SEPARATOR
    Unicode Character 'PARAGRAPH SEPARATOR' (U+2029) Treated as a line feed character in XFA rich and plain text.
    Since: 5.4.3
    See Also:
    Constant Field Values
  • notdef

    public static final String notdef
    a not defined character in a custom PDF encoding
    See Also:
    Constant Field Values
  • compressionLevel

    protected int compressionLevel
    The compression level for the font stream.
    Since: 2.1.3 IOException Creates a new font. This will always be the default Helvetica font (not embedded). This method is introduced because Helvetica is used in many examples.
    Returns: a BaseFont object (Helvetica, Winansi, not embedded)
    Throws:
    IOException - This shouldn't occur ever
    DocumentException - This shouldn't occur ever
    Since: 2.1.1
  • createFont

    public static BaseFont createFont(String name,
                                      String encoding,
                                      boolean embedded)
                               throws DocumentException,
                                      IOException
    Creates a new font. This font can be one of the 14 built in types, a Type1 font referred to by an AFM or PFM file, a TrueType font (simple or collection) or a CJK font from the Adobe Asian Font Pack. TrueType fonts and CJK fonts can have an optional style modifier appended to the name. These modifiers are: Bold, Italic and BoldItalic. An example would be "STSong-Light,Bold". Note that this modifiers do not work if the font is embedded. Fonts in TrueType collections are addressed by index such as "msgothic.ttc,1". This would get the second font (indexes start at 0), in this case "MS PGothic".

    The fonts are cached and if they already exist they are extracted from the cache, not parsed again.

    Besides the common encodings described by name, custom encodings can also be made. These encodings will only work for the single byte fonts Type1 and TrueType. The encoding string starts with a '#' followed by "simple" or "full". If "simple" there is a decimal for the first character position and then a list of hex values representing the Unicode codes that compose that encoding.
    The "simple" encoding is recommended for TrueType fonts as the "full" encoding risks not matching the character with the right glyph if not done with care.
    The "full" encoding is specially aimed at Type1 fonts where the glyphs have to be described by non standard names like the Tex math fonts. Each group of three elements compose a code position: the one byte code order in decimal or as 'x' (x cannot be the space), the name and the Unicode character used to access the glyph. The space must be assigned to character position 32 otherwise text justification will not work.

    Example for a "simple" encoding that includes the Unicode character space, A, B and ecyrillic:

     "# simple 32 0020 0041 0042 0454"
               

    Example for a "full" encoding for a Type1 Tex font:

     "# full 'A' nottriangeqlleft 0041 'B' dividemultiply 0042 32 space 0020"
               

    This method calls:

     createFont(name, encoding, embedded, true, null, null);
               
    Parameters:
    name - the name of the font or its location on file
    encoding - the encoding to be applied to this font
    embedded - true if the font is to be embedded in the PDF
    Returns: returns a new font. This font may come from the cache
    Throws:
    DocumentException - the font is invalid
    IOException - the font file could not be read
  • createFont

    public static BaseFont createFont(String name,
                                      String encoding,
                                      boolean embedded,
                                      boolean forceRead)
                               throws DocumentException,
                                      IOException
    Creates a new font. This font can be one of the 14 built in types, a Type1 font referred to by an AFM or PFM file, a TrueType font (simple or collection) or a CJK font from the Adobe Asian Font Pack. TrueType fonts and CJK fonts can have an optional style modifier appended to the name. These modifiers are: Bold, Italic and BoldItalic. An example would be "STSong-Light,Bold". Note that this modifiers do not work if the font is embedded. Fonts in TrueType collections are addressed by index such as "msgothic.ttc,1". This would get the second font (indexes start at 0), in this case "MS PGothic".

    The fonts are cached and if they already exist they are extracted from the cache, not parsed again.

    Besides the common encodings described by name, custom encodings can also be made. These encodings will only work for the single byte fonts Type1 and TrueType. The encoding string starts with a '#' followed by "simple" or "full". If "simple" there is a decimal for the first character position and then a list of hex values representing the Unicode codes that compose that encoding.
    The "simple" encoding is recommended for TrueType fonts as the "full" encoding risks not matching the character with the right glyph if not done with care.
    The "full" encoding is specially aimed at Type1 fonts where the glyphs have to be described by non standard names like the Tex math fonts. Each group of three elements compose a code position: the one byte code order in decimal or as 'x' (x cannot be the space), the name and the Unicode character used to access the glyph. The space must be assigned to character position 32 otherwise text justification will not work.

    Example for a "simple" encoding that includes the Unicode character space, A, B and ecyrillic:

     "# simple 32 0020 0041 0042 0454"
               

    Example for a "full" encoding for a Type1 Tex font:

     "# full 'A' nottriangeqlleft 0041 'B' dividemultiply 0042 32 space 0020"
               

    This method calls:

     createFont(name, encoding, embedded, true, null, null);
               
    Parameters:
    name - the name of the font or its location on file
    encoding - the encoding to be applied to this font
    embedded - true if the font is to be embedded in the PDF
    forceRead - in some cases (TrueTypeFont, Type1Font), the full font file will be read and kept in memory if forceRead is true
    Returns: returns a new font. This font may come from the cache
    Throws:
    DocumentException - the font is invalid
    IOException - the font file could not be read
    Since: 2.1.5
  • createFont

    public static BaseFont createFont(String name,
                                      String encoding,
                                      boolean embedded,
                                      boolean cached,
                                      byte[] ttfAfm,
                                      byte[] pfb)
                               throws DocumentException,
                                      IOException
    Creates a new font. This font can be one of the 14 built in types, a Type1 font referred to by an AFM or PFM file, a TrueType font (simple or collection) or a CJK font from the Adobe Asian Font Pack. TrueType fonts and CJK fonts can have an optional style modifier appended to the name. These modifiers are: Bold, Italic and BoldItalic. An example would be "STSong-Light,Bold". Note that this modifiers do not work if the font is embedded. Fonts in TrueType collections are addressed by index such as "msgothic.ttc,1". This would get the second font (indexes start at 0), in this case "MS PGothic".

    The fonts may or may not be cached depending on the flag cached. If the byte arrays are present the font will be read from them instead of the name. A name is still required to identify the font type.

    Besides the common encodings described by name, custom encodings can also be made. These encodings will only work for the single byte fonts Type1 and TrueType. The encoding string starts with a '#' followed by "simple" or "full". If "simple" there is a decimal for the first character position and then a list of hex values representing the Unicode codes that compose that encoding.
    The "simple" encoding is recommended for TrueType fonts as the "full" encoding risks not matching the character with the right glyph if not done with care.
    The "full" encoding is specially aimed at Type1 fonts where the glyphs have to be described by non standard names like the Tex math fonts. Each group of three elements compose a code position: the one byte code order in decimal or as 'x' (x cannot be the space), the name and the Unicode character used to access the glyph. The space must be assigned to character position 32 otherwise text justification will not work.

    Example for a "simple" encoding that includes the Unicode character space, A, B and ecyrillic:

     "# simple 32 0020 0041 0042 0454"
               

    Example for a "full" encoding for a Type1 Tex font:

     "# full 'A' nottriangeqlleft 0041 'B' dividemultiply 0042 32 space 0020"
               
    Parameters:
    name - the name of the font or its location on file
    encoding - the encoding to be applied to this font
    embedded - true if the font is to be embedded in the PDF
    cached - true if the font comes from the cache or is added to the cache if new, false if the font is always created new
    ttfAfm - the true type font or the afm in a byte array
    pfb - the pfb in a byte array
    Returns: returns a new font. This font may come from the cache but only if cached is true, otherwise it will always be created new
    Throws:
    DocumentException - the font is invalid
    IOException - the font file could not be read
    Since: iText 0.80
  • createFont

    public static BaseFont createFont(String name,
                                      String encoding,
                                      boolean embedded,
                                      boolean cached,
                                      byte[] ttfAfm,
                                      byte[] pfb,
                                      boolean noThrow)
                               throws DocumentException,
                                      IOException
    Creates a new font. This font can be one of the 14 built in types, a Type1 font referred to by an AFM or PFM file, a TrueType font (simple or collection) or a CJK font from the Adobe Asian Font Pack. TrueType fonts and CJK fonts can have an optional style modifier appended to the name. These modifiers are: Bold, Italic and BoldItalic. An example would be "STSong-Light,Bold". Note that this modifiers do not work if the font is embedded. Fonts in TrueType collections are addressed by index such as "msgothic.ttc,1". This would get the second font (indexes start at 0), in this case "MS PGothic".

    The fonts may or may not be cached depending on the flag cached. If the byte arrays are present the font will be read from them instead of the name. A name is still required to identify the font type.

    Besides the common encodings described by name, custom encodings can also be made. These encodings will only work for the single byte fonts Type1 and TrueType. The encoding string starts with a '#' followed by "simple" or "full". If "simple" there is a decimal for the first character position and then a list of hex values representing the Unicode codes that compose that encoding.
    The "simple" encoding is recommended for TrueType fonts as the "full" encoding risks not matching the character with the right glyph if not done with care.
    The "full" encoding is specially aimed at Type1 fonts where the glyphs have to be described by non standard names like the Tex math fonts. Each group of three elements compose a code position: the one byte code order in decimal or as 'x' (x cannot be the space), the name and the Unicode character used to access the glyph. The space must be assigned to character position 32 otherwise text justification will not work.

    Example for a "simple" encoding that includes the Unicode character space, A, B and ecyrillic:

     "# simple 32 0020 0041 0042 0454"
               

    Example for a "full" encoding for a Type1 Tex font:

     "# full 'A' nottriangeqlleft 0041 'B' dividemultiply 0042 32 space 0020"
               
    Parameters:
    name - the name of the font or its location on file
    encoding - the encoding to be applied to this font
    embedded - true if the font is to be embedded in the PDF
    cached - true if the font comes from the cache or is added to the cache if new, false if the font is always created new
    ttfAfm - the true type font or the afm in a byte array
    pfb - the pfb in a byte array
    noThrow - if true will not throw an exception if the font is not recognized and will return null, if false will throw an exception if the font is not recognized. Note that even if true an exception may be thrown in some circumstances. This parameter is useful for FontFactory that may have to check many invalid font names before finding the right one
    Returns: returns a new font. This font may come from the cache but only if cached is true, otherwise it will always be created new
    Throws:
    DocumentException - the font is invalid
    IOException - the font file could not be read
    Since: 2.0.3
  • createFont

    public static BaseFont createFont(String name,
                                      String encoding,
                                      boolean embedded,
                                      boolean cached,
                                      byte[] ttfAfm,
                                      byte[] pfb,
                                      boolean noThrow,
                                      boolean forceRead)
                               throws DocumentException,
                                      IOException
    Creates a new font. This font can be one of the 14 built in types, a Type1 font referred to by an AFM or PFM file, a TrueType font (simple or collection) or a CJK font from the Adobe Asian Font Pack. TrueType fonts and CJK fonts can have an optional style modifier appended to the name. These modifiers are: Bold, Italic and BoldItalic. An example would be "STSong-Light,Bold". Note that this modifiers do not work if the font is embedded. Fonts in TrueType collections are addressed by index such as "msgothic.ttc,1". This would get the second font (indexes start at 0), in this case "MS PGothic".

    The fonts may or may not be cached depending on the flag cached. If the byte arrays are present the font will be read from them instead of the name. A name is still required to identify the font type.

    Besides the common encodings described by name, custom encodings can also be made. These encodings will only work for the single byte fonts Type1 and TrueType. The encoding string starts with a '#' followed by "simple" or "full". If "simple" there is a decimal for the first character position and then a list of hex values representing the Unicode codes that compose that encoding.
    The "simple" encoding is recommended for TrueType fonts as the "full" encoding risks not matching the character with the right glyph if not done with care.
    The "full" encoding is specially aimed at Type1 fonts where the glyphs have to be described by non standard names like the Tex math fonts. Each group of three elements compose a code position: the one byte code order in decimal or as 'x' (x cannot be the space), the name and the Unicode character used to access the glyph. The space must be assigned to character position 32 otherwise text justification will not work.

    Example for a "simple" encoding that includes the Unicode character space, A, B and ecyrillic:

     "# simple 32 0020 0041 0042 0454"
               

    Example for a "full" encoding for a Type1 Tex font:

     "# full 'A' nottriangeqlleft 0041 'B' dividemultiply 0042 32 space 0020"
               
    Parameters:
    name - the name of the font or its location on file
    encoding - the encoding to be applied to this font
    embedded - true if the font is to be embedded in the PDF
    cached - true if the font comes from the cache or is added to the cache if new, false if the font is always created new
    ttfAfm - the true type font or the afm in a byte array
    pfb - the pfb in a byte array
    noThrow - if true will not throw an exception if the font is not recognized and will return null, if false will throw an exception if the font is not recognized. Note that even if true an exception may be thrown in some circumstances. This parameter is useful for FontFactory that may have to check many invalid font names before finding the right one
    forceRead - in some cases (TrueTypeFont, Type1Font), the full font file will be read and kept in memory if forceRead is true
    Returns: returns a new font. This font may come from the cache but only if cached is true, otherwise it will always be created new
    Throws:
    DocumentException - the font is invalid
    IOException - the font file could not be read
    Since: 2.1.5
  • createFont

    public static BaseFont createFont(PRIndirectReference fontRef)
    Creates a font based on an existing document font. The created font font may not behave as expected, depending on the encoding or subset.
    Parameters:
    fontRef - the reference to the document font
    Returns: the font
  • isVertical

    public boolean isVertical()
    Indicates whether the font is used for verticl writing or not.
    Returns:
    true if the writing mode is vertical for the given font, false otherwise.
  • getBaseName

    protected static String getBaseName(String name)
    Gets the name without the modifiers Bold, Italic or BoldItalic.
    Parameters:
    name - the full name of the font
    Returns: the name without the modifiers Bold, Italic or BoldItalic
  • normalizeEncoding

    protected static String normalizeEncoding(String enc)
    Normalize the encoding names. "winansi" is changed to "Cp1252" and "macroman" is changed to "MacRoman".
    Parameters:
    enc - the encoding to be normalized
    Returns: the normalized encoding
  • getWidth

    public int getWidth(int char1)
    Gets the width of a char in normalized 1000 units.
    Parameters:
    char1 - the unicode char to get the width of
    Returns: the width in normalized 1000 units
  • getWidth

    public int getWidth(String text)
    Gets the width of a String in normalized 1000 units.
    Parameters:
    text - the String to get the width of
    Returns: the width in normalized 1000 units
  • getDescent

    public int getDescent(String text)
    Gets the descent of a String in normalized 1000 units. The descent will always be less than or equal to zero even if all the characters have an higher descent.
    Parameters:
    text - the String to get the descent of
    Returns: the descent in normalized 1000 units
  • getAscent

    public int getAscent(String text)
    Gets the ascent of a String in normalized 1000 units. The ascent will always be greater than or equal to zero even if all the characters have a lower ascent.
    Parameters:
    text - the String to get the ascent of
    Returns: the ascent in normalized 1000 units float fontSize)
  • Gets the descent of a String in points. The descent will always be less than or equal to zero even if all the characters have an higher descent.
    Parameters:
    text - the String to get the descent of
    fontSize - the size of the font
    Returns: the descent in points float fontSize)
    Gets the ascent of a String in points. The ascent will always be greater than or equal to zero even if all the characters have a lower ascent.
    Parameters:
    text - the String to get the ascent of
    fontSize - the size of the font
    Returns: the ascent in points
  • convertToBytes

    public byte[] convertToBytes(String text)
    Converts a String to a byte array according to the font's encoding.
    Parameters:
    text - the String to be converted
    Returns: an array of byte representing the conversion according to the font's encoding
  • getEncoding

    public String getEncoding()
    Gets the encoding used to convert String into byte[].
    Returns: the encoding name float fontSize)
  • Gets the font parameter identified by key. Valid values for key are ASCENT, AWT_ASCENT, CAPHEIGHT, DESCENT, AWT_DESCENT, ITALICANGLE, BBOXLLX, BBOXLLY, BBOXURX and BBOXURY.
    Parameters:
    key - the parameter to be extracted
    fontSize - the font size in points
    Returns: the parameter in points float value)
    Sets the font parameter identified by key. Valid values for key are ASCENT, AWT_ASCENT, CAPHEIGHT, DESCENT, AWT_DESCENT, ITALICANGLE, BBOXLLX, BBOXLLY, BBOXURX and BBOXURY.
    Parameters:
    key - the parameter to be updated
    value - the parameter value
  • getFontType

    public int getFontType()
    Gets the font type. The font types can be: FONT_TYPE_T1, FONT_TYPE_TT, FONT_TYPE_CJK and FONT_TYPE_TTUNI.
    Returns: the font type
  • createSubsetPrefix

    public static String createSubsetPrefix()
    Creates a unique subset prefix to be added to the font name when the font is embedded and subset.
    Returns: the subset prefix
  • getPostscriptFontName

    public abstract String getPostscriptFontName()
    Gets the postscript font name.
    Returns: the postscript font name
  • setPostscriptFontName

    public abstract void setPostscriptFontName(String name)
    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.
    Parameters:
    name - the new font name
  • getFullFontName

    public abstract String[][] getFullFontName()
    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}.
    Returns: the full name of the font
  • getAllNameEntries

    public abstract String[][] getAllNameEntries()
    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}.
    Returns: the full name of the font
    Since: 2.0.8
  • getFullFontName

    public static String[][] getFullFontName(String name,
                                             String encoding,
                                             byte[] ttfAfm)
                                      throws DocumentException,
                                             IOException
    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}.
    Parameters:
    name - the name of the font
    encoding - the encoding of the font
    ttfAfm - the true type font or the afm in a byte array
    Returns: the full name of the font
    Throws:
    DocumentException - on error
    IOException - on error
  • getAllFontNames

    public static Object[] getAllFontNames(String name,
                                           String encoding,
                                           byte[] ttfAfm)
                                    throws DocumentException,
                                           IOException
    Gets all the names from the font. Only the required tables are read.
    Parameters:
    name - the name of the font
    encoding - the encoding of the font
    ttfAfm - the true type font or the afm in a byte array
    Returns: an array of Object[] built with {getPostscriptFontName(), getFamilyFontName(), getFullFontName()}
    Throws:
    DocumentException - on error
    IOException - on error
  • getAllNameEntries

    public static String[][] getAllNameEntries(String name,
                                               String encoding,
                                               byte[] ttfAfm)
                                        throws DocumentException,
                                               IOException
    Gets all the entries of the namestable from the font. Only the required tables are read.
    Parameters:
    name - the name of the font
    encoding - the encoding of the font
    ttfAfm - the true type font or the afm in a byte array
    Returns: an array of Object[] built with {getPostscriptFontName(), getFamilyFontName(), getFullFontName()}
    Throws:
    DocumentException - on error
    IOException - on error
    Since: 2.0.8
  • getFamilyFontName

    public abstract String[][] getFamilyFontName()
    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}.
    Returns: the family name of the font
  • getCodePagesSupported

    public String[] getCodePagesSupported()
    Gets the code pages supported by the font. This has only meaning with True Type fonts.
    Returns: the code pages supported by the font
  • enumerateTTCNames

    public static String[] enumerateTTCNames(String ttcFile)
                                      throws DocumentException,
                                             IOException
    Enumerates the postscript font names present inside a True Type Collection.
    Parameters:
    ttcFile - the file name of the font
    Returns: the postscript font names
    Throws:
    DocumentException - on error
    IOException - on error
  • enumerateTTCNames

    public static String[] enumerateTTCNames(byte[] ttcArray)
                                      throws DocumentException,
                                             IOException
    Enumerates the postscript font names present inside a True Type Collection.
    Parameters:
    ttcArray - the font as a byte array
    Returns: the postscript font names
    Throws:
    DocumentException - on error
    IOException - on error
  • getDifferences

    public String[] getDifferences()
    Gets the array with the names of the characters.
    Returns: the array with the names of the characters
  • getUnicodeDifferences

    public char[] getUnicodeDifferences()
    Gets the array with the unicode characters.
    Returns: the array with the unicode characters
  • setForceWidthsOutput

    public void setForceWidthsOutput(boolean forceWidthsOutput)
    Set to true to force the generation of the widths array.
    Parameters:
    forceWidthsOutput - true to force the generation of the widths array
  • isDirectTextToByte

    public boolean isDirectTextToByte()
    Gets the direct conversion of char to byte.
    Returns: value of property directTextToByte.
    See Also:
    setDirectTextToByte(boolean directTextToByte)
  • setDirectTextToByte

    public void setDirectTextToByte(boolean directTextToByte)
    Sets the conversion of char directly to byte by casting. This is a low level feature to put the bytes directly in the content stream without passing through String.getBytes().
    Parameters:
    directTextToByte - New value of property directTextToByte.
  • isSubset

    public boolean isSubset()
    Indicates if all the glyphs and widths for that particular encoding should be included in the document.
    Returns:
    false to include all the glyphs and widths.
  • setSubset

    public void setSubset(boolean subset)
    Indicates if all the glyphs and widths for that particular encoding should be included in the document. When set to true only the glyphs used will be included in the font. When set to false and addSubsetRange(int[]) was not called the full font will be included otherwise just the characters ranges will be included.
    Parameters:
    subset - new value of property subset
  • getUnicodeEquivalent

    public int getUnicodeEquivalent(int c)
    Gets the Unicode equivalent to a CID. The (inexistent) CID is translated as '\n'. It has only meaning with CJK fonts with Identity encoding.
    Parameters:
    c - the CID code
    Returns: the Unicode equivalent
  • getCidCode

    public int getCidCode(int c)
    Gets the CID code given an Unicode. It has only meaning with CJK fonts.
    Parameters:
    c - the Unicode
    Returns: the CID equivalent
  • hasKernPairs

    public abstract boolean hasKernPairs()
    Checks if the font has any kerning pairs.
    Returns:
    true if the font has any kerning pairs
  • getDocumentFonts

    public static ArrayList<Object[]> getDocumentFonts(PdfReader reader)
    Gets a list of all document fonts. Each element of the ArrayList contains a Object[]{String,PRIndirectReference} with the font name and the indirect reference to it.
    Parameters:
    reader - the document where the fonts are to be listed from
    Returns: the list of fonts and references
  • getDocumentFonts

    public static ArrayList<Object[]> getDocumentFonts(PdfReader reader,
                                                       int page)
    Gets a list of the document fonts in a particular page. Each element of the ArrayList contains a Object[]{String,PRIndirectReference} with the font name and the indirect reference to it.
    Parameters:
    reader - the document where the fonts are to be listed from
    page - the page to list the fonts from
    Returns: the list of fonts and references
  • getCharBBox

    public int[] getCharBBox(int c)
    Gets the smallest box enclosing the character contours. It will return null 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].
    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
  • getFontMatrix

    public double[] getFontMatrix()
    get default array of six numbers specifying the font matrix, mapping glyph space to text space
    Returns: an array of six values null
  • correctArabicAdvance

    public void correctArabicAdvance()
    iText expects Arabic Diactrics (tashkeel) to have zero advance but some fonts, most notably those that come with Windows, like times.ttf, have non-zero advance for those characters. This method makes those character to have zero width advance and work correctly in the iText Arabic shaping and reordering context.
  • addSubsetRange

    public void addSubsetRange(int[] range)
    Adds a character range when subsetting. The range is an int array where the first element is the start range inclusive and the second element is the end range inclusive. Several ranges are allowed in the same array.
    Parameters:
    range - the character range
  • getCompressionLevel

    public int getCompressionLevel()
    Returns the compression level used for the font streams.
    Returns: the compression level (0 = best speed, 9 = best compression, -1 is default)
    Since: 2.1.3
  • setCompressionLevel

    public void setCompressionLevel(int compressionLevel)
    Sets the compression level to be used for the font streams.
    Parameters:
    compressionLevel - a value between 0 (best speed) and 9 (best compression)
    Since: 2.1.3
  •