Difference between revisions of "Java Advanced Imaging ImageIO Tools"

From MircWiki
Jump to navigation Jump to search
Line 5: Line 5:
 
==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><td>jai_imageio.jar</td><td>JAR file containing core JAI Image I/O class files.</td></tr>
+
<tr><td>jai_imageio.jar</td><td>JAR file containing core JAI Image I/O class files.</td><td><b>jre/lib/ext</b></td></tr>
<tr><td>clibwrapper_jiio.jar.</td><td>codecLib JNI interfaces.</td></tr>
+
<tr><td>clibwrapper_jiio.jar.</td><td>codecLib JNI interfaces.</td><td><b>jre/i386</b></td><td><b>jre/lib/ext</b></td></tr>
 
</table>
 
</table>
  
Line 14: Line 14:
 
<tr><th>File name</th><th>Description</th><th>Platform</th><th>Typical Location</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><td><b>jre/i386</b></td></tr>
 
<tr><td>libclib_jiio.so</td><td>mediaLib JNI shared libraries</td><td>Linux</td><td><b>jre/i386</b></td></tr>
<tr><td>clib_jiio.dll</td><td>codecLib JNI shared libraries</td><td>Windows</td><td><b>jre/lib/ext</b></td></tr>
+
<tr><td>clib_jiio.dll</td><td>codecLib JNI shared libraries</td><td>Windows</td><td><b>jre/bin</b></td></tr>
<tr><td>clib_jiio_sse2.dll</td><td>mediaLib JNI DLL libraries</td><td>Windows</td><td><b>jre/lib/ext</b></td></tr>
+
<tr><td>clib_jiio_sse2.dll</td><td>mediaLib JNI DLL libraries</td><td>Windows</td><td><b>jre/bin</b></td></tr>
<tr><td>clib_jiio_util.dll</td><td>Utilities</td><td>Windows</td><td><b>jre/lib/ext</b></td></tr>
+
<tr><td>clib_jiio_util.dll</td><td>Utilities</td><td>Windows</td><td><b>jre/bin</b></td></tr>
 
</table>
 
</table>
  

Revision as of 19:08, 19 November 2009

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.

1 JAR Files

File nameDescriptionTypical Location
jai_imageio.jarJAR file containing core JAI Image I/O class files.jre/lib/ext
clibwrapper_jiio.jar.codecLib JNI interfaces.jre/i386jre/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 Notes

  1. The jar files are typically located in the Java jre/lib/ext directory.
  2. The dll files are typically located in the Java jre/bin directory on a Windows system.
  3. The so file is typically located in the Java jre/i386 directory on an Intel Linux system.
  4. All the binary builds are available on https://jai-imageio.dev.java.net/binary-builds.html
  5. The jar files are required.
  6. The dll/so files provide acceleration for certain image types.
  7. The dll/so files may also provide support for additional image types.
  8. 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

At one time, the following was true (according to jgarnet):

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.