Color

26 dic 2022

Utility for working with colors.

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

26 dic 2022

Note di rilascio

v2

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

28 dic 2022

Note di rilascio

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.

28 dic 2022

Note di rilascio

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.

28 dic 2022

Note di rilascio

v5

31 dic 2022

Note di rilascio

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.

31 dic 2022

Note di rilascio

v7 Fixes to brighten

31 dic 2022

Note di rilascio

v8 Fixes to brighten

28 feb 2023

Note di rilascio

v9 Added extension syntax.

7 lug

Note di rilascio

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.