Color

2022年12月26日

Utility for working with colors.

Get the luminosity of a color and determine the optimal (black or white) foreground color.

2022年12月26日

版本注释

v2

Added:
equals(color a, color b) function that deals with na values.

2022年12月28日

版本注释

v3

Added:
tostringRGBT(color)
  Converts a color value to a string in the "rgbt(r,g,b,t)" format.
  Parameters:
    color: The color to convert.
  Returns: The color value as a string.

toHexChar(n)
  Converts an integer between 0 and 15 to its hex equivalent character.
  Parameters:
    n: The integer value to convert.

byteToHex(n)
  Converts an integer from 0 to 255 to a 2-character hex string.
  Parameters:
    n: The integer value to convert.

toHex(color)
  Converts a color to its hex string (#FFFFFF).
  Parameters:
    color
  Returns: The six digit hex string.

2022年12月28日

版本注释

v4

Updated:
getContrastColor(bgColor, keepNa)
  Returns a color that is either black or white depending on the luminosity of the given background color. If the background color is na, returns gray.
  Parameters:
    bgColor: The background color to determine the contrast color for.
    keepNa: When true and the value of bgColor is na the return value will be na; otherwise the if bgColor is na the return will be gray.
  Returns: A color that provides high contrast with the given background color.

2022年12月28日

版本注释

v5

2022年12月31日

版本注释

v6

Added:
brighten(c, value)
  Proportionally adjusts the RGB values of a color. A value of positive (+) 100 will result in white. A value of negative (-) 100 will result in black.
  Parameters:
    c: The color to adjust.
    value: The amount (-100 to +100) to adjust the color by. Values less than -100 or greater than +100 will be clamped.
  Returns: The resultant color.

darken(c, value)
  Proportionally adjusts the RGB values of a color. A value of positive (+) 100 will result in black. A value of negative (-) 100 will result in white.
  Parameters:
    c: The color to adjust.
    value: The amount (-100 to +100) to adjust the color by. Values less than -100 or greater than +100 will be clamped.
  Returns: The resultant color.

2022年12月31日

版本注释

v7 Fixes to brighten

2022年12月31日

版本注释

v8 Fixes to brighten

2023年2月28日

版本注释

v9 Added extension syntax.

7月7日

版本注释

v10 Upgraded to v6. Added "blending" functions/methods

Added:
lerp(color1, color2, t)
  Linear interpolation between two colors.
  Parameters:
    color1 (color): The first color.
    color2 (color): The second color.
    t (float): The interpolation factor (0.0 = color1, 1.0 = color2).
  Returns: The interpolated color.

method blendWith(this, toColor, t)
  Blends this color with another color using linear interpolation.
  Namespace types: series color, simple color, input color, const color
  Parameters:
    this (color): The starting color.
    toColor (color): The target color to blend with.
    t (float): The blend factor (0.0 = this, 1.0 = toColor).
  Returns: The blended color.