PDFlib Cookbook

cookbook

type3_fonts/type3_subsetting

Demonstrate Type 3 font definition, use, and subsetting.

Download Java Code  Switch to PHP Code  Show Output 

/*
 * Type 3 subsetting:
 * Demonstrate Type 3 font definition, use, and subsetting
 * 
 * In the first definition pass, create the "T3font" widths-only font by 
 * supplying all font and glyph metrics.
 * Load the "T3font" font with "subsetting" and output some text.
 * In the second definition pass, supply all glyph descriptions for the font.
 * With the "subsetting" option PDFlib will include only those glyphs in the
 * font which are actually used in the document in order to reduce the overall
 * file size. However, the full metrics must be supplied in the first pass of
 * the font definition. 
 *
 * Required software: PDFlib/PDFlib+PDI/PPS 9
 * Required data: none
 */
package com.pdflib.cookbook.pdflib.type3_fonts;

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

public class type3_subsetting {
    private static void define_font(pdflib p, int pass) throws PDFlibException,
        Exception {
        int image;

        int data[][] = {
            { 0x00, 0x00, 0x00, 0x00, 0x00, 0x78, 0x84, 0x04, 0x7C, 0x84, 0x84,
                0x8C, 0x76, 0x00, 0x00, 0x00 }, /* "a" */
            { 0x00, 0x00, 0xC0, 0x40, 0x40, 0x5C, 0x62, 0x42, 0x42, 0x42, 0x42,
                0x62, 0xDC, 0x00, 0x00, 0x00 } }; /* "b" */

        /*
         * From the data defining three glyphs, create three PVFs
         * "/pvf/font/bitmap0" ... "/pvf/font/bitmap2"
         */
        if (pass == 2) {
            byte[] glyphdef = new byte[data[0].length];

            for (int i = 0; i < 2; i++) {
                for (int j = 0; j < data[0].length; j++)
                    glyphdef[j] = (byte) data[i][j];

                p.create_pvf("/pvf/font/bitmap" + i, glyphdef, "");
            }
        }

        /*
         * Create the "T3font" widths-only font in pass 1
         */
        p.begin_font("T3Font", 1 / 16.0, 0, 0, 1 / 16.0, 0, -3 / 16.0,
            pass == 1 ? "widthsonly=true" : "");

        /*
         * The .notdef (fallback) glyph should be contained in all Type 3 fonts
         * to avoid problems with some PDF viewers. It is usually empty.
         * Therefore we don't have to distinguish between pass 1 and pass 2.
         */
        p.begin_glyph_ext(0x0000, "width=8");
        p.end_glyph();

        /* Define the glyph "a" */
        p.begin_glyph_ext(0x0061, "width=8 boundingbox={0 0 8 16}");

        /*
         * In pass 2, load the bitmap data for the glyph from the PVF. The
         * "inline" option is provided so that load_image() will internally
         * perform the equivalent of fit_image(image, 0, 0, "") and
         * close_image(image).
         */
        String optlist =
            "inline bpc=1 components=1 height=16 width=8 mask invert";

        if (pass == 2) {
            image = p.load_image("raw", "/pvf/font/bitmap0", optlist);
            if (image == -1 && p.get_errnum() > 0)
                throw new Exception("Error: " + p.get_errmsg());
        }

        p.end_glyph();

        /* Define the glyph "b" */
        p.begin_glyph_ext(0x0062, "width=8 boundingbox={0 0 8 16}");

        if (pass == 2) {
            image = p.load_image("raw", "/pvf/font/bitmap1", optlist);
            if (image == -1 && p.get_errnum() > 0)
                throw new Exception("Error: " + p.get_errmsg());
        }

        p.end_glyph();

        /* ...define all glyph descriptions... */

        p.end_font();
    }

    public static void main(String argv[]) {
        /* This is where the data files are. Adjust as necessary. */
        String searchpath = "../input";
        String outfile = "type3_subsetting.pdf";
        String title = "Type 3 Subsetting";

        pdflib p = null;
        int font;
        int exitcode = 0;

        try {
            p = new pdflib();

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

            /* This means we must check return values of load_font() etc. */
            p.set_option("errorpolicy=return");

            if (p.begin_document(outfile, "") == -1)
                throw new Exception("Error: " + p.get_errmsg());

            p.set_info("Creator", "PDFlib Cookbook");
            p.set_info("Title", title);

            /* Pass 1: Create the widths-only font to make it known to PDFlib */
            define_font(p, 1);

            /*
             * Create some text on the page with glyphs from the font. Loading
             * the font with the "subsetting" option will include only those
             * glyphs in the font which are actually used in the document.
             */
            p.begin_page_ext(0, 0, "width=a4.width height=a4.height");

            font = p.load_font("T3Font", "unicode", "subsetting");
            if (font == -1)
                throw new Exception("Error: " + p.get_errmsg());

            p.fit_textline("a", 50, 700, "font=" + font + " fontsize=36");

            p.end_page_ext("");

            /* Pass 2: Supply glyph descriptions for the font */
            define_font(p, 2);

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