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 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:
  • AppearanceNoneappearance of the visible spectrum
    AxesTruewhether to draw axes
    AxesLabelAutomaticaxes labels
    BoundaryStyleAutomaticthe style for the boundary of each region
    BoxRatios{1,1,1}bounding 3D box ratios
    FillingStyleAutomaticfilling style for each color space
    MaxPlotPoints2000maximum number of colors or pixels to show
    MeshNonewhether to draw a mesh
    MeshStyleAutomaticthe style for mesh divisions
    PlotLegendsAutomaticlegends for each space
    PlotPointsAutomaticnumber of sample points in each dimension
    PlotStyleAutomaticspecify 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
    WhitePointAutomaticwhat 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 all close all

Basic Examples  (2)

Visualization of the sRGB color gamut:

Click for copyable input

Compare the gamut of two RGB color spaces:

Click for copyable input

Scope  (8)

Options  (30)

Applications  (2)

Properties & Relations  (2)

Neat Examples  (1)

Introduced in 2014
Updated in 2019