Version 0.2.1.2

Create and manipulate colors with ease.

Color.get("violet")
Color(0xEE82EE)
Color("#EE82EE")
Color("EE82EE")
Color(0xEE, 0x82, 0xEE)
Color("EE", "82", "EE")
Color(238, 130, 238)
Color.rgb(238, 130, 238)
Color.hsl(0.8333333333333334, 0.7605633802816902, 0.7215686274509804)
// 300°, 75.88652482269505%, 72.35294117647058%

Color("#ABC") // "#AABBCC"
Color("ABC")  // "#AABBCC"

var c = new Color('#ABC123', 0.6);
c.getRGBA(); // rgba(171,193,35,0.6)

var myColor = new Color;
myColor.setValue(0xAA7F00);
myColor.hexTriplet() === "#aa7f00";
myColor.channels[0] = 0xFF;
myColor.hexTriplet() === "#ff7f00"; // orange

Color.define("rind", [92, 163, 16])
Color.get("rind").hexTriplet() === "#5ca310"

Color.random("green", "blue");

red   = Color.parse("rgb(255, 0, 0)");
green = Color.parse("rgb ,128"); // shorthand
blue  = Color.parse("hsl(240, 100%, 50%)");

red.hexTriplet()   === "#ff0000";
green.hexTriplet() === "#008000";
blue.hexTriplet()  === "#0000ff";

• Firefox 1+
• Safari 2+
• IE 6+
• Opera 7+
• Google Chrome 0.1+

color.js can be used in any ECMAScript environment as it does not make use of the DOM. color.js is very useful on the server-side and the client-side.

The color.js CSS module defines all of the standard CSS colors for use in color.js.

Note: HSL values are in the form of fractions (0 to 1). A hue value of 0.5 is equivalent to a hue of 180°.

Color objects can be instantiated in any of the following ways:

color = [new ]Color(color:int | string, [, alpha:float])
color = [new ]Color(red:int | string, green:int | string, blue:int | string [, alpha:float | string])
color = Color.rgb(red:int, green:int, blue:int [, alpha:float])
color = Color.hsl(hue:float, saturation:float, lightness:float [, alpha:float])

channels : array

An array containing a color's red, green, blue, and alpha channels in that order.

rgb()

Returns a CSS rgb() function representing the color.

rgba()

Returns a CSS rgba() function representing the color.

hsl()

Returns a CSS hsl() function representing the color.

hsla()

Returns a CSS hsla() function representing the color.

css()

If the alpha channel is 1, this returns hexTriplet(). Otherwise, this returns rgba().

getValue() and valueOf()

Returns an integer representation of the color.

setValue(value:int)

Sets the to value.

hexTriplet()

Returns the hex triplet (#RRGGBB) representation of the color.

rgbData()

Returns an array containing the color's red, green, and blue channels in that order.

hslData()

Returns an array containing the color's hue, saturation, and lightness channels in that order.

toString()

Returns this[Color.TO_STRING_METHOD]().

Color names are case-insensitive.

Color.define(colorName:string, RGB:array | string)

Saves the specified RGB color under colorName, for later retrieval.

Color.get(colorName:string)

Returns a new color instance instance using the RGB data from a previously defined color with the name, colorName.

Color.del(colorName:string)

Deletes a previously defined color with the name of colorName.

Color.clearColors()

Clears all color definitions.

Color.parse(cssFunction:string)

Returns the color represented by a CSS function (eg. hsl(0, 100%, 50%)) or hex triplet. If no color could be parsed, this returns null. This function intentionally allows invalid syntax when parsing css functions. As long as the first three non-whitespace characters (case-insensitive) are "rgb" or "hsl" and the arguments (which are all optional and default to zero) are separated by commas, this function will be able to parse the CSS function.

Color.random([rangeStart:int | string] [, rangeEnd:int | string])

Returns a random color from rangeStart to rangeEnd. If rangeStart is not specified, this returns a random color from #000000 to #FFFFFF. rangeStart and rangeEnd can also be color names.

Color.rgb(red:int, green:int, blue:int [, alpha:float])

Returns a color constructed from the specified RGB values.

Color.hsl(hue:float, saturation:float, lightness:float [, alpha:float])

Returns a color constructed from the specified HSL values.

Color.RGBtoHSL(rgb:array)

Returns the array of RGB values converted to HSL values.

Color.HSLtoRGB(hsl:array)

Returns the array of HSL values converted to RGB values.

Color.TO_STRING_METHOD : string

The method name of which to call when a color instance's toString() method is called. This defaults to hexTriplet.