Skip to content

th-schwarz/JII

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

GitHub license

Build Status

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: GitHub release (latest by date including pre-releases)
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:

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.

About

JII (Java Image Info) provides a clean interface to a collection of Java libraries and source code to read basic properties of images.

Resources

License

Stars

Watchers

Forks

Packages

No packages published