Extracting Color Coordinates

Description

Allows to extract the current values of one or multiple dimensions for all colors of this color object. The names of the coordinates varies between different color spaces.

Usage

hexcols.get(dimname=None)

Arguments

dimnameNone, str
If None (default) values of all coordinates of the current color object are returned. A specific coordinate can be specified if needed.

Return

Returns a numpy.ndarray if coordinates of one specific dimension are requested, else a dict of arrays.

Examples

from colorspace import HCL, sRGB, hexcols
# Example using HCL color object with alpha channel
cols = HCL([260, 80, 30], [80, 0, 80], [30, 90, 30], [1, 0.6, 0.2])
cols.get("H") # Specific dimension
array([260.,  80.,  30.])
cols.get("alpha") # Alpha (if existing)
array([1. , 0.6, 0.2])
cols.get() # All dimensions
{'H': array([260.,  80.,  30.]),
 'C': array([80.,  0., 80.]),
 'L': array([30., 90., 30.]),
 'alpha': array([1. , 0.6, 0.2])}
# Convert colors to sRGB
cols.to("sRGB")
cols.get("R") # Specific dimension
array([0.00691302, 0.88757039, 0.49625787])
cols.get() # All dimensions
{'R': array([0.00691302, 0.88757039, 0.49625787]),
 'G': array([0.24577258, 0.8875635 , 0.17895641]),
 'B': array([ 0.64603426,  0.88759885, -0.30114778]),
 'alpha': array([1. , 0.6, 0.2])}
# Convert to hexcols
cols.to("hex")
cols.get("hex_")
array(['#023FA5', '#E2E2E2', '#7F2E00'], dtype='<U7')

Raises

  • TypeError: If argument dimname is neither None or str.
  • ValueError: If the dimension specified on dimnames does not exist.