Beyond Linux® From Scratch - Version 2012-05-20

Chapter 46. PostScript

fop-1.0

Introduction to fop

The FOP (Formatting Objects Processor) package contains a print formatter driven by XSL formatting objects (XSL-FO). It is a Java application that reads a formatting object tree and renders the resulting pages to a specified output. Output formats currently supported include PDF, PCL, PostScript, SVG, XML (area tree representation), print, AWT, MIF and ASCII text. The primary output target is PDF.

This package is known to build and work properly using an LFS-7.0 platform.

Package Information

Additional Downloads

Required packages

fop Dependencies

Required

Xorg-7.6 and apache-ant-1.8.3

Optional

JIMI SDK, XMLUnit, JAI Image I/O Tools, JEuclid, PMD (requires Jaxen), and Forrest (Forrest used only to rebuild the documentation)

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/fop

Installation of fop

[Important]

Important

You must run this installation from an X-window using a GL-aware Xorg server or some of the JUnit tests will hang.

Ensure $JAVA_HOME is set correctly before beginning the build. To build the JIMI SDK and/or XMLUnit extension classes, ensure the corresponding .jar files can be found via the CLASSPATH environment variable.

Installing OFFO Hyphenation Patterns

First, unpack the fop source tarball and the hyphenation zipfile from the same directory, then change directories into the root of the fop source tree. Copy the XML hyphenation patterns into the fop source tree by running the following commands: 

cp ../offo-hyphenation/hyph/* hyph &&
rm -rf ../offo-hyphenation

Installing Java Advanced Imaging (JAI) API components

Next install the JAI API components. As the root user: 

case `uname -m` in
  i?86)   
    tar -xf ../jai-1_1_3-lib-linux-i586.tar.gz  
    cp -v jai-1_1_3/lib/{jai*,mlibwrapper_jai.jar} $JAVA_HOME/jre/lib/ext/
    cp -v jai-1_1_3/lib/libmlib_jai.so             $JAVA_HOME/jre/lib/i386/
    ;;

  x86_64) 
    tar -xf ../jai-1_1_3-lib-linux-amd64.tar.gz 
    cp -v jai-1_1_3/lib/{jai*,mlibwrapper_jai.jar} $JAVA_HOME/jre/lib/ext/
    cp -v jai-1_1_3/lib/libmlib_jai.so             $JAVA_HOME/jre/lib/amd64/
    ;;
esac

Installing fop Components

If Forrest is not installed, remove a reference to it in the build.xml: 

sed -i -e "s/all,javadocs,docs/all,javadocs/" \
       -e '\#${dist.bin.result.dir}/docs#,\#</copy>#d' build.xml

Compile fop by running the following commands: 

ant dist

The unit regression tests were performed in the build step above.

Now, as the root user: 

install -v -d -m755      /opt/fop-1.0 &&
mv -v dist-bin/fop-1.0/* /opt/fop-1.0 &&
ln -v -sf fop-1.0 /opt/fop

Command Explanations

ant dist: This reads the build.xml file's dist target, builds the package and runs the unit regression tests. It also creates the Java API documentation and a directory where the newly created binaries are placed. This directory is used to install fop into its final place.

ln -v -sf fop-1.0 /opt/fop: This is optional and creates a convenience symlink so that $FOP_HOME doesn't have to be changed each time there's a package version change.

Configuring fop

Config Files

~/.foprc

Configuration Information

Using fop to process some large FO's (including the FO derived from the BLFS XML sources), can lead to memory errors. Unless you add a parameter to the java command used in the fop script you may receive messages similar to the one shown below:

Exception in thread "main" java.lang.OutOfMemoryError: Java heap space

To avoid errors like this, you need to pass an extra parameter to the java command used in the fop script. This can be accomplished by creating a ~/.foprc (which is sourced by the fop script) and adding the parameter to the FOP_OPTS environment variable.

The fop script looks for a FOP_HOME environment variable to locate the fop class libraries. You can create this variable using the ~/.foprc file as well. Create a ~/.foprc file using the following commands: 

cat > ~/.foprc << "EOF"
FOP_OPTS="-Xmx<RAM_Installed>m"
FOP_HOME="/opt/fop"

EOF

Replace <RAM_Installed> with a number representing the amount of RAM installed in your computer (in megabytes). An example would be FOP_OPTS="-Xmx768m". For more information about memory issues running fop, see http://xml.apache.org/fop/running.html#memory.

To include the fop script in your path, update your personal or system-wide profile with the following: 

PATH=$PATH:/opt/fop

Contents

Installed Programs: fop
Installed Libraries: fop.jar and numerous support library classes located in /opt/fop/{build,lib}; JAI components include libmlib_jai.so, jai_codec.jar, jai_core.jar, and mlibwrapper_jai.jar
Installed Directory: /opt/fop-1.0

Short Descriptions

fop

is a wrapper script to the java command which sets up the fop environment and passes the required parameters.

fop.jar

contains all the fop Java classes.

Last updated on 2012-05-08 05:21:33 +0000