<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
<article>
    <title>HOWTO</title>
    <subtitle>Add support for PNG and TIFF in FOP</subtitle>
    <abstract>
        <para>This article explains how to install and configure support for PNG and TIFF images for
            the built-in Apache FOP engine in Oxygen XML Editor 4.0 or higher.</para>
    </abstract>
    <sect1>
        <title>Introduction</title>
        <para>FOP natively supports the use of several graphical formats: BMP, EPS (limited
            support), GIF, JPEG, TIFF (limited support). In order to support the PNG and TIFF
            formats, FOP needs several external graphical libraries, like JIMI and JAI.</para>
        <para>FOP has been compiled both with JIMI and JAI support, but because of licensing issues
            (nontransferable license and inability to make copies of the respective software), none
            of them was included in the FOP distribution. However, any of them is easy to install.</para>
    </sect1>
    <sect1>
        <title>Installation</title>
        <para/>
        <procedure>
            <title>Installing JIMI</title>
            <para>JIMI is a class library for managing images. For FOP it adds support for PNG images.</para>
            <step>
                <para>Exit &lt;oXygen/&gt; if it is started.</para>
            </step>
            <step>
                <para>Download JIMI from <ulink url="http://java.sun.com/products/jimi/">http://java.sun.com/products/jimi/</ulink>.</para>
            </step>
            <step>
                <para>Unzip the downloaded archive. This will spawn a directory that contain
                    sources, docs, examples and the compiled library (JimiProClasses.zip).</para>
            </step>
            <step>
                <para>Rename JimiProClasses.zip into jimi-1.0.jar.</para>
            </step>
            <step>
                <para>Copy jimi-1.0.jar into [oXygenInstallDir]\lib</para>
            </step>
            <step>
                <para>Restart &lt;oXygen/&gt;.</para>
            </step>
        </procedure>
        <procedure>
            <title>Installing JAI</title>
            <para>JAI adds support for PNG and TIFF images.</para>
            <step>
                <para>Exit &lt;oXygen/&gt; if it is started.</para>
            </step>
            <step>
                <para>Download JAI 1.1.2 from:</para>
                <para><ulink url="http://java.sun.com/products/java-media/jai/downloads/download-1_1_2.html">http://java.sun.com/products/java-media/jai/downloads/download-1_1_2.html</ulink>. </para>
            </step>
            <step>
                <para>Install the kit into the default specified directory (e.g. on Windows platform
                    in C:/jai-1_1_2)</para>
            </step>
            <step>
                <para>Copy jai_codec.jar and jai_core.jar from C:/jai-1_1_2/lib into [oxygenInstallDir]\lib</para>
            </step>
            <step>
                <para>Restart &lt;oXygen/&gt;.</para>
            </step>
        </procedure>
    </sect1>
</article>

