def pointer_gamut_visual(reference_colourspace='CIE xyY',
size=4.0,
edge_size=0.5,
uniform_colour=(0.9, 0.9, 0.9),
uniform_opacity=0.8,
uniform_edge_colour=(0.9, 0.9, 0.9),
uniform_edge_opacity=0.8,
parent=None):
"""
Returns a :class:`vispy.scene.visuals.Symbol` class instance representing
Pointer's Gamut data using cross symbols.
Parameters
----------
reference_colourspace : unicode, optional
**{'CIE XYZ', 'CIE xyY', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW',
'IPT', 'Hunter Lab', 'Hunter Rdab'}**,
Reference colourspace to use for colour conversions / transformations.
size : numeric, optional
Cross size.
edge_size : numeric, optional
Cross edge size.
uniform_colour : array_like, optional
Uniform cross colour.
uniform_opacity : numeric, optional
Uniform cross opacity.
uniform_edge_colour : array_like, optional
Uniform cross edge colour.
uniform_edge_opacity : numeric, optional
Uniform cross edge opacity.
parent : Node, optional
Parent of the Pointer's Gamut visual in the `SceneGraph`.
Returns
-------
Symbol
Pointer's Gamut visual.
"""
points = common_colourspace_model_axis_reorder(
XYZ_to_colourspace_model(POINTER_GAMUT_DATA, POINTER_GAMUT_ILLUMINANT,
reference_colourspace), reference_colourspace)
RGB = ColorArray(uniform_colour, alpha=uniform_opacity).rgba
RGB_e = ColorArray(uniform_edge_colour, alpha=uniform_edge_opacity).rgba
markers = Symbol(
symbol='cross',
positions=points,
size=size,
edge_size=edge_size,
face_colour=RGB,
edge_colour=RGB_e,
parent=parent)
return markers
def pointer_gamut_hull_visual(reference_colourspace='CIE xyY',
width=2.0,
uniform_colour=(0.9, 0.9, 0.9),
uniform_opacity=0.4,
parent=None):
"""
Returns a :class:`vispy.scene.visuals.Node` class instance with
:class:`vispy.scene.visuals.Lines` class instance children representing
Pointer's Gamut hull.
Parameters
----------
reference_colourspace : unicode, optional
See :func:`pointer_gamut_visual` argument for possible values.
Reference colourspace to use for colour conversions / transformations.
width : numeric, optional
Lines width.
uniform_colour : array_like, optional
Uniform lines colour.
uniform_opacity : numeric, optional
Uniform lines opacity.
parent : Node, optional
Parent of the Pointer's Gamut hull visual in the `SceneGraph`.
Returns
-------
Node
Pointer's Gamut hull visual.
"""
node = Node(parent=parent)
pointer_gamut_data = np.reshape(POINTER_GAMUT_DATA, (16, -1, 3))
for i in range(16):
points = common_colourspace_model_axis_reorder(
XYZ_to_colourspace_model(
np.vstack(
[pointer_gamut_data[i], pointer_gamut_data[i][0, ...]]),
POINTER_GAMUT_ILLUMINANT, reference_colourspace),
reference_colourspace)
points[np.isnan(points)] = 0
RGB = ColorArray(uniform_colour, alpha=uniform_opacity).rgba
Line(points, RGB, width=width, parent=node)
return node
def RGB_colourspace_whitepoint_axis_visual(colourspace='ITU-R BT.709',
reference_colourspace='CIE xyY',
width=2.0,
method='gl',
parent=None):
"""
Returns a :class:`vispy.scene.visuals.Line` class instance representing
a given RGB colourspace whitepoint axis.
Parameters
----------
colourspace : unicode, optional
See :func:`RGB_colourspace_volume_visual` argument for possible values.
:class:`colour.RGB_Colourspace` class instance name defining the *RGB*
colourspace whitepoint axis to draw.
reference_colourspace : unicode, optional
**{'CIE XYZ', 'CIE xyY', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW',
'IPT', 'Hunter Lab', 'Hunter Rdab'}**,
Reference colourspace to use for colour conversions / transformations.
width : numeric, optional
Line width.
method : unicode, optional
**{'gl', 'agg'}**,
Line drawing method.
parent : Node, optional
Parent of the spectral locus visual in the `SceneGraph`.
Returns
-------
Line
RGB colourspace whitepoint axis.
"""
colourspace = first_item(filter_RGB_colourspaces(colourspace).values())
XYZ_o = xy_to_XYZ(colourspace.whitepoint + (0, ))
XYZ_f = xy_to_XYZ(colourspace.whitepoint + (1.1, ))
XYZ_l = np.vstack([XYZ_o, XYZ_f])
illuminant = DEFAULT_PLOTTING_ILLUMINANT
points = common_colourspace_model_axis_reorder(
XYZ_to_colourspace_model(XYZ_l, illuminant, reference_colourspace),
reference_colourspace)
line = Line(points, (1, 1, 1), width=width, method=method, parent=parent)
return line
def pointer_gamut_boundaries_visual(reference_colourspace='CIE xyY',
width=2.0,
uniform_colour=(0.9, 0.9, 0.9),
uniform_opacity=0.8,
parent=None):
"""
Returns a :class:`vispy.scene.visuals.Line` class instance representing
Pointer's Gamut boundaries.
Parameters
----------
reference_colourspace : unicode, optional
See :func:`pointer_gamut_visual` argument for possible values.
Reference colourspace to use for colour conversions / transformations.
width : numeric, optional
Line width.
uniform_colour : array_like, optional
Uniform line colour.
uniform_opacity : numeric, optional
Uniform line opacity.
parent : Node, optional
Parent of the Pointer's Gamut boundaries visual in the `SceneGraph`.
Returns
-------
Line
Pointer's Gamut boundaries visual.
"""
XYZ = np.vstack(
[POINTER_GAMUT_BOUNDARIES, POINTER_GAMUT_BOUNDARIES[0, ...]])
illuminant = DEFAULT_PLOTTING_ILLUMINANT
points = common_colourspace_model_axis_reorder(
XYZ_to_colourspace_model(XYZ, illuminant, reference_colourspace),
reference_colourspace)
points[np.isnan(points)] = 0
RGB = ColorArray(uniform_colour, alpha=uniform_opacity).rgba
line = Line(points, RGB, width=width, method='agg', parent=parent)
return line
def XYZ_to_colourspace_model_normalised(XYZ, illuminant, model, **kwargs):
"""
Converts from *CIE XYZ* tristimulus values to given colourspace model while
normalising for visual convenience some of the models.
Parameters
----------
XYZ : array_like
*CIE XYZ* tristimulus values.
illuminant : array_like
*CIE XYZ* tristimulus values *illuminant* *xy* chromaticity
coordinates.
model : unicode
**{'CIE XYZ', 'CIE xyY', 'CIE xy', 'CIE Lab', 'CIE LCHab', 'CIE Luv',
'CIE Luv uv', 'CIE LCHuv', 'CIE UCS', 'CIE UCS uv', 'CIE UVW',
'DIN 99', 'Hunter Lab', 'Hunter Rdab', 'IPT', 'JzAzBz, 'OSA UCS',
'hdr-CIELAB', 'hdr-IPT'}**,
Colourspace model to convert the *CIE XYZ* tristimulus values to.
Other Parameters
----------------
\**kwargs : dict, optional
Keywords arguments.
Returns
-------
ndarray
Colourspace model values.
"""
ijk = XYZ_to_colourspace_model(XYZ, illuminant, model, **kwargs)
if model == 'JzAzBz':
ijk /= XYZ_to_JzAzBz([1, 1, 1])[0]
if model == 'OSA UCS':
ijk /= XYZ_to_OSA_UCS([1, 1, 1])[0]
return ijk
def RGB_colourspace_volume_visual(colourspace='ITU-R BT.709',
reference_colourspace='CIE xyY',
segments=16,
uniform_colour=None,
uniform_opacity=0.5,
wireframe=True,
wireframe_colour=None,
wireframe_opacity=1.0,
parent=None):
"""
Returns a :class:`vispy.scene.visuals.Node` class instance with one or two
:class:`colour_analysis.visuals.Box` class instance children representing
a *RGB* colourspace volume visual.
Parameters
----------
colourspace : unicode, optional
**{'ITU-R BT.709', 'ACES2065-1', 'ACEScc', 'ACEScg', 'ACESproxy',
'ALEXA Wide Gamut', 'Adobe RGB (1998)', 'Adobe Wide Gamut RGB',
'Apple RGB', 'Best RGB', 'Beta RGB', 'CIE RGB', 'Cinema Gamut',
'ColorMatch RGB', 'DCI-P3', 'DCI-P3+', 'DRAGONcolor', 'DRAGONcolor2',
'Don RGB 4', 'ECI RGB v2', 'ERIMM RGB', 'Ekta Space PS 5', 'Max RGB',
'NTSC', 'Pal/Secam', 'ProPhoto RGB', 'REDcolor', 'REDcolor2',
'REDcolor3', 'REDcolor4', 'RIMM RGB', 'ROMM RGB', 'ITU-R BT.2020',
'Russell RGB', 'S-Gamut', 'S-Gamut3', 'S-Gamut3.Cine', 'SMPTE-C RGB',
'V-Gamut', 'Xtreme RGB', 'sRGB'}**,
:class:`colour.RGB_Colourspace` class instance name defining the *RGB*
colourspace volume to draw.
reference_colourspace : unicode
**{'CIE XYZ', 'CIE xyY', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW',
'IPT', 'Hunter Lab', 'Hunter Rdab'}**,
Reference colourspace to convert the *CIE XYZ* tristimulus values to.
segments : int, optional
Box segments.
uniform_colour : array_like, optional
Uniform mesh colour.
uniform_opacity : numeric, optional
Uniform mesh opacity.
wireframe : bool, optional
Use wireframe display.
Uniform mesh opacity.
wireframe_colour : array_like, optional
Wireframe mesh colour.
wireframe_opacity : numeric, optional
Wireframe mesh opacity.
parent : Node, optional
Parent of the *RGB* colourspace volume visual in the `SceneGraph`.
"""
node = Node(parent)
colourspace = first_item(filter_RGB_colourspaces(colourspace).values())
RGB_cube_f = RGB_identity_cube(width_segments=segments,
height_segments=segments,
depth_segments=segments,
uniform_colour=uniform_colour,
uniform_opacity=uniform_opacity,
vertex_colours=not uniform_colour,
parent=node)
vertices = RGB_cube_f.mesh_data.get_vertices()
XYZ = RGB_to_XYZ(vertices, colourspace.whitepoint, colourspace.whitepoint,
colourspace.RGB_to_XYZ_matrix)
value = common_colourspace_model_axis_reorder(
XYZ_to_colourspace_model(XYZ, colourspace.whitepoint,
reference_colourspace), reference_colourspace)
value[np.isnan(value)] = 0
RGB_cube_f.mesh_data.set_vertices(value)
if wireframe:
RGB_cube_w = RGB_identity_cube(width_segments=segments,
height_segments=segments,
depth_segments=segments,
uniform_colour=wireframe_colour,
uniform_opacity=wireframe_opacity,
vertex_colours=not wireframe_colour,
wireframe=True,
parent=node)
RGB_cube_w.mesh_data.set_vertices(value)
return node
def RGB_scatter_visual(RGB,
colourspace='ITU-R BT.709',
reference_colourspace='CIE xyY',
symbol='disc',
size=4.0,
edge_size=0.5,
uniform_colour=None,
uniform_opacity=1.0,
uniform_edge_colour=None,
uniform_edge_opacity=1.0,
resampling='auto',
parent=None):
"""
Returns a :class:`vispy.scene.visuals.Symbol` class instance representing
*RGB* data using given symbols.
Parameters
----------
RGB : array_like
*RGB* data to draw.
colourspace : unicode, optional
**{'ITU-R BT.709', 'ACES2065-1', 'ACEScc', 'ACEScg', 'ACESproxy',
'ALEXA Wide Gamut', 'Adobe RGB (1998)', 'Adobe Wide Gamut RGB',
'Apple RGB', 'Best RGB', 'Beta RGB', 'CIE RGB', 'Cinema Gamut',
'ColorMatch RGB', 'DCI-P3', 'DCI-P3+', 'DRAGONcolor', 'DRAGONcolor2',
'Don RGB 4', 'ECI RGB v2', 'ERIMM RGB', 'Ekta Space PS 5', 'Max RGB',
'NTSC', 'Pal/Secam', 'ProPhoto RGB', 'REDcolor', 'REDcolor2',
'REDcolor3', 'REDcolor4', 'RIMM RGB', 'ROMM RGB', 'ITU-R BT.2020',
'Russell RGB', 'S-Gamut', 'S-Gamut3', 'S-Gamut3.Cine', 'SMPTE-C RGB',
'V-Gamut', 'Xtreme RGB', 'sRGB'}**,
:class:`colour.RGB_Colourspace` class instance name defining the *RGB*
colourspace of the data to draw.
reference_colourspace : unicode, optional
**{'CIE XYZ', 'CIE xyY', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW',
'IPT', 'Hunter Lab', 'Hunter Rdab'}**,
Reference colourspace to use for colour conversions / transformations.
symbol : unicode, optional
Symbol type to draw.
size : numeric, optional
Symbol size.
edge_size : numeric, optional
Symbol edge size.
uniform_colour : array_like, optional
Uniform symbol colour.
uniform_opacity : numeric, optional
Uniform symbol opacity.
uniform_edge_colour : array_like, optional
Uniform symbol edge colour.
uniform_edge_opacity : numeric, optional
Uniform symbol edge opacity.
resampling : numeric or unicode, optional
Resampling value, if numeric input, one pixel every `resampling`
argument value will be kept.
parent : Node, optional
Parent of the *RGB* scatter visual in the `SceneGraph`.
Returns
-------
Symbol
*RGB* scatter visual.
"""
colourspace = first_item(filter_RGB_colourspaces(colourspace).values())
RGB = np.asarray(RGB)
if resampling == 'auto':
resampling = max(int((0.0078125 * np.average(RGB.shape[0:1])) // 2), 1)
RGB = RGB[::resampling, ::resampling].reshape([-1, 3])
XYZ = RGB_to_XYZ(RGB, colourspace.whitepoint, colourspace.whitepoint,
colourspace.RGB_to_XYZ_matrix)
points = common_colourspace_model_axis_reorder(
XYZ_to_colourspace_model(XYZ, colourspace.whitepoint,
reference_colourspace), reference_colourspace)
points[np.isnan(points)] = 0
RGB = np.clip(RGB, 0, 1)
if uniform_colour is None:
RGB = np.hstack([
RGB,
np.full((RGB.shape[0], 1), uniform_opacity, DEFAULT_FLOAT_DTYPE)
])
else:
RGB = ColorArray(uniform_colour, alpha=uniform_opacity).rgba
if uniform_edge_colour is None:
RGB_e = RGB
else:
RGB_e = ColorArray(uniform_edge_colour,
alpha=uniform_edge_opacity).rgba
markers = Symbol(symbol=symbol,
positions=points,
size=size,
edge_size=edge_size,
face_colour=RGB,
edge_colour=RGB_e,
parent=parent)
return markers
def spectral_locus_visual(reference_colourspace='CIE xyY',
cmfs='CIE 1931 2 Degree Standard Observer',
width=2.0,
uniform_colour=None,
uniform_opacity=1.0,
method='gl',
parent=None):
"""
Returns a :class:`vispy.scene.visuals.Line` class instance representing
the spectral locus.
Parameters
----------
reference_colourspace : unicode, optional
**{'CIE XYZ', 'CIE xyY', 'CIE Lab', 'CIE Luv', 'CIE UCS', 'CIE UVW',
'IPT', 'Hunter Lab', 'Hunter Rdab'}**,
Reference colourspace to use for colour conversions / transformations.
cmfs : unicode, optional
Standard observer colour matching functions used to draw the spectral
locus.
width : numeric, optional
Line width.
uniform_colour : array_like, optional
Uniform symbol colour.
uniform_opacity : numeric, optional
Uniform symbol opacity.
method : unicode, optional
**{'gl', 'agg'}**,
Line drawing method.
parent : Node, optional
Parent of the spectral locus visual in the `SceneGraph`.
Returns
-------
Line
Spectral locus visual.
"""
cmfs = first_item(filter_cmfs(cmfs).values())
XYZ = cmfs.values
XYZ = np.vstack([XYZ, XYZ[0, ...]])
illuminant = DEFAULT_PLOTTING_ILLUMINANT
points = common_colourspace_model_axis_reorder(
XYZ_to_colourspace_model(XYZ, illuminant, reference_colourspace),
reference_colourspace)
points[np.isnan(points)] = 0
if uniform_colour is None:
RGB = normalise_maximum(XYZ_to_sRGB(XYZ, illuminant), axis=-1)
RGB = np.hstack([
RGB,
np.full((RGB.shape[0], 1), uniform_opacity, DEFAULT_FLOAT_DTYPE)
])
else:
RGB = ColorArray(uniform_colour, alpha=uniform_opacity).rgba
line = Line(points,
np.clip(RGB, 0, 1),
width=width,
method=method,
parent=parent)
return line