oracle.dss.util
Class ImageUtils

java.lang.Object
  oracle.dss.util.ImageUtils

public class ImageUtils
extends java.lang.Object

A utility class for working with images.

ImageUtils contains utility functions for:

• Forcing images to load synchronously
• Loading image resources
• Creating a filtered version of an image
• Creating a disabled version of an image
• Creating a "not loaded" image that doesn't rely on any resources external to the class.

Method Summary

static java.awt.Image	createDisabledImage(java.awt.Image image) Creates a disabled version of an image.
static java.awt.Image	createFilteredImage(java.awt.Image baseImage, java.awt.image.ImageFilter imageFilter) Given an image and a filter, creates the resulting image.
static java.awt.Image	createImage(javax.swing.Icon icon, java.awt.Component component) Given an icon, get the image it represents, when rendered in the context of the given component.
static java.awt.Image	getImageResource(java.lang.Class cl, java.lang.String name) Gets an image resource.
static java.awt.Image	getNotLoadedImage() Returns the special "not loaded" image, indicating that an image failed to be loaded properly.
static boolean	isImageLoaded(java.awt.Image image) Return true if the Image has been successfully loaded.
static boolean	loadImage(java.awt.Image image) Synchronously loads a single image.
static boolean	loadImages(java.awt.Image[] images) Synchronously loads multiple images.

Methods inherited from class java.lang.Object

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

Method Detail

createImage

public static java.awt.Image createImage(javax.swing.Icon icon,
                                         java.awt.Component component)

Given an icon, get the image it represents, when rendered in the context of the given component.

createFilteredImage

public static java.awt.Image createFilteredImage(java.awt.Image baseImage,
                                                 java.awt.image.ImageFilter imageFilter)

Given an image and a filter, creates the resulting image.

Parameters:

baseImage - the base image

imageFilter - the image filter

Since:

EWT 3.0

createDisabledImage

public static java.awt.Image createDisabledImage(java.awt.Image image)

Creates a disabled version of an image. The current algorithm only grays out the image. For many images, this is insufficient, and clients will need to have disabled images explicitly designed.

Parameters:

image - the base image

getImageResource

public static java.awt.Image getImageResource(java.lang.Class cl,
                                              java.lang.String name)

Gets an image resource. If the image cannot be loaded, returns the special "not loaded" image.

Parameters:

cl - the class used to load the resource

name - the path to the resource, relative to the class

getNotLoadedImage

public static java.awt.Image getNotLoadedImage()

Returns the special "not loaded" image, indicating that an image failed to be loaded properly.

isImageLoaded

public static boolean isImageLoaded(java.awt.Image image)

Return true if the Image has been successfully loaded.

Parameters:

image - Image to check for sucessful loading

Returns:

True if the image has been sucessfully loaded.

Since:

EWT 3.0

loadImage

public static boolean loadImage(java.awt.Image image)

Synchronously loads a single image.

Returns:

true if the image loaded successfully, false if it failed.

loadImages

public static boolean loadImages(java.awt.Image[] images)

Synchronously loads multiple images.

Returns:

true if all images loaded successfully, false if any failed