Package com.itextpdf.text.pdf

Class CJKFont

  • class CJKFont
extends BaseFont
    Creates a CJK font compatible with the fonts in the Adobe Asian font Pack.

    • Field Detail

      • CJK_ENCODING

        static final java.lang.String CJK_ENCODING
        The encoding used in the PDF document for CJK fonts
        See Also:
        Constant Field Values

      • cjkFonts

        static java.util.Properties cjkFonts

      • cjkEncodings

        static java.util.Properties cjkEncodings

      • allFonts

        private static final java.util.HashMap<java.lang.String,​java.util.HashMap<java.lang.String,​java.lang.Object>> allFonts

      • propertiesLoaded

        private static boolean propertiesLoaded

      • RESOURCE_PATH_CMAP

        public static final java.lang.String RESOURCE_PATH_CMAP
        The path to the font resources.
        See Also:
        Constant Field Values

      • registryNames

        private static final java.util.HashMap<java.lang.String,​java.util.Set<java.lang.String>> registryNames

      • uniMap

        private java.lang.String uniMap

      • fontName

        private java.lang.String fontName
        The font name

      • style

        private java.lang.String style
        The style modifier

      • CMap

        private java.lang.String CMap
        The CMap name associated with this font

      • cidDirect

        private boolean cidDirect

      • fontDesc

        private java.util.HashMap<java.lang.String,​java.lang.Object> fontDesc

    • Constructor Detail

      • CJKFont

        CJKFont​(java.lang.String fontName,
        java.lang.String enc,
        boolean emb)
 throws DocumentException
        Creates a CJK font.
        Parameters:
        fontName - the name of the font
        enc - the encoding of the font
        emb - always false. CJK font and not embedded
        Throws:
        DocumentException - on error

    • Method Detail

      • loadProperties

        private static void loadProperties()

      • loadRegistry

        private static void loadRegistry()
                          throws java.io.IOException
        Throws:
        java.io.IOException

      • getUniMap

        java.lang.String getUniMap()

      • GetCompatibleFont

        public static java.lang.String GetCompatibleFont​(java.lang.String enc)
        Returns a font compatible with a CJK encoding or null if not found.
        Parameters:
        enc -
        Returns:

      • isCJKFont

        public static boolean isCJKFont​(java.lang.String fontName,
                                java.lang.String enc)
        Checks if its a valid CJK font.
        Parameters:
        fontName - the font name
        enc - the encoding
        Returns:
        true if it is CJK font

      • 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​(java.lang.String text)
        Description copied from class: BaseFont
        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

      • getRawWidth

        int getRawWidth​(int c,
                java.lang.String name)
        Description copied from class: BaseFont
        Gets the width from the font according to the Unicode char c or the name. If the name is null it's a symbolic font.
        Specified by:
        getRawWidth in class BaseFont
        Parameters:
        c - the unicode char
        name - the glyph name
        Returns:
        the width of the char

      • getKerning

        public int getKerning​(int char1,
                      int char2)
        Description copied from class: BaseFont
        Gets the kerning between two Unicode chars.
        Specified by:
        getKerning in class BaseFont
        Parameters:
        char1 - the first char
        char2 - the second char
        Returns:
        the kerning to be applied in normalized 1000 units

      • 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 class BaseFont
        Parameters:
        writer - the writer for this document
        ref - the font indirect reference
        params - several parameters that depend on the font type
        Throws:
        DocumentException - error in generating the object
        java.io.IOException - on error

      • getFullFontStream

        public PdfStream getFullFontStream()
        You can't get the FontStream of a CJK font (CJK fonts are never embedded), so this method always returns null.
        Specified by:
        getFullFontStream in class BaseFont
        Returns:
        null
        Since:
        2.1.3

      • getDescNumber

        private float getDescNumber​(java.lang.String name)

      • getBBox

        private float getBBox​(int idx)

      • getFontDescriptor

        public float getFontDescriptor​(int key,
                               float fontSize)
        Gets the font parameter identified by key. Valid values for key are ASCENT, CAPHEIGHT, DESCENT and ITALICANGLE.
        Specified by:
        getFontDescriptor in class BaseFont
        Parameters:
        key - the parameter to be extracted
        fontSize - the font size in points
        Returns:
        the parameter in points

      • getPostscriptFontName

        public java.lang.String getPostscriptFontName()
        Description copied from class: BaseFont
        Gets the postscript font name.
        Specified by:
        getPostscriptFontName in class BaseFont
        Returns:
        the postscript font name

      • getFullFontName

        public java.lang.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}.
        Specified by:
        getFullFontName in class BaseFont
        Returns:
        the full name of the font

      • getAllNameEntries

        public java.lang.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}.
        Specified by:
        getAllNameEntries in class BaseFont
        Returns:
        the full name of the font

      • getFamilyFontName

        public java.lang.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}.
        Specified by:
        getFamilyFontName in class BaseFont
        Returns:
        the family name of the font

      • createMetric

        static IntHashtable createMetric​(java.lang.String s)

      • convertToHCIDMetrics

        static java.lang.String convertToHCIDMetrics​(int[] keys,
                                             IntHashtable h)

      • readFontProperties

        private static java.util.HashMap<java.lang.String,​java.lang.Object> readFontProperties​(java.lang.String name)
                                                                                      throws java.io.IOException
        Throws:
        java.io.IOException

      • getUnicodeEquivalent

        public int getUnicodeEquivalent​(int c)
        Description copied from class: BaseFont
        Gets the Unicode equivalent to a CID. The (inexistent) CID is translated as '\n'. It has only meaning with CJK fonts with Identity encoding.
        Overrides:
        getUnicodeEquivalent in class BaseFont
        Parameters:
        c - the CID code
        Returns:
        the Unicode equivalent

      • getCidCode

        public int getCidCode​(int c)
        Description copied from class: BaseFont
        Gets the CID code given an Unicode. It has only meaning with CJK fonts.
        Overrides:
        getCidCode in class BaseFont
        Parameters:
        c - the Unicode
        Returns:
        the CID equivalent

      • hasKernPairs

        public boolean hasKernPairs()
        Checks if the font has any kerning pairs.
        Specified by:
        hasKernPairs in class BaseFont
        Returns:
        always false

      • 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. Will always return false

      • setPostscriptFontName

        public void setPostscriptFontName​(java.lang.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.
        Specified by:
        setPostscriptFontName in class BaseFont
        Parameters:
        name - the new font name

      • 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 class BaseFont
        Parameters:
        char1 - the first char
        char2 - the second char
        kern - the kerning to apply in normalized 1000 units
        Returns:
        true if the kerning was applied, 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

      • getRawCharBBox

        protected int[] getRawCharBBox​(int c,
                               java.lang.String name)
        Specified by:
        getRawCharBBox in class BaseFont

      • convertToBytes

        public byte[] convertToBytes​(java.lang.String text)
        Converts a String to a byte array according to the font's encoding.
        Overrides:
        convertToBytes in class BaseFont
        Parameters:
        text - the String to be converted
        Returns:
        an array of byte representing the conversion according to the font's encoding

      • convertToBytes

        byte[] convertToBytes​(int char1)
        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

      • isIdentity

        public boolean isIdentity()