colour.plotting.section.plot_hull_section_colours(hull: trimesh.Trimesh, model: Literal['CAM02LCD', 'CAM02SCD', 'CAM02UCS', 'CAM16LCD', 'CAM16SCD', 'CAM16UCS', 'CIE XYZ', 'CIE xyY', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW', 'DIN99', 'Hunter Lab', 'Hunter Rdab', 'ICaCb', 'ICtCp', 'IPT', 'IgPgTg', 'Jzazbz', 'OSA UCS', 'Oklab', 'hdr-CIELAB', 'hdr-IPT'] | str = 'CIE xyY', axis: Literal['+z', '+x', '+y'] | str = '+z', origin: float = 0.5, normalise: bool = True, section_colours: ArrayLike | str | None = None, section_opacity: float = 1, convert_kwargs: dict | None = None, samples: int = 256, **kwargs: Any) Tuple[plt.Figure, plt.Axes][source]#

Plot the section colours of given trimesh hull along given axis and origin.

  • hull (trimesh.Trimesh) – Trimesh hull.

  • model (Literal['CAM02LCD', 'CAM02SCD', 'CAM02UCS', 'CAM16LCD', 'CAM16SCD', 'CAM16UCS', 'CIE XYZ', 'CIE xyY', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW', 'DIN99', 'Hunter Lab', 'Hunter Rdab', 'ICaCb', 'ICtCp', 'IPT', 'IgPgTg', 'Jzazbz', 'OSA UCS', 'Oklab', 'hdr-CIELAB', 'hdr-IPT'] | str) – Colourspace model, see colour.COLOURSPACE_MODELS attribute for the list of supported colourspace models.

  • axis (Literal['+z', '+x', '+y'] | str) – Axis the hull section will be normal to.

  • origin (float) – Coordinate along axis at which to plot the hull section.

  • normalise (bool) – Whether to normalise axis to the extent of the hull along it.

  • section_colours (ArrayLike | str | None) – Colours of the hull section, if section_colours is set to RGB, the colours will be computed according to the corresponding coordinates.

  • section_opacity (float) – Opacity of the hull section colours.

  • convert_kwargs (dict | None) – Keyword arguments for the colour.convert() definition.

  • samples (int) – Samples count on one axis when computing the hull section colours.

  • kwargs (Any) – {colour.plotting.artist(), colour.plotting.render()}, See the documentation of the previously listed definitions.


Current figure and axes.

Return type



>>> from colour.models import RGB_COLOURSPACE_sRGB
>>> from colour.utilities import is_trimesh_installed
>>> vertices, faces, _outline = primitive_cube(1, 1, 1, 64, 64, 64)
>>> XYZ_vertices = RGB_to_XYZ(
...     vertices["position"] + 0.5, RGB_COLOURSPACE_sRGB
... )
>>> if is_trimesh_installed:
...     from trimesh import Trimesh
...     hull = Trimesh(XYZ_vertices, faces, process=False)
...     plot_hull_section_colours(hull, section_colours="RGB")
(<Figure size ... with 1 Axes>, <...Axes...>)