Class ImageUtil
- java.lang.Object
-
- com.twelvemonkeys.image.ImageUtil
-
public final class ImageUtil extends java.lang.Object
This class contains methods for basic image manipulation and conversion.- Version:
- $Id: common/common-image/src/main/java/com/twelvemonkeys/image/ImageUtil.java#3 $
- Author:
- Harald Kuhr, last modified by $Author: haku $
-
-
Field Summary
Fields Modifier and Type Field Description static int
COLOR_SELECTION_DEFAULT
Default color selectionstatic int
COLOR_SELECTION_FAST
Prioritize speedstatic int
COLOR_SELECTION_QUALITY
Prioritize qualitystatic int
DITHER_DEFAULT
Java default ditherstatic int
DITHER_DIFFUSION
Error diffusion ditherstatic int
DITHER_DIFFUSION_ALTSCANS
Error diffusion dither with alternating scansstatic int
DITHER_NONE
No ditherstatic int
EDGE_NO_OP
Alias forConvolveOp.EDGE_NO_OP
.static int
EDGE_REFLECT
Adds a border to the image while convolving.static int
EDGE_WRAP
Adds a border to the image while convolving.static int
EDGE_ZERO_FILL
Alias forConvolveOp.EDGE_ZERO_FILL
.static int
FLIP_HORIZONTAL
static int
FLIP_VERTICAL
protected static java.awt.geom.AffineTransform
IDENTITY_TRANSFORM
protected static java.awt.Point
LOCATION_UPPER_LEFT
static int
ROTATE_180
static int
ROTATE_90_CCW
static int
ROTATE_90_CW
static int
TRANSPARENCY_BITMASK
Convert alpha to bitmaskstatic int
TRANSPARENCY_DEFAULT
Default transparency (none)static int
TRANSPARENCY_OPAQUE
Discard any alpha informationprotected static int
TRANSPARENCY_TRANSLUCENT
Keep original alpha (not supported yet)
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static java.awt.image.BufferedImage
accelerate(java.awt.Image pImage)
Tries to use H/W-accelerated code for an image for display purposes.static java.awt.image.BufferedImage
accelerate(java.awt.Image pImage, java.awt.GraphicsConfiguration pConfiguration)
Tries to use H/W-accelerated code for an image for display purposes.static java.awt.Color
blend(java.awt.Color pColor, java.awt.Color pOther)
Blends two colors half and half, to create a tone in between.static java.awt.Color
blend(java.awt.Color pColor, java.awt.Color pOther, float pBlendFactor)
Blends two colors, controlled by the blending factor.static java.awt.image.BufferedImage
blur(java.awt.image.BufferedImage pOriginal)
Creates a blurred version of the given image.static java.awt.image.BufferedImage
blur(java.awt.image.BufferedImage pOriginal, float pRadius)
Creates a blurred version of the given image.static java.awt.Image
brightness(java.awt.Image pOriginal, float pAmount)
Changes the brightness of the original image.static java.awt.Image
contrast(java.awt.Image pOriginal)
Adds contraststatic java.awt.Image
contrast(java.awt.Image pOriginal, float pAmount)
Changes the contrast of the imagestatic java.awt.image.BufferedImage
convolve(java.awt.image.BufferedImage pOriginal, java.awt.image.Kernel pKernel, int pEdgeOperation)
Convolves an image, using a convolution matrix.static java.awt.image.BufferedImage
createClear(int pWidth, int pHeight, int pType, java.awt.Color pBackground)
Creates a clear image with the given background color.static java.awt.image.BufferedImage
createClear(int pWidth, int pHeight, java.awt.Color pBackground)
Creates a clear image with the given background color.static java.awt.image.BufferedImage
createCopy(java.awt.image.BufferedImage pImage)
Creates a deep copy of the given image.static java.awt.image.BufferedImage
createFlipped(java.awt.Image pImage, int pAxis)
Creates a flipped version of the given image.static java.awt.image.BufferedImage
createIndexed(java.awt.Image pImage)
Creates an indexed version of the given image (aBufferedImage
with anIndexColorModel
.static java.awt.image.BufferedImage
createIndexed(java.awt.Image pImage, int pColors, java.awt.Color pMatte, int pHints)
Creates an indexed version of the given image (aBufferedImage
with anIndexColorModel
.static java.awt.image.BufferedImage
createIndexed(java.awt.Image pImage, java.awt.image.IndexColorModel pColors, java.awt.Color pMatte, int pHints)
Creates an indexed version of the given image (aBufferedImage
with anIndexColorModel
.static java.awt.image.BufferedImage
createIndexed(java.awt.Image pImage, java.awt.Image pColors, java.awt.Color pMatte, int pHints)
Creates an indexed version of the given image (aBufferedImage
with anIndexColorModel
.static java.awt.image.BufferedImage
createResampled(java.awt.image.BufferedImage pImage, int pWidth, int pHeight, int pHints)
Creates a scaled instance of the givenBufferedImage
.static java.awt.image.BufferedImage
createResampled(java.awt.image.RenderedImage pImage, int pWidth, int pHeight, int pHints)
Creates a scaled instance of the givenRenderedImage
, and converts it to aBufferedImage
if needed.static java.awt.image.BufferedImage
createResampled(java.awt.Image pImage, int pWidth, int pHeight, int pHints)
Creates a scaled instance of the givenImage
, and converts it to aBufferedImage
if needed.static java.awt.image.BufferedImage
createRotated(java.awt.Image pImage, double pAngle)
Rotates the image to the given angle.static java.awt.image.BufferedImage
createRotated(java.awt.Image pImage, int pDirection)
Rotates the image 90 degrees, clockwise (aka "rotate right"), counter-clockwise (aka "rotate left") or 180 degrees, depending on thepDirection
argument.static java.awt.image.BufferedImage
createScaled(java.awt.Image pImage, int pWidth, int pHeight, int pHints)
Creates a scaled instance of the givenImage
, and converts it to aBufferedImage
if needed.static java.awt.Color
createTranslucent(java.awt.Color pColor, int pTransparency)
Creates a translucent version of the given color.static java.awt.image.BufferedImage
createTransparent(int pWidth, int pHeight)
Creates a transparent image.static java.awt.image.BufferedImage
createTransparent(int pWidth, int pHeight, int pType)
Creates a transparent image.static java.awt.Image
filter(java.awt.Image pOriginal, java.awt.image.ImageFilter pFilter)
Filters an image, using the givenImageFilter
.static int
getHeight(java.awt.Image pImage)
Gets the height of an Image.static java.awt.image.IndexColorModel
getIndexColorModel(java.awt.Image pImage, int pColors, int pHints)
Extracts anIndexColorModel
from the given image.static int
getWidth(java.awt.Image pImage)
Gets the width of an Image.static java.awt.Image
grayscale(java.awt.Image pOriginal)
Converts an image to grayscale.static boolean
hasTransparentPixels(java.awt.image.RenderedImage pImage, boolean pFast)
Tests whether the image has any transparent or semi-transparent pixels.static java.awt.image.BufferedImage
sharpen(java.awt.image.BufferedImage pOriginal)
Sharpens an image using a convolution matrix.static java.awt.image.BufferedImage
sharpen(java.awt.image.BufferedImage pOriginal, float pAmount)
Sharpens an image using a convolution matrix.static java.awt.image.BufferedImage
toBuffered(java.awt.Image pOriginal)
Converts theImage
to aBufferedImage
.static java.awt.image.BufferedImage
toBuffered(java.awt.image.BufferedImage pOriginal, int pType)
Converts theBufferedImage
to aBufferedImage
of the given type.static java.awt.image.BufferedImage
toBuffered(java.awt.image.RenderedImage pOriginal)
Converts theRenderedImage
to aBufferedImage
.static java.awt.image.BufferedImage
toBuffered(java.awt.image.RenderedImage pOriginal, int pType)
Converts theRenderedImage
to aBufferedImage
of the given type.static java.awt.image.BufferedImage
toBuffered(java.awt.Image pOriginal, int pType)
Converts theImage
to aBufferedImage
of the given type.static boolean
waitForImage(java.awt.Image pImage)
Waits for an image to load completely.static boolean
waitForImage(java.awt.Image pImage, long pTimeOut)
Waits for an image to load completely.static boolean
waitForImages(java.awt.Image[] pImages)
Waits for a number of images to load completely.static boolean
waitForImages(java.awt.Image[] pImages, long pTimeOut)
Waits for a number of images to load completely.
-
-
-
Field Detail
-
ROTATE_90_CCW
public static final int ROTATE_90_CCW
- See Also:
- Constant Field Values
-
ROTATE_90_CW
public static final int ROTATE_90_CW
- See Also:
- Constant Field Values
-
ROTATE_180
public static final int ROTATE_180
- See Also:
- Constant Field Values
-
FLIP_VERTICAL
public static final int FLIP_VERTICAL
- See Also:
- Constant Field Values
-
FLIP_HORIZONTAL
public static final int FLIP_HORIZONTAL
- See Also:
- Constant Field Values
-
EDGE_ZERO_FILL
public static final int EDGE_ZERO_FILL
Alias forConvolveOp.EDGE_ZERO_FILL
.
-
EDGE_NO_OP
public static final int EDGE_NO_OP
Alias forConvolveOp.EDGE_NO_OP
.
-
EDGE_REFLECT
public static final int EDGE_REFLECT
Adds a border to the image while convolving. The border will reflect the edges of the original image. This is usually a good default. Note that while this mode typically provides better quality than the standard modesEDGE_ZERO_FILL
andEDGE_NO_OP
, it does so at the expense of higher memory consumption and considerable more computation.
-
EDGE_WRAP
public static final int EDGE_WRAP
Adds a border to the image while convolving. The border will wrap the edges of the original image. This is usually the best choice for tiles. Note that while this mode typically provides better quality than the standard modesEDGE_ZERO_FILL
andEDGE_NO_OP
, it does so at the expense of higher memory consumption and considerable more computation.
-
DITHER_DEFAULT
public static final int DITHER_DEFAULT
Java default dither- See Also:
- Constant Field Values
-
DITHER_NONE
public static final int DITHER_NONE
No dither- See Also:
- Constant Field Values
-
DITHER_DIFFUSION
public static final int DITHER_DIFFUSION
Error diffusion dither- See Also:
- Constant Field Values
-
DITHER_DIFFUSION_ALTSCANS
public static final int DITHER_DIFFUSION_ALTSCANS
Error diffusion dither with alternating scans- See Also:
- Constant Field Values
-
COLOR_SELECTION_DEFAULT
public static final int COLOR_SELECTION_DEFAULT
Default color selection- See Also:
- Constant Field Values
-
COLOR_SELECTION_FAST
public static final int COLOR_SELECTION_FAST
Prioritize speed- See Also:
- Constant Field Values
-
COLOR_SELECTION_QUALITY
public static final int COLOR_SELECTION_QUALITY
Prioritize quality- See Also:
- Constant Field Values
-
TRANSPARENCY_DEFAULT
public static final int TRANSPARENCY_DEFAULT
Default transparency (none)- See Also:
- Constant Field Values
-
TRANSPARENCY_OPAQUE
public static final int TRANSPARENCY_OPAQUE
Discard any alpha information- See Also:
- Constant Field Values
-
TRANSPARENCY_BITMASK
public static final int TRANSPARENCY_BITMASK
Convert alpha to bitmask- See Also:
- Constant Field Values
-
TRANSPARENCY_TRANSLUCENT
protected static final int TRANSPARENCY_TRANSLUCENT
Keep original alpha (not supported yet)- See Also:
- Constant Field Values
-
IDENTITY_TRANSFORM
protected static final java.awt.geom.AffineTransform IDENTITY_TRANSFORM
-
LOCATION_UPPER_LEFT
protected static final java.awt.Point LOCATION_UPPER_LEFT
-
-
Method Detail
-
toBuffered
public static java.awt.image.BufferedImage toBuffered(java.awt.image.RenderedImage pOriginal)
Converts theRenderedImage
to aBufferedImage
. The new image will have the sameColorModel
,Raster
and properties as the original image, if possible.If the image is already a
BufferedImage
, it is simply returned and no conversion takes place.- Parameters:
pOriginal
- the image to convert.- Returns:
- a
BufferedImage
-
toBuffered
public static java.awt.image.BufferedImage toBuffered(java.awt.image.RenderedImage pOriginal, int pType)
Converts theRenderedImage
to aBufferedImage
of the given type.If the image is already a
BufferedImage
of the given type, it is simply returned and no conversion takes place.- Parameters:
pOriginal
- the image to convert.pType
- the type of buffered image- Returns:
- a
BufferedImage
- Throws:
java.lang.IllegalArgumentException
- ifpOriginal == null
orpType
is not a valid type forBufferedImage
- See Also:
BufferedImage.getType()
-
toBuffered
public static java.awt.image.BufferedImage toBuffered(java.awt.image.BufferedImage pOriginal, int pType)
Converts theBufferedImage
to aBufferedImage
of the given type. The new image will have the sameColorModel
,Raster
and properties as the original image, if possible.If the image is already a
BufferedImage
of the given type, it is simply returned and no conversion takes place.This method simply invokes
toBuffered((RenderedImage) pOriginal, pType)
.- Parameters:
pOriginal
- the image to convert.pType
- the type of buffered image- Returns:
- a
BufferedImage
- Throws:
java.lang.IllegalArgumentException
- ifpOriginal == null
or ifpType
is not a valid type forBufferedImage
- See Also:
BufferedImage.getType()
-
toBuffered
public static java.awt.image.BufferedImage toBuffered(java.awt.Image pOriginal)
Converts theImage
to aBufferedImage
. The new image will have the sameColorModel
,Raster
and properties as the original image, if possible.If the image is already a
BufferedImage
, it is simply returned and no conversion takes place.- Parameters:
pOriginal
- the image to convert.- Returns:
- a
BufferedImage
- Throws:
java.lang.IllegalArgumentException
- ifpOriginal == null
ImageConversionException
- if the image cannot be converted
-
createCopy
public static java.awt.image.BufferedImage createCopy(java.awt.image.BufferedImage pImage)
Creates a deep copy of the given image. The image will have the same color model and raster type, but will not share image (pixel) data with the input image.- Parameters:
pImage
- the image to clone.- Returns:
- a new
BufferedImage
- Throws:
java.lang.IllegalArgumentException
- ifpImage
isnull
-
toBuffered
public static java.awt.image.BufferedImage toBuffered(java.awt.Image pOriginal, int pType)
Converts theImage
to aBufferedImage
of the given type. The new image will have the sameColorModel
,Raster
and properties as the original image, if possible.If the image is already a
BufferedImage
of the given type, it is simply returned and no conversion takes place.- Parameters:
pOriginal
- the image to convert.pType
- the type of buffered image- Returns:
- a
BufferedImage
- Throws:
java.lang.IllegalArgumentException
- ifpOriginal == null
or ifpType
is not a valid type forBufferedImage
- See Also:
BufferedImage.getType()
-
createFlipped
public static java.awt.image.BufferedImage createFlipped(java.awt.Image pImage, int pAxis)
Creates a flipped version of the given image.- Parameters:
pImage
- the image to flippAxis
- the axis to flip around- Returns:
- a new
BufferedImage
-
createRotated
public static java.awt.image.BufferedImage createRotated(java.awt.Image pImage, int pDirection)
Rotates the image 90 degrees, clockwise (aka "rotate right"), counter-clockwise (aka "rotate left") or 180 degrees, depending on thepDirection
argument.The new image will be completely covered with pixels from the source image.
- Parameters:
pImage
- the source image.pDirection
- the direction, must be eitherROTATE_90_CW
,ROTATE_90_CCW
orROTATE_180
- Returns:
- a new
BufferedImage
-
createRotated
public static java.awt.image.BufferedImage createRotated(java.awt.Image pImage, double pAngle)
Rotates the image to the given angle. Areas not covered with pixels from the source image will be left transparent, if possible.- Parameters:
pImage
- the source imagepAngle
- the angle of rotation, in radians- Returns:
- a new
BufferedImage
, unlesspAngle == 0.0
-
createScaled
public static java.awt.image.BufferedImage createScaled(java.awt.Image pImage, int pWidth, int pHeight, int pHints)
Creates a scaled instance of the givenImage
, and converts it to aBufferedImage
if needed. If the original image is aBufferedImage
the result will have same type and color model. Note that this implies overhead, and is probably not useful for anything butIndexColorModel
images.- Parameters:
pImage
- theImage
to scalepWidth
- width in pixelspHeight
- height in pixelspHints
- scaling ints- Returns:
- a
BufferedImage
- Throws:
java.lang.NullPointerException
- ifpImage
isnull
.- See Also:
createResampled(java.awt.Image, int, int, int)
,Image.getScaledInstance(int,int,int)
,Image.SCALE_AREA_AVERAGING
,Image.SCALE_DEFAULT
,Image.SCALE_FAST
,Image.SCALE_REPLICATE
,Image.SCALE_SMOOTH
-
createResampled
public static java.awt.image.BufferedImage createResampled(java.awt.Image pImage, int pWidth, int pHeight, int pHints)
Creates a scaled instance of the givenImage
, and converts it to aBufferedImage
if needed.- Parameters:
pImage
- theImage
to scalepWidth
- width in pixelspHeight
- height in pixelspHints
- scaling mHints- Returns:
- a
BufferedImage
- Throws:
java.lang.NullPointerException
- ifpImage
isnull
.- See Also:
Image.SCALE_AREA_AVERAGING
,Image.SCALE_DEFAULT
,Image.SCALE_FAST
,Image.SCALE_REPLICATE
,Image.SCALE_SMOOTH
,ResampleOp
-
createResampled
public static java.awt.image.BufferedImage createResampled(java.awt.image.RenderedImage pImage, int pWidth, int pHeight, int pHints)
Creates a scaled instance of the givenRenderedImage
, and converts it to aBufferedImage
if needed.- Parameters:
pImage
- theRenderedImage
to scalepWidth
- width in pixelspHeight
- height in pixelspHints
- scaling mHints- Returns:
- a
BufferedImage
- Throws:
java.lang.NullPointerException
- ifpImage
isnull
.- See Also:
Image.SCALE_AREA_AVERAGING
,Image.SCALE_DEFAULT
,Image.SCALE_FAST
,Image.SCALE_REPLICATE
,Image.SCALE_SMOOTH
,ResampleOp
-
createResampled
public static java.awt.image.BufferedImage createResampled(java.awt.image.BufferedImage pImage, int pWidth, int pHeight, int pHints)
Creates a scaled instance of the givenBufferedImage
.- Parameters:
pImage
- theBufferedImage
to scalepWidth
- width in pixelspHeight
- height in pixelspHints
- scaling mHints- Returns:
- a
BufferedImage
- Throws:
java.lang.NullPointerException
- ifpImage
isnull
.- See Also:
Image.SCALE_AREA_AVERAGING
,Image.SCALE_DEFAULT
,Image.SCALE_FAST
,Image.SCALE_REPLICATE
,Image.SCALE_SMOOTH
,ResampleOp
-
getIndexColorModel
public static java.awt.image.IndexColorModel getIndexColorModel(java.awt.Image pImage, int pColors, int pHints)
Extracts anIndexColorModel
from the given image.- Parameters:
pImage
- the image to get the color model frompColors
- the maximum number of colors in the resulting color modelpHints
- hints controlling transparency and color selection- Returns:
- the extracted
IndexColorModel
- See Also:
COLOR_SELECTION_DEFAULT
,COLOR_SELECTION_FAST
,COLOR_SELECTION_QUALITY
,TRANSPARENCY_DEFAULT
,TRANSPARENCY_OPAQUE
,TRANSPARENCY_BITMASK
,TRANSPARENCY_TRANSLUCENT
-
createIndexed
public static java.awt.image.BufferedImage createIndexed(java.awt.Image pImage)
Creates an indexed version of the given image (aBufferedImage
with anIndexColorModel
. The resulting image will have a maximum of 256 different colors. Transparent parts of the original will be replaced with solid black. Default (possibly HW accelerated) dither will be used.- Parameters:
pImage
- the image to convert- Returns:
- an indexed version of the given image
-
createIndexed
public static java.awt.image.BufferedImage createIndexed(java.awt.Image pImage, int pColors, java.awt.Color pMatte, int pHints)
Creates an indexed version of the given image (aBufferedImage
with anIndexColorModel
.- Parameters:
pImage
- the image to convertpColors
- number of colors in the resulting imagepMatte
- color to replace transparent parts of the original.pHints
- hints controlling dither, transparency and color selection- Returns:
- an indexed version of the given image
- See Also:
COLOR_SELECTION_DEFAULT
,COLOR_SELECTION_FAST
,COLOR_SELECTION_QUALITY
,DITHER_NONE
,DITHER_DEFAULT
,DITHER_DIFFUSION
,DITHER_DIFFUSION_ALTSCANS
,TRANSPARENCY_DEFAULT
,TRANSPARENCY_OPAQUE
,TRANSPARENCY_BITMASK
,TRANSPARENCY_TRANSLUCENT
-
createIndexed
public static java.awt.image.BufferedImage createIndexed(java.awt.Image pImage, java.awt.image.IndexColorModel pColors, java.awt.Color pMatte, int pHints)
Creates an indexed version of the given image (aBufferedImage
with anIndexColorModel
.- Parameters:
pImage
- the image to convertpColors
- theIndexColorModel
to be used in the resulting image.pMatte
- color to replace transparent parts of the original.pHints
- hints controlling dither, transparency and color selection- Returns:
- an indexed version of the given image
- See Also:
COLOR_SELECTION_DEFAULT
,COLOR_SELECTION_FAST
,COLOR_SELECTION_QUALITY
,DITHER_NONE
,DITHER_DEFAULT
,DITHER_DIFFUSION
,DITHER_DIFFUSION_ALTSCANS
,TRANSPARENCY_DEFAULT
,TRANSPARENCY_OPAQUE
,TRANSPARENCY_BITMASK
,TRANSPARENCY_TRANSLUCENT
-
createIndexed
public static java.awt.image.BufferedImage createIndexed(java.awt.Image pImage, java.awt.Image pColors, java.awt.Color pMatte, int pHints)
Creates an indexed version of the given image (aBufferedImage
with anIndexColorModel
.- Parameters:
pImage
- the image to convertpColors
- anImage
used to get colors from. If the image is has anIndexColorModel
, it will be uesd, otherwise anIndexColorModel
is created from the image.pMatte
- color to replace transparent parts of the original.pHints
- hints controlling dither, transparency and color selection- Returns:
- an indexed version of the given image
- See Also:
COLOR_SELECTION_DEFAULT
,COLOR_SELECTION_FAST
,COLOR_SELECTION_QUALITY
,DITHER_NONE
,DITHER_DEFAULT
,DITHER_DIFFUSION
,DITHER_DIFFUSION_ALTSCANS
,TRANSPARENCY_DEFAULT
,TRANSPARENCY_OPAQUE
,TRANSPARENCY_BITMASK
,TRANSPARENCY_TRANSLUCENT
-
sharpen
public static java.awt.image.BufferedImage sharpen(java.awt.image.BufferedImage pOriginal)
Sharpens an image using a convolution matrix. The sharpen kernel used, is defined by the following 3 by 3 matrix:Sharpen Kernel Matrix 0.0 -0.3 0.0 -0.3 2.2 -0.3 0.0 -0.3 0.0 This is the same result returned as
sharpen(pOriginal, 0.3f)
.- Parameters:
pOriginal
- the BufferedImage to sharpen- Returns:
- a new BufferedImage, containing the sharpened image.
-
sharpen
public static java.awt.image.BufferedImage sharpen(java.awt.image.BufferedImage pOriginal, float pAmount)
Sharpens an image using a convolution matrix. The sharpen kernel used, is defined by the following 3 by 3 matrix:Sharpen Kernel Matrix 0.0 - pAmount
0.0 - pAmount
4.0 * pAmount
+ 1.0- pAmount
0.0 - pAmount
0.0 - Parameters:
pOriginal
- the BufferedImage to sharpenpAmount
- the amount of sharpening- Returns:
- a BufferedImage, containing the sharpened image.
-
blur
public static java.awt.image.BufferedImage blur(java.awt.image.BufferedImage pOriginal)
Creates a blurred version of the given image.- Parameters:
pOriginal
- the original image- Returns:
- a new
BufferedImage
with a blurred version of the given image
-
blur
public static java.awt.image.BufferedImage blur(java.awt.image.BufferedImage pOriginal, float pRadius)
Creates a blurred version of the given image.- Parameters:
pOriginal
- the original imagepRadius
- the amount to blur- Returns:
- a new
BufferedImage
with a blurred version of the given image
-
convolve
public static java.awt.image.BufferedImage convolve(java.awt.image.BufferedImage pOriginal, java.awt.image.Kernel pKernel, int pEdgeOperation)
Convolves an image, using a convolution matrix.- Parameters:
pOriginal
- the BufferedImage to sharpenpKernel
- the kernelpEdgeOperation
- the edge operation. Must be one ofEDGE_NO_OP
,EDGE_ZERO_FILL
,EDGE_REFLECT
orEDGE_WRAP
- Returns:
- a new BufferedImage, containing the sharpened image.
-
contrast
public static java.awt.Image contrast(java.awt.Image pOriginal)
Adds contrast- Parameters:
pOriginal
- the BufferedImage to add contrast to- Returns:
- an
Image
, containing the contrasted image.
-
contrast
public static java.awt.Image contrast(java.awt.Image pOriginal, float pAmount)
Changes the contrast of the image- Parameters:
pOriginal
- theImage
to changepAmount
- the amount of contrast in the range [-1.0..1.0].- Returns:
- an
Image
, containing the contrasted image.
-
brightness
public static java.awt.Image brightness(java.awt.Image pOriginal, float pAmount)
Changes the brightness of the original image.- Parameters:
pOriginal
- theImage
to changepAmount
- the amount of brightness in the range [-2.0..2.0].- Returns:
- an
Image
-
grayscale
public static java.awt.Image grayscale(java.awt.Image pOriginal)
Converts an image to grayscale.- Parameters:
pOriginal
- the image to convert.- Returns:
- a new Image, containing the gray image data.
- See Also:
GrayFilter
,RGBImageFilter
-
filter
public static java.awt.Image filter(java.awt.Image pOriginal, java.awt.image.ImageFilter pFilter)
Filters an image, using the givenImageFilter
.- Parameters:
pOriginal
- the original imagepFilter
- the filter to apply- Returns:
- the new
Image
-
accelerate
public static java.awt.image.BufferedImage accelerate(java.awt.Image pImage)
Tries to use H/W-accelerated code for an image for display purposes. Note that transparent parts of the image might be replaced by solid color. Additional image information not used by the current diplay hardware may be discarded, like extra bith depth etc.- Parameters:
pImage
- anyImage
- Returns:
- a
BufferedImage
-
accelerate
public static java.awt.image.BufferedImage accelerate(java.awt.Image pImage, java.awt.GraphicsConfiguration pConfiguration)
Tries to use H/W-accelerated code for an image for display purposes. Note that transparent parts of the image might be replaced by solid color. Additional image information not used by the current diplay hardware may be discarded, like extra bith depth etc.- Parameters:
pImage
- anyImage
pConfiguration
- theGraphicsConfiguration
to accelerate for- Returns:
- a
BufferedImage
-
createTransparent
public static java.awt.image.BufferedImage createTransparent(int pWidth, int pHeight)
Creates a transparent image.- Parameters:
pWidth
- the requested width of the imagepHeight
- the requested height of the image- Returns:
- the new image
- Throws:
java.lang.IllegalArgumentException
- ifpType
is not a valid type forBufferedImage
-
createTransparent
public static java.awt.image.BufferedImage createTransparent(int pWidth, int pHeight, int pType)
Creates a transparent image.- Parameters:
pWidth
- the requested width of the imagepHeight
- the requested height of the imagepType
- the type ofBufferedImage
to create- Returns:
- the new image
- Throws:
java.lang.IllegalArgumentException
- ifpType
is not a valid type forBufferedImage
- See Also:
BufferedImage(int,int,int)
-
createClear
public static java.awt.image.BufferedImage createClear(int pWidth, int pHeight, java.awt.Color pBackground)
Creates a clear image with the given background color.- Parameters:
pWidth
- the requested width of the imagepHeight
- the requested height of the imagepBackground
- the background color. The color may be translucent. May benull
, in such case the color is undefined.- Returns:
- the new image
- Throws:
java.lang.IllegalArgumentException
- ifpType
is not a valid type forBufferedImage
- See Also:
BufferedImage(int,int,int)
-
createClear
public static java.awt.image.BufferedImage createClear(int pWidth, int pHeight, int pType, java.awt.Color pBackground)
Creates a clear image with the given background color.- Parameters:
pWidth
- the width of the image to createpHeight
- the height of the image to createpType
- the type of image to create (one of the constants fromBufferedImage
orBI_TYPE_ANY
)pBackground
- the background color. The color may be translucent. May benull
, in such case the color is undefined.- Returns:
- the new image
- Throws:
java.lang.IllegalArgumentException
- ifpType
is not a valid type forBufferedImage
- See Also:
BufferedImage(int,int,int)
-
getWidth
public static int getWidth(java.awt.Image pImage)
Gets the width of an Image. This method has the side-effect of completely loading the image.- Parameters:
pImage
- an image.- Returns:
- the width of the image, or -1 if the width could not be determined (i.e. an error occured while waiting for the image to load).
-
getHeight
public static int getHeight(java.awt.Image pImage)
Gets the height of an Image. This method has the side-effect of completely loading the image.- Parameters:
pImage
- an image.- Returns:
- the height of the image, or -1 if the height could not be determined (i.e. an error occured while waiting for the image to load).
-
waitForImage
public static boolean waitForImage(java.awt.Image pImage)
Waits for an image to load completely. Will wait forever.- Parameters:
pImage
- an Image object to wait for.- Returns:
- true if the image was loaded successfully, false if an error occured, or the wait was interrupted.
- See Also:
waitForImage(Image,long)
-
waitForImage
public static boolean waitForImage(java.awt.Image pImage, long pTimeOut)
Waits for an image to load completely. Will wait the specified time.- Parameters:
pImage
- an Image object to wait for.pTimeOut
- the time to wait, in milliseconds.- Returns:
- true if the image was loaded successfully, false if an error occurred, or the wait was interrupted.
- See Also:
waitForImages(Image[],long)
-
waitForImages
public static boolean waitForImages(java.awt.Image[] pImages)
Waits for a number of images to load completely. Will wait forever.- Parameters:
pImages
- an array of Image objects to wait for.- Returns:
- true if the images was loaded successfully, false if an error occurred, or the wait was interrupted.
- See Also:
waitForImages(Image[],long)
-
waitForImages
public static boolean waitForImages(java.awt.Image[] pImages, long pTimeOut)
Waits for a number of images to load completely. Will wait the specified time.- Parameters:
pImages
- an array of Image objects to wait forpTimeOut
- the time to wait, in milliseconds- Returns:
- true if the images was loaded successfully, false if an error occurred, or the wait was interrupted.
-
hasTransparentPixels
public static boolean hasTransparentPixels(java.awt.image.RenderedImage pImage, boolean pFast)
Tests whether the image has any transparent or semi-transparent pixels.- Parameters:
pImage
- the imagepFast
- iftrue
, the method tests maximum 10 x 10 pixels, evenly spaced out in the image.- Returns:
true
if transparent pixels are found, otherwisefalse
.
-
createTranslucent
public static java.awt.Color createTranslucent(java.awt.Color pColor, int pTransparency)
Creates a translucent version of the given color.- Parameters:
pColor
- the original colorpTransparency
- the transparency level (0 - 255
)- Returns:
- a translucent color
- Throws:
java.lang.NullPointerException
- ifpColor
isnull
-
blend
public static java.awt.Color blend(java.awt.Color pColor, java.awt.Color pOther)
Blends two colors half and half, to create a tone in between.- Parameters:
pColor
- color 1pOther
- color 2- Returns:
- a new
Color
-
blend
public static java.awt.Color blend(java.awt.Color pColor, java.awt.Color pOther, float pBlendFactor)
Blends two colors, controlled by the blending factor. A factor of0.0
will return the first color, a factor of1.0
will return the second.- Parameters:
pColor
- color 1pOther
- color 2pBlendFactor
-[0...1]
- Returns:
- a new
Color
-
-