JII - Java Image Info

There are a lot of possibilities to read out basic properties of image files like the width and height. Each way has its pro and cons relating to specific project requirements. JII provides a simple and clear interface to these different ways which are represented by various libraries and source codes. This significantly simplifies the validation of these methods with respect to a particular project.

The focus is on the following image types which are relevant for the web:

• BMP
• GIF
• JPEG
• PNG

For completeness, here is the changelog.

Disclaimer

I'm not responsible for any data loss, hardware damage or broken keyboards. This guide comes without any warranty!

Get It

By Download

All required jars can be found in the current release:
Hint: The Zip file contains all dependencies.

By Maven

The following entries are required in the pom.xml:

<repositories>
	<repository>
		<id>jiirepo</id>
		<url>https://myrepo.thischwa.codes/repository/jii/</url>
	</repository>
</repositories>

<dependency>
	<groupId>codes.thischwa.jii</groupId>
	<artifactId>java-image-info</artifactId>
	<version>1.2.0</version>
</dependency>

Supported libraries / source codes:

• iText: A library for pdf generation.
  There is an internal class to read out some image properties.
• ImageInfo: A small and robust Java class by Marco Schmidt. It seems that he doesn't support this project any longer.
  The corresponding website hasn't been accessible for years.
• SimpleImageInfo: A Java class by Jaimon Mathew to get the image size without loading the whole data. It's very fast.
• Wrapper to the command line tool (identify)[http://www.imagemagick.org/script/identify.php] of ImageMagick: This wrapper is written by the author and analyzes the output of the tool.
• Wrapper to Java's javax.imageio.ImageIO: A relatively slow pure JRE solution.
• Wrapper to Apache's commons-imaging: A pure-Java image library.

Usage

Here is the current api doc!

JII provides currently two interfaces:

• codes.thischwa.jii.IDimensionProvider
  It just provides the Dimension of an image.
• codes.thischwa.jii.IResolutionProvider
  It just provides the Resolution of an image.

All available implementations (wrappers) can be found in the core package. Each wrapper implements one or both interfaces above.

Example:

  IDimensionProvider dp = new SimpleImageInfoWrapper();
  dp.set(new File("/dir/file.jpg"));
  Dimension dim = dp.getDimension();
  System.out.println(String.format("Dimension: %dx%d", dim.height, dim.width));

The codes.thischwa.jii.IResolutionProvider works in the same way.