View source for ColorDiff

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


<span style="color:red">'''Note:'''</span> [[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.
<br>
<br>
== Requirements ==
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.5.8 or greater]
* Supported color formats: [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]

<br>

== [[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>
<br>
== Examples ==
 FFImageSource("linuXP.jpg")
 ConvertToYUY2()
 ColorDiff(c1=100, c2=100, c3=100, w1=2.0, w2=2.0, w3=2.0, colorspace="YUV")
<br>
== Changelog ==
 Version      Date            Changes<br>
              2007/05/26      - latest release
              2007/05/09      - initial release
<br>
== 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]
|}
<br>
==External Links ==
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Debugging.2FDiagnostic_Filters|External Filters]] &larr;'''