colour.plotting.RGB_colourspaces_gamuts_plot

colour.plotting.RGB_colourspaces_gamuts_plot(colourspaces=None, reference_colourspace='CIE xyY', segments=8, display_grid=True, grid_segments=10, spectral_locus=False, spectral_locus_colour=None, cmfs='CIE 1931 2 Degree Standard Observer', **kwargs)[source]

Plots given RGB colourspaces gamuts in given reference colourspace.

Parameters:
  • colourspaces (array_like, optional) – RGB colourspaces to plot the gamuts.
  • reference_colourspace (unicode, optional) – {‘CIE XYZ’, ‘CIE xyY’, ‘CIE Lab’, ‘CIE Luv’, ‘CIE UCS’, ‘CIE UVW’, ‘IPT’, ‘Hunter Lab’, ‘Hunter Rdab’}, Reference colourspace to plot the gamuts into.
  • segments (int, optional) – Edge segments count for each RGB colourspace cubes.
  • display_grid (bool, optional) – Display a grid at the bottom of the RGB colourspace cubes.
  • grid_segments (bool, optional) – Edge segments count for the grid.
  • spectral_locus (bool, optional) – Is spectral locus line plotted.
  • spectral_locus_colour (array_like, optional) – Spectral locus line colour.
  • cmfs (unicode, optional) – Standard observer colour matching functions used for spectral locus.
Other Parameters:
 
  • **kwargs (dict, optional) – {colour.plotting.volume.nadir_grid()}, Please refer to the documentation of the previously listed definition.
  • face_colours (array_like, optional) – Face colours array such as face_colours = (None, (0.5, 0.5, 1.0)).
  • edge_colours (array_like, optional) – Edge colours array such as edge_colours = (None, (0.5, 0.5, 1.0)).
  • face_alpha (numeric, optional) – Face opacity value such as face_alpha = (0.5, 1.0).
  • edge_alpha (numeric, optional) – Edge opacity value such as edge_alpha = (0.0, 1.0).
Returns:

Current figure or None.

Return type:

Figure

Examples

>>> c = ['ITU-R BT.709', 'ACEScg', 'S-Gamut']
>>> RGB_colourspaces_gamuts_plot(c)