README-build: build instructions for the jai-imageio-core project

Building the Java Advanced Imaging Image I/O Tools Packages

To build the Java Advanced Imaging Image I/O Tools packages, you must first checkout the jai-imageio-core CVS repository on java.net. For example, run the cvs checkout command as follows:

cd <cvs-root-dir>

cvs checkout jai-imageio-core

System Requirements

Any operating environment that supports J2SE should work. We have built jai-imageio-core on the following operating environments:

Solaris-sparc: Sparc (Ultra60 or better) running Solaris 9
Solaris-x86: i386/i586 running Solaris-x86 9
Linux: i386/i586 running SuSE 9 or RedHat 9.0
Windows: Windows/XP, Windows 2000

The following software must be installed:

J2SE 1.4 or later.
Apache Ant 1.6 or later

Building Java Advanced Imaging Image I/O Tools

Before you start building, your PATH must include these directories

<ant-root-dir>/bin
<jdk-root-dir>/bin

and Java Advanced Imaging (JAI) must be be referenced either by

JAI being installed in the J2SDK used for the build; or
jai_core.jar being on the CLASSPATH.

Setting the JAVA_HOME or JAVACMD environment variable will supersede <jdk-root-dir>/bin for ant. For further details please refer to the ant manual.

The default target, jar, creates both optimized and debug jar files.

To build:

 cd <cvs-root-dir>/jai-imageio-core

ant

The above steps build the Java code for the jj2000.*, com.sun.media.imageio.*, com.sun.media.imageioimpl.*, com.sun.media.jai.imageioimpl and com.sun.media.jai.operator packages.

The build will be placed in jai-imageio-core/build/<platform>/opt, where <platform> is determined from the ant echo command:

ant echo

Jar files are placed in jai-imageio-core/build/<platform>/opt/lib/ext. Binaries for native libraries are part of the project and are copied to the jai-imageio-core/build/<platform>/opt/<jrenativesubdir> directory as part of the build, where <jrenativesubdir> is determined from the

ant
echo

command as above.

To see other targets that are available, type "ant -projecthelp". Note that ant must be run from the top-level directory.

Running Java Advanced Imaging Image I/O Tools

To run Java Advanced Imaging Image I/O Tools, please checkout the jai-imageio-demos project and then refer to README-build.html in jai-imageio-demos for details on building and running Java Advanced Imaging Image I/O Tools demo programs.