Class TrueTypeFontUnicode

All Implemented Interfaces:
Comparator

class TrueTypeFontUnicode extends TrueTypeFont implements Comparator
Represents a True Type font with Unicode encoding. All the character in the font can be used directly by using the encoding Identity-H or Identity-V. This is the only way to represent some character sets such as Thai.
  • Field Details

    • rotbits

      private static final byte[] rotbits
    • vertical

      boolean vertical
      true if the encoding is vertical.
    • inverseCmap

      Map<Integer,Integer> inverseCmap
  • Constructor Details

    • TrueTypeFontUnicode

      TrueTypeFontUnicode(String ttFile, String enc, boolean emb, byte[] ttfAfm, boolean forceRead) throws DocumentException, IOException
      Creates a new TrueType font addressed by Unicode characters. The font will always be embedded.
      Parameters:
      ttFile - the location of the font on file. The file must end in '.ttf'. The modifiers after the name are ignored.
      enc - the encoding to be applied to this font
      emb - true if the font is to be embedded in the PDF
      ttfAfm - the font as a byte array
      Throws:
      DocumentException - the font is invalid
      IOException - the font file could not be read
  • Method Details

    • toHex4

      private static String toHex4(int n)
    • toHex

      static String toHex(int n)
      Gets an hex string in the format "<HHHH>".
      Parameters:
      n - the number
      Returns:
      the hex string
    • readCMaps

      void readCMaps() throws DocumentException, IOException
      Description copied from class: TrueTypeFont
      Reads the several maps from the table 'cmap'. The maps of interest are 1.0 for symbolic fonts and 3.1 for all others. A symbolic font is defined as having the map 3.0.
      Overrides:
      readCMaps in class TrueTypeFont
      Throws:
      DocumentException - the font is invalid
      IOException - the font file could not be read
    • getCharacterCode

      protected Integer getCharacterCode(int code)
    • getWidth

      public int getWidth(int char1)
      Gets the width of a char in normalized 1000 units.
      Overrides:
      getWidth in class BaseFont
      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.
      Overrides:
      getWidth in class BaseFont
      Parameters:
      text - the String to get the width of
      Returns:
      the width in normalized 1000 units
    • getToUnicode

      private PdfStream getToUnicode(int[][] metrics)
      Creates a ToUnicode CMap to allow copy and paste from Acrobat.
      Parameters:
      metrics - metrics[0] contains the glyph index and metrics[2] contains the Unicode code
      Returns:
      the stream representing this CMap or null
    • filterCmapMetrics

      private int[][] filterCmapMetrics(int[][] metrics)
    • getCIDFontType2

      private PdfDictionary getCIDFontType2(PdfIndirectReference fontDescriptor, String subsetPrefix, int[][] metrics)
      Generates the CIDFontTyte2 dictionary.
      Parameters:
      fontDescriptor - the indirect reference to the font descriptor
      subsetPrefix - the subset prefix
      metrics - the horizontal width metrics
      Returns:
      a stream
    • getFontBaseType

      private PdfDictionary getFontBaseType(PdfIndirectReference descendant, String subsetPrefix, PdfIndirectReference toUnicode)
      Generates the font dictionary.
      Parameters:
      descendant - the descendant dictionary
      subsetPrefix - the subset prefix
      toUnicode - the ToUnicode stream
      Returns:
      the stream
    • compare

      public int compare(Object o1, Object o2)
      The method used to sort the metrics array.
      Specified by:
      compare in interface Comparator
      Parameters:
      o1 - the first element
      o2 - the second element
      Returns:
      the comparison
    • writeFont

      void writeFont(PdfWriter writer, PdfIndirectReference ref, Object[] params) throws DocumentException, IOException
      Outputs to the writer the font dictionaries and streams.
      Overrides:
      writeFont in class TrueTypeFont
      Parameters:
      writer - the writer for this document
      ref - the font indirect reference
      params - several parameters that depend on the font type
      Throws:
      IOException - on error
      DocumentException - error in generating the object
    • getFullFontStream

      public PdfStream getFullFontStream() throws IOException, DocumentException
      Returns a PdfStream object with the full font program.
      Overrides:
      getFullFontStream in class TrueTypeFont
      Returns:
      a PdfStream with the font program
      Throws:
      IOException - on error
      DocumentException - on error
      Since:
      2.1.3
    • convertToBytes

      byte[] convertToBytes(String text)
      A forbidden operation. Will throw a null pointer exception.
      Overrides:
      convertToBytes in class BaseFont
      Parameters:
      text - the text
      Returns:
      always null
    • convertToBytes

      byte[] convertToBytes(int char1)
      Description copied from class: BaseFont
      Converts a char to a byte array according to the font's encoding.
      Overrides:
      convertToBytes in class BaseFont
      Parameters:
      char1 - the char to be converted
      Returns:
      an array of byte representing the conversion according to the font's encoding
    • getMetricsTT

      public int[] getMetricsTT(int c)
      Gets the glyph index and metrics for a character.
      Overrides:
      getMetricsTT in class TrueTypeFont
      Parameters:
      c - the character
      Returns:
      an int array with {glyph index, width}
    • charExists

      public boolean charExists(int c)
      Checks if a character exists in this font.
      Overrides:
      charExists in class BaseFont
      Parameters:
      c - the character to check
      Returns:
      true if the character has a glyph, false otherwise
    • setCharAdvance

      public boolean setCharAdvance(int c, int advance)
      Sets the character advance.
      Overrides:
      setCharAdvance in class BaseFont
      Parameters:
      c - the character
      advance - the character advance normalized to 1000 units
      Returns:
      true if the advance was set, false otherwise
    • getCharBBox

      public int[] getCharBBox(int c)
      Description copied from class: BaseFont
      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].
      Overrides:
      getCharBBox in class BaseFont
      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