PDFlib Cookbook

cookbook

general/license_key

Download Java Code      Switch to PHP Code     Show Output PDF

/*
 * $Id: license_key.java,v 1.11 2012/12/10 14:16:23 stm Exp $
 *
 * License key:
 * Apply your PDFlib license key using various methods to get rid of the demo 
 * stamp 
 * 
 * The first method is to apply your license key at runtime or (for Windows
 * only) via a registry key. The second alternative method is to supply your
 * license key in a license file and to inform PDFlib about the license file
 * using set_option(), a system environment variable or (for Windows only)
 * a registry key.
 *   
 * Check for an existing license key by using set_option() with the
 * "avoiddemostamp" option.
 * 
 * Note that PDFlib, PDFlib+PDI, and PPS (PDFlib Personalization Server) are
 * different products which require different license keys although they are
 * delivered in a single package. PDFlib+PDI license keys will also be valid
 * for PDFlib, but not vice versa, and PPS license keys will be valid for
 * PDFlib+PDI and PDFlib. All license keys are platform-dependent, and can only
 * be used on the platform for which they have been purchased.
 *
 * Required software: PDFlib/PDFlib+PDI/PPS 9
 * Required data: valid license key for PDFlib, PDFlib+PDI, or PPS
 */
package com.pdflib.cookbook.pdflib.general;

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

public class license_key {
    public static void main(String argv[]) {
        String outfile = "license_key.pdf";
        String title = "License Key";

        pdflib p = null;
        int tf;

        final String text = 
            "You can apply your PDFlib license key using various methods to get "
            + "rid of the demo stamp. The first method is to apply your license "
            + "key at runtime or (for Windows only) via a registry key. The second "
            + "alternative method is to supply your license key "
            + "in a license file and to inform PDFlib about the license file using "
            + "set_option(\"licensefile=<path to license file>\"), "
            + "a system environment variable or (for Windows only) a registry "
            + "key. "
            + "See the source code for a detailed description. "
            + "See also chapter 0 in the PDFlib Tutorial for detailed "
            + "documentation about the licensing mechanism.";

        try {
            p = new pdflib();

            /*
             * --- First method: --- 
             * --- Apply the license key at runtime ---
             */

            /*
             * Provide the "license" option with your license key. This must
             * be done immediately after having instantiated the PDFlib object
             * with "new pdflib()" In the following function call replace "0"
             * with your license key number.
             */
            p.set_option("license=0");

            /*
             * On Windows you can also enter the license key in the following
             * registry key:
             * 
             * HKEY_LOCAL_MACHINE\SOFTWARE\PDFlib\PDFlib\9.0.0
             * 
             * with a version of 9.0.0 for example
             */

            /*
             * (If you are working with the Windows COM .NET installer you can
             * enter a license key when you install the PDFlib product.)
             */

            /*
             * Using PDFlib+PDI functions if only the PDFlib license key has
             * been installed: If you installed a valid PDFlib license key the
             * PDI functionality will no longer be available for testing. When a
             * license key for a product has already been installed, you can
             * replace it with the dummy license string "0" (zero) to enable
             * functionality of a higher product class for evaluation with:
             * 
             * p.set_option("license=0");
             * 
             * This will enable the previously disabled functions, and
             * re-activate the demo stamp across all pages. This also applies to
             * PDFlib+PDI and PPS.
             */

            /*
             * --- Alternative second method: --- 
             * --- Supply the license key in a license file ---
             */

            /*
             * Enter the license key in a text file according to the following
             * format (use the license file template "licensekeys.txt" which is
             * contained in all PDFlib distributions):

               PDFlib license file 1.0
               # Licensing information for PDFlib GmbH products
               PDFlib <version> <license key>

             * "PDFlib" indicates PDFlib, PDFlib+PDI, and PPS, respectively.
             * <version> is the PDFlib version number, e.g. 9.0.0, and <license
             * key> is your license key. The license file may contain license
             * keys for multiple PDFlib GmbH products on separate lines.
             */

            /*
             * After the license key has been manually added to the license
             * file, either place the file "licensekeys.txt" in one of the
             * default locations that PDFlib searches (see section "Default 
             * file search paths" in the PDFlib Tutorial), or inform PDFlib
             * about the license file in one of the following ways:
             * 
             * p.set_option("licensefile=path/to/licensekeys.txt");
             * 
             * Alternatively, set the environment variable PDFLIBLICENSEFILE to
             * point to your license file.
             *
             * On Windows open the system control panel and choose System, 
             * Advanced, Environment Variables, System variables.
             * 
             * On Unix apply a command similar to the following:
             * export PDFLIBLICENSEFILE=/path/to/licensekeys.txt
             */

            /*
             * On Windows you can also enter the name of the license file in the
             * following registry key:
             * 
             * HKLM\Software\PDFlib\PDFLIBLICENSEFILE
             */

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

            /*
             * Start the first document. By default, a demo stamp will be
             * generated on all pages if no valid license key has been found.
             */
            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.11 $");

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

            final String optlist = "fontname=Helvetica-Bold fontsize=16 " 
                + "encoding=unicode fillcolor={gray 0} leading=140%";

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

            p.fit_textflow(tf, 50, 200, 400, 600, "");

            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());
        }
        catch (Exception e) {
            System.err.println(e.getMessage());
        }

        try {
            /*
             * By default a demo stamp will be created on all pages when no
             * valid license key has been found. However, we can force an
             * exception in those cases. This is recommended to be immediately
             * informed about problems with missing or invalid license keys
             * which will result in the unwanted demo stamp. Before beginning a
             * new document, we set the "avoiddemostamp" option to "true". An
             * exception will be thrown when no valid license key has been
             * found.
             */
            p.set_option("avoiddemostamp=true");

            /*
             * Start a new document, generate it in memory to avoid creation of
             * an invalid PDF document on disk.
             */
            p.begin_document("", "");
            p.begin_page_ext(0, 0, "width=a4.width height=a4.height");
            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");
            if (e.get_errnum() == 1994)
                System.err
                    .println("This behaviour is expected since we did not\n"
                        + "supply a valid license key and set the\n"
                        + "\"avoiddemostamp\" option to \"true\".");
        }
        catch (Exception e) {
            System.err.println(e.getMessage());
        }
        finally {
            if (p != null) {
                p.delete();
            }
        }
    }
}