PDFlib Cookbook

cookbook

textflow/fill_polygons_with_text

Define arbitrary polygons to be filled with text.

Download Java Code  Switch to PHP Code  Show Output 

/* 
 * Fill polygons with text:
 * Define arbitrary polygons to be filled with text
 * 
 * Use fit_textflow() with the "wrap" option and the "addfitbox" and "polygons"
 * suboptions to define a rhombus to be filled with text. Then define a hexagon
 * and a rectangle positioned within the hexagon. In this case the overlapping
 * area will be left blank when fitting the text using the options above.
 * 
 * Required software: PDFlib/PDFlib+PDI/PPS 10
 * Required data: none
 */
package com.pdflib.cookbook.pdflib.textflow;

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

public class fill_polygons_with_text
{
    public static void main (String argv[])
    {
        pdflib p = null;
        int exitcode = 0;
        String searchpath = "../input";
        String outfile = "fill_polygons_with_text.pdf";
        String title = "Fill Polygons with Text";
        
        int i, font, tf = -1;
        String result;
        final double llx = 50, lly = 200, urx = 450, ury = 700;


        final String textopts =
            "fontname=NotoSerif-Regular fontsize=10 " +
            "fillcolor={gray 0} alignment=justify charref";

        /* Text which is placed on the page. Soft hyphens are marked with the
         * character reference "­" (character references are enabled by the
         * charref option).
         */
        final String text =
            "Our paper planes are the ideal way of passing the time. We offer " +
            "revolutionary new develop­ments of the traditional common paper " +
            "planes. If your lesson, conference, or lecture turn out to be " +
            "deadly boring, you can have a wonderful time with our planes. " +
            "All our models are fol­ded from one paper sheet. They are " +
            "exclu­sively folded with­out using any adhesive. Several " +
            "models are equipped with a folded landing gear enabling a safe " +
            "landing on the intended loca­tion provided that you have aimed " +
            "well. Other models are able to fly loops or cover long distances. " +
            "Let them start from a vista point in the mountains and see " +
            "where they touch the ground. ";
        
        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");
            p.set_option("charref=true");

            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());
            
            
            /* ------------------------
             * Fill a rhombus with text
             * ------------------------
             */
            p.begin_page_ext(0, 0, "width=a4.width height=a4.height");

            /* Create a heading */
            p.setfont(font, 11);
            
            p.fit_textline("Page 1:", llx, ury+60, "fillcolor={rgb 0 0 1}");
            p.fit_textline("fit_textflow() with option", llx, ury+40,
                "fillcolor={rgb 0 0 1}");
            p.fit_textline("wrap={addfitbox polygons={{50% 80%   20% 50%   " +
                "50% 20%   80% 50%   50% 80%}}}", llx, ury+20, 
                "fillcolor={rgb 0 0 1}");

            /* Create some text and feed it to a Textflow object */
            tf = p.add_textflow(tf, text, textopts);
            if (tf == -1)
                throw new Exception("Error: " + p.get_errmsg());

            /* Place the text. Use the "wrap" option with the "addfitbox" and
             * "polygons" suboptions to add a rhombus to the area being filled.
             * In this case, each corner of the rhombus is specified by a pair
             * of coordinates defined as percentage of the fitbox width or
             * height, respectively.
             * "showborder" is used to illustrate the fitbox borders. 
             */
            result = p.fit_textflow(tf, llx, lly, urx, ury,
                "verticalalign=justify linespreadlimit=120% showborder " +
                "wrap={ addfitbox polygons={" +
                "{50% 80%   20% 50%   50% 20%   80% 50%   50% 80%} } }");

            /* Check for errors */
            if (!result.equals("_stop"))
            {
                /* "_boxempty" happens if the box is very small and doesn't
                 * hold any text at all.
                 */
                if (result.equals( "_boxempty"))
                    throw new Exception ("Error: Textflow box too small");
                else
                {
                    /* Any other return value is a user exit caused by
                     * the "return" option; this requires dedicated code to
                     * deal with.
                     */
                    throw new Exception ("User return '" + result +
                            "' found in Textflow");
                }
            }
            p.delete_textflow(tf);
            
            p.end_page_ext("");
            
            
            /* ------------------------------------------------------------------
             * Fill two overlapping shapes with text. 
             * In this case, the first shape will be filled while the area of the
             * second shape overlapping with the first shape will be left blank.  
             * ------------------------------------------------------------------
             */
            tf = -1;
            
            p.begin_page_ext(0, 0, "width=a4.width height=a4.height");
            
            /* Create a heading */
            p.setfont(font, 11);
            
            p.fit_textline("Page 2:", llx, ury+80, "fillcolor={rgb 0 0 1}");
            p.fit_textline("fit_textflow() with option wrap={addfitbox polygons={",
                llx, ury+60, "fillcolor={rgb 0 0 1}");
            p.fit_textline("{20% 10%   80% 10%   100% 50%   80% 90%   20% 90%   " +
                "0% 50%   20% 10%}", llx, ury+40, "fillcolor={rgb 0 0 1}");
            p.fit_textline("{35% 35%   65% 35%   65% 65%   35% 65%   35% 35%}}}",
                llx, ury+20, "fillcolor={rgb 0 0 1}");
            
            /* Create some text and feed it to a Textflow object */
            for (i = 0; i < 3; i++) {
                tf = p.add_textflow(tf, text, textopts);
                if (tf == -1)
                    throw new Exception("Error: " + p.get_errmsg());
            }
            
            /* Place the text. Use the "wrap" option with the "addfitbox" and
             * "polygons" suboptions to add a hexagon to the area being filled and
             * a rectangle to the area being left empty. Each corner is specified by
             * a pair of coordinates defined as percentage of the fitbox width or
             * height, respectively.
             * "showborder" is used to illustrate the fitbox borders. 
             */
            result = p.fit_textflow(tf, llx, lly, urx, ury,
                "verticalalign=justify linespreadlimit=120% showborder " +
                "wrap={ addfitbox polygons={" +
          "{20% 10%   80% 10%   100% 50%   80% 90%   20% 90%   0% 50%   20% 10%} " +
          "{35% 35%   65% 35%   65% 65%   35% 65%   35% 35%} } }");
            
            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);
        }
    }
}