Difference between revisions of "Java Advanced Imaging ImageIO Tools"

From MircWiki
Jump to navigation Jump to search
Line 7: Line 7:
 
<tr><th>File name</th><th>Description</th><th>Typical Location</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><td><b>jre/lib/ext</b></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><td><b>jre/i386</b></td><td><b>jre/lib/ext</b></td></tr>
+
<tr><td>clibwrapper_jiio.jar.</td><td>codecLib JNI interfaces.</td><td><b>jre/lib/ext</b></td></tr>
 
</table>
 
</table>
  
Line 20: Line 20:
  
 
==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
 
#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.

Revision as of 19:09, 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/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. All the binary builds are available on https://jai-imageio.dev.java.net/binary-builds.html
  2. The jar files are required.
  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

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.