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:
  • Appearance Automaticappearance of the plot
    AppearanceElements Automaticelements to include in the plot
    MaskingAllthe region of interest
    MaxPlotPoints Automaticthe maximum number of samples to show
    PlotStyle Automaticthe 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: 24-March-2023 ]}


@online{reference.wolfram_2022_imagevectorscopeplot, organization={Wolfram Research}, title={ImageVectorscopePlot}, year={2020}, url={}, note=[Accessed: 24-March-2023 ]}