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.