From Avisynth wiki
Jump to: navigation, search
Author Randy French, Wilbert Dijkhof
Version v1.2.1
Category Levels and Chroma
License GPLv2
Discussion Doom9 Thread


[edit] Description

You can think of VideoScope as a 'super' histograph. Instead of drawing a histograph for the entire frame, it draws one for each line (side), or each column (bottom).

[edit] Requirements

[edit] Syntax and Parameters

VideoScope (clip, string "DrawMode", bool "TickMarks", string "HistoTypeSide", string "HistoTypeBottom", string "FrameType")

clip   =
Input clip must be YUY2.

string  DrawMode = "both"
DrawMode: can be "side", "bottom", or "both".

bool  TickMarks = true
TickMarks: true or false.

string  HistoTypeSide = "Y"
string  HistoTypeBottom = "Y"
HistoTypeSide / HistoTypeBottom: "Y", "U", "V", "UV", or "YUV".

string  FrameType = "blank"
FrameType: "blank", "colormap", "Y", "U", "V", "UV"

[edit] Examples

As an example lets say you used the command:

VideoScope(DrawMode="bottom", TickMarks=true, HistoTypeSide="Y", HistoTypeBottom="Y", FrameType="Y")

You will see the graph below the picture. The vertical position on the graph shows the Y-value (brightness) of the pixels in the picture. The brightness of the pixels in the graph show how many pixels had that Y-value. If only one pixel has that value then it will be dim (but still visible). If many pixels have that value it will be bright white. The graph is 256 pixels tall since there are 256 possible Y-values.

  • You can use the tickmarks to get a pretty exact reading of the Y-values.
  • The blue ticks are 0-63 and 128-191.
  • The brown ticks are 64-127 and 192-255.
  • The widely spaced vertical ticks are 16 apart.
  • The closer spaced ticks are 8 apart.
  • the triple ticks are 4 apart.

VideoScope(DrawMode="both", TickMarks=false, HistoTypeSide="Y", HistoTypeBottom="Y", FrameType="Y")

In the bottom right corner is the full-frame histogram. It is similar to the histogram in VirtualDub. However it uses linear scaling whereas VirtualDub seems to use a logarithmic scale.

VideoScope(DrawMode="both", TickMarks=true, HistoTypeSide="U", HistoTypeBottom="V", FrameType="UV")
  • The side (purple) graph shows the U-value.
  • The bottom (green) graph shows the V-value.
  • The interesting full-frame display is the UV map. The background color is the same as 'colormap' It shows the full UV range.
  • Y is held constant at 128.
  • V is vertical (0-255 from bottom to top).
  • U is horizontal (0-255 from left to right).
  • The crosshair represents the neutral (grey) 128,128 value.
  • The UV values of all the pixels are mapped to the graph. If just one pixel has a particular UV value, it will show as a black dot. If many pixels have that value it will become brighter.

[edit] Changelog

Version      Date            Changes
v1.2.1 2022/04/15 - Converted to AviSynth+ / AviSynth 2.6 plugin - Added support for frame properties passthrough. - Added resource file - x86/x64 plugins compiled with MSVC 2019
v1.2 2004/05/14 - compiled for AviSynth v2.5 and removed the ShowDelta and StackVert functions (Wilbert Dijkhof).
v1.1 2001/10/23 - original version (by Randy French)

[edit] Archived Downloads

Version Download Mirror

[edit] External Links

Back to External Filters

Personal tools