Java Advanced Imaging Installation Instructions

 

Java Advanced Imaging API
Advanced Imaging API 1.0.2 Installation

System Requirements:
  • For the Solaris operating environment:
    • Solaris operating environment 2.5.1 or subsequent compatible version
    • Java 2 platform ( JDK 1.2 ) FCS or subsequent compatible version
    • 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
    • Optionally, an additional 5M bytes of free disk space for the sample code and images
    • An additional 10M bytes may be needed temporarily during the installation process
  • For Microsoft Windows:
    • Windows 95/98/NT 4.0
    • Java 2 platform ( JDK 1.2) FCS or subsequent compatible version
    • At least 5M bytes of free disk space
    • Optionally, an additional 5M bytes of free disk space for the sample code and images
    • 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

  • Solaris operating environment installation instructions

  • The downloaded bin files are executable files. In the Solaris operating environment, they are self-extracting shell scripts.

    • For the SPARC edition, they are:
      • jai1_0_2-lib-solsparc.bin
      • jai1_0_2-sample-solsparc.bin
    • 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.
    • 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
      
    • 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: 

    • jai1_0_2-lib-win.exe
    • 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. 
    • To install the library files, double-click on the jai1_0_2-lib-win.exe icon and follow the directions.
    • 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

  • 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: 

    • jai1_0_2-lib-solx86.tar.gz
    • 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/sparc/libmlib_*_jai.so* mediaLib JNI shared libraries, C version.
(Solaris operating environment, SPARC and Intel editions.)
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 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.
Left Curve
Java SDKs and Tools
Right Curve
Left Curve
Java Resources
Right Curve
JavaOne Banner Java 8 banner (182)