ShowPixelValues
From Avisynth wiki
(Difference between revisions)
(Page was very messy.) |
(reformat) |
||
| Line 1: | Line 1: | ||
| − | |||
| − | |||
| − | |||
*Official homepage and documentation: [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/showpixelvalues.html showpixelvalues.html] | *Official homepage and documentation: [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/showpixelvalues.html showpixelvalues.html] | ||
| − | *'''Download:''' [http://web.archive.org/web/20091028122947/http://geocities.com/siwalters_uk/showpixelvalues1.4c.zip showpixelvalues1.4c.zip] | + | *'''Download:''' [http://web.archive.org/web/20091028122947/http://geocities.com/siwalters_uk/showpixelvalues1.4c.zip '''showpixelvalues1.4c.zip'''] |
*Discussion: [http://forum.doom9.org/showthread.php?t=64192 Doom9 Thread] | *Discussion: [http://forum.doom9.org/showthread.php?t=64192 Doom9 Thread] | ||
| + | <br> | ||
| + | == 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 [[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> | ||
| + | == [[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> | ||
| + | <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. | ||
| + | |||
| + | ::*'''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. | ||
| + | <br> | ||
| + | ==Examples== | ||
| + | Show the pixel values at the top left of the frame: | ||
| + | [[LoadPlugin]]("ShowPixelValues.dll")<br> | ||
| + | [[AviSource]]("Test.avi") | ||
| + | ShowPixelValues() | ||
| + | |||
| + | |||
| + | == Version History == | ||
| + | |||
| + | <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. | ||
| + | |||
| + | 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.</pre> | ||
| + | <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. | ||
| + | |||
| + | Please email me if you have any queries/comments/ideas/bug reports | ||
| + | |||
| + | Copyright Simon Walters siwalters@hotmail.com | ||
| + | |||
{{FilterCat4|External_filters|Plugins|Other_filters|Debugging/Diagnostic_filters}} | {{FilterCat4|External_filters|Plugins|Other_filters|Debugging/Diagnostic_filters}} | ||
Revision as of 21:37, 20 September 2014
- Official homepage and documentation: showpixelvalues.html
- Download: showpixelvalues1.4c.zip
- Discussion: Doom9 Thread
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 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.
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
