returns a 3D gamut of the color space colspace.


plots the specific color.


plots the pixels of image as individual colors.


plots multiple colors, color spaces and images.


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
    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
    "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


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, (updated 2019).


Wolfram Research (2014), ChromaticityPlot3D, Wolfram Language function, (updated 2019).


Wolfram Language. 2014. "ChromaticityPlot3D." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2019.


Wolfram Language. (2014). ChromaticityPlot3D. Wolfram Language & System Documentation Center. Retrieved from


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


@online{reference.wolfram_2023_chromaticityplot3d, organization={Wolfram Research}, title={ChromaticityPlot3D}, year={2019}, url={}, note=[Accessed: 09-June-2023 ]}