How to define a color.
The color of light is best represented in terms of hue, saturation, kelvin, and brightness components. Hue and saturation describe color where as kelvin describes warm and cool whites. Extra care should be given when converting between RGB and HSBK as RGB poorly represents the color of light.
-
`#ff0000` – Deep red, maximum brightness -
`hue:120 saturation:1.0 brightness:0.5` – Deep green, 50% brightness -
`kelvin:2700 brightness: 0.5` – Warm white (2700 K), 50% brightness -
`rgb:0,255,255` – Cyan, 100% brightness -
`kelvin:5000` – Set kelvin to cool white (5000 K) and saturation to 0 without affecting other components -
`kelvin:2700 saturation:1` – Set kelvin to warm (2700 K) and saturation to 1 -
`brightness:0.75` – Set brightness to 75% without affecting other components -
`saturation:0.25` – Set saturation to 25% without affecting other components -
`red` – Sets color to red but doesn't affect brightness
One or many of the hue, saturation, kelvin, and brightness components can be combined to describe the desired color.
Formatting Colors
| Format | Example | Notes |
|---|---|---|
[name] | white, red, orange, yellow, cyan, green, blue, purple, or pink | Sets the hue and saturation components, but leaves brightness untouched. |
hue:[0-360] | hue:120 | Sets hue without affecting other components |
saturation:[0.0-1.0] | saturation:0.5 | Sets saturation without affecting other components |
brightness:[0.0-1.0] | brightness:0.5 | Sets brightness without affecting other components |
kelvin:[1500-9000] | kelvin:5000 | Sets kelvin to the given value and saturation to 0.0. Other components are not affected. |
#RRGGBB | #ff0000 | Automatically converts to HSBK |
rgb:[0-255],[0-255],[0-255] | rgb:255,255,0 | Automatically converts to HSBK |
Validating Colors
If you need to validate user input, you can use the Validate Color endpoint.