Image IO

The class is designed to simplify reading, writing, and manipulating image files. Here are a couple simple examples of how to open, rotate, crop, resize, and save image files. Please refer to the JavaDocs for a full list of methods.

Open an Image

Here's a simple example of how to open an image and print its dimensions: image = new"/photo.jpg");
System.out.println(image.getWidth() + "x" + image.getHeight());

File Conversion

Here's a simple example of how to convert a file from one format to another:


Note that the list of supported input and output formats may vary based on the version of your JRE/JDK and whether your application uses JAI. You can get a list of supported input and output formats without instantiating the Image class by accessing static variables. Example:

String[] inputFormats =;
String[] ouputFormats =; 


There are several methods to adjust the width/height of an image. image = new"/cup.jpg");
image.setWidth(200); //set width, adjusts height to maintain aspect ratio
image.setHeight(50); //set height, adjusts width to maintain aspect ratio
image.resize(75, 150); //set width and height to whatever you want
Original Image Image Resized to 200px width Image Resized to 50px height Image Resized to 75x150


You can rotate an image with one simple call. You can also flip the image clockwise or counterclockwise. Note that the rotations in this example are additive. image = new"/cup.jpg");
Original Image Image Rotated 30 degrees Image Rotated Counter Clockwise
90+30 degrees
Image Rotated Clockwise
90+30-90 degrees


You can crop or subset an image by providing an x,y offset from the upper left corner of the image and a width/height. image = new"/cup.jpg"); 
Original Image Image Crop


You can adjust the corners of the image to arbitrary pixel coordinates. This can be used to add perspective to your images. image = new"/cup.jpg");
int width = image.getWidth();
int height = image.getHeight();
image.setCorners(20, 70,              //UL
                 width-70, 0,         //UR
                 width+20, height-50, //LR
                 50, height);         //LL
Original Image Skewed Image

Accessing Raw Bytes

Note that you can access the raw pixels via the getByteArray() method.

byte[] b = image.getByteArray();

By default, this returns a jpeg compressed image. You can specify an output format

byte[] b = image.getByteArray("tif");

You can access the raw pixels via the getBufferedImage() method.

java.awt.image.BufferedImage bi = image.getBufferedImage(); 

Image Metadata

In javaxt-core 1.4.1, we introduced the ability to read image metadata (e.g. EXIF, IPTC, etc.). Here's a simple example of how to parse EXIF metadata created by a digital camera.

      //Open Image and Get EXIF Metadata image = new"/photo.jpg");
        java.util.HashMap<Integer, Object> exif = image.getExifTags();
      //Print Camera Info
        System.out.println("EXIF Fields: " + exif.size());
        System.out.println("Date: " + exif.get(0x0132)); //0x9003       
        System.out.println("Camera: " + exif.get(0x0110));
        System.out.println("Manufacturer: " + exif.get(0x010F));
        System.out.println("Focal Length: " + exif.get(0x920A));
        System.out.println("F-Stop: " + exif.get(0x829D));
        System.out.println("Exposure Time (1 / Shutter Speed): " + exif.get(0x829A));
        System.out.println("ISO Speed Ratings: " + exif.get(0x8827));
        System.out.println("Shutter Speed Value (APEX): " + exif.get(0x9201));
        System.out.println("Shutter Speed (Exposure Time): " + exif.get(0x9201));
        System.out.println("Aperture Value (APEX): " + exif.get(0x9202));
      //Print Image Orientation
            int orientation = (Integer) exif.get(0x0112);
            String desc = "";
            switch (orientation) {
                case 1: desc = "Top, left side (Horizontal / normal)"; break;
                case 2: desc = "Top, right side (Mirror horizontal)"; break;
                case 3: desc = "Bottom, right side (Rotate 180)"; break;
                case 4: desc = "Bottom, left side (Mirror vertical)"; break;
                case 5: desc = "Left side, top (Mirror horizontal and rotate 270 CW)"; break;
                case 6: desc = "Right side, top (Rotate 90 CW)"; break;
                case 7: desc = "Right side, bottom (Mirror horizontal and rotate 90 CW)"; break;
                case 8: desc = "Left side, bottom (Rotate 270 CW)"; break;
            System.out.println("Orientation: " + orientation + " -- " + desc);
        catch(Exception e){

      //Print GPS Information
        double[] coord = image.getGPSCoordinate();
        if (coord!=null){
            System.out.println("GPS Coordinate: " + coord[0] + ", " + coord[1]);
            System.out.println("GPS Datum: " + image.getGPSDatum());

Here's a simple example of how to parse IPTC metadata.

      //Open Image and Get IPTC Metadata image = new"/photo.jpg");
        java.util.HashMap<Integer, Object> iptc = image.getIptcTags();   
      //Print Selected Fields
        System.out.println("IPTC Fields: " + iptc.size());
        System.out.println("Date: " + iptc.get(0x0237));
        System.out.println("Caption: " + iptc.get(0x0278));
        System.out.println("Copyright: " + iptc.get(0x0274));

Metadata Resources