matthewplotlib

matthewplotlib.colors

type Color = numpy.ndarray[tuple[typing.Any, ...], numpy.dtype[~_ScalarT]]
type ColorLike = str | numpy.ndarray[tuple[typing.Any, ...], numpy.dtype[~_ScalarT]] | tuple[int, int, int] | tuple[float, float, float] | Color
def parse_color(color: ColorLike | None) -> Color | None:

Accept and standardise RGB triples in any of the following 'color like' formats:

  1. Named colours: The following strings are recognised and translated to RGB triples: "black", "red", "green", "blue", "cyan", "magenta", "yellow", "white".

  2. Hexadecimal: A hexadecimal string like "#ff0000" specifying the RGB values in the usual manner.

  3. Short hexadecimal: A three-character hexadecimal string like "#f00", where "#RGB" is equivalent to "#RRGGBB" in the usual hexadecimal format.

  4. Integer triple: An array or tuple of three integers in the range 0 to 255, converted directly to an RGB triple.

  5. Float triple: An array or tuple of three floats in the range 0.0 to 1.0, converted to an RGB triple by multiplying by 255 and rounding down to the nearest integer.

(Arrays or tuples with mixed integers and floats are promoted by NumPy to become float triples.)

NAMED_COLORS: dict[str, Color] = {'black': array([0, 0, 0], dtype=uint8), 'red': array([255, 0, 0], dtype=uint8), 'green': array([ 0, 255, 0], dtype=uint8), 'blue': array([ 0, 0, 255], dtype=uint8), 'cyan': array([ 0, 255, 255], dtype=uint8), 'magenta': array([255, 0, 255], dtype=uint8), 'yellow': array([255, 255, 0], dtype=uint8), 'white': array([255, 255, 255], dtype=uint8)}