MTCombMask

From Avisynth wiki
(Difference between revisions)
Jump to: navigation, search
(MTCombMask: add documentation)
 
(v2.2.1)
 
(6 intermediate revisions by one user not shown)
Line 1: Line 1:
−
{{FilterCat5|External_filters|Plugins|Plugins_x64|Adjustment_filters|Masking}}
+
{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Masking|Deep_color_tools}}
 
{{Filter3
 
{{Filter3
−
| {{Author/Manao}}, [https://github.com/Asd-g Asd-g]
+
| {{Author/Manao}}, {{Author/Asd-g}}
−
| v2.0.0
+
| v2.2.1
−
|[https://github.com/Asd-g/MTCombMask/releases MTCombMask-2.0.0.7z]
+
|[https://github.com/Asd-g/MTCombMask/releases MTCombMask-2.2.1.7z]
 
| Masking
 
| Masking
 
| [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
 
| [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
Line 16: Line 16:
  
 
* Chroma could be filtered;
 
* Chroma could be filtered;
 +
* Y/YUV(A) 8..32-bit clips are accepted;
 
* All planar Y/YUV 8-bit clips are accepted;
 
* All planar Y/YUV 8-bit clips are accepted;
 
* Support for AviSynth+'s v8 interface;
 
* Support for AviSynth+'s v8 interface;
 
* Removed MMX asm code;
 
* Removed MMX asm code;
−
* Self registeres as [[MT_NICE_FILTER]] in AviSynth+.
+
* Self registers as [[MT_NICE_FILTER]] in AviSynth+.
  
 
<br>
 
<br>
 +
 
== Requirements ==
 
== Requirements ==
−
* [x86]: [[AviSynth+]] or [http://forum.doom9.org/showthread.php?t=168764 AviSynth 2.6]
+
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
 
* [x64]: [[AviSynth+]]
 
* [x64]: [[AviSynth+]]
 
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
 
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
 +
** AviSynth+: all Y/YUV/YUVA [[planar]] (8/10/12/14/16/32-bit) formats are supported
 
<br>
 
<br>
−
* [https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads Microsoft Visual C++ 2019 Redistributable Package (x86 / x64)]
+
* [https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads Microsoft Visual C++ 2022 Redistributable Package (x86 / x64)]
 
:<span style="color:red">***</span> <tt>vcredist_x86.exe</tt> is required for <tt>MTCombMask-x86</tt>
 
:<span style="color:red">***</span> <tt>vcredist_x86.exe</tt> is required for <tt>MTCombMask-x86</tt>
 
:<span style="color:red">***</span> <tt>vcredist_x64.exe</tt> is required for <tt>MTCombMask-x64</tt>
 
:<span style="color:red">***</span> <tt>vcredist_x64.exe</tt> is required for <tt>MTCombMask-x64</tt>
Line 34: Line 37:
 
== [[Script variables|Syntax and Parameters]] ==
 
== [[Script variables|Syntax and Parameters]] ==
  
−
:{{Template:FuncDef|CombMask (clip, int "thY1", int "thY2", int "Y", int "U", int "V", bool "usemmx") }}
+
:{{Template:FuncDef|CombMask (clip, int "thY1", int "thY2", int "Y", int "U", int "V", bool "usemmx", int "opt")}}
 
<br>
 
<br>
 
::{{Par2| |clip| }}
 
::{{Par2| |clip| }}
−
:::Input clip.
+
:::A clip to process. It must be in YUV planar format.
 
<br>
 
<br>
 
::{{Par2|thY1|int|30}}
 
::{{Par2|thY1|int|30}}
Line 59: Line 62:
 
::{{Par2|usemmx|bool|true}}
 
::{{Par2|usemmx|bool|true}}
 
:::Dummy parameter for backward compatibility.
 
:::Dummy parameter for backward compatibility.
 +
<br>
 +
::{{Par2|opt|int|-1}}
 +
:::Sets which cpu optimizations to use.
 +
:::*-1 : Auto-detect.
 +
:::*0 : Use C++ code.
 +
:::*1 : Use SSE2 code.
 +
:::*2 : Use AVX2 code.
 +
:::*3 : Use AVX512 code.
 +
:::Default: -1.
 
<br>
 
<br>
 
<br>
 
<br>
Line 64: Line 76:
 
== Examples ==
 
== Examples ==
 
CombMask with default values:
 
CombMask with default values:
−
  CombMask(thy1=30, thy2=30, y=3, u=1, v=1)
+
  CombMask(thy1=30, thy2=30, y=3, u=1, v=1, opt=-1)
  
 
To log combing value you may use this code:
 
To log combing value you may use this code:
Line 73: Line 85:
 
== Changelog ==
 
== Changelog ==
 
  Version      Date            Changes<br>
 
  Version      Date            Changes<br>
 +
v2.2.1      2022/08/06      - Added ~10% faster C code.
 +
                              - Added SSE2, AVX2 and AVX512 code.
 +
                              - Added parameter opt.
 +
v2.2.0      2020/09/20      - Added support for float input.
 +
v2.1.0      2020/05/31      - Added support for 10..16-bit clips.
 
  v2.0.0      2020/05/20      - Initial release
 
  v2.0.0      2020/05/20      - Initial release
 
<br>
 
<br>

Latest revision as of 16:57, 7 August 2022

Abstract
Author Manao, Asd-g
Version v2.2.1
Download MTCombMask-2.2.1.7z
Category Masking
License GPLv2
Discussion


Contents

[edit] Description

This filter produces a mask showing areas that are combed. CombMask uses 3-point sampling to determine combing in a pixel.

The thresholds work as following: after calculating the combing value, if one is below thY1, the pixel is set to 0, if above thY2, it is set to 255, and if in between, it is set to the combing value divided by 256.

This is the same filter as the one from MaskTools-v1.5.8 with few changes:

  • Chroma could be filtered;
  • Y/YUV(A) 8..32-bit clips are accepted;
  • All planar Y/YUV 8-bit clips are accepted;
  • Support for AviSynth+'s v8 interface;
  • Removed MMX asm code;
  • Self registers as MT_NICE_FILTER in AviSynth+.


[edit] Requirements


*** vcredist_x86.exe is required for MTCombMask-x86
*** vcredist_x64.exe is required for MTCombMask-x64


[edit] Syntax and Parameters

CombMask (clip, int "thY1", int "thY2", int "Y", int "U", int "V", bool "usemmx", int "opt")


clip   =
A clip to process. It must be in YUV planar format.


int  thY1 = 30
Pixels below thY1 are set to 0.
Must be between 0 and 255 and must be <= thY2.
Default: 30.


int  thY2 = 30
Pixels above thY2 are set to 255.
Must be between 0 and 255 and must be >= thY1.
Default: 30.


int  Y = 3
int  U = 1
int  V = 1
Select which planes to process:
  • 1 : do not process (garbage)
  • 2 : copy
  • 3 : process


bool  usemmx = true
Dummy parameter for backward compatibility.


int  opt = -1
Sets which cpu optimizations to use.
  • -1 : Auto-detect.
  • 0 : Use C++ code.
  • 1 : Use SSE2 code.
  • 2 : Use AVX2 code.
  • 3 : Use AVX512 code.
Default: -1.



[edit] Examples

CombMask with default values: 

CombMask(thy1=30, thy2=30, y=3, u=1, v=1, opt=-1)

To log combing value you may use this code: 

CombMask(thy1=30, thy2=30, y=3, u=1, v=1)
WriteFile("c:\log.txt", """ ScriptClip(String(AverageLuma())) """)


[edit] Changelog 

Version      Date            Changes

v2.2.1       2022/08/06      - Added ~10% faster C code.
                             - Added SSE2, AVX2 and AVX512 code.
                             - Added parameter opt.
v2.2.0       2020/09/20      - Added support for float input.
v2.1.0       2020/05/31      - Added support for 10..16-bit clips.
v2.0.0       2020/05/20      - Initial release


[edit] External Links

  • GitHub - Source code repository.



Back to External Filters ←

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