ImageVectorscopePlot
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: [List of all options]
-
Appearance Automatic appearance of the plot AppearanceElements Automatic elements to include in the plot Masking All the region of interest MaxPlotPoints Automatic the maximum number of samples to show PlotStyle Automatic the styles in which objects are to be drawn - Possible settings for the Appearance option include:
-
Automatic plots 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.
-
AlignmentPoint Center the default point in the graphic to align with AspectRatio Automatic ratio of height to width Axes False whether to draw axes AxesLabel None axes labels AxesOrigin Automatic where axes should cross AxesStyle {} style specifications for the axes Background None background color for the plot BaselinePosition Automatic how to align with a surrounding text baseline BaseStyle {} base style specifications for the graphic ContentSelectable Automatic whether to allow contents to be selected CoordinatesToolOptions Automatic detailed behavior of the coordinates tool Epilog {} primitives rendered after the main plot FormatType TraditionalForm the default format type for text Frame False whether to put a frame around the plot FrameLabel None frame labels FrameStyle {} style specifications for the frame FrameTicks Automatic frame ticks FrameTicksStyle {} style specifications for frame ticks GridLines None grid lines to draw GridLinesStyle {} style specifications for grid lines ImageMargins 0. the margins to leave around the graphic ImagePadding All what extra padding to allow for labels etc. ImageSize Automatic the absolute size at which to render the graphic LabelStyle {} style specifications for labels Method Automatic details of graphics methods to use PlotLabel None an overall label for the plot PlotRange All range of values to include PlotRangeClipping False whether to clip at the plot range PlotRangePadding Automatic how much to pad the range of values PlotRegion Automatic the final display region to be filled PreserveImageOptions Automatic whether to preserve image options when displaying new versions of the same graphic Prolog {} primitives rendered before the main plot RotateLabel True whether to rotate y labels on the frame Ticks Automatic axes ticks TicksStyle {} style specifications for axes ticks Appearance Automatic appearance of the plot AppearanceElements Automatic elements to include in the plot Masking All the region of interest MaxPlotPoints Automatic the maximum number of samples to show PlotStyle Automatic the styles in which objects are to be drawn
List of all options
Examples
open allclose allBasic Examples (2)Summary of the most common use cases
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-76pbnd
Out[1]=1
Vectorscope of a frame from a video:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-kyqg27
Out[1]=1
In[2]:=2
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-pbvehl
Out[2]=2
In[3]:=3
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-25c16w
Out[3]=3
Scope (2)Survey of the scope of standard use cases
Plot colors of an image on a vectorscope:
In[2]:=2
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-8sxnte
Out[2]=2
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-wsqcze
Out[1]=1
Plot a set of colors on a vectorscope:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-xx9at7
Out[1]=1
Plot a set with constant saturation:
In[2]:=2
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-fq3qyq
Out[2]=2
Plot a set of colors with constant hue:
In[3]:=3
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-scdbfk
Out[3]=3
Options (7)Common values & functionality for each option
Appearance (1)
By default, pixels are drawn in a solid color:
In[3]:=3
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-k24gpe
Out[3]=3
Use Appearance"Color" to draw pixels using their original color:
In[2]:=2
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-irrlaa
Out[2]=2
AppearanceElements (3)
By default, a gamut limit and location of reference colors are displayed:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-mu8j0k
Out[1]=1
Specify elements to be displayed:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-dhn182
Out[1]=1
Use AppearanceElementsAll to display all available elements:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-nxtf1v
Out[1]=1
MaxPlotPoints (1)
PlotStyle (2)
Use PlotStyle to control the style of the displayed points:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-e2frdd
Out[1]=1
Multiple graphic directives can be combined:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-skft33
Out[1]=1
Applications (4)Sample problems that can be solved with this function
Vectorscope of an image of a person, where skin tones align with the guide:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-15naaq
Out[1]=1
Frame-by-frame vectorscope of a list of frames:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-jhvguq
Out[1]=1
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-nufqp3
Out[1]=1
Dynamically adjust the chromaticity to make a reference spot a neutral white:
In[1]:=1
✖
https://wolfram.com/xid/0pnfu2432zg3h5z2-njza7x
Out[1]=1
Interactive Examples (1)Examples with interactive outputs
Wolfram Research (2020), ImageVectorscopePlot, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageVectorscopePlot.html.
✖
Wolfram Research (2020), ImageVectorscopePlot, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageVectorscopePlot.html.Text
Wolfram Research (2020), ImageVectorscopePlot, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageVectorscopePlot.html.
✖
Wolfram Research (2020), ImageVectorscopePlot, Wolfram Language function, https://reference.wolfram.com/language/ref/ImageVectorscopePlot.html.CMS
Wolfram Language. 2020. "ImageVectorscopePlot." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ImageVectorscopePlot.html.
✖
Wolfram Language. 2020. "ImageVectorscopePlot." Wolfram Language & System Documentation Center. Wolfram Research. https://reference.wolfram.com/language/ref/ImageVectorscopePlot.html.APA
Wolfram Language. (2020). ImageVectorscopePlot. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ImageVectorscopePlot.html
✖
Wolfram Language. (2020). ImageVectorscopePlot. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/ImageVectorscopePlot.htmlBibTeX
✖
@misc{reference.wolfram_2025_imagevectorscopeplot, author="Wolfram Research", title="{ImageVectorscopePlot}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/ImageVectorscopePlot.html}", note=[Accessed: 02-June-2025
]}BibLaTeX
✖
@online{reference.wolfram_2025_imagevectorscopeplot, organization={Wolfram Research}, title={ImageVectorscopePlot}, year={2020}, url={https://reference.wolfram.com/language/ref/ImageVectorscopePlot.html}, note=[Accessed: 02-June-2025
]}