info.bioinfweb.commons.graphics

Class GraphicsUtils

java.lang.Object

info.bioinfweb.commons.graphics.GraphicsUtils

public class GraphicsUtils
extends java.lang.Object

Contains method that implement general graphic tasks.

Author:

Ben Stöver

Constructor Summary

Constructors

Constructor and Description
GraphicsUtils()

Method Summary

Modifier and Type	Method and Description
static java.awt.Color	addToColorChannels(java.awt.Color color, int addend) Adds a constant value to all color channels of the specified color.
static java.awt.Color	blend(java.awt.Color... colors) Blends different colors.
static int	brightnessDifference(java.awt.Color c1, java.awt.Color c2) Returns the sum of the absolute differences the three channels of the two colors.
static java.lang.String	colorToHexString(java.awt.Color color)
static void	drawStringInRectangle(java.awt.Graphics2D g, java.awt.geom.Rectangle2D rectangle, java.lang.String text) Draws the specified string into the center of the specified rectangle.
static java.awt.Color	getContrastColor(java.awt.Color color, java.awt.Color background, int minDifference) Returns the specified color if it differs enough from the given background color.
static java.awt.Color	invertColor(java.awt.Color color)
static java.awt.Color	moveColorToCenter(java.awt.Color color, float factor) The result of the method depends on the specified color.
static java.awt.Color	multiplyColorChannels(java.awt.Color color, float factor) Multiplies all color channels of the specified color with the specified value.
static java.awt.Color	rgbToGrayColor(java.awt.Color color) Returns the according gray scale color to the specified color.
static int	rgbToGrayValue(java.awt.Color color) Returns the according gray scale value to the specified color.

Methods inherited from class java.lang.Object

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

Constructor Detail

GraphicsUtils

public GraphicsUtils()

Method Detail

rgbToGrayValue

public static int rgbToGrayValue(java.awt.Color color)

Returns the according gray scale value to the specified color. That value is calculated as the arithmetic mean if the red, green and blue color values.

Parameters:

color - the color to be converted

Returns:

an integer between 0 and 255

See Also:

rgbToGrayColor(Color)

rgbToGrayColor

public static java.awt.Color rgbToGrayColor(java.awt.Color color)

Returns the according gray scale color to the specified color. The values for all channels are calculated as the arithmetic mean of the red, green and blue color values of the specified color. The alpha channel is preserved.

Parameters:

color - the color to be converted

Returns:

a color where all color channels have an equal value

See Also:

rgbToGrayValue(Color)

multiplyColorChannels

public static java.awt.Color multiplyColorChannels(java.awt.Color color,
                                                   float factor)

Multiplies all color channels of the specified color with the specified value. (The alpha channel is preserved). Channel values will never become higher than 255.

This method can be used as an alternative to Color.brighter() and Color.darker()n which always multiply with a constant factor.

Parameters:

color - the color to changed

factor - the factor to be multiplied with the channel values

Returns:

the changed color

See Also:

moveColorToCenter(Color, float)

addToColorChannels

public static java.awt.Color addToColorChannels(java.awt.Color color,
                                                int addend)

Adds a constant value to all color channels of the specified color. (The alpha channel is preserved).

Channel values will never become higher than 255 or lower than 0.

Parameters:

color - the color to changed

addend - the value to be add to all color channels

Returns:

the changed color

moveColorToCenter

public static java.awt.Color moveColorToCenter(java.awt.Color color,
                                               float factor)

The result of the method depends on the specified color. If the gray value of color is greater than 127 all color channels are multiplied by factor. If the gray value is lower all color channels are divided by factor. The alpha channel is not changed.

Channel values will never become higher than 255 or lower than 0.

Parameters:

color - the color to be modified

factor - the scale factor for the color channels

Returns:

the modified color

See Also:

multiplyColorChannels(Color, float)

brightnessDifference

public static int brightnessDifference(java.awt.Color c1,
                                       java.awt.Color c2)

Returns the sum of the absolute differences the three channels of the two colors.

Parameters:

c1 -

c2 -

Returns:

invertColor

public static java.awt.Color invertColor(java.awt.Color color)

getContrastColor

public static java.awt.Color getContrastColor(java.awt.Color color,
                                              java.awt.Color background,
                                              int minDifference)

Returns the specified color if it differs enough from the given background color. Otherwise the inverted color is returned.

Parameters:

color - the designated foreground color

background - the background color

minDifference - the minimal difference the two colors must have so that the designated color is returned

Returns:

the given color or its inversion

blend

public static java.awt.Color blend(java.awt.Color... colors)

Blends different colors. (Each color adds the same percentage to the resulting color.)

Parameters:

colors - an array of colors (should contain at least two elements)

Returns:

the blended color or black if an empty array was specified

colorToHexString

public static java.lang.String colorToHexString(java.awt.Color color)

drawStringInRectangle

public static void drawStringInRectangle(java.awt.Graphics2D g,
                                         java.awt.geom.Rectangle2D rectangle,
                                         java.lang.String text)

Draws the specified string into the center of the specified rectangle.

Parameters:

g - the graphics context to paint to

rectangle - the rectangle to fit the text into

text - the text to be drawn

See Also:

FontCalculator.fontToFitRectangle(Rectangle2D, double, String, String, int, int)