Java Advanced Imaging ImageIO Tools

From MircWiki
Revision as of 19:11, 19 November 2009 by Johnperry (talk | contribs) (→‎JAR Files)
Jump to navigation Jump to search

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