Difference between revisions of "Java Advanced Imaging ImageIO Tools"

From MircWiki
Jump to: navigation, search
(Notes)
(Macintosh)
 
(26 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
This article captures current information about the Java Advanced Imaging ImageIO Tools to document exactly what files are involved.
 
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==
 
==JAR Files==
 
<table border="1" style="padding:2px;">
 
<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>
 
</table>
  
 
==Native Libraries==
 
==Native Libraries==
 
<table border="thin solid gray">
 
<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>
 
</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==
 
==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 <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:
 
#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>
 
::<b>-Dcom.sun.media.imageio.disableCodecLib=true</b>
  
At one time, the following was 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.
 
+
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[TM] 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.
+

Latest 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 nameDescriptionTypical Location
jai_imageio.jarJAR file containing core JAI Image I/O class filesjre/lib/ext
clibwrapper_jiio.jarcodecLib JNI interfacesjre/lib/ext

2 Native Libraries

File nameDescriptionPlatformTypical Location
libclib_jiio.somediaLib JNI shared librariesLinuxjre/i386
clib_jiio.dllcodecLib JNI shared librariesWindowsjre/bin
clib_jiio_sse2.dllmediaLib JNI DLL librariesWindowsjre/bin
clib_jiio_util.dllUtilitiesWindowsjre/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

  1. The jar files are required.
  2. The dll/so files are optional.
  3. The dll/so files provide acceleration for certain image types.
  4. The dll/so files may also provide support for additional image types.
  5. 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.