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

FormatExampleNotes
[name]white, red, orange, yellow, cyan, green, blue, purple, or pinkSets the hue and saturation components, but leaves brightness untouched.
hue:[0-360]hue:120Sets hue without affecting other components
saturation:[0.0-1.0]saturation:0.5Sets saturation without affecting other components
brightness:[0.0-1.0]brightness:0.5Sets brightness without affecting other components
kelvin:[1500-9000]kelvin:5000Sets kelvin to the given value and saturation to 0.0. Other components are not affected.
#RRGGBB#ff0000Automatically converts to HSBK
rgb:[0-255],[0-255],[0-255]rgb:255,255,0Automatically converts to HSBK

Validating Colors

If you need to validate user input, you can use the Validate Color endpoint.