Reel.Deal: ColorDiff

2020-06-30T17:43:29Z

ColorDiff

New page

{{FilterCat|External_filters|Plugins|Debugging/Diagnostic_filters}}
{{Filter3
|1=[https://github.com/ignus2 Ignus2]
|2=26th May 2007
|3=[https://forum.doom9.org/attachment.php?attachmentid=7811&d=1196110203 colordiff.zip]
|4=Debug filter
|5=[http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|6=[http://forum.doom9.org/showthread.php?t=116949 Doom9 Forum]
}}

== Description ==
[[ColorDiff]] makes a greyscale (Y8) frame according to the input frame's pixels' "distance" from a specified color. The diff is calculated by simply getting the diff of the individual color components from the desired color's components and summing them up. Also, weights can be set for the individual diffs. It can work in YUV, RGB and HSL ([http://en.wikipedia.org/wiki/HSL_color_space wikipedia]) mode. The resulting Y8 frame is greyscale. It's a kind of MaskHS() in a non-binary (greyscale) way.

'''Note:''' [[ColorDiff]] is a C-plugin so it must be loaded using [[Plugins#LoadCPlugin|LoadCPlugin]], except if you're using AviSynth+, it allows autoloading of C-plugins.
 
 
== Requirements ==
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.5.8 or greater]
* Supported color formats: [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]

 

== [[Script variables|Syntax and Parameters]] ==
<pre>
ColorDiff(clip, int "c1", int "c2", int "c3", float "w1", float "w2", float "w3", int "threshold", string "colorspace")

clip clip: input clip, can be YUY2 or YV12 for "YUV" colorspace, or RGB for "RGB" or "HSL" colorspace
int c1 (range: [0-255] for Y, [0-360] for H): desired color component 1 (Y, R, H)
int c2 (range: [0-255]): desired color component 2 (U, G, S)
int c2 (range: [0-255]): desired color component 3 (V, B, L)
float w1 (default: 1.0): weight of color component 1
float w2 (default: 1.0): weight of color component 2
float w3 (default: 1.0): weight of color component 3
int threshold: if calculated distance > threshold then result will be black.
Otherwise result will be white.
-1 means don't use thresholding, result will be the calculated diff value,
clamped to 255, then inverted (substracted from 255).
string colorspace: the colorspace used to calculate the distance. Can be "YUV", "RGB" or "HSL".
The desired color components (c1, c2, c3) must also be given in this colorspace.

output: Y8 greyscale (or binary) mask

Notes:
------
HSL values are calculated from RGB according to http://en.wikipedia.org/wiki/HSL_color_space
</pre>
 
== Examples ==
FFImageSource("linuXP.jpg")
ConvertToYUY2()
ColorDiff(c1=100, c2=100, c3=100, w1=2.0, w2=2.0, w3=2.0, colorspace="YUV")
 
== Changelog ==
Version Date Changes 
2007/05/26 - latest release
2007/05/09 - initial release
 
== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!2007/05/26
|[https://forum.doom9.org/attachment.php?attachmentid=7811&d=1196110203 colordiff.zip]
|[https://web.archive.org/web/20200630174022if_/https://files.videohelp.com/u/223002/colordiff.zip colordiff.zip]
|}
 
==External Links ==
 
 
-----------------------------------------------
'''Back to [[External_filters#Debugging.2FDiagnostic_Filters|External Filters]] ←'''

ColorDiff - Revision history

Reel.Deal: ColorDiff