Skip to content

Color

There are many different way to define color in JSON

Hexadecimal number

The simplest way is by using hexadecimal numbers. You can do that be prefixing your number string with 0x, 0X or #. The format is AARRGGBB. If A (alpha) is not set, it defaults to full opacity

Example

json
{
  "color": "#FFFFFF"
}

The following formats can all have the alpha or a property, with a value from either 0.0 to 1.0 or from 0 to 255. If you want to use the 0.0 to 1.0 range you need use a .. 1 will use the 0 to 255 range and is very low. 1.0 will use the 0.0 to 1.0 range and is full opacity.

RGB

  • red or r: The red value from 0 to 255
  • green or g: The green value from 0 to 255
  • blue or b: The blue value from 0 to 255

Example

json
{
  "color": {
    "r": 200,
    "g": 0,
    "b": 44,
    "alpha": 1.0
  }
}

Here you can see how alpha can be added.

HSV

  • hue or h: The hue value from 0 to 360 (wraps around) (default is 0)
  • saturation or s: The saturation from 0.0 to 1.0 (default is 0.0)
  • value or v: The value from 0.0 to 1.0 (default is 1.0)

If value is not defined, HSL will be used.

Example

json
{
  "color": {
    "hue": 120,
    "saturation": 0.5,
    "value": 0.75
  }
}

HSL

  • hue or h: The hue value from 0 to 360 (wraps around) (default is 0)
  • saturation or s: The saturation from 0.0 to 1.0 (default is 0.0)
  • lightness or l: The value from 0.0 to 1.0 (default is 0.5)

Example

json
{
  "color": {
    "hue": 120,
    "saturation": 0.5,
    "lightness": 0.75
  }
}

NOTE

The saturation is not the same from HSV as from HSL (they are calculated slightly different), but the hue is.

CMYK

  • cyan or c: The cyan value from 0.0 to 1.0 (default is 1.0)
  • magenta or m: The cyan value from 0.0 to 1.0 (default is 1.0)
  • yellow or y: The cyan value from 0.0 to 1.0 (default is 1.0)
  • black or k: The cyan value from 0.0 to 1.0 (default is 1.0)

Example

json
{
  "color": {
    "c": 1.0,
    "m": 0.5,
    "y": 0.75,
    "k": 0.2
  }
}

WARNING

You can NOT mix any of those formats! (except of course alpha)

Contributors

Changelog

© 2024 CleanroomMC. All Rights Reserved.