Created a small and simple utility class for myself to be able to perform common operations on images in Java.
Using this class you can load and save images, you’re able to resize images maintaining aspect ratio, you’re able to save jpeg images with specified compression, you can rotate images to any given angle, you can also watermark them.
Hope it’ll save you some time.
/**
* @(#) ImageUtils.java;
*
* AUTHOR ** Danil Glinenko
* */
package net.codemate.api.image;
import javax.imageio.IIOImage;
import javax.imageio.ImageIO;
import javax.imageio.ImageWriteParam;
import javax.imageio.ImageWriter;
import javax.imageio.stream.FileImageOutputStream;
import java.awt.*;
import java.awt.geom.AffineTransform;
import java.awt.geom.Rectangle2D;
import java.awt.image.BufferedImage;
import java.io.File;
import java.io.IOException;
import java.util.HashMap;
import java.util.Iterator;
import java.util.Map;
public final class ImageUtils {
public static final float BEST_QUALITY = 1.0f;
public static final float HIGH_QUALITY = 0.75f;
public static final float MEDIUM_QUALITY = 0.5f;
public static final float LOW_QUALITY = 0.25f;
public static final float LEAST_QUALITY = 0.0f;
private ImageUtils() {
}
/**
* Loads image from file system to BufferedImage object.
* @param imageFile Image file to be loaded.
* @return BufferedImage object.
* @throws IOException if file is not found or the image can’t be loaded.
*/
public static BufferedImage loadImage(final File imageFile) throws IOException {
return ImageIO.read(imageFile);
}
/**
* Loads image from file system to BufferedImage object.
* @param imageFilePath file path to the image to be loaded.
* @return BufferedImage object.
* @throws IOException if file is not found or the image can’t be loaded.
*/
public static BufferedImage loadImage(final String imageFilePath) throws IOException {
return loadImage(new File(imageFilePath));
}
/**
* Saves given BufferedImage to a file. Supports “png” and “jpg” formats. The format is identified based on
* the given file name for the picture. The default is “jpg”.
* @param image Image to be saved to file.
* @param imageFile file the images will be saved in to.
* @throws IOException if the image can’t be saved or file is not found.
*/
public static void saveImage(final BufferedImage image, final File imageFile) throws IOException {
if (image == null || imageFile== null){throw new IllegalArgumentException(“\”image\” or \”imageFile\” params cannot be null.”);}
final String format = (imageFile.getName().endsWith(“png”))? “png”: “jpg”;
ImageIO.write(image, format, imageFile);
}
/**
* Saves given BufferedImage to a file. Supports “png” and “jpg” formats. The format is identified based on
* the given file name for the picture. The default is “jpg”.
* @param image Image to be saved to file.
* @param imageFilePath file path the images will be saved in to.
* @throws IOException if the image can’t be saved or file is not found.
*/
public static void saveImage(final BufferedImage image, final String imageFilePath) throws IOException {
saveImage(image, new File(imageFilePath));
}
/**
* Save JPEG image with the compression specified.
* @param image Image to be saved to file.
* @param imageFile file to save image.
* @param quality must be in 0..1 range. 0.0 – highest compression is important, 1.0 – high image quality is important.
* @throws IOException if the image can’t be saved or file is not found.
*/
public static void saveImageJPGCompressed(final BufferedImage image, final File imageFile, final float quality) throws IOException {
if (image == null || imageFile == null){throw new IllegalArgumentException(“\”image\” or \”imageFile\” params cannot be null.”);}
if (quality < 0 || quality >1){throw new IllegalArgumentException(“Quality parameter must be in from 0 to 1 range.”);}
Iterator writers = ImageIO.getImageWritersBySuffix(“jpeg”);
if (!writers.hasNext()) {
throw new IllegalStateException(“No writers found.”);
}
// get the writer
ImageWriter writer = (ImageWriter) writers.next();
ImageWriteParam wParams = writer.getDefaultWriteParam();
wParams.setCompressionMode(ImageWriteParam.MODE_EXPLICIT);
wParams.setCompressionQuality(quality);
//writing image
FileImageOutputStream output = new FileImageOutputStream(imageFile);
writer.setOutput(output);
writer.write(null, new IIOImage(image, null, null), wParams);
writer.dispose();
}
/**
* Rotates given image to given angle.
* @param image image to be rotated.
* @param angle angle to rotate image to
* @return rotated image.
*/
public static BufferedImage rotate(final BufferedImage image, final int angle) {
if (image == null){throw new IllegalArgumentException(“\”image\” param cannot be null.”);}
final int imageWidth = image.getWidth();
final int imageHeight = image.getHeight();
final Map
final int newWidth = boundingBoxDimensions.get(“width”);
final int newHeight = boundingBoxDimensions.get(“height”);
final BufferedImage newImage = new BufferedImage(newWidth, newHeight, image.getType());
final Graphics2D newImageGraphic = newImage.createGraphics();
final AffineTransform transform = new AffineTransform();
transform.setToTranslation((newWidth-imageWidth)/2, (newHeight-imageHeight)/2);
transform.rotate(Math.toRadians(angle), imageWidth/2, imageHeight/2);
newImageGraphic.drawImage(image, transform, null);
newImageGraphic.dispose();
return newImage;
}
private static Map
final Map
// coordinates of our given image
final int[][] points = {
{0, 0},
{imageWidth, 0},
{0, imageHeight},
{imageWidth, imageHeight}
};
final Map
put(“left”, 0);
put(“right”, 0);
put(“top”, 0);
put(“bottom”, 0);
}};
final double theta = Math.toRadians(angle);
for (final int[] point : points) {
final int x = point[0];
final int y = point[1];
final int newX = (int) (x * Math.cos(theta) + y * Math.sin(theta));
final int newY = (int) (x * Math.sin(theta) + y * Math.cos(theta));
//assign the bounds
boundBox.put(“left”, Math.min(boundBox.get(“left”), newX));
boundBox.put(“right”, Math.max(boundBox.get(“right”), newX));
boundBox.put(“top”, Math.min(boundBox.get(“top”), newY));
boundBox.put(“bottom”, Math.max(boundBox.get(“bottom”), newY));
}
// now get the dimensions of the new box.
dimensions.put(“width”, Math.abs(boundBox.get(“right”) – boundBox.get(“left”)));
dimensions.put(“height”, Math.abs(boundBox.get(“bottom”) – boundBox.get(“top”)));
return dimensions;
}
/**
* Resizes given image to the given dimensions.
* @param image original image to resize.
* @param newWidth new width of the image.
* @param newHeight new height of the image.
* @param maintainAspectRatio if true the aspect ratio will be maintained.
* @return resized image.
*/
public static BufferedImage resize(final BufferedImage image, int newWidth, int newHeight, final boolean maintainAspectRatio) {
if (image == null){throw new IllegalArgumentException(“\”image\” param cannot be null.”);}
final int imageWidth = image.getWidth();
final int imageHeight = image.getHeight();
// if we want to maintain aspect ratio.
if (maintainAspectRatio) {
final double newRatio = (double) newWidth / (double) newHeight;
final double imageRatio = (double) imageWidth / (double) imageHeight;
if (newRatio < imageRatio) {
newHeight = (int)(newWidth / imageRatio);
} else {
newWidth = (int)(newHeight * imageRatio);
}
}
final BufferedImage dimg = new BufferedImage(newWidth, newHeight, image.getType());
final Graphics2D g = dimg.createGraphics();
g.setRenderingHint(RenderingHints.KEY_INTERPOLATION, RenderingHints.VALUE_INTERPOLATION_BILINEAR);
g.drawImage(image, 0, 0, newWidth, newHeight, 0, 0, imageWidth, imageHeight, null);
g.dispose();
return dimg;
}
/**
* Watermarks the given image with given text.
* @param image Image to be watermarked
* @param text text to be used as a watermark.
* @return new watermarked image.
*/
public static BufferedImage waterMarkImage(final BufferedImage image, final String text) {
if (image == null){throw new IllegalArgumentException("\"image\" param cannot be null.");}
// create a new image
final BufferedImage waterMarked = new BufferedImage(image.getWidth(), image.getHeight(), image.getType());
final Graphics2D imageG = waterMarked.createGraphics();
// draw original image.
imageG.drawImage(image, null, 0, 0);
imageG.dispose();
final Graphics2D g = waterMarked.createGraphics();
g.setComposite(AlphaComposite.getInstance(AlphaComposite.SRC_OVER, 0.5f)); // 50% transparency
g.setColor(Color.white);
g.setRenderingHint(RenderingHints.KEY_TEXT_ANTIALIASING, RenderingHints.VALUE_TEXT_ANTIALIAS_ON);
g.setFont(new Font("Arial", Font.BOLD, 30));
final FontMetrics fontMetrics = g.getFontMetrics();
final Rectangle2D rect = fontMetrics.getStringBounds(text, g);
final int centerX = (image.getWidth() - (int) rect.getWidth()) /2;
final int centerY = (image.getHeight() - (int) rect.getHeight()) /2;
g.drawString(text, centerX, centerY);
g.dispose();
return waterMarked;
}
}
[/code]
Some useful links used:
Java lobby article
How to calculate bounding box coordinates
Codemate 
Looks very, very, very familiar.
Seems like almost every swing project has some sort of these utils.
send how we add some shapes on objects..
Just there is no fucntion to display the image. Please let me know how to do that.
Hi,
This is very fantastic but there is bug if width and height is odd number the after rotating there are some extra space take place how could I fix it.
Thanks,
Assad
Finally found what I was looking for. I greatly appreciate your code. Excellent work.
class does have a main method wat does dat mean please help….i wat it by 2morrow