com.alee.utils

Class ImageUtils

java.lang.Object

com.alee.utils.ImageUtils

public final class ImageUtils
extends java.lang.Object

Field Summary

Fields

Modifier and Type	Field and Description
static javax.swing.ImageIcon	coloredChooserIcon Creates color chooser icon
static java.lang.String	IMAGE_CACHE_SEPARATOR Cached image data parts separator.
static javax.swing.ImageIcon	transparentChooserIcon

Constructor Summary

Constructors

Constructor and Description
ImageUtils()

Method Summary

Modifier and Type	Method and Description
static java.awt.image.BufferedImage	addBackground(java.awt.image.BufferedImage image, java.awt.Color background)
static javax.swing.ImageIcon	addBackground(javax.swing.ImageIcon imageIcon, java.awt.Color background) Adds background to icon
static void	clearDisabledCopyCache()
static void	clearDisabledCopyCache(java.lang.String id)
static void	clearImageCache(java.lang.String src)
static void	clearImagesCache()
static void	clearMergedIconsCache()
static void	clearMergedImagesCache()
static java.awt.image.BufferedImage	combineIcons(java.awt.Image... images)
static javax.swing.ImageIcon	combineIcons(javax.swing.ImageIcon... icons)
static java.awt.image.BufferedImage	combineIcons(int spacing, java.awt.Image... images)
static javax.swing.ImageIcon	combineIcons(int spacing, javax.swing.ImageIcon... icons)
static javax.swing.ImageIcon	combineIcons(int spacing, java.util.List<javax.swing.ImageIcon> icons)
static javax.swing.ImageIcon	combineIcons(java.util.List<javax.swing.ImageIcon> icons) Combines few images into single one
static java.awt.image.BufferedImage	copy(java.awt.image.BufferedImage bufferedImage)
static java.awt.image.BufferedImage	copy(java.awt.Image image) Makes a copy of BufferedImage
static java.awt.image.BufferedImage	createBufferedImage(javax.swing.Icon icon)
static javax.swing.ImageIcon	createColorChooserIcon(java.awt.Color color)
static java.awt.image.BufferedImage	createColorChooserImage(java.awt.Color color)
static javax.swing.ImageIcon	createColorIcon(java.awt.Color color) Creates color icon
static javax.swing.ImageIcon	createColorIcon(java.awt.Color color, int width, int height)
static java.awt.image.BufferedImage	createColorImage(java.awt.Color color)
static java.awt.image.BufferedImage	createColorImage(java.awt.Color color, int width, int height)
static java.awt.image.BufferedImage	createCompatibleImage(java.awt.image.BufferedImage image)
static java.awt.image.BufferedImage	createCompatibleImage(java.awt.image.BufferedImage image, int transparency)
static java.awt.image.BufferedImage	createCompatibleImage(java.awt.image.BufferedImage image, int width, int height)
static java.awt.image.BufferedImage	createCompatibleImage(int width, int height) Creates a compatible image using given data
static java.awt.image.BufferedImage	createCompatibleImage(int width, int height, int transparency)
static java.awt.image.BufferedImage	createDisabledCopy(java.awt.Image img)
static javax.swing.ImageIcon	createDisabledCopy(javax.swing.ImageIcon imageIcon)
static javax.swing.ImageIcon	createEmptyIcon(int width, int height) Creates empty icon
static java.awt.image.BufferedImage	createEmptyImage(int width, int height)
static java.awt.image.BufferedImage	createGrayscaleCopy(java.awt.image.BufferedImage img)
static java.awt.image.BufferedImage	createGrayscaleCopy(java.awt.Image img)
static javax.swing.ImageIcon	createGrayscaleCopy(javax.swing.ImageIcon imageIcon) Creates grayscale image copy
static java.awt.image.BufferedImage	createInnerShadeImage(int width, java.awt.Shape shape, int shadeWidth, float opacity) Returns shade image based on provided shape.
static javax.swing.ImageIcon	createPreviewIcon(java.awt.image.BufferedImage image, int size)
static javax.swing.ImageIcon	createPreviewIcon(javax.swing.ImageIcon image, int size)
static javax.swing.ImageIcon	createPreviewIcon(java.awt.Image image, int size)
static java.awt.image.BufferedImage	createPreviewImage(java.awt.image.BufferedImage image, java.awt.Dimension fitTo)
static java.awt.image.BufferedImage	createPreviewImage(java.awt.image.BufferedImage image, int length)
static java.awt.image.BufferedImage	createPreviewImage(java.awt.image.BufferedImage image, int width, int height)
static java.awt.image.BufferedImage	createShadeImage(int width, int height, java.awt.Shape shape, int shadeWidth, float opacity, boolean clipShade) Returns shade image based on provided shape.
static javax.swing.ImageIcon	createSizedImagePreview(javax.swing.ImageIcon icon, int length, boolean drawBorder)
static javax.swing.ImageIcon	createThumbnailIcon(java.lang.String src) Image preview generation
static javax.swing.ImageIcon	createThumbnailIcon(java.lang.String src, int size)
static javax.swing.ImageIcon	createTransparentCopy(javax.swing.ImageIcon imageIcon, float opacity)
static java.awt.image.BufferedImage	cutImage(java.awt.Shape shape, java.awt.Image image)
static javax.swing.ImageIcon	cutImage(java.awt.Shape shape, javax.swing.ImageIcon image) Cuts image by the specified shape
static void	darkenImage(java.awt.image.BufferedImage image, float darken) Darkens specified BufferedImage
static java.awt.image.BufferedImage	decodeImage(java.lang.String imageString) Returns BufferedImage decoded from Base64 string.
static java.lang.String	encodeImage(java.awt.image.BufferedImage image) Returns image encoded in Base64 string.
static java.awt.image.BufferedImage	getBufferedImage(javax.swing.Icon icon) Retrieves BufferedImage from Icon
static java.awt.image.BufferedImage	getBufferedImage(java.awt.Image image)
static java.awt.image.BufferedImage	getBufferedImage(javax.swing.ImageIcon imageIcon)
static java.awt.image.BufferedImage	getBufferedImage(java.lang.String iconSrc)
static java.awt.image.BufferedImage	getBufferedImage(java.net.URL url) Retrieves BufferedImage from Image
static javax.swing.ImageIcon	getDisabledCopy(java.lang.String key, javax.swing.Icon icon)
static javax.swing.ImageIcon	getDisabledCopy(java.lang.String key, javax.swing.ImageIcon imageIcon)
static java.awt.Color	getImageAverageColor(javax.swing.ImageIcon icon) Average image color
static javax.swing.ImageIcon	getImageIcon(java.io.File file)
static javax.swing.ImageIcon	getImageIcon(java.io.File file, boolean useCache)
static javax.swing.ImageIcon	getImageIcon(javax.swing.Icon icon)
static javax.swing.ImageIcon	getImageIcon(java.lang.String src)
static javax.swing.ImageIcon	getImageIcon(java.lang.String src, boolean useCache)
static javax.swing.ImageIcon	getImageIcon(java.net.URL resource)
static javax.swing.ImageIcon	getImageIcon(java.net.URL resource, boolean useCache)
static javax.swing.ImageIcon	getSizedImagePreview(java.lang.String id, javax.swing.ImageIcon icon, int length, boolean drawBorder)
static javax.swing.ImageIcon	getSizedImagePreview(java.lang.String src, int length, boolean drawBorder)
static javax.swing.ImageIcon	getTransparentCopy(java.lang.String id, javax.swing.ImageIcon imageIcon, float opacity)
static boolean	isCompatibleImage(java.awt.image.BufferedImage image) Returns true if image is compatible
static boolean	isImageCached(java.lang.String src)
static boolean	isImageLoadable(java.lang.String name) Is this image format can be loaded
static boolean	isTransparent(java.awt.image.BufferedImage image, int x, int y) Returns whether or not image pixel at the specified X and Y coordinates is fully transparent.
static java.awt.image.BufferedImage	loadCompatibleImage(java.net.URL resource) Creates a compatible image from the content specified by the resource
static javax.swing.ImageIcon	loadImage(java.lang.Class nearClass, java.lang.String src) Loads image from specified resource near class
static java.awt.image.BufferedImage	loadImage(java.io.File file)
static javax.swing.ImageIcon	loadImage(java.io.InputStream inputStream) Loads image from InputStream
static java.awt.image.BufferedImage	loadImage(java.lang.String src) Loads image from specified source file
static javax.swing.ImageIcon	loadImage(java.net.URL url) Loads image from URL
static javax.swing.ImageIcon	mergeIcons(javax.swing.Icon... icons)
static javax.swing.ImageIcon	mergeIcons(java.util.List<? extends javax.swing.Icon> icons)
static javax.swing.ImageIcon	mergeIcons(java.lang.String key, javax.swing.Icon... icons)
static javax.swing.ImageIcon	mergeIcons(java.lang.String key, java.util.List<? extends javax.swing.Icon> icons)
static java.awt.image.BufferedImage	mergeImages(java.awt.Image... images)
static java.awt.image.BufferedImage	mergeImages(java.lang.String key, java.awt.Image... images)
static java.awt.image.BufferedImage	resizeCanvas(java.awt.image.BufferedImage image, int width, int height)
static javax.swing.ImageIcon	resizeCanvas(javax.swing.ImageIcon imageIcon, int width, int height) Resizes image canvas
static java.awt.image.BufferedImage	rotateImage180(java.awt.image.BufferedImage image)
static javax.swing.ImageIcon	rotateImage180(javax.swing.ImageIcon imageIcon)
static java.awt.image.BufferedImage	rotateImage90CCW(java.awt.image.BufferedImage image)
static javax.swing.ImageIcon	rotateImage90CCW(javax.swing.ImageIcon imageIcon)
static java.awt.image.BufferedImage	rotateImage90CW(java.awt.image.BufferedImage image)
static javax.swing.ImageIcon	rotateImage90CW(javax.swing.ImageIcon imageIcon) Rotate image
static void	setImageCache(java.lang.String src, javax.swing.ImageIcon imageIcon)
static java.awt.image.BufferedImage	toCompatibleImage(java.awt.image.BufferedImage image) If the source image is already compatible, then the source image is returned.
static java.util.List<java.awt.Image>	toImagesList(java.util.List<? extends javax.swing.ImageIcon> imageIcons) Returns Images list instead of ImageIcons list

Methods inherited from class java.lang.Object

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

Field Detail

IMAGE_CACHE_SEPARATOR

public static final java.lang.String IMAGE_CACHE_SEPARATOR

Cached image data parts separator.

See Also:

Constant Field Values

coloredChooserIcon

public static final javax.swing.ImageIcon coloredChooserIcon

Creates color chooser icon

transparentChooserIcon

public static final javax.swing.ImageIcon transparentChooserIcon

Constructor Detail

ImageUtils

public ImageUtils()

Method Detail

isTransparent

public static boolean isTransparent(java.awt.image.BufferedImage image,
                                    int x,
                                    int y)

Returns whether or not image pixel at the specified X and Y coordinates is fully transparent.

Parameters:

image - image

x - X coordinate

y - Y coordinate

Returns:

true if image pixel at the specified x and y coordinates is fully transparent, false otherwise

createCompatibleImage

public static java.awt.image.BufferedImage createCompatibleImage(int width,
                                                                 int height)

Creates a compatible image using given data

createCompatibleImage

public static java.awt.image.BufferedImage createCompatibleImage(int width,
                                                                 int height,
                                                                 int transparency)

createCompatibleImage

public static java.awt.image.BufferedImage createCompatibleImage(java.awt.image.BufferedImage image)

createCompatibleImage

public static java.awt.image.BufferedImage createCompatibleImage(java.awt.image.BufferedImage image,
                                                                 int transparency)

createCompatibleImage

public static java.awt.image.BufferedImage createCompatibleImage(java.awt.image.BufferedImage image,
                                                                 int width,
                                                                 int height)

loadCompatibleImage

public static java.awt.image.BufferedImage loadCompatibleImage(java.net.URL resource)
                                                        throws java.io.IOException

Creates a compatible image from the content specified by the resource

Throws:

java.io.IOException

toCompatibleImage

public static java.awt.image.BufferedImage toCompatibleImage(java.awt.image.BufferedImage image)

If the source image is already compatible, then the source image is returned. This version takes a BufferedImage, but it could be extended to take an Image instead

isCompatibleImage

public static boolean isCompatibleImage(java.awt.image.BufferedImage image)

Returns true if image is compatible

cutImage

public static javax.swing.ImageIcon cutImage(java.awt.Shape shape,
                                             javax.swing.ImageIcon image)

Cuts image by the specified shape

cutImage

public static java.awt.image.BufferedImage cutImage(java.awt.Shape shape,
                                                    java.awt.Image image)

toImagesList

public static java.util.List<java.awt.Image> toImagesList(java.util.List<? extends javax.swing.ImageIcon> imageIcons)

Returns Images list instead of ImageIcons list

combineIcons

public static javax.swing.ImageIcon combineIcons(java.util.List<javax.swing.ImageIcon> icons)

Combines few images into single one

combineIcons

public static javax.swing.ImageIcon combineIcons(int spacing,
                                                 java.util.List<javax.swing.ImageIcon> icons)

combineIcons

public static javax.swing.ImageIcon combineIcons(javax.swing.ImageIcon... icons)

combineIcons

public static javax.swing.ImageIcon combineIcons(int spacing,
                                                 javax.swing.ImageIcon... icons)

combineIcons

public static java.awt.image.BufferedImage combineIcons(java.awt.Image... images)

combineIcons

public static java.awt.image.BufferedImage combineIcons(int spacing,
                                                        java.awt.Image... images)

clearMergedIconsCache

public static void clearMergedIconsCache()

mergeIcons

public static javax.swing.ImageIcon mergeIcons(java.util.List<? extends javax.swing.Icon> icons)

mergeIcons

public static javax.swing.ImageIcon mergeIcons(java.lang.String key,
                                               java.util.List<? extends javax.swing.Icon> icons)

mergeIcons

public static javax.swing.ImageIcon mergeIcons(javax.swing.Icon... icons)

mergeIcons

public static javax.swing.ImageIcon mergeIcons(java.lang.String key,
                                               javax.swing.Icon... icons)

clearMergedImagesCache

public static void clearMergedImagesCache()

mergeImages

public static java.awt.image.BufferedImage mergeImages(java.awt.Image... images)

mergeImages

public static java.awt.image.BufferedImage mergeImages(java.lang.String key,
                                                       java.awt.Image... images)

loadImage

public static java.awt.image.BufferedImage loadImage(java.lang.String src)

Loads image from specified source file

loadImage

public static java.awt.image.BufferedImage loadImage(java.io.File file)

loadImage

public static javax.swing.ImageIcon loadImage(java.net.URL url)

Loads image from URL

loadImage

public static javax.swing.ImageIcon loadImage(java.lang.Class nearClass,
                                              java.lang.String src)

Loads image from specified resource near class

loadImage

public static javax.swing.ImageIcon loadImage(java.io.InputStream inputStream)

Loads image from InputStream

addBackground

public static javax.swing.ImageIcon addBackground(javax.swing.ImageIcon imageIcon,
                                                  java.awt.Color background)

Adds background to icon

addBackground

public static java.awt.image.BufferedImage addBackground(java.awt.image.BufferedImage image,
                                                         java.awt.Color background)

resizeCanvas

public static javax.swing.ImageIcon resizeCanvas(javax.swing.ImageIcon imageIcon,
                                                 int width,
                                                 int height)

Resizes image canvas

resizeCanvas

public static java.awt.image.BufferedImage resizeCanvas(java.awt.image.BufferedImage image,
                                                        int width,
                                                        int height)

rotateImage90CW

public static javax.swing.ImageIcon rotateImage90CW(javax.swing.ImageIcon imageIcon)

Rotate image

rotateImage90CW

public static java.awt.image.BufferedImage rotateImage90CW(java.awt.image.BufferedImage image)

rotateImage90CCW

public static javax.swing.ImageIcon rotateImage90CCW(javax.swing.ImageIcon imageIcon)

rotateImage90CCW

public static java.awt.image.BufferedImage rotateImage90CCW(java.awt.image.BufferedImage image)

rotateImage180

public static javax.swing.ImageIcon rotateImage180(javax.swing.ImageIcon imageIcon)

rotateImage180

public static java.awt.image.BufferedImage rotateImage180(java.awt.image.BufferedImage image)

createEmptyIcon

public static javax.swing.ImageIcon createEmptyIcon(int width,
                                                    int height)

Creates empty icon

createEmptyImage

public static java.awt.image.BufferedImage createEmptyImage(int width,
                                                            int height)

createColorIcon

public static javax.swing.ImageIcon createColorIcon(java.awt.Color color)

Creates color icon

createColorIcon

public static javax.swing.ImageIcon createColorIcon(java.awt.Color color,
                                                    int width,
                                                    int height)

createColorImage

public static java.awt.image.BufferedImage createColorImage(java.awt.Color color)

createColorImage

public static java.awt.image.BufferedImage createColorImage(java.awt.Color color,
                                                            int width,
                                                            int height)

createColorChooserIcon

public static javax.swing.ImageIcon createColorChooserIcon(java.awt.Color color)

createColorChooserImage

public static java.awt.image.BufferedImage createColorChooserImage(java.awt.Color color)

darkenImage

public static void darkenImage(java.awt.image.BufferedImage image,
                               float darken)

Darkens specified BufferedImage

getImageAverageColor

public static java.awt.Color getImageAverageColor(javax.swing.ImageIcon icon)

Average image color

isImageLoadable

public static boolean isImageLoadable(java.lang.String name)

Is this image format can be loaded

createThumbnailIcon

public static javax.swing.ImageIcon createThumbnailIcon(java.lang.String src)

Image preview generation

createThumbnailIcon

public static javax.swing.ImageIcon createThumbnailIcon(java.lang.String src,
                                                        int size)

createPreviewIcon

public static javax.swing.ImageIcon createPreviewIcon(javax.swing.ImageIcon image,
                                                      int size)

createPreviewIcon

public static javax.swing.ImageIcon createPreviewIcon(java.awt.Image image,
                                                      int size)

createPreviewIcon

public static javax.swing.ImageIcon createPreviewIcon(java.awt.image.BufferedImage image,
                                                      int size)

createPreviewImage

public static java.awt.image.BufferedImage createPreviewImage(java.awt.image.BufferedImage image,
                                                              java.awt.Dimension fitTo)

createPreviewImage

public static java.awt.image.BufferedImage createPreviewImage(java.awt.image.BufferedImage image,
                                                              int width,
                                                              int height)

createPreviewImage

public static java.awt.image.BufferedImage createPreviewImage(java.awt.image.BufferedImage image,
                                                              int length)

isImageCached

public static boolean isImageCached(java.lang.String src)

setImageCache

public static void setImageCache(java.lang.String src,
                                 javax.swing.ImageIcon imageIcon)

clearImagesCache

public static void clearImagesCache()

clearImageCache

public static void clearImageCache(java.lang.String src)

getImageIcon

public static javax.swing.ImageIcon getImageIcon(java.io.File file)

getImageIcon

public static javax.swing.ImageIcon getImageIcon(java.io.File file,
                                                 boolean useCache)

getImageIcon

public static javax.swing.ImageIcon getImageIcon(java.lang.String src)

getImageIcon

public static javax.swing.ImageIcon getImageIcon(java.lang.String src,
                                                 boolean useCache)

getImageIcon

public static javax.swing.ImageIcon getImageIcon(java.net.URL resource)

getImageIcon

public static javax.swing.ImageIcon getImageIcon(java.net.URL resource,
                                                 boolean useCache)

copy

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

Makes a copy of BufferedImage

copy

public static java.awt.image.BufferedImage copy(java.awt.image.BufferedImage bufferedImage)

getBufferedImage

public static java.awt.image.BufferedImage getBufferedImage(java.net.URL url)

Retrieves BufferedImage from Image

getBufferedImage

public static java.awt.image.BufferedImage getBufferedImage(java.lang.String iconSrc)

getBufferedImage

public static java.awt.image.BufferedImage getBufferedImage(javax.swing.ImageIcon imageIcon)

getBufferedImage

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

getBufferedImage

public static java.awt.image.BufferedImage getBufferedImage(javax.swing.Icon icon)

Retrieves BufferedImage from Icon

createBufferedImage

public static java.awt.image.BufferedImage createBufferedImage(javax.swing.Icon icon)

getImageIcon

public static javax.swing.ImageIcon getImageIcon(javax.swing.Icon icon)

getSizedImagePreview

public static javax.swing.ImageIcon getSizedImagePreview(java.lang.String src,
                                                         int length,
                                                         boolean drawBorder)

getSizedImagePreview

public static javax.swing.ImageIcon getSizedImagePreview(java.lang.String id,
                                                         javax.swing.ImageIcon icon,
                                                         int length,
                                                         boolean drawBorder)

createSizedImagePreview

public static javax.swing.ImageIcon createSizedImagePreview(javax.swing.ImageIcon icon,
                                                            int length,
                                                            boolean drawBorder)

clearDisabledCopyCache

public static void clearDisabledCopyCache()

clearDisabledCopyCache

public static void clearDisabledCopyCache(java.lang.String id)

getDisabledCopy

public static javax.swing.ImageIcon getDisabledCopy(java.lang.String key,
                                                    javax.swing.Icon icon)

getDisabledCopy

public static javax.swing.ImageIcon getDisabledCopy(java.lang.String key,
                                                    javax.swing.ImageIcon imageIcon)

createDisabledCopy

public static javax.swing.ImageIcon createDisabledCopy(javax.swing.ImageIcon imageIcon)

createDisabledCopy

public static java.awt.image.BufferedImage createDisabledCopy(java.awt.Image img)

createGrayscaleCopy

public static javax.swing.ImageIcon createGrayscaleCopy(javax.swing.ImageIcon imageIcon)

Creates grayscale image copy

createGrayscaleCopy

public static java.awt.image.BufferedImage createGrayscaleCopy(java.awt.Image img)

createGrayscaleCopy

public static java.awt.image.BufferedImage createGrayscaleCopy(java.awt.image.BufferedImage img)

getTransparentCopy

public static javax.swing.ImageIcon getTransparentCopy(java.lang.String id,
                                                       javax.swing.ImageIcon imageIcon,
                                                       float opacity)

createTransparentCopy

public static javax.swing.ImageIcon createTransparentCopy(javax.swing.ImageIcon imageIcon,
                                                          float opacity)

createShadeImage

public static java.awt.image.BufferedImage createShadeImage(int width,
                                                            int height,
                                                            java.awt.Shape shape,
                                                            int shadeWidth,
                                                            float opacity,
                                                            boolean clipShade)

Returns shade image based on provided shape.

Parameters:

width - shade image width

height - shade image height

shape - shade shape

shadeWidth - shade width

opacity - shade opacity

clipShade - whether or not should clip shade form

Returns:

shade image based on provided shape

createInnerShadeImage

public static java.awt.image.BufferedImage createInnerShadeImage(int width,
                                                                 java.awt.Shape shape,
                                                                 int shadeWidth,
                                                                 float opacity)

Returns shade image based on provided shape.

Parameters:

width - shade image width

shape - shade shape

shadeWidth - shade width

opacity - shade opacity

Returns:

shade image based on provided shape

decodeImage

public static java.awt.image.BufferedImage decodeImage(java.lang.String imageString)

Returns BufferedImage decoded from Base64 string.

Parameters:

imageString - image encoded in Base64 string to decode

Returns:

BufferedImage decoded from Base64 string

encodeImage

public static java.lang.String encodeImage(java.awt.image.BufferedImage image)

Returns image encoded in Base64 string.

Parameters:

image - image to encode into Base64 string

Returns:

image encoded in Base64 string