ShowPixelValues

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
m (1 revision)
(reformat)
 
(3 intermediate revisions by one user not shown)
Line 1: Line 1:
−
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.
+
{{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]}}
  
−
It currently supports YUY2 and RGB32 colour spaces.
+
== 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]
 +
<br>
 +
<br>
 +
== Requirements ==
 +
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
 +
* Supported color formats: [[RGB32]], [[YUY2]]
 +
<br>
 +
== [[Script variables|Syntax and Parameters]] ==
 +
:{{Template:FuncDef|ShowPixelValues (clip, int "Left", int "Top", bool "ShowValues", bool "ShowArea", int "Bright", int "Dim", int "Threshold", bool "ShowPixels")}}
 +
<br>
 +
::{{Par2| |clip| }}
 +
:::Input clip.
 +
<br>
 +
::{{Par2|Left|int|0}}
 +
::{{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.
 +
<br>
 +
::{{Par2|ShowValues|bool|true}}
 +
:::'''ShowValues''' determines whether the pixel values are displayed.
 +
<br>
 +
::{{Par2|ShowArea|bool|false}}
 +
:::'''ShowArea''' highlights the area that is magnified by drawing a border around it.
 +
<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>
 +
==Examples==
 +
Show the pixel values at the top left of the frame:
 +
[[LoadPlugin]]("ShowPixelValues.dll")<br>
 +
[[AviSource]]("Test.avi")
 +
ShowPixelValues()
  
−
To examine RGB24, simple use ConvertToRGB32 before this filter.
+
* 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/>
  
−
To examine YV12, use ConvertToYUY2 before this filter but BEWARE YV12/YUY2 INTERLACING/PROGRESSIVE CONVERSION ISSUES!
+
*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 ==
  
−
In YUY2 mode the filter outputs pairs of magnified pixels with their Y U and V values e.g.
+
<pre>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.
  
−
[[19]]  18
+
xx yyyy 200z V1.4 - Can't Remember
  
−
128  131
+
3rd November 2003 - V1.3 Added underlining to Y1 value in YUY2 mode.
  
−
where 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.
+
1st November 2003 - Added ability to alter brightness of displayed pixel values
  
−
In RGB32 mode the filter outputs each magnified pixel with their R G and B values in their respective colours e.g.
+
31st October 2003 - Added ability to display RGB32.
  
−
74
+
30th October 2003 - 1st release.</pre>
−
138
+
<br>
−
69
+
== 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>
 +
==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.
  
−
where 74 = R value, 138 = G, 69 = B.
+
Please email me if you have any queries/comments/ideas/bug reports
  
−
Example Avisynth Syntax
+
Copyright Simon Walters siwalters@hotmail.com
−
 
+
<br>
−
LoadPlugin("ShowPixelValues.dll")
+
<br>
−
AVISource("Test.avi")
+
==External Links ==
−
ShowPixelValues()
+
<br>
−
# Show the pixel values at the top left of the frame
+
<br>
−
 
+
-----------------------------------------------
−
The full parameter list is
+
'''Back to [[External_filters#Debugging.2FDiagnostic_Filters|External Filters]] &larr;'''
−
 
+
−
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])
+
−
 
+
−
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.
+
−
 
+
−
ShowValues determines whether the pixel values are displayed.
+
−
 
+
−
ShowArea highlights the area that is magnified by drawing a border around it.
+
−
 
+
−
Bright (0-255) - Normal brightness of displayed pixel values.
+
−
 
+
−
Dim (0-255) - Brightness value used in light areas.
+
−
 
+
−
Threshold (0-255) - Threshold for determining light/normal areas.
+
−
 
+
−
ShowPixels - if false then it blanks underlying pixel colour to improve value clarity.
+
−
 
+
−
Discussion + download: http://forum.doom9.org/showthread.php?t=64192
+
−
 
+
−
{{FilterCat|Plugins|External_filters|Other_filters|Debugging/Diagnostic_filters}}
+

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 ←

Retrieved from "http://avisynth.nl/index.php?title=ShowPixelValues&oldid=6064"
Personal tools