plots the chrominance of image.

Details and Options

  • ImageVectorscopePlot is typically used to measure and adjust the hue and saturation of colors of an image or frames of a video.
  • Pixels are plotted in the YCbCr space, derived from the RGB space using the following transformation:
  • Coefficients , , are equal to the component of the XYZ representation of red, green and blue color primaries, respectively.
  • ImageVectorscopePlot has the same options as Graphics, with the following additions and changes:
  • AppearanceAutomaticappearance of the plot
    AppearanceElementsAutomaticelements to include in the plot
    MaskingAllthe region of interest
    MaxPlotPointsAutomaticthe maximum number of samples to show
    PlotStyleAutomaticthe styles in which objects are to be drawn
  • Possible settings for the Appearance option include:
  • Automaticplots solid color points
    "Color"the points keep their original colors
  • Possible settings for the AppearanceElements option include:
  • "SafeTargets"target showing the RGB corners at 75% saturation
    "SkinToneAxis"axes along and perpendicular to the skin hue
    "TargetNames"target labels
    "Targets"target showing the RGB corners
  • Additional settings include:
  • "Circle"max CbCr saturation
    "GamutLimit"max saturation at a given hue
    "Ticks"ticks on the max saturation circle
    {elem,f}the specified elem at a fraction f of the max saturation
  • By default, using AppearanceElementsAutomatic, "Targets", "TargetNames" and {"GamutLimit",.75} are displayed.


open allclose all

Basic Examples  (2)

Vectorscope of an image:

Vectorscope of a frame from a video:

Show the color vectorscope:

Scope  (2)

Plot colors of an image on a vectorscope:

A color vectorscope plot:

Plot a set of colors on a vectorscope:

Plot a set with constant saturation:

Plot a set of colors with constant hue:

Options  (7)

Appearance  (1)

By default, pixels are drawn in a solid color:

Use Appearance"Color" to draw pixels using their original color:

AppearanceElements  (3)

By default, a gamut limit and location of reference colors are displayed:

Specify elements to be displayed:

Use AppearanceElementsAll to display all available elements:

MaxPlotPoints  (1)

Control the maximum number of points to plot:

PlotStyle  (2)

Use PlotStyle to control the style of the displayed points:

Multiple graphic directives can be combined:

Applications  (4)

Vectorscope of an image of a person, where skin tones align with the guide:

Frame-by-frame vectorscope of a list of frames:

Vectorscope of color bars:

Dynamically adjust the chromaticity to make a reference spot a neutral white:

Interactive Examples  (1)

Dynamic vectorscope of the current captured frame:

Neat Examples  (1)

Build an analog-looking vectorscope:

Wolfram Research (2020), ImageVectorscopePlot, Wolfram Language function,


Wolfram Research (2020), ImageVectorscopePlot, Wolfram Language function,


Wolfram Language. 2020. "ImageVectorscopePlot." Wolfram Language & System Documentation Center. Wolfram Research.


Wolfram Language. (2020). ImageVectorscopePlot. Wolfram Language & System Documentation Center. Retrieved from


@misc{reference.wolfram_2022_imagevectorscopeplot, author="Wolfram Research", title="{ImageVectorscopePlot}", year="2020", howpublished="\url{}", note=[Accessed: 02-December-2022 ]}


@online{reference.wolfram_2022_imagevectorscopeplot, organization={Wolfram Research}, title={ImageVectorscopePlot}, year={2020}, url={}, note=[Accessed: 02-December-2022 ]}