|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.jdesktop.swingx.color.ColorUtil
public class ColorUtil
A collection of utility methods for working with Colors.
| Constructor Summary | |
|---|---|
ColorUtil()
|
|
| Method Summary | |
|---|---|
static Color |
blend(Color origin,
Color over)
Blends two colors to create a new color. |
static Color |
computeForeground(Color bg)
Computes an appropriate foreground color (either white or black) for the given background color. |
static Paint |
getCheckerPaint()
Obtain a java.awt.Paint instance which draws a checker
background of black and white. |
static Paint |
getCheckerPaint(Color c1,
Color c2,
int size)
|
static Color |
interpolate(Color b,
Color a,
float t)
|
static Color |
removeAlpha(Color color)
Returns a new color equal to the old one, except that there is no alpha (transparency) channel. |
static Color |
setAlpha(Color color,
int alpha)
Returns a new color equal to the old one, except alpha (transparency) channel is set to the new value. |
static Color |
setBrightness(Color color,
float brightness)
Returns a new color equal to the old one, except the brightness is set to the new value. |
static Color |
setSaturation(Color color,
float saturation)
Returns a new color equal to the old one, except the saturation is set to the new value. |
static void |
tileStretchPaint(Graphics g,
JComponent comp,
BufferedImage img,
Insets ins)
Draws an image on top of a component by doing a 3x3 grid stretch of the image using the specified insets. |
static String |
toHexString(Color color)
Creates a String that represents the supplied color as a
hex-value RGB triplet, including the "#". |
| Methods inherited from class java.lang.Object |
|---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Constructor Detail |
|---|
public ColorUtil()
| Method Detail |
|---|
public static Color removeAlpha(Color color)
This method is a convenience and has the same effect as setAlpha(color, 255).
color - the color to remove the alpha (transparency) from
Color
NullPointerException - if color is null
public static Color setAlpha(Color color,
int alpha)
color - the color to modifyalpha - the new alpha (transparency) level. Must be an int between 0
and 255
Color
IllegalArgumentException - if alpha is not between 0 and 255 inclusive
NullPointerException - if color is null
public static Color setSaturation(Color color,
float saturation)
The color is modified using HSB calculations. The saturation must be a float between 0 and 1. If 0 the resulting color will be gray. If 1 the resulting color will be the most saturated possible form of the passed in color.
color - the color to modifysaturation - the saturation to use in the new color
Color
IllegalArgumentException - if saturation is not between 0 and 1 inclusive
NullPointerException - if color is null
public static Color setBrightness(Color color,
float brightness)
The color is modified using HSB calculations. The brightness must be a float between 0 and 1. If 0 the resulting color will be black. If 1 the resulting color will be the brightest possible form of the passed in color.
color - the color to modifybrightness - the brightness to use in the new color
Color
IllegalArgumentException - if brightness is not between 0 and 1 inclusive
NullPointerException - if color is nullpublic static String toHexString(Color color)
String that represents the supplied color as a
hex-value RGB triplet, including the "#". The return value is suitable
for use in HTML. The alpha (transparency) channel is neither include nor
used in producing the string.
color - the color to convert
Stringpublic static Color computeForeground(Color bg)
bg - the background color
Color.WHITE or Color.BLACK
NullPointerException - if bg is null
public static Color blend(Color origin,
Color over)
origin color is the
base for the new color and regardless of its alpha component, it is
treated a fully opaque (alpha 255).
origin - the base of the new colorover - the alpha-enabled color to add to the origin color
origin and over
colorspublic static Paint getCheckerPaint()
java.awt.Paint instance which draws a checker
background of black and white.
Note: The returned instance may be shared.
Note: This method should be reimplemented to not use a png resource.
public static Paint getCheckerPaint(Color c1,
Color c2,
int size)
public static void tileStretchPaint(Graphics g,
JComponent comp,
BufferedImage img,
Insets ins)
TODO this is image related; move to GraphicsUtilities
public static Color interpolate(Color b,
Color a,
float t)
|
||||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||