dk.heick.properties.types.utils.colors

Class HSBAColorFormat

java.lang.Object

dk.heick.properties.types.utils.colors.TupleColorFormat

dk.heick.properties.types.utils.colors.HSBAColorFormat

All Implemented Interfaces:

ColorFormat, Serializable

Direct Known Subclasses:

HSVAColorFormat

public class HSBAColorFormat
extends TupleColorFormat

The HSBA (Hue, Saturation, Brightness, Alpha) color model defines a color space in terms of four constituent components : Hue, Saturation, Brightness and Alpha.

The HSBA model is also known as HSV (Hue, Saturation, Brightness, Alpha) model.
The HSBA model was created in 1978 by Alvy Ray Smith.
It is a nonlinear transformation of the RGB color space.
In other words, color is not defined as a simple combination (addition/substraction) of primary colors but as a mathematical transformation.
Note: HSV and HSB are the same, but HSL is different.

Name	HSBAColorFormat
Format	hsba(hue,saturation,brightness,alpha)
Description	Hue : A float - Ranges from 0.0 to 360.0 (both inclusive) in most applications. each value corresponds to one color : 0 is red, 45 is a shade of orange and 55 is a shade of yellow. Saturation : A float - the intensity of the color. Ranges from 0.0 to 100.0% (both inclusive) 0 means no color, that is a shade of grey between black and white; 100 means intense color. Brightness : A float - the brightness of the color. Ranges from 0.0 to 100.0% (both inclusive) 0 is always black; depending on the saturation, 100 may be white or a more or less saturated color. Alpha : A float - the uniform opacity setting. Any values outside the range 0.0 (fully transparent) to 1.0 (fully opaque) will be clamped to this range. (both inclusive).
Example of valid values	hsba(355.2,82.7% ,89.01%,1.0) hsba(124.2,78.42% ,78.14%,0.43) hsba(234.8,80.05%,84.7%,0.90)
Notes	Extends TupleColorFormat
Links	Wiki

Since:

1.7

Author:

Frederik Heick,

See Also:

HSVAColorFormat, TupleColorFormat, http://colorizer.org/, http://stackoverflow.com/questions/17242144/javascript-convert-hsb-hsv-color-to-rgb-accurately, Serialized Form

Field Summary

Fields inherited from class dk.heick.properties.types.utils.colors.TupleColorFormat

logger

Constructor Summary

Constructors

Constructor and Description
HSBAColorFormat()

Method Summary

Modifier and Type	Method and Description
String	format(Color color) Formats the color to a string representation of this format.
String	getColorMethodName() The method name which identifies the color method (aka rgb, rgba, hsl, hsla etc.)
boolean	isAlphaSupported() Do the implemtation supports Alpha (opacity).
Color	parse(String text) Parse a text string to a Color.

Methods inherited from class dk.heick.properties.types.utils.colors.TupleColorFormat

formatColorMethod, formatTuples, getLogger, getMethodTokens, isOfColorMethodFormat, limitsValue, limitsValue, limitsValue, parseFloatToken, parseIntToken, parsePercentageToken, parseRGBToken, validateRange

Methods inherited from class java.lang.Object

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

Constructor Detail

HSBAColorFormat

public HSBAColorFormat()

Method Detail

getColorMethodName

public String getColorMethodName()

Description copied from class: TupleColorFormat

The method name which identifies the color method (aka rgb, rgba, hsl, hsla etc.)

Specified by:

getColorMethodName in class TupleColorFormat

Returns:

the method name.

isAlphaSupported

public boolean isAlphaSupported()

Description copied from interface: ColorFormat

Do the implemtation supports Alpha (opacity).

Returns:

true if the ColorFormat supports Alpha, otherwise false.

parse

public Color parse(String text)
            throws ColorFormatException

Description copied from interface: ColorFormat

Parse a text string to a Color.

Parameters:

text - a text string with the color format.

Returns:

a Color

Throws:

ColorFormatException - if the text is null or can not be parse by this format.

See Also:

Color

format

public String format(Color color)
              throws NullPointerException

Description copied from interface: ColorFormat

Formats the color to a string representation of this format.

Parameters:

color - the color.

Returns:

a string version of the color format.

Throws:

NullPointerException - if color is null.