colour.plotting.plot_multi_colour_swatches(colour_swatches, width=1, height=1, spacing=0, columns=None, text_parameters=None, background_colour=(1.0, 1.0, 1.0), compare_swatches=None, **kwargs)[source]

Plots given colours swatches.

  • colour_swatches (list) – Colour swatch sequence.

  • width (numeric, optional) – Colour swatch width.

  • height (numeric, optional) – Colour swatch height.

  • spacing (numeric, optional) – Colour swatches spacing.

  • columns (int, optional) – Colour swatches columns count, defaults to the colour swatch count or half of it if comparing.

  • text_parameters (dict, optional) – Parameters for the plt.text() definition, visible can be set to make the text visible, offset can be set to define the text offset.

  • background_colour (array_like or unicode, optional) – Background colour.

  • compare_swatches (unicode, optional) – {None, ‘Stacked’, ‘Diagonal’}, Whether to compare the swatches, in which case the colour swatch count must be an even number with alternating reference colour swatches and test colour swatches. Stacked will draw the test colour swatch in the center of the reference colour swatch, Diagonal will draw the reference colour swatch in the upper left diagonal area and the test colour swatch in the bottom right diagonal area.

Other Parameters

**kwargs (dict, optional) – {colour.plotting.artist(), colour.plotting.render()}, Please refer to the documentation of the previously listed definitions.


Current figure and axes.

Return type



>>> RGB_1 = ColourSwatch(RGB=(0.45293517, 0.31732158, 0.26414773))
>>> RGB_2 = ColourSwatch(RGB=(0.77875824, 0.57726450, 0.50453169))
>>> plot_multi_colour_swatches([RGB_1, RGB_2])  
(<Figure size ... with 1 Axes>, <matplotlib.axes._subplots.AxesSubplot object at 0x...>)