JavaTM Advanced Imaging API

                        JavaTM Advanced Imaging API 1.0.2
                                             Installation

      * System Requirements
      * Downloading the archive files
      * Installation Instructions
           o Linux operating environment installation instructions
           o Solaris operating environment installation instructions
           o Microsoft Windows operating environment installation
             instructions
           o Manual installation instructions
      * After Java Advanced Imaging is installed
      * Updating CLASSPATH, PATH, and LD_LIBRARY_PATH
      * Uninstall Instructions

   System Requirements:

      * For the Linux operating environment:
           o Linux kernel >= 2.2.14, Glibc >= 2.1.3
           o JavaTM 2 platform (JDKTM 1.2.2) FCS or subsequent compatible
             version
           o At least 5M bytes of free disk space for the Intel edition
           o Optionally, an additional 5M bytes of free disk space for the
             sample code and images
           o An additional 10M bytes may be needed temporarily during the
             installation process
      * For the SolarisTM operating environment:
           o Solaris operating environment 2.5.1 or subsequent compatible
             version
           o JavaTM 2 platform (JDKTM 1.2) FCS or subsequent compatible
             version
           o At least 8M bytes of free disk space for the SPARC edition, or
             at least 5M bytes of free disk space for the Intel edition
           o Optionally, an additional 5M bytes of free disk space for the
             sample code and images
           o An additional 10M bytes may be needed temporarily during the
             installation process
      * For Microsoft Windows:
           o Windows 95/98/NT 4.0
           o Java 2 platform (JDK 1.2) FCS or subsequent compatible version
           o At least 5M bytes of free disk space
           o Optionally, an additional 5M bytes of free disk space for the
             sample code and images
           o An additional 10M bytes may be needed temporarily during the
             installation process

   Downloading the Archive Files

   Using your browser, download the appropriate executable(s) or tar.gz
   files from the download page to the location where you want to
   temporarily store them .

   The download has been broken into two archives for convenience. The
   first archive contains the JAI library itself and is required in order
   to run JAI. The second archive contains sample code and images that may
   optionally be downloaded in order to demonstrate some of the
   functionality of JAI.

   Installation Instructions

      * Linux operating environment installation instructions

        The downloaded files are in tar.bz2 format.
           o For the Intel edition, they are:
                + jai1_0_2-lib-linux-i386.tar.bz2
                + jai1_0_2-sample-linux.tar.bz2
           o For the Sparc edition, they are:
                + jai1_0_2-lib-linux-sparc.tar.bz2
                + jai1_0_2-sample-linux.tar.bz2
           o For the PPC edition, they are:
                + jai1_0_2-lib-linux-ppc.tar.bz2
                + jai1_0_2-sample-linux.tar.bz2

        To extract the files from the archives:

             % cd $JDK1_2

             where $JDK1_2 is the path into the jdk1.2 (or a higher
             version) directory, and $downloaddir is the directory into
             which you downloaded the .tar.bz2 files.

           o If you are on an Intel-based system, run the command:

             % tar xvfI u+x $downloaddir/jai1_0_2-lib-linux-i386.tar.bz2

           o If you are on an Sparc-based system, run the command:

             % tar xvfI u+x $downloaddir/jai1_0_2-lib-linux-sparc.tar.bz2

           o If you are on an PPC-based system, run the command:

             % tar xvfI u+x $downloaddir/jai1_0_2-lib-linux-ppc.tar.bz2

           To install the samples on any of the above systems, run the
           commond:

             % tar xvfI u+x $downloaddir/jai1_0_2-sample-linux.tar.bz2


      * Solaris operating environment installation instructions

        The downloaded bin files are executable files. In the Solaris
        operating environment, they are self-extracting shell scripts.
           o For the SPARC edition, they are:
                + jai1_0_2-lib-solsparc.bin
                + jai1_0_2-sample-solsparc.bin
           o For the Intel edition, they are:
                + jai1_0_2-lib-solx86.bin
                + jai1_0_2-sample-solx86.bin
        The archive files are also available for download in separate
        pieces of 1.4 Mbytes each. These pieces have names ending in
        -a.bin, -b.bin, etc. These pieces must be reassembled into complete
        archive files before proceeding with the installation.

        The archive pieces may be reassembled into complete archive files
        using the commands:

        % cat jai1_0_2-lib-solsparc-?.bin > \
         jai1_0_2-lib-solsparc.bin
        % cat jai1_0_2-sample-solsparc-?.bin > \
         jai1_0_2-sample-solsparc.bin

        To extract the files from the archives:

             % cd $JDK1_2

             where $JDK1_2 is the path into the jdk1.2 (or a higher
             version) directory, and $downloaddir is the directory into
             which you downloaded the .bin files.
           o If you are on a SPARC-based system, run the commands:

             % chmod u+x $downloaddir/jai1_0_2-lib-solsparc.bin
             % $downloaddir/jai1_0_2-lib-solsparc.bin

             If you wish to install the sample files, run the commands:

             % chmod u+x $downloaddir/jai1_0_2-sample-solsparc.bin
             % $downloaddir/jai1_0_2-sample-solsparc.bin

           o If you are on an Intel-based system, run the commands:

             % chmod u+x $downloaddir/jai1_0_2-lib-solx86.bin
             % $downloaddir/jai1_0_2-lib-solx86.bin

             If you wish to install the sample files, run the commands:

             % chmod u+x $downloaddir/jai1_0_2-sample-solx86.bin
             % $downloaddir/jai1_0_2-sample-solx86.bin

        You may answer 'yes' to any questions about replacing files. You
        may delete the jai1_0_2-*.bin files after you are done with the
        extraction.

        IMPORTANT: If you do not "cd" to the JDK1.2 (or higher version)
        directory before performing the extraction, then JAI will not work
        correctly.

      * Microsoft Windows installation instructions

        The downloaded objects are executable files. In Microsoft Windows,
        they are .exe files:
           o jai1_0_2-lib-win.exe
           o jai1_0_2-sample-win.exe
        The archive files are also available for download in separate
        pieces of 1.4Mbytes each. These pieces have names ending in -a.exe,
        -b.exe, etc. These pieces must be reassembled into complete archive
        files before proceeding with the installation. The MS-DOS copy
        command may be used to reassemble the pieces into a single file.

        To reassemble the library archive pieces, run the following command
        from an MS-DOS (command prompt) window:

        C:\> copy /b jai1_0_2-lib-win-a.exe +
                     jai1_0_2-lib-win-b.exe +
                     jai1_0_2-lib-win-c.exe
                     jai1_0_2-lib-win.exe
        C:\> copy /b jai1_0_2-sample-win-a.exe +
                     jai1_0_2-sample-win-b.exe +
                     jai1_0_2-sample-win-c.exe +
                     jai1_0_2-sample-win-d.exe
                     jai1_0_2-sample-win.exe

        The commands are shown here on multiple lines for formatting
        reasons; they should each be entered on a single line.
           o To install the library files, double-click on the
             jai1_0_2-lib-win.exe icon and follow the directions.
           o If you wish to install the sample files, double-click on the
             jai1_0_2-sample-win.exe icon and follow the directions.
        You may delete the jai1_0_2-*.exe files after you are done with the
        extraction.

        IMPORTANT: The executable will try to install JAI within the latest
        JDK version that it finds. If you need to install and use JAI
        within another JDK version on disk, please make sure you enter a
        valid JDK directory when prompted.

      * Manual installation instructions for Solaris

        In addition to the self-installing .bin files, the Solaris version
        of JAI is also available in the form of standard gzip compressed
        tar archives for manual installation. These may be used, for
        example, to experiment with JAI on unsupported platforms. Manual
        installation is to be done at your own risk; the directory
        structure and installation rules for Java extensions may differ
        from platform to platform.

        The tar.gz files are:
           o jai1_0_2-lib-solx86.tar.gz
           o jai1_0_2-sample-solx86.tar.gz
        To install, change directories to the root directory of the JDK and
        issue commands such as:

        % gunzip -c $downloaddir/jai1_0_2-lib-solsparc.tar.gz | tar xf -
        % gunzip -c $downloaddir/jai1_0_2-sample-solsparc.tar.gz | tar xf -

        to load the Solaris/SPARC files, or

        % gunzip -c $downloaddir/jai1_0_2-lib-solx86.tar.gz | tar xf -
        % gunzip -c $downloaddir/jai1_0_2-sample-solx86.tar.gz | tar xf -

        to install the Solaris/Intel files.

   After Java Advanced Imaging is installed

   Java Advanced Imaging will be installed under the $JDK1_2 directory with
   the following files:
    COPYRIGHT-jai.txt                   Copyright notice.
    INSTALL-jai.txt                     Installation instructions (this
                                        file)
    UNINSTALL-jai                       UnInstall executable
    LICENSE-jai.txt                     License agreement.
    README-jai.txt                      Useful release information.
    jre/lib/ext/jai_core.jar            JAR file containing core JAI class
                                        files.
    jre/lib/ext/jai_codec.jar           JAR file containing JAI class files
                                        for image I/O.
    jre/lib/ext/registryFile.jai        Registry File for JAI.
    jre/lib/ext/mlibwrapper_jai.jar     mediaLib JNI interfaces.
    jre/lib/$ARCH/libmlib_*_jai.so*     mediaLib JNI shared libraries, C
                                        version.
                                        (Solaris and Linux operating 
                                        environmens)
    jre/lib/sparc/libmlib_*_jai_vis.so* mediaLib JNI shared libraries, VIS
                                        version.
                                        (Solaris operating environment,
                                        SPARC edition only.)
    jre/bin/mlib_*_jai.dll              mediaLib JNI DLL libraries.
                                        (Microsoft Windows operating
                                        environment)

   If the sample archive has been installed, the following files will also
   be installed:
    demo/jai/Makefile         Makefile to build the sample programs.
    demo/jai/README           Information about the sample programs.
    demo/jai/runjai*.sh       Solaris operating environment -
                              Shell scripts to run the sample programs.
    demo/jai/runjai*.bat      Microsoft Windows -
                              Batch files to run the sample programs.
    demo/jai/*.java           Sample source code.
    demo/jai/*.class          Sample class files.
    demo/jai/codec/Makefile   Makefile to build the codec sample program.
    demo/jai/codec/runjai.sh  Solaris operating environment -
                              Shell script to run the codec sample program.
    demo/jai/codec/runjai.bat Microsoft Windows -
                              Batch file to run the codec sample program.
    demo/jai/codec/*.java     Codec sample source code.
    demo/jai/codec/*.class    Codec sample class files.
    demo/jai/images/*.bmp     Sample BMP images.
    demo/jai/images/*.gif     Sample GIF images.
    demo/jai/images/*.fpx     Sample FlashPIX images.
    demo/jai/images/*.jpg     Sample JPEG images.
    demo/jai/images/*.png     Sample PNG images.
    demo/jai/images/*.pgm     Sample PGM images.
    demo/jai/images/*.ppm     Sample PPM images.
    demo/jai/images/*.tif     Sample TIFF images.

   Read the top-level README-jai.txt file for information on what is in
   this release of Java Advanced Imaging.

   Updating CLASSPATH, PATH, and LD_LIBRARY_PATH

   Since JAI is now installed as part of the Java 2 SDK's Java Runtime
   Environment, no CLASSPATH or LD_LIBRARY_PATH settings are required.

   A point to be noted on the Windows platform is that the Java2 SDK 1.2,
   by default, installs Java into both the JDK location:

   c:\jdk1.2

   and into the JRE location:

   C:\Program Files\JavaSoft\Jre\1.2

   Additionally, a shortcut to java.exe is installed in the WINNT/System32
   (for NT systems) or Windows/System (for Windows 95 and 98) directory.

   Developers need to be aware of this when working with the Java 2 SDK.
   Unless the path to the 1.2 SDK jre\bin and bin directories is placed in
   the PATH environment variable in the same order, ahead of the system
   directory, the SDK's java.exe will not be executed. Any extensions (such
   as JAI) that are installed into the SDK but not into the JRE will not be
   found during program execution.The same applies to higher versions of
   the JDK.

   Uninstall Instructions

      * Solaris/Linux operating environment

             % cd $JDK1_2

             where $JDK1_2 is the path into the jdk1.2 (or a higher
             version) directory, where JAI was installed.

             % chmod u+x UNINSTALL-jai
             % ./UNINSTALL-jai

      * Microsoft Windows Operating environment
             You would need to go to the Control Panel and double-click on
             Add/Remove Programs. Find the listing for Java Advanced
             Imaging 1.0.2 and click on Add/Remove. This should uninstall
             the library for you.