org.jdesktop.swingx.util
Class PaintUtils

java.lang.Object
  org.jdesktop.swingx.util.PaintUtils

public class PaintUtils
extends java.lang.Object

A collection of utilties for painting visual effects.

Author:

Mark Davidson

Field Summary

static java.awt.GradientPaint	AERITH
static java.awt.GradientPaint	BLUE_EXPERIENCE
static java.awt.GradientPaint	GRAY
static java.awt.GradientPaint	MAC_OSX
static java.awt.GradientPaint	MAC_OSX_SELECTED
static java.awt.GradientPaint	NIGHT_GRAY
static java.awt.GradientPaint	NIGHT_GRAY_LIGHT
static java.awt.GradientPaint	RED_XP

Method Summary

static java.awt.image.BufferedImage	convertToBufferedImage(java.awt.Image img) Deprecated. Use GraphicsUtilities.convertToBufferedImage(Image) instead
static java.awt.image.BufferedImage	createCompatibleImage(int width, int height) Deprecated. (pre-0.9.6) use GraphicsUtilities.createCompatibleImage(int, int)
static java.awt.image.BufferedImage	createCompatibleImage(int width, int height, int transparency) Deprecated. (pre-0.9.6) use GraphicsUtilities.createCompatibleImage(int, int) or GraphicsUtilities.createCompatibleTranslucentImage(int, int)
static javax.swing.border.Border	getDefaultBorder() Deprecated. (pre 0.9.6) no replacement
static java.awt.Rectangle	getTextBounds(java.awt.Graphics g, javax.swing.JLabel label) Returns the bounds that the text of a label will be drawn into.
static java.awt.image.BufferedImage	loadCompatibleImage(java.io.InputStream in) Deprecated. Use GraphicsUtilities.loadCompatibleImage(InputStream) instead
static java.awt.image.BufferedImage	loadCompatibleImage(java.net.URL resource) Deprecated. (pre-0.9.6) use GraphicsUtilities.loadCompatibleImage(URL)
static void	paintGradient(java.awt.Graphics g, javax.swing.JComponent comp, java.awt.Color color1, java.awt.Color color2) Paints a top to bottom gradient fill over the component bounds from color1 to color2.
static java.awt.Paint	resizeGradient(java.awt.Paint p, int width, int height) Resizes a gradient to fill the width and height available.
static void	setBackgroundColor(java.awt.Container cont, java.awt.Color color) Deprecated. (pre 0.9.6) use SwingXUtilities.setComponentTreeBackground(Component, Color)
static void	setFont(java.awt.Container cont, java.awt.Font font) Deprecated. (pre 0.9.6) use SwingXUtilities.setComponentTreeFont(Component, Font)
static void	setForegroundColor(java.awt.Container cont, java.awt.Color color) Deprecated. (pre 0.9.6) use SwingXUtilities.setComponentTreeForeground(Component, Color)
static java.awt.Shape	setMergedClip(java.awt.Graphics g, java.awt.Shape newClip) Deprecated. (pre-0.9.6) Use GraphicsUtilities.mergeClip(Graphics,Shape) instead
static java.awt.image.BufferedImage	toCompatibleImage(java.awt.image.BufferedImage image) Deprecated. (pre-0.9.6) use GraphicsUtilities.toCompatibleImage(BufferedImage)

Methods inherited from class java.lang.Object

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

Field Detail

BLUE_EXPERIENCE

public static final java.awt.GradientPaint BLUE_EXPERIENCE

MAC_OSX_SELECTED

public static final java.awt.GradientPaint MAC_OSX_SELECTED

MAC_OSX

public static final java.awt.GradientPaint MAC_OSX

AERITH

public static final java.awt.GradientPaint AERITH

GRAY

public static final java.awt.GradientPaint GRAY

RED_XP

public static final java.awt.GradientPaint RED_XP

NIGHT_GRAY

public static final java.awt.GradientPaint NIGHT_GRAY

NIGHT_GRAY_LIGHT

public static final java.awt.GradientPaint NIGHT_GRAY_LIGHT

Method Detail

getDefaultBorder

@Deprecated
public static javax.swing.border.Border getDefaultBorder()

Deprecated. (pre 0.9.6) no replacement

getTextBounds

public static java.awt.Rectangle getTextBounds(java.awt.Graphics g,
                                               javax.swing.JLabel label)

Returns the bounds that the text of a label will be drawn into. Takes into account the current font metrics.

paintGradient

public static void paintGradient(java.awt.Graphics g,
                                 javax.swing.JComponent comp,
                                 java.awt.Color color1,
                                 java.awt.Color color2)

Paints a top to bottom gradient fill over the component bounds from color1 to color2.

setBackgroundColor

@Deprecated
public static void setBackgroundColor(java.awt.Container cont,
                                                 java.awt.Color color)

Deprecated. (pre 0.9.6) use SwingXUtilities.setComponentTreeBackground(Component, Color)

Sets the background color for a containment hierarchy.

setForegroundColor

@Deprecated
public static void setForegroundColor(java.awt.Container cont,
                                                 java.awt.Color color)

Deprecated. (pre 0.9.6) use SwingXUtilities.setComponentTreeForeground(Component, Color)

Sets the foreground color for a containment hierarchy.

setFont

@Deprecated
public static void setFont(java.awt.Container cont,
                                      java.awt.Font font)

Deprecated. (pre 0.9.6) use SwingXUtilities.setComponentTreeFont(Component, Font)

Sets the font for a containment hierarchy.

createCompatibleImage

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

Deprecated. (pre-0.9.6) use GraphicsUtilities.createCompatibleImage(int, int)

Parameters:

width - the width of the new BufferedImage

height - the height of the new BufferedImage

Returns:

Creates and returns a BufferedImage that is "compatible" with this machines video card and subsystem

createCompatibleImage

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

Deprecated. (pre-0.9.6) use GraphicsUtilities.createCompatibleImage(int, int) or GraphicsUtilities.createCompatibleTranslucentImage(int, int)

Parameters:

width - the width of the new BufferedImage

height - the height of the new BufferedImage

transparency - one of the values in the Transparency interface

Returns:

Creates and returns a BufferedImage that is "compatible" with this machines video card and subsystem with the given Transparency.

convertToBufferedImage

@Deprecated
public static java.awt.image.BufferedImage convertToBufferedImage(java.awt.Image img)

Deprecated. Use GraphicsUtilities.convertToBufferedImage(Image) instead

loadCompatibleImage

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

Deprecated. (pre-0.9.6) use GraphicsUtilities.loadCompatibleImage(URL)

Loads the image at the URL and makes it compatible with the screen. If loading the url fails then this method will either throw an IOException or return null.

Throws:

java.io.IOException

loadCompatibleImage

@Deprecated
public static java.awt.image.BufferedImage loadCompatibleImage(java.io.InputStream in)
                                                        throws java.io.IOException

Deprecated. Use GraphicsUtilities.loadCompatibleImage(InputStream) instead

Throws:

java.io.IOException

toCompatibleImage

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

Deprecated. (pre-0.9.6) use GraphicsUtilities.toCompatibleImage(BufferedImage)

setMergedClip

@Deprecated
public static java.awt.Shape setMergedClip(java.awt.Graphics g,
                                                      java.awt.Shape newClip)

Deprecated. (pre-0.9.6) Use GraphicsUtilities.mergeClip(Graphics,Shape) instead

Sets the clip on a graphics object by merging with the existing clip instead of replacing it. The new clip will be an intersection of the old clip and the passed in clip shape. The old clip shape will be returned

resizeGradient

public static java.awt.Paint resizeGradient(java.awt.Paint p,
                                            int width,
                                            int height)

Resizes a gradient to fill the width and height available. If the gradient is left to right it will be resized to fill the entire width. If the gradient is top to bottom it will be resized to fill the entire height. If the gradient is on an angle it will be resized to go from one corner to the other of the rectangle formed by (0,0 -> width,height). This method can resize java.awt.GradientPaint, java.awt.LinearGradientPaint, and the LinearGradientPaint implementation from Apache's Batik project. Note, this method does not require the MultipleGradientPaint.jar from Apache to compile or to run. MultipleGradientPaint.jar *is* required if you want to resize the LinearGradientPaint from that jar. Any paint passed into this method which is not a kind of gradient paint (like a Color or TexturePaint) will be returned unmodified. It will not throw an exception. If the gradient cannot be resized due to other errors the original paint will be returned unmodified. It will not throw an exception.