ShowPixelValues

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
(reformat)
m (Syntax and Parameters)
Line 27: Line 27:
 
<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>
+
:<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>
 
<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.
 
::*'''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.
Line 43: Line 43:
 
::*'''ShowPixels''' - if false then it blanks underlying pixel colour to improve value clarity.
 
::*'''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:

Revision as of 21:40, 20 September 2014


Contents

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. This filter was inspired by Bordo32 over at Doom9.


It currently supports YUY2 and RGB32 colour spaces.

  • 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.

 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 = R value, 138 = G, 69 = B.

Syntax and Parameters

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.


Examples

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

LoadPlugin("ShowPixelValues.dll")
AviSource("Test.avi") ShowPixelValues()


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.


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

Personal tools