Difference between revisions of "Java Advanced Imaging ImageIO Tools"

Revision as of 13:37, 16 September 2015

This article captures current information about the Java Advanced Imaging ImageIO Tools to document exactly what files are involved.

The ImageIO Tools consist of two jar files plus one or more files which are in native code for the platform. The names in the tables below are the ones that appeared in versions 1.0 and 1.1. As the ImageIO Tools progress, the names of the files may accumulate release identification, as in jai_imageio-1.2-pre-dr-b04.jar.

1 JAR Files

File name	Description	Typical Location
jai_imageio.jar	JAR file containing core JAI Image I/O class files	jre/lib/ext
clibwrapper_jiio.jar	codecLib JNI interfaces	jre/lib/ext

2 Native Libraries

File name	Description	Platform	Typical Location
libclib_jiio.so	mediaLib JNI shared libraries	Linux	jre/i386
clib_jiio.dll	codecLib JNI shared libraries	Windows	jre/bin
clib_jiio_sse2.dll	mediaLib JNI DLL libraries	Windows	jre/bin
clib_jiio_util.dll	Utilities	Windows	jre/bin

3 Installation Files

The Oracle site no longer provides links to the ImageIO Tools version 1.1 or later. The files necessary to install the tools on several platforms have been put on the RSNA MIRC site.

3.1 Windows

The Windows installer for the ImageIO Tools is available at: jai_imageio-1_1-lib-windows-i586-jre.exe

A zip file containing the files (not required if using the installer) is available at: http://mirc.rsna.org/ImageIO/win-i686.zip

3.2 Linux

A zip file for installing the ImageIO Tools on an i686 platform is available at: http://mirc.rsna.org/ImageIO/linux-i686.zip

A zip file for installing the ImageIO Tools on an x86_64 platform is available at: http://mirc.rsna.org/ImageIO/linux-x86_64.zip

3.3 Solaris

A zip file for installing the ImageIO Tools on an i686 platform is available at: http://mirc.rsna.org/ImageIO/solaris-i686.zip

A zip file for installing the ImageIO Tools on a SPARC platform is available at: http://mirc.rsna.org/ImageIO/solaris-sparc.zip

A zip file for installing the ImageIO Tools on a SPARC v9 platform is available at: http://mirc.rsna.org/ImageIO/solaris-sparcv9.zip

A zip file for installing the ImageIO Tools on an x86_64 platform is available at: http://mirc.rsna.org/ImageIO/solaris-x86_64.zip

3.4 Macintosh

A zip file containing the two jar files is available at http://mirc.rsna.org/ImageIO/ImageIOJars.zip.

No native libraries are available for the Macintosh. Place the two jar files into:

/Library/Java/JavaVirtualMachines/jdk.../lib/ext.

4 Notes

The jar files are required.
The dll/so files are optional.
The dll/so files provide acceleration for certain image types.
The dll/so files may also provide support for additional image types.
You can force the ImageIO Tools not to use the native libraries by starting a program with this switch:

-Dcom.sun.media.imageio.disableCodecLib=true

Much more information is available at http://download.java.net/media/jai-imageio/builds/release/1.1/INSTALL-jai_imageio.html, although this information seems to be out of date.

@@ Line 1: / Line 1: @@
 This article captures current information about the Java Advanced Imaging ImageIO Tools to document exactly what files are involved.
-The ImageIO Tools consist of two <b>jar</b> files plus one or more files which are in native code for the platform.
+The ImageIO Tools consist of two <b>jar</b> files plus one or more files which are in native code for the platform. The names in the tables below are the ones that appeared in versions 1.0 and 1.1. As the ImageIO Tools progress, the names of the files may accumulate release identification, as in <tt><b>jai_imageio-1.2-pre-dr-b04.jar</b></tt>.
 ==JAR Files==
 <table border="1" style="padding:2px;">
-<tr><th>File name</th><th>Description</th></tr>
+<tr><th>File name</th><th>Description</th><th>Typical Location</th></tr>
-<tr>
+<tr><td style="padding:5px;">jai_imageio.jar</td><td style="padding:5px;">JAR file containing core JAI Image I/O class files</td><td style="padding:5px;"><b>jre/lib/ext</b></td></tr>
-<td>jai_imageio.jar</td>
+<tr><td style="padding:5px;">clibwrapper_jiio.jar</td><td style="padding:5px;">codecLib JNI interfaces</td><td style="padding:5px;"><b>jre/lib/ext</b></td></tr>
-<td>JAR file containing core JAI Image I/O class files.</td>
-<td>required</td>
-</tr>
-<tr>
-<td>clibwrapper_jiio.jar.</td>
-<td>codecLib JNI interfaces.</td>
-<td>required.</td>
-</tr>
 </table>
 ==Native Libraries==
 <table border="thin solid gray">
-<tr><th>File name</th><th>Description</th><th>Platform</th></tr>
+<tr><th>File name</th><th>Description</th><th>Platform</th><th>Typical Location</th></tr>
-<tr><td>libclib_jiio.so</td><td>mediaLib JNI shared libraries</td><td>Linux</td></tr>
+<tr><td style="padding:5px;">libclib_jiio.so</td><td style="padding:5px;">mediaLib JNI shared libraries</td><td style="padding:5px;">Linux</td><td style="padding:5px;"><b>jre/i386</b></td></tr>
-<tr><td>clib_jiio.dll</td><td>codecLib JNI shared libraries</td><td>Windows</td></tr>
+<tr><td style="padding:5px;">clib_jiio.dll</td><td style="padding:5px;">codecLib JNI shared libraries</td><td style="padding:5px;">Windows</td><td style="padding:5px;"><b>jre/bin</b></td></tr>
-<tr><td>clib_jiio_sse2.dll</td><td>mediaLib JNI DLL libraries</td><td>Windows</td></tr>
+<tr><td style="padding:5px;">clib_jiio_sse2.dll</td><td style="padding:5px;">mediaLib JNI DLL libraries</td><td style="padding:5px;">Windows</td><td style="padding:5px;"><b>jre/bin</b></td></tr>
-<tr><td>clib_jiio_util.dll</td><td>Utilities</td><td>Windows</td></tr>
+<tr><td style="padding:5px;">clib_jiio_util.dll</td><td style="padding:5px;">Utilities</td><td style="padding:5px;">Windows</td><td style="padding:5px;"><b>jre/bin</b></td></tr>
 </table>
+==Installation Files==
+The Oracle site no longer provides links to the ImageIO Tools version 1.1 or later. The files necessary to install the tools on several platforms have been put on the RSNA MIRC site.
+===Windows===
+The Windows installer for the ImageIO Tools is available at: [http://mirc.rsna.org/ImageIO/jai_imageio-1_1-lib-windows-i586-jre.exe jai_imageio-1_1-lib-windows-i586-jre.exe]
+A zip file containing the files (not required if using the installer) is available at: [http://mirc.rsna.org/ImageIO/win-i686.zip http://mirc.rsna.org/ImageIO/win-i686.zip]
+===Linux===
+A zip file for installing the ImageIO Tools on an i686 platform is available at: [http://mirc.rsna.org/ImageIO/linux-i686.zip http://mirc.rsna.org/ImageIO/linux-i686.zip]
+A zip file for installing the ImageIO Tools on an x86_64 platform is available at: [http://mirc.rsna.org/ImageIO/linux-x86_64.zip http://mirc.rsna.org/ImageIO/linux-x86_64.zip]
+===Solaris===
+A zip file for installing the ImageIO Tools on an i686 platform is available at: [http://mirc.rsna.org/ImageIO/solaris-i686.zip http://mirc.rsna.org/ImageIO/solaris-i686.zip]
+A zip file for installing the ImageIO Tools on a SPARC platform is available at: [http://mirc.rsna.org/ImageIO/solaris-sparc.zip http://mirc.rsna.org/ImageIO/solaris-sparc.zip]
+A zip file for installing the ImageIO Tools on a SPARC v9 platform is available at: [http://mirc.rsna.org/ImageIO/solaris-sparcv9.zip http://mirc.rsna.org/ImageIO/solaris-sparcv9.zip]
+A zip file for installing the ImageIO Tools on an x86_64 platform is available at: [http://mirc.rsna.org/ImageIO/solaris-x86_64.zip http://mirc.rsna.org/ImageIO/solaris-x86_64.zip]
+===Macintosh===
+A zip file containing the two jar files is available at [http://mirc.rsna.org/ImageIO/ImageIOJars.zip http://mirc.rsna.org/ImageIO/ImageIOJars.zip].
+No native libraries are available for the Macintosh. Place the two jar files into:
+:<b><tt>/Library/Java/JavaVirtualMachines/jdk.../lib/ext</tt></b>.
 ==Notes==
-#The <b>jar</b> files are typically located in the Java <b>jre/lib/ext</b> directory.
-#The <b>dll</b> files are typically located in the Java <b>jre/bin</b> directory on a Windows system.
-#The <b>so</b> file is typically located in the Java <b>jre/i386</b> directory on an Intel Linux system.
-#All the binary builds are available on https://jai-imageio.dev.java.net/binary-builds.html
 #The <b>jar</b> files are required.
-#The dll/so files just provide acceleration for certain image types.
+#The dll/so files are optional.
-#The dll/so files may provide support for additional image types.
+#The dll/so files provide acceleration for certain image types.
+#The dll/so files may also provide support for additional image types.
 #You can force the ImageIO Tools not to use the native libraries by starting a program with this switch:
 ::<b>-Dcom.sun.media.imageio.disableCodecLib=true</b>
-At one time, the following was true (according to jgarnet):
+Much more information is available at http://download.java.net/media/jai-imageio/builds/release/1.1/INSTALL-jai_imageio.html, although this information seems to be out of date.
-If use of native code is disallowed then the JPEG and PNG reader-writer plug-ins and some accelerations used for bilevel TIFF compression will not be available nor will the native implementation of the JPEG 2000 reader-writer plug-in; the Java implementation of the JPEG 2000 plug-in will however be available. The respective plug-ins will detect that native libraries cannot be used and respond accordingly.