View source for VideoScope

{{FilterCat5|External_filters|Plugins|Plugins_x64|Adjustment_filters|Levels and Chroma filters}}
{{Filter3
|{{Author/Randy French}}, {{Author/Wilbert Dijkhof}}
|v1.2.1
|[https://github.com/Reel-Deal/AviSynth-VideoScope/releases VideoScope-v1.2.1.zip]
|Levels and Chroma
|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|6=[http://forum.doom9.org/showthread.php?t=76238 Doom9 Thread]}}
<br>
== Description ==
You can think of {{Template:FuncDef3|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).
<br>
<br>
== Requirements ==
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
* [x64]: [[AviSynth+]]
* Supported color formats: [[YUY2]]
<br>
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|VideoScope (clip, string "DrawMode", bool "TickMarks", string "HistoTypeSide", string "HistoTypeBottom", string "FrameType")}}
<br>
::{{Par2| |clip| }}
:::Input clip must be YUY2.
<br>
::{{Par2|DrawMode|string|"both"}}
:::{{Template:FuncDef3|DrawMode}}: can be <tt>"side", "bottom", or "both"</tt>.
<br>
::{{Par2|TickMarks|bool|true}}
:::{{Template:FuncDef3|TickMarks}}: true or false.
<br>
::{{Par2|HistoTypeSide|string|"Y"}}
::{{Par2|HistoTypeBottom|string|"Y"}}
:::{{Template:FuncDef3|HistoTypeSide}} / {{Template:FuncDef3|HistoTypeBottom}}: <tt>"Y", "U", "V", "UV",</tt> or <tt>"YUV"</tt>.
<br>
::{{Par2|FrameType|string|"blank"}}
:::{{Template:FuncDef3|FrameType}}: <tt>"blank", "colormap", "Y", "U", "V", "UV"</tt>
<br>
== 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.
<br>
== Changelog ==
 Version      Date            Changes<br>
 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<br>
 v1.2         2004/05/14      - compiled for AviSynth v2.5 and removed the ShowDelta and StackVert functions (Wilbert Dijkhof).<br>
 v1.1         2001/10/23      - original version (by Randy French)
<br>
== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v1.2
|[http://www.wilbertdijkhof.com/VScope12.zip VScope12.zip]
|[http://web.archive.org/web/20131210033035/http://www.wilbertdijkhof.com/VScope12.zip VScope12.zip]
|-
!v1.1
|[http://www.videotools.net/bin/VScope11.zip VScope11.zip]
|[http://web.archive.org/web/20131206213046/http://www.videotools.net/bin/VScope11.zip VScope11.zip]
|}
<br>

==External Links ==
* [https://github.com/Reel-Deal/AviSynth-VideoScope GitHub] - Source code repository
*[http://avisynth.org.ru/docs/english/externalfilters/vscope.htm avisynth.org.ru] - VideoScope documentation.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] &larr;'''