ShowPixelValues

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m (Syntax and Parameters)
(reformat)
 
Line 1: Line 1:
*Official homepage and documentation: [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/showpixelvalues.html showpixelvalues.html]
+
{{FilterCat4|External_filters|Plugins|Other_filters|Debugging/Diagnostic_filters}}
 +
{{Filter3
 +
| {{Author/Simon Walters}}
 +
| v1.4c
 +
| 3=[http://web.archive.org/web/20091028122947/http://geocities.com/siwalters_uk/showpixelvalues1.4c.zip showpixelvalues1.4c.zip]
 +
| 4=Debug filter
 +
| 5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
 +
| 6=[http://forum.doom9.org/showthread.php?t=64192 Doom9 Thread]}}
  
*'''Download:''' [http://web.archive.org/web/20091028122947/http://geocities.com/siwalters_uk/showpixelvalues1.4c.zip '''showpixelvalues1.4c.zip''']
+
== Description ==
 
+
This diagnostic filter displays the actual Y U and V (or R G and B) values from pixels within a frame. This can be useful in determining levels or seeing how another filter changes actual pixel values. See official documentation: [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/showpixelvalues.html showpixelvalues.html]
*Discussion: [http://forum.doom9.org/showthread.php?t=64192 Doom9 Thread]
+
 
<br>
 
<br>
== Description ==
+
<br>
This diagnostic filter displays the actual Y U and V (or R G and B) values from pixels within a frame. This can be useful in determining levels or seeing how another filter changes actual pixel values. This filter was inspired by Bordo32 over at Doom9.
+
== Requirements ==
 
+
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
 
+
* Supported color formats: [[RGB32]], [[YUY2]]
It currently supports YUY2 and RGB32 colour spaces.
+
 
+
*To examine [[RGB24]], simple use [[ConvertToRGB32]] before this filter.
+
 
+
*To examine [[YV12]], use [[ConvertToYUY2]] before this filter but BEWARE YV12/YUY2 INTERLACING/PROGRESSIVE CONVERSION ISSUES!
+
 
+
In [[YUY2]] mode the filter outputs pairs of magnified pixels with their Y U and V values e.g.
+
<blockquote style="width: 6%;"><pre> 19  18
+
---
+
128  131</pre></blockquote>
+
here 19 = Y1 value, 18 = Y2 value, 128 = U, 131 = V. (if this seems strange it is because each pair of Y value shares its U and V values with each other in [[YUY2]] colourspace). The Y1 value is underlined to make it a bit more obvious which value is which.<br/>
+
In [RGB32]] mode the filter outputs each magnified pixel with their R G and B values in their respective colours e.g.
+
<blockquote style="width: 6%;"><pre>74
+
138
+
69</pre></blockquote>
+
Where 74 = R value, 138 = G, 69 = B.<br/>
+
 
<br>
 
<br>
 
== [[Script variables|Syntax and Parameters]] ==
 
== [[Script variables|Syntax and Parameters]] ==
:<code>'''ShowPixelValues''' (clip clip[, int Left default=0] [, int Top default=0 ][,bool ShowValues default=true][ , bool ShowArea default=false][, int Bright default=235][, int Dim default=160][,int Threshold default=200][,bool ShowPixels default=true])</code>
+
:{{Template:FuncDef|ShowPixelValues (clip, int "Left", int "Top", bool "ShowValues", bool "ShowArea", int "Bright", int "Dim", int "Threshold", bool "ShowPixels")}}
 
<br>
 
<br>
::*'''Left''' and '''Top''' dictate what part of the frame will be expanded to examine. Left is always adjusted to be an even value. Left and Top are limited to maximum values to prevent trying to magnify an area not in the frame.
+
::{{Par2| |clip| }}
 
+
:::Input clip.
::*'''ShowValues''' determines whether the pixel values are displayed.
+
<br>
 
+
::{{Par2|Left|int|0}}
::*'''ShowArea''' highlights the area that is magnified by drawing a border around it.
+
::{{Par2|Top|int|0}}
 
+
:::'''Left''' and '''Top''' dictate what part of the frame will be expanded to examine. Left is always adjusted to be an even value. Left and Top are limited to maximum values to prevent trying to magnify an area not in the frame.
::*'''Bright''' (0-255) - Normal brightness of displayed pixel values.
+
<br>
 
+
::{{Par2|ShowValues|bool|true}}
::*'''Dim''' (0-255) - Brightness value used in light areas.
+
:::'''ShowValues''' determines whether the pixel values are displayed.
 
+
<br>
::*'''Threshold''' (0-255) - Threshold for determining light/normal areas.
+
::{{Par2|ShowArea|bool|false}}
 
+
:::'''ShowArea''' highlights the area that is magnified by drawing a border around it.
::*'''ShowPixels''' - if false then it blanks underlying pixel colour to improve value clarity.
+
<br>
 +
::{{Par2|Bright|int|235}}
 +
:::'''Bright''' (0-255) - Normal brightness of displayed pixel values.
 +
<br>
 +
::{{Par2|Dim|int|160}}
 +
:::'''Dim''' (0-255) - Brightness value used in light areas.
 +
<br>
 +
::{{Par2|Threshold|int|200}}
 +
:::'''Threshold''' (0-255) - Threshold for determining light/normal areas.
 +
<br>
 +
::{{Par2|ShowPixels|bool|true}}
 +
:::'''ShowPixels''' - if false then it blanks underlying pixel colour to improve value clarity.
 
<br>
 
<br>
 
 
==Examples==
 
==Examples==
 
Show the pixel values at the top left of the frame:
 
Show the pixel values at the top left of the frame:
Line 50: Line 50:
 
  ShowPixelValues()
 
  ShowPixelValues()
  
 +
* In [[YUY2]] mode the filter outputs pairs of magnified pixels with their Y U and V values e.g.<br><code><u>19</u> 18<br>128 131</code><br> Here 19 = Y1 value, 18 = Y2 value, 128 = U, 131 = V. (if this seems strange it is because each pair of Y value shares its U and V values with each other in [[YUY2]] colourspace). The Y1 value is underlined to make it a bit more obvious which value is which.<br/>
  
 +
*In [[RGB32]] mode the filter outputs each magnified pixel with their R G and B values in their respective colours e.g.<br><code>74<br>138<br>69</code><br>Where 74 = Red value, 138 = Green, 69 = Blue.<br/>
 +
<br>
 
== Version History ==
 
== Version History ==
  
Line 65: Line 68:
  
 
30th October 2003 - 1st release.</pre>
 
30th October 2003 - 1st release.</pre>
 +
<br>
 +
== Archived Downloads ==
 +
{| class="wikitable" border="1"; width="600px"
 +
|-
 +
!!width="100px"| Version
 +
!!width="150px"| Download
 +
!!width="150px"| Mirror
 +
|-
 +
!v1.4c
 +
|[http://web.archive.org/web/20091028122947/http://geocities.com/siwalters_uk/showpixelvalues1.4c.zip showpixelvalues1.4c.zip]
 +
|[http://www.oocities.org/siwalters_uk/showpixelvalues1.4c.zip showpixelvalues1.4c.zip]
 +
|}
 
<br>
 
<br>
 
==Source Code==
 
==Source Code==
Line 72: Line 87:
  
 
Copyright Simon Walters siwalters@hotmail.com
 
Copyright Simon Walters siwalters@hotmail.com
 
+
<br>
 
+
<br>
 
+
==External Links ==
{{FilterCat4|External_filters|Plugins|Other_filters|Debugging/Diagnostic_filters}}
+
<br>
 +
<br>
 +
-----------------------------------------------
 +
'''Back to [[External_filters#Debugging.2FDiagnostic_Filters|External Filters]] &larr;'''

Latest revision as of 19:01, 14 September 2015

Abstract
Author Simon Walters
Version v1.4c
Download showpixelvalues1.4c.zip
Category Debug filter
License GPLv2
Discussion Doom9 Thread

Contents

[edit] Description

This diagnostic filter displays the actual Y U and V (or R G and B) values from pixels within a frame. This can be useful in determining levels or seeing how another filter changes actual pixel values. See official documentation: showpixelvalues.html

[edit] Requirements


[edit] Syntax and Parameters

ShowPixelValues (clip, int "Left", int "Top", bool "ShowValues", bool "ShowArea", int "Bright", int "Dim", int "Threshold", bool "ShowPixels")


clip   =
Input clip.


int  Left = 0
int  Top = 0
Left and Top dictate what part of the frame will be expanded to examine. Left is always adjusted to be an even value. Left and Top are limited to maximum values to prevent trying to magnify an area not in the frame.


bool  ShowValues = true
ShowValues determines whether the pixel values are displayed.


bool  ShowArea = false
ShowArea highlights the area that is magnified by drawing a border around it.


int  Bright = 235
Bright (0-255) - Normal brightness of displayed pixel values.


int  Dim = 160
Dim (0-255) - Brightness value used in light areas.


int  Threshold = 200
Threshold (0-255) - Threshold for determining light/normal areas.


bool  ShowPixels = true
ShowPixels - if false then it blanks underlying pixel colour to improve value clarity.


[edit] Examples

Show the pixel values at the top left of the frame:

LoadPlugin("ShowPixelValues.dll")
AviSource("Test.avi") ShowPixelValues()
  • In YUY2 mode the filter outputs pairs of magnified pixels with their Y U and V values e.g.
    19 18
    128 131

    Here 19 = Y1 value, 18 = Y2 value, 128 = U, 131 = V. (if this seems strange it is because each pair of Y value shares its U and V values with each other in YUY2 colourspace). The Y1 value is underlined to make it a bit more obvious which value is which.
  • In RGB32 mode the filter outputs each magnified pixel with their R G and B values in their respective colours e.g.
    74
    138
    69

    Where 74 = Red value, 138 = Green, 69 = Blue.


[edit] Version History

6th January  2006 - V1.4c Fixed crashes caused by non mod 16 image sizes, reduced inconsistencies between 
                    RBG/YU2 modes and reduced size of some characters used in font to improve clarity.

xx yyyy 200z V1.4 - Can't Remember

3rd November 2003 - V1.3 Added underlining to Y1 value in YUY2 mode.

1st November 2003 - Added ability to alter brightness of displayed pixel values

31st October 2003 - Added ability to display RGB32.

30th October 2003 - 1st release.


[edit] Archived Downloads

Version Download Mirror
v1.4c showpixelvalues1.4c.zip showpixelvalues1.4c.zip


[edit] Source Code

All source code here is provided under the GPL license. This means you are free to use and distribute the software and program code for no fee. This also means you are free and encouraged to improve and expand upon the source code, but only as long as you make your modified version also under the GPL, and thus free software with access to the source code for anyone. The source code compiles under Visual C++ 2005. If there is a problem with the source code distribution, please do let me know.

Please email me if you have any queries/comments/ideas/bug reports

Copyright Simon Walters siwalters@hotmail.com

[edit] External Links




Back to External Filters

Personal tools