MatchHistogram

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
(redirect for convenient searching)
 
(MatchHistogram: add documentation)
Line 1: Line 1:
−
#REDIRECT [[External_filters#Levels_and_Chroma]]
+
{{FilterCat5|External_filters|Plugins|Plugins_x64|Adjustment_filters|Levels_and_Chroma_filters}}
−
{{FilterCat|External_filters|Adjustment_filters|Levels_and_Chroma_filters}}
+
{{Filter3
 +
|{{Author/LaTo}}, [https://github.com/dubhater Dubhater], [http://avisynth.nl/index.php/User_talk:Asd asd]
 +
|2020-04-22
 +
|3=[http://s000.tinyupload.com/index.php?file_id=95849288976593060703 MatchHistogram.7z]
 +
|4=Adjustment Filters
 +
|5=Open source
 +
|6=[https://forum.doom9.org/showthread.php?p=1729864#post1729864 Doom9 Thread]
 +
}}
 +
== Description ==
 +
MatchHistogram modifies one clip's histogram to match the histogram of another clip.
 +
 
 +
Will produce weird results if frame contents are dissimilar.
 +
 
 +
Should be used for analysis only, not for production.
 +
<br>
 +
<br>
 +
== Requirements ==
 +
* [x86]: [[AviSynth+]] or [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6]
 +
* [x64]: [[AviSynth+]]
 +
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]]
 +
<br>
 +
 
 +
== [[Script variables|Syntax and Parameters]] ==
 +
 
 +
:{{Template:FuncDef|MatchHistogram (clip clip1 , clip clip12, clip clip3, bool "raw", bool "show", bool "debug", int "smoothing_window", bool "y", bool "u", bool "v")}}
 +
<br>
 +
::{{Par2| |clip| }}
 +
:::Clip1: must have constant format and dimensions and 8 bits per sample, and it must not be RGB.
 +
<br>
 +
::{{Par2| |clip| }}
 +
:::Clip2: clip whose histogram is to be copied.
 +
:::Must have the same format and dimensions as ''clip1''.
 +
 
 +
<br>
 +
::{{Par2| |clip|clip1}}
 +
:::Clip3: clip to be modified to match ''clip2'''s histogram.
 +
:::Must have the same format as ''clip1'' and constant dimensions.
 +
:::If this parameter is not passed then ''clip1'' is used instead.
 +
:::Default: clip1
 +
<br>
 +
::{{Par2|raw|bool|false}}
 +
:::Use the raw histogram without postprocessing.
 +
<br>
 +
::{{Par2|cpu|bool|false}}
 +
:::Show calculated curve on video frame.
 +
:::This parameter has no effect when d<code>ebug=true</code>.
 +
<br>
 +
::{{Par2|debug|bool|false}}
 +
:::Return 256x256 clip with calculated data.
 +
<br>
 +
::{{Par2|smoothing_window|int|8}}
 +
:::Window used when smoothing the curve.
 +
:::A value of 0 disables the smoothing.
 +
:::This parameter has no effect when <code>raw=true</code>.
 +
<br>
 +
::{{Par2|y|bool|true}}
 +
::{{Par2|y|bool|false}}
 +
::{{Par2|y|bool|false}}
 +
:::Select which planes to process. Any unprocessed planes will be copied from the third clip.
 +
<br>
 +
 
 +
== Examples ==
 +
[[TODO]]
 +
<br>
 +
<br>
 +
== Changelog ==
 +
Version        Date            Changes
 +
                2020/04/22      - Author: asd
 +
                                - Backport VS port MatchHistogram v2 by dubhater
 +
                                - Compiled with MSVC 2019 (Clang 9).
 +
                2015/07/12      - Initial release by LaTo
 +
<br>
 +
== Archived Downloads ==
 +
{| class="wikitable" border="1"; width="600px"
 +
|-
 +
!!width="100px"| Version
 +
!!width="150px"| Download
 +
!!width="150px"| Mirror
 +
|-
 +
!2015/07/12
 +
|[http://latoninf.free.fr/d9/MatchHistogram.7z MatchHistogram.7z]
 +
|[https://web.archive.org/web/20170617113811/http://latoninf.free.fr/d9/MatchHistogram.7z MatchHistogram.7z]
 +
|}
 +
<br>
 +
 
 +
==External Links ==
 +
[https://github.com/dubhater/vapoursynth-matchhistogram GitHub] - VapourSynth port source code repository.
 +
<br>
 +
<br>
 +
-----------------------------------------------
 +
'''Back to [[External_filters#Levels_and_Chroma|External Filters]] &larr;'''

Revision as of 02:09, 25 April 2020

Abstract
Author LaTo, Dubhater, asd
Version 2020-04-22
Download MatchHistogram.7z
Category Adjustment Filters
License Open source
Discussion Doom9 Thread

Contents

 [hide] 

Description

MatchHistogram modifies one clip's histogram to match the histogram of another clip.

Will produce weird results if frame contents are dissimilar.

Should be used for analysis only, not for production.

Requirements


Syntax and Parameters

MatchHistogram (clip clip1 , clip clip12, clip clip3, bool "raw", bool "show", bool "debug", int "smoothing_window", bool "y", bool "u", bool "v")


clip   =
Clip1: must have constant format and dimensions and 8 bits per sample, and it must not be RGB.


clip   =
Clip2: clip whose histogram is to be copied.
Must have the same format and dimensions as clip1.


clip   = clip1
Clip3: clip to be modified to match clip2's histogram.
Must have the same format as clip1 and constant dimensions.
If this parameter is not passed then clip1 is used instead.
Default: clip1


bool  raw = false
Use the raw histogram without postprocessing.


bool  cpu = false
Show calculated curve on video frame.
This parameter has no effect when debug=true.


bool  debug = false
Return 256x256 clip with calculated data.


int  smoothing_window = 8
Window used when smoothing the curve.
A value of 0 disables the smoothing.
This parameter has no effect when raw=true.


bool  y = true
bool  y = false
bool  y = false
Select which planes to process. Any unprocessed planes will be copied from the third clip.


Examples

TODO

Changelog 

Version         Date            Changes
                2020/04/22      - Author: asd
                                - Backport VS port MatchHistogram v2 by dubhater
                                - Compiled with MSVC 2019 (Clang 9).
                2015/07/12      - Initial release by LaTo


Archived Downloads

Version Download Mirror
2015/07/12 MatchHistogram.7z MatchHistogram.7z


External Links

GitHub - VapourSynth port source code repository.

Back to External Filters ←

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