prajna.image

Class ImageUtils

java.lang.Object

prajna.image.ImageUtils

public class ImageUtils
extends java.lang.Object

Collection of utilities which operate on buffered images

Author:

Edward Swing

Constructor Summary

Constructors

Constructor and Description
ImageUtils()

Method Summary

Methods

Modifier and Type	Method and Description
static java.awt.image.BufferedImage	addTransparency(java.awt.image.BufferedImage image, float alpha) Create a new image with the specified transparency applied to the original image.
static java.awt.image.BufferedImage	bufferImage(java.awt.Image image) Return a buffered image that contains the original image contents.
static java.awt.image.BufferedImage	extractColors(java.awt.image.BufferedImage img, java.util.Set<java.awt.Color> colors, java.awt.Color replaceColor) Extract the colors matching the color set into a new image.
static java.util.Set<java.awt.Color>	getCloseColorsFromImage(java.awt.image.BufferedImage image, java.awt.Color color) Get the set of colors in an image that are "close" to a specified color.
static java.util.Set<java.awt.Color>	getColors(java.awt.image.BufferedImage img) Get the set of colors used in an image
static java.awt.image.BufferedImage	selectTransparentColors(java.awt.image.BufferedImage image, java.util.Set<java.awt.Color> colors) Create a new image from an existing image by specifying the set of colors that should be transparent.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ImageUtils

public ImageUtils()

Method Detail

addTransparency

public static java.awt.image.BufferedImage addTransparency(java.awt.image.BufferedImage image,
                                           float alpha)

Create a new image with the specified transparency applied to the original image.

Parameters:

image - the original image

alpha - the alpha value for the transparency

Returns:

a new image with transparency

bufferImage

public static java.awt.image.BufferedImage bufferImage(java.awt.Image image)

Return a buffered image that contains the original image contents. If the image is already a buffered image, then it is simply returned. Otherwise, a new buffered image is created, and the image copied into it.

Parameters:

image - the original image

Returns:

a buffered image

extractColors

public static java.awt.image.BufferedImage extractColors(java.awt.image.BufferedImage img,
                                         java.util.Set<java.awt.Color> colors,
                                         java.awt.Color replaceColor)

Extract the colors matching the color set into a new image. This method essentially extracts an overlay from the original image. If replaceColor is not null, the pixel in the original image is replaced with replaceColor where an overlay color occurs.

Parameters:

img - the original image

colors - the set of colors to extract from the image

replaceColor - the color to replace the overlay colors with. If null, the overlay colors are not replaced

Returns:

the overlay image

getCloseColorsFromImage

public static java.util.Set<java.awt.Color> getCloseColorsFromImage(java.awt.image.BufferedImage image,
                                                    java.awt.Color color)

Get the set of colors in an image that are "close" to a specified color. This method uses a simple RGB distance algorithm

Parameters:

image - the image

color - the initial color

Returns:

a set of colors that are close to the specified color.

getColors

public static java.util.Set<java.awt.Color> getColors(java.awt.image.BufferedImage img)

Get the set of colors used in an image

Parameters:

img - a buffered image

Returns:

the set of colors in the image

selectTransparentColors

public static java.awt.image.BufferedImage selectTransparentColors(java.awt.image.BufferedImage image,
                                                   java.util.Set<java.awt.Color> colors)

Create a new image from an existing image by specifying the set of colors that should be transparent.

Parameters:

image - the original image

colors - the colors that should be transparent.

Returns:

a new image with the specified colors replaced by total transparency.