PDFlib Cookbook

cookbook

text_output/image_as_text_fill_color

Create outline text and fill the interior of the glyphs with an image.

Download Java Code  Switch to PHP Code  Show Output 

/*
 * Image as text fill color:
 * Create outline text and fill the interior of the glyphs with an image.
 * 
 * Define a pattern containing an image and use it as the fill color for the
 * text being filled and stroked.
 * 
 * Required software: PDFlib/PDFlib+PDI/PPS 9.0.2
 * Required data: none
 */
package com.pdflib.cookbook.pdflib.text_output;

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

public class image_as_text_fill_color {
    public static void main(String argv[]) {
        /* This is where the data files are. Adjust as necessary. */
        String searchpath = "../input";
        String outfile = "image_as_text_fill_color.pdf";
        String title = "Image as Text Fill Color";
        int exitcode = 0;

        pdflib p = null;

        String imagefile = "text_filling.tif";
        int font, pattern, image;
        double imageheight, imagewidth, resx, resy;

        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);

            /* Load the font. */
            font = p.load_font("NotoSerif-Bold", "unicode", "");
            if (font == -1)
                throw new Exception("Error: " + p.get_errmsg());

            /* Load the background image */
            image = p.load_image("auto", imagefile, "");
            if (image == -1)
                throw new Exception("Error: " + p.get_errmsg());

            /*
             * Retrieve the image dimensions (related to its original
             * resolution)
             */
            imagewidth = p.info_image(image, "imagewidth", "");
            imageheight = p.info_image(image, "imageheight", "");

            /*
             * The image may have a resolution above 72 dpi. If we used the
             * returned dimensions (in points) for the pattern height and width
             * and placed our image into the pattern, it wouldn't match the
             * pattern size, and a white margin would be left. To make the
             * pattern the same size as the image we calculate the image size
             * based on its resolution.
             * 
             * Retrieve the original image resolution
             */
            resx = p.info_image(image, "resx", "");
            resy = p.info_image(image, "resy", "");

            /* Calculate the image dimensions for 72 dpi */
            if (resx > 0) {
                imagewidth = imagewidth * 72 / resx;
                imageheight = imageheight * 72 / resy;
            }

            /*
             * Create a pattern using the retrieved image dimensions. The
             * painttype parameter must be set to 1 since a colorized image is
             * used (as opposed to an image mask).
             */
            pattern = p.begin_pattern_ext(imagewidth, imageheight, "");
            p.fit_image(image, 0, 0, "");
            p.end_pattern();
            p.close_image(image);

            /* Start page */
            p.begin_page_ext(0, 0, "width=a4.width height=a4.height");

            /*
             * Set the pattern as the current fill color. Encapsulate the
             * setcolor() call with save() and restore() to be able to proceed
             * with the original colors.
             */
            p.save();
            
            /*
             * In addition to filling the text (which is the default), stroke
             * the text by setting the textrendering mode to 2 (fill and stroke)
             * and defining a stroke color different from black.
             */
            p.set_text_option("textrendering=2");
            p.setcolor("stroke", "rgb", 0.5, 0.2, 0.1, 0);
            p.setcolor("fill", "pattern", pattern, 0, 0, 0);

            /*
             * Output the text with the current fill color, i.e. the image in
             * terms of the pattern color
             */
            int fontsize = 50;
            p.set_text_option("font=" + font + " fontsize=" + fontsize);
            p.fit_textline("Hello World!", 50, 500, "");
            p.fit_textline("(says PDFlib GmbH)", 50, 500 - fontsize, "");

            p.restore();

            p.end_page_ext("");

            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);
        }
    }
}