/* $Id: text_on_color.java,v 1.8.4.1 2008/06/17 12:30:47 katja Exp $
 * Text on colored background:
 * Place a text line and a Textflow on a colored background
 *
 * Place a text line on a colored background using info_textline() to get the
 * dimensions of the text line. Place a text line using the "matchbox" option
 * which provides a more versatile way for text calculations.
 * Fit a Textflow on a colored background. Use fit_textflow() in "blind" mode
 * and info_textflow() to calculate the dimensions of the Textflow without any
 * output generated. Use fit_textflow() with the "rewind" option to actually
 * fit the Textflow.
 *
 * Required software: PDFlib/PDFlib+PDI/PPS 7
 * Required data: none
 */
package com.pdflib.cookbook.pdflib.text_output;

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

public class text_on_color
{
    public static void main (String argv[])
    {
    /* This is where the data files are. Adjust as necessary. */
    String searchpath = "../input";
    String outfile = "text_on_color.pdf";
    String title = "Text on colored Background";

    pdflib p = null;
    int font, tf = -1, offset = 30, x = 50, y;
    String result, optlist;
    double width, height;

    String textline = "Giant Wing Paper Plane";

    String textflow =
        "To fold the famous rocket looper proceed as follows:\nTake a A4 " +
        "sheet. Fold it lenghtwise in the middle. Then, fold the upper " +
        "corners down. Fold the long sides inwards that the points A and B " +
        "meet on the central fold. Fold the points C and D that the upper " +
        "corners meet with the central fold as well. Fold the plane in the " +
        "middle. Fold the wings down that they close with the lower border " +
        "of the plane.";

    try {
        p = new pdflib();

        p.set_parameter("SearchPath", searchpath);

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

        /* 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 Cookbook");
        p.set_info("Title", title + " $Revision: 1.8.4.1 $");

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

        /* Load font */
        font = p.load_font("Helvetica", "unicode", "");

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

        /* --------- Text line: Method I -------- */

        /* Place a text line with a colored background using info_textline()
         * for retrieving the width and height of the default box for the
         * text. The height will be the capheight of the font by default. To
         * use another font property use the "matchbox" option as shown below.
         */
        optlist = "font=" + font + " fontsize=40 " + "fillcolor={gray 1}";
        width = p.info_textline(textline, "width", optlist);
        height = p.info_textline(textline, "height", optlist);

        /* Draw a rectangle with exactly the retrieved width and height */
        p.setcolor("fill", "rgb", 0.0, 0.8, 0.8, 0);
        p.rect(x, 700, width, height);
        p.fill();

        /* Place the text line on the rectangle */
        p.fit_textline(textline, x, 700, optlist);

        /* --------- Text line: Method II -------- */

        /* Place a text line with a colored background in a single
         * fit_textline() call. The "matchbox" option is used to specify the
         * rectangle to be colored. The "boxheight" suboption defines the height
         * of the matchbox while "offsetbottom" and "offsettop" adds some space
         * at the top and bottom. The width of the matchbox is specified by the
         * text width plus the space defined by "offsetleft" and "offsetright".
         */
        optlist =
            "font=" + font + " fontsize=40 " + "fillcolor={gray 1} " +
            "matchbox={fillcolor={rgb 0 0.8 0.8} " +
            "boxheight={ascender descender}}";

        /* Place the text line */
        p.fit_textline(textline, x, 600, optlist);

        /* To increase the matchbox beyond the text, use "offsetbottom" and
         * "offsettop" to add some space at the top and bottom. Use "offsetleft"
         * and "offsetright" to add some space to the left and right.
         */
        optlist =
            "font=" + font + " fontsize=40 " + "fillcolor={gray 1} " +
            "matchbox={fillcolor={rgb 0 0.8 0.8} " +
            "boxheight={ascender descender} " +
            "offsetleft=-8 offsetright=8 offsettop=8 offsetbottom=-8}";

        /* Place the text line */
        p.fit_textline(textline, x, 500, optlist);

        /* --------- Textflow on a colored background -------- */

        /* Place a white Textflow on a green background. To get the dimensions
         * of the background rectangle, first fit the Textflow in "blind" mode.
         * All calculations will be done but no Textflow will be placed in the
         * output file.
         * Then, retrieve the width and height of the Textflow and use them to
         * draw the background rectangle. Finally, rewind the Textflow state to
         * before the last (blind mode) call to fit_textflow() and fit the
         * Textflow.
         */
        optlist = "font=" + font +  " fontsize=20 fillcolor={gray 1}";

        tf = p.add_textflow(tf, textflow, optlist);
        if (tf == -1)
            throw new Exception("Error: " + p.get_errmsg());

        /* Fit the Textflow in "blind" mode. All calculations will be done but
         * the textflow will not actually be placed.
         */
        result = p.fit_textflow(tf, 0, 0, 500, 500, "blind");
        if (!result.equals("_stop"))
        {
            /* Check for errors or more text to be placed */
        }

        /* Get the width and height of the Textflow placed */
        width = p.info_textflow(tf, "textwidth");
        height = p.info_textflow(tf, "textheight");

        /* Draw a rectangle with the retrieved width and height */
        y = 270;
        p.setcolor("fill", "rgb", 0.0, 0.8, 0.8, 0.0);
        p.rect(x, y, width, height);
        p.fill();

        /* Now actually fit the textflow. To rewind the Textflow
         * status to before the last call to fit_textflow() use "rewind=-1".
         */
        result = p.fit_textflow(tf, x, y, x+width, y+height, "rewind=-1");
        if (!result.equals("_stop"))
        {
            /* Check for errors or more text to be placed */
        }

        /* Draw a rectangle with the retrieved dimensions plus a defined
         * offset for some empty space around the text.
         */
        y = 50;
        p.setcolor("fill", "rgb", 0.0, 0.8, 0.8, 0.0);
        p.rect(x-offset/2, y-offset/2, width+offset, height+offset);
        p.fill();

        /* Fit the Textflow a second time while considering the offset. To
         * rewind the Textflow status to before the last call to
         * fit_textflow() use "rewind=-1".
         */
        result = p.fit_textflow(tf, x, y, x+width, y+height, "rewind=-1");
        if (!result.equals("_stop"))
        {
            /* Check for errors or more text to be placed */
        }

        p.end_page_ext("");

        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");
        } catch (Exception e) {
            System.err.println(e.toString());
        } finally {
            if (p != null) {
                p.delete();
            }
        }
    }
}