colour.plotting.section.plot_hull_section_colours#
- colour.plotting.section.plot_hull_section_colours(hull: trimesh.Trimesh, model: LiteralColourspaceModel | 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[Figure, Axes] [source]#
Plot the section colours of given trimesh hull along given axis and origin.
- Parameters:
hull (trimesh.Trimesh) – Trimesh hull.
model (LiteralColourspaceModel | 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) – Sample 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.
- Returns:
Current figure and axes.
- Return type:
Examples
>>> 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...>)