colour.describe_conversion_path

colour.describe_conversion_path(source, target, mode='Short', width=79, padding=3, print_callable=<built-in function print>, **kwargs)[source]

Describes the conversion path from source colour representation to target colour representation using the automatic colour conversion graph.

Parameters
  • source (unicode) – Source colour representation, i.e. the source node in the automatic colour conversion graph.

  • target (unicode) – Target colour representation, i.e. the target node in the automatic colour conversion graph.

  • mode (unicode, optional) – {‘Short’, ‘Long’, ‘Extended’}, Verbose mode: Short describes the conversion path, Long provides details about the arguments, definitions signatures and output values, Extended appends the definitions documentation.

  • width (int, optional) – Message box width.

  • padding (unicode, optional) – Padding on each sides of the message.

  • print_callable (callable, optional) – Callable used to print the message box.

Other Parameters

**kwargs (dict, optional) – {colour.convert()}, Please refer to the documentation of the previously listed definition.

Examples

>>> describe_conversion_path('Spectral Distribution', 'sRGB', width=75)
===========================================================================
*                                                                         *
*   [ Conversion Path ]                                                   *
*                                                                         *
*   "sd_to_XYZ" --> "XYZ_to_sRGB"                                         *
*                                                                         *
===========================================================================