color-ops v2.0.0
color-ops
simple color operations
toHSL(color)
Convert a color specified as an RGBA array into an HSL object.
Parameters
parameter | type | description |
---|---|---|
color | Array | rgba color |
Returns Object
, hsl representation of that color
rgb(r, g, b)
Given an r, g, b color, return a 4-element RGBA array
Parameters
parameter | type | description |
---|---|---|
r | number | red |
g | number | green |
b | number | blue |
Returns Array
, rgba array
rgba(r, g, b, a)
Given an rgba color as number-like objects, return that array with numbers if possible, and null otherwise
Parameters
parameter | type | description |
---|---|---|
r | number | red |
g | number | green |
b | number | blue |
a | number | alpha |
Returns Array
, rgba array
hsl(h, s, l)
Given an HSL color as components, return an RGBA array with 100% alpha
Parameters
parameter | type | description |
---|---|---|
h | number | hue |
s | number | saturation |
l | number | luminosity |
Returns Array
, rgba color
hsla(h, s, l, a)
Given an HSL color as components, return an RGBA array
Parameters
parameter | type | description |
---|---|---|
h | number | hue |
s | number | saturation |
l | number | luminosity |
a | number | alpha |
Returns Array
, rgba color
hue(color)
Get the hue component of a color
Parameters
parameter | type | description |
---|---|---|
color | Color |
Returns Number
, hue
saturation(color)
Get the saturation component of a color as a string representing percentage
Parameters
parameter | type | description |
---|---|---|
color | Color |
Returns String
, saturation
lightness(color)
Get the lightness component of a color as a string representing percentage
Parameters
parameter | type | description |
---|---|---|
color | Color |
Returns String
, lightness
alpha(color)
Get the alpha component of a color
Parameters
parameter | type | description |
---|---|---|
color | Array |
Returns Number
, alpha
saturate(color, amount)
Saturate or desaturate a color by a given amount
Parameters
parameter | type | description |
---|---|---|
color | Color | |
amount | Number |
Returns Color
, color
lighten(color, amount)
Lighten or darken a color by a given amount
Parameters
parameter | type | description |
---|---|---|
color | Color | |
amount | Number |
Returns Color
, color
fade(color, amount)
Fade a color by a given amount
Parameters
parameter | type | description |
---|---|---|
color | Color | |
amount | Number |
Returns Color
, color
spin(color, degrees)
Rotate the hue of a color by an amount given in decimal degrees.
Parameters
parameter | type | description |
---|---|---|
color | Color | |
degrees | Number |
Returns Color
, output
mix(color1, color2, degrees)
Mix two colors.
Parameters
parameter | type | description |
---|---|---|
color1 | Color | |
color2 | Color | |
degrees | Number |
Returns Color
, output
Installation
Requires nodejs.
$ npm install color-ops
Tests
$ npm test