PDFlib Cookbook

cookbook

fonts/opentype_features_for_cjk

Download Java Code    Switch to PHP Code     Show Output PDF

/* $Id: opentype_features_for_cjk.java,v 1.11 2017/01/26 13:12:51 stm Exp $
 * Starter sample for OpenType font features
 *
 * Demonstrate various typographic OpenType features after checking
 * whether a particular feature is supported in a font.
 *
 * Required software: PDFlib/PDFlib+PDI/PPS 9
 * Required data: Meiryo font from Windows Vista/7, or another
 * suitable font with OpenType CJK features
 * 
 * For better results you should replace the default font with a suitable
 * commercial font. Depending on the implementation of the features in
 * the font you may have to replace the sample text below in order to
 * see some effect of the features.
 * 
 * Note that even if a particular OpenType feature is present in the font
 * it may not necessarily process the characters provided in the test strings
 * below. In this case you must replace the test strings with content that
 * is suited to your font.
 *
 * This example is not run by default from the Ant build.xml file and can be
 * executed either specifically by invoking "ant opentype_features_for_cjk" or
 * together with the other topics that require extra configuration by invoking
 * "ant run-extra-topics".
 */

package com.pdflib.cookbook.pdflib.fonts;

import com.pdflib.pdflib;
import com.pdflib.PDFlibException;

class opentype_features_for_cjk {
    public static void main(String argv[]) {
        /* This is where the data files are. Adjust as necessary. */
        final String searchpath = "../input";
        /* Put the Meiryo font into the "extra_input" directory */
        final String extra_searchpath = "../extra_input";
        
        final String outfile = "opentype_features_for_cjk.pdf";

        String optlist;
        pdflib p = null;
        int i, table, font;
        final double llx = 50, lly = 50, urx = 800, ury = 550;
        String result;
	int exitcode = 0;

        final String testfont = "meiryo:0";

        final String headers[] = { "Description", "Option list",
            "Font name", "Raw input (feature disabled)", "Feature enabled" };

        class testcase {
            testcase(String description, String optlist,
            		String feature, String text) {
                this.description = description;
                this.optlist = optlist;
                this.feature = feature;
                this.text = text;
            }

            String description;
            String optlist;
            String feature;
            String text;
        }

        final testcase testcases[] = {
            new testcase("Localized forms for simplified Chinese",
        		"features={locl} script=hani language=ZHS", "locl",
        		"\u4E0B\u4E0E\u4E10\u4E11\u4E16\u4E17" +
        		"\u4E4B\u4E4F\u4E55\u4E62\u4E76\u4E77"),

            new testcase("Localized forms for traditional Chinese",
        		"features={locl} script=hani language=ZHT", "locl",
        		"\u4E03\u4E0E\u4E10\u4E16\u4E31\u4E42" +
        		"\u4E92\u4E9F\u4EA1\u4EA2\u4EA4\u4EA5"),

            new testcase("Localized forms for Korean",
        		"features={locl} script=hani language=KOR", "locl",
        		"\u4E42\u4E9E\u4EA8\u4EAB\u4EB6\u4ED7" +
        		"\u50AC\u50C5\u50CA\u50CF\u50E7\u50ED"),

            new testcase("Simplified forms",
        		"features={smpl}", "smpl",
        		"\u6AAF \u81FA \u98B1"),

            new testcase("Traditional forms",
        		"features={trad}", "trad",
        		"\u53F0\u4E03\u4E0E\u4E31\u7D1B\u9912\u96B8" +
                "\u9698\u966A\u939A"),

            new testcase("Expert forms",
        		"features={expt}", "expt",
        		"\u5516\u82A6\u98F4\u9E78\u9D60\u6F23\u84EE\u7BDD"),

            new testcase("Full widths",
        		"features={fwid}", "fwid",
        		"0123-456(789)=25"),

            new testcase("Horizontal kana alternates",
        		"features={hkna}", "hkna",
        		"\u3041\u3042\u3043\u3044 \u30A1\u30A2\u30A3" +
                "\u30A4\u30E5\u30E4\u30B4\u30A7"),

            new testcase("Hangul",
        		"features={hngl}", "hngl",
        		"\u4F3D"),

            new testcase("Hojo kanji forms (JIS X 0212-1990)",
        		"features={hojo}", "hojo",
        		"\u6FF9\u9B35\u8200\u9CE6\u9B2D\u9721\u884B"),

            new testcase("Half widths",
        		"features={hwid}", "hwid",
        		"\u53F0\u4E03\u4E0E\u4E31\u7D1B\u9912\u96B8" +
        		"0123-456(789)=25"),

            new testcase("Italics",
        		"features={ital}", "ital",
        		"ABCD abcd 1234"),

            new testcase("JIS2004 forms",
        		"features={jp04}", "jp04",
        		"\u9022\u98F4\u6EA2\u8328\u9C2F\u6DEB\u8FC2"),

            new testcase("JIS78 forms",
        		"features={jp78}", "jp78",
        		"\u5516\u9C2F\u5026\u53F1\u63B4\u9019\u2FD4\u8000"),

            new testcase("JIS83 forms",
        		"features={jp83}", "jp83",
        		"\u9B58\u9BC6\u9BF1\u9D48\u9F08\u2F57"),

            new testcase("JIS90 forms",
        		"features={jp90}", "jp90",
        		"\u555E"),

            new testcase("Alternate annotation forms",
        		"features={nalt}", "nalt",
        		"ABC123\u002F\u30B4\u217B\u4E0B\u7981\u2F29\u4E2D\u2F42"),

            new testcase("NLC kanji forms",
        		"features={nlck}", "nlck",
        		"\u9022\u82A6\u98F4\u6EA2\u8328\uFA1F\u7149"),

            new testcase("Proportional kana",
        		"features={pkna}", "pkna",
        		"\u3041\u3042 \u30A1\u30A2 \uFF66 \uFF67"),

            new testcase("Proportional widths",
        		"features={pwid}", "pwid",
        		"\u3041\u3042 \u30A1\u30A2 \uFF21\uFF23\uFF28" +
        		"\uFF29\uFF2D ABCD abcd 1234"),

            new testcase("Quarter widths",
        		"features={qwid}", "qwid",
        		"0123-456(789)=25"),

            new testcase("Ruby notation forms",
        		"features={ruby}", "ruby",
        		"\u3042\u304A\u307D\u30AA\u30BC\u30F1\u25C9\u31F0\u31FF"),

            new testcase("Traditional name forms",
        		"features={tnam}", "tnam",
        		"\u4E9C"),

            new testcase("Third widths",
        		"features={twid}", "twid",
        		"0123-456(789)=25"),
      
            new testcase("Vertical kana alternates",
        		"features={vkna}", "vkna",
        		"\u3041\u3042\u3043\u3044 \u31FF\u31F8\u30CB\u30BB"),

            new testcase("Vertical alternates and rotation",
        		"features={vrt2}", "vrt2",
        		"[abc.]ABC- 012/"),
                		
        };

        try {
            p = new pdflib();

            p.set_option("searchpath={" + searchpath + "}");
            p.set_option("searchpath={" + extra_searchpath + "}");
            p.set_option("charref=true");

            /*
             * This means that formatting and other errors will raise an
             * exception. This simplifies our sample code, but is not
             * recommended for production code.
             */
            p.set_option("errorpolicy=exception");

            /* Set an output path according to the name of the topic */
            if (p.begin_document(outfile, "") == -1) {
                throw new Exception("Error: " + p.get_errmsg());
            }

            p.set_info("Creator", "PDFlib starter sample");
            p.set_info("Title", "opentype_features_for_cjk $Revision: 1.11 $");

            table = -1;

            /* Table header */
            for (i = 0; i < headers.length; i++) {
                final int col = i + 1;

                optlist =
                    "fittextline={fontname=Helvetica-Bold encoding=unicode fontsize=12} "
                    + "margin=4";
                table = p.add_table_cell(table, col, 1, headers[i], optlist);
            }

            /* Create a table with feature samples, one feature per table row */
            for (i = 0; i < testcases.length; i += 1) {
                final testcase testcase = testcases[i];
                final int row = i + 2;

                int col = 1;

                /* Common option list for columns 1-3 */
                optlist =
                    "fittextline={fontname=Helvetica encoding=unicode fontsize=12} "
                    + "margin=4";

                /* Column 1: feature description */
                table = p.add_table_cell(table, col++, row,
                        testcase.description, optlist);

                /* Column 2: option list */
                table = p.add_table_cell(table, col++, row, testcase.optlist,
                		optlist);

                /* Column 3: font name */
                table = p.add_table_cell(table, col++, row, testfont, optlist);

                /* Column 4: raw input text with feature disabled */
                optlist = "fittextline={fontname={" + testfont
                        + "} encoding=unicode fontsize=12 embedding} margin=4";
                table = p.add_table_cell(table, col++, row, testcase.text,
                        optlist);

                /*
                 * Column 5: text with enabled feature, or warning if the
                 * feature is not available in the font
                 */
                font = p.load_font(testfont, "unicode", "embedding");

                /* Check whether font contains the required feature table */
                optlist = "name=" + testcase.feature;
                if (p.info_font(font, "feature", optlist) == 1) {
                    /* feature is available: apply it to the text */
                    optlist = "margin=4 fittextline={fontname={" + testfont
                            + "} encoding=unicode fontsize=12 embedding "
                            + testcase.optlist + "}";
                    table = p.add_table_cell(table, col++, row, testcase.text,
                            optlist);
                }
                else {
                    /* feature is not available: emit a warning */
                    optlist = "fittextline={fontname=Helvetica encoding=unicode "
                            + "fontsize=12 fillcolor=red} margin=4";
                    table = p.add_table_cell(table, col++, row,
                            "(feature not available in this font)", optlist);
                }
            }

            /*
             * Loop until all of the table is placed; create new pages as long
             * as more table instances need to be placed.
             */
            do {
                p.begin_page_ext(0, 0, "width=a4.height height=a4.width");

                optlist = "header=1 fill={{area=rowodd fillcolor={gray 0.9}}} "
                    + "stroke={{line=other}} ";

                /* Place the table instance */
                result = p.fit_table(table, llx, lly, urx, ury, optlist);

                if (result.equals("_error"))
                    throw new Exception("Couldn't place table: "
                        + p.get_errmsg());

                p.end_page_ext("");

            }
            while (result.equals("_boxfull"));
            
            p.end_document("");
        }
        catch (PDFlibException e) {
            System.err.print("PDFlib exception occurred:\n");
            System.err.print("[" + e.get_errnum() + "] " + e.get_apiname()
                    + ": " + e.get_errmsg() + "\n");
	    exitcode = 1;
        }
        catch (Exception e) {
            System.err.println(e.getMessage());
	    exitcode = 1;
        }
        finally {
            if (p != null) {
                p.delete();
            }
	    System.exit(exitcode);
        }
    }
}