ChromaticityPlot3D

ChromaticityPlot3D[colspace]

returns a 3D gamut of the color space colspace.

ChromaticityPlot3D[color]

plots the specific color.

ChromaticityPlot3D[image]

plots the pixels of image as individual colors.

ChromaticityPlot3D[{input1,input2,}]

plots multiple colors, color spaces and images.

ChromaticityPlot3D[,refcolspace]

uses the reference color space refcolspace.

Details and Options

  • ChromaticityPlot3D is also known as chromatic diagram.
  • Typically used to visualize one or several color spaces compared to the visual spectrum. It is also used to visualize one or several such colors in an image.
  • ChromaticityPlot3D converts and displays the color coordinates in colspace to coordinates in refcolspace color space.
  • Color specification color can be any color directive or a color neighborhood given as a ColorsNear object.
  • Possible colspace values that can also be a ColorSpace option setting are:
  • "Grayscale"GrayLevel
    "RGB"RGBColor
    "CMYK"CMYKColor
    "HSB"Hue
    "XYZ"XYZColor
    "LAB"LABColor
    "LUV"LUVColor
    "LCH"LCHColor
    ColorProfileData[][i]color profile with the specified rendering intent
  • Other possible colspace values:
  • "AdobeRGB"Adobe RGB (1998) color space
    "AppleRGB"Apple RGB color space
    "CIERGB"CIE RGB color space
    "ProPhotoRGB"ProPhoto RGB
    "sRGB"standard sRGB color space
    "WideGamutRGB"large gamut RGB (a.k.a. Adobe Wide Gamut RGB)
  • Possible refcolspace specifications include:
  • "CIE31"CIE 1931 (default)
    "CIE76"CIE 1976
    "XYZ"CIE 1931
    "LAB"CIE 1976
    "LCH"CIE
    "LUV"CIE 1976
    "RGB"RGB cube
    "HSB"HSB cube
  • ChromaticityPlot3D accepts all Graphics3D options with the following additions and changes:
  • Appearance Noneappearance of the visible spectrum
    Axes Truewhether to draw axes
    AxesLabel Automaticaxes labels
    BoundaryStyle Automaticthe style for the boundary of each region
    BoxRatios {1,1,1}bounding 3D box ratios
    FillingStyle Automaticfilling style for each color space
    MaxPlotPoints 2000maximum number of colors or pixels to show
    Mesh Nonewhether to draw a mesh
    MeshStyle Automaticthe style for mesh divisions
    PlotLegends Automaticlegends for each space
    PlotPoints Automaticnumber of sample points in each dimension
    PlotStyle Automaticspecify the style for colors and images
    PlotTheme $PlotThemeoverall theme for the plot
    ViewPoint{1,1.5,-2.}viewing position
    ViewVertical{1,0,0}direction to make vertical
    WhitePoint Automaticwhat white point to show
  • Possible settings for Appearance are:
  • Nonedo not show the visible spectrum
    "VisibleSpectrum"show the curve corresponding to the visible spectrum
  • Typical settings for PlotLegends include:
  • Noneadd no legend
    Automaticuse automatic legending
    "Expressions"use color space name as legend labels
    {lbl1,lbl2,}use lbli for the i^(th) input
    Placed[lspec,]specify placement of legend

Examples

open allclose all

Basic Examples  (2)

Visualization of the sRGB color gamut:

Compare the gamut of two RGB color spaces:

Scope  (8)

Visualize the sRGB gamut in the CIE 1931 Yxy reference space:

Visualize the gamut in the CIE 1931 XYZ reference space:

Compare two gamuts in the CIE 1976 space:

Show a list of RGB colors in the RGB cube:

Visualize color regions in 3D:

Visualize the pixels of an image:

Visualize the pixels of a 3D image:

Visualize the color distribution of a graphics object:

Options  (40)

Appearance  (1)

By default, only the color space gamuts are displayed:

Also show the boundary of the visible spectrum:

Axes  (3)

By default, the box and axes are drawn:

Turn off axes:

Turn off both axes and box:

AxesLabel  (3)

By default, appropriate labels are displayed for each coordinate:

Place a label on the z axis:

Specify axes labels:

AxesOrigin  (2)

The position of the axes is determined automatically:

Specify an explicit origin for the axes:

AxesStyle  (4)

Change the style for the axes:

Specify a style for each axis:

Use different styles for the ticks and the axes:

Use different styles for the labels and the axes:

BoundaryStyle  (3)

By default, a boundary for each space is drawn:

Use thick boundary:

Specify color and style of each boundary:

BoxRatios  (1)

By default, side-length ratios of 1 are used:

Use BoxRatios->Automatic to use natural side-length ratios:

Use custom box ratios:

FillingStyle  (3)

By default, one space is fully opaque and colored:

Make the plot partially transparent:

Show just the boundaries:

Use a specific color:

With multiple spaces, by default all are partially transparent:

Individually define the appearance for each space:

If the specified list of styles is shorter than the list of color spaces, it is cyclically padded:

MaxPlotPoints  (1)

By default, the maximum number of points in the plot is limited:

Increase the limit to accommodate all points:

Mesh  (6)

By default, no mesh is displayed:

Use five mesh lines in each direction:

Show full mesh:

The resolution of the full mesh is taken from the PlotPoints option:

Show only the mesh for each space:

Use five mesh lines in each direction for every space:

Specify whether to show the mesh individually for each space:

MeshStyle  (1)

By default, the boundary style is used for mesh style:

Specify a different mesh style:

PlotLegends  (2)

By default, the legends are not shown for one color space:

Show the plot legend:

By default, the legends are shown for multiple spaces:

Turn the legends off:

PlotPoints  (1)

PlotPoints specifies the density of the grid:

PlotStyle  (1)

By default, each directive or pixel is plotted with its actual color:

Use a custom style:

PlotTheme  (3)

Use a theme with simple frame ticks in a bold color scheme:

Change the boundary styles:

Use a monochrome theme:

WhitePoint  (5)

By default, the white point is not shown:

Turn the white point on:

Show white points for multiple spaces:

Show a specific white point:

Show custom white points:

Applications  (2)

Visualize shades of green in the RGB cube:

Shades of green in the HSB cube:

ImageAdjust rescales RGB values to 0 and 1. Visualize the transformation in the Lab color space:

Properties & Relations  (2)

ProPhoto RGB is designed to cover most of the visible portion of the Lab space:

ChromaticityPlot3D can visualize symbolic color regions specified by ColorsNear:

Neat Examples  (1)

A cube portion of LCH is a cylindrical region in LAB:

Wolfram Research (2014), ChromaticityPlot3D, Wolfram Language function, https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html (updated 2019).

Text

Wolfram Research (2014), ChromaticityPlot3D, Wolfram Language function, https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html (updated 2019).

CMS

Wolfram Language. 2014. "ChromaticityPlot3D." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019. https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html.

APA

Wolfram Language. (2014). ChromaticityPlot3D. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html

BibTeX

@misc{reference.wolfram_2023_chromaticityplot3d, author="Wolfram Research", title="{ChromaticityPlot3D}", year="2019", howpublished="\url{https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html}", note=[Accessed: 09-June-2023 ]}

BibLaTeX

@online{reference.wolfram_2023_chromaticityplot3d, organization={Wolfram Research}, title={ChromaticityPlot3D}, year={2019}, url={https://reference.wolfram.com/language/ref/ChromaticityPlot3D.html}, note=[Accessed: 09-June-2023 ]}