View source for AGM

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Effects|Deep_color_tools}}
{{Filter3
|1={{Author/Asd-g}}
|2=1.0.0
|3=[https://github.com/Asd-g/AviSynth-AGM/releases/ AGM-1.0.0.7z]
|4=Effects
|5=[https://github.com/Asd-g/AviSynth-AGM/blob/main/LICENSE GPLv3]
|6=
}}

== Description ==
[[AGM]]: Adaptive Grain Mask.

Generally, the lower a frame's average luma, the more grain is applied even to the brighter areas. This abuses the fact that our eyes are instinctively drawn to the brighter part of any image, making the grain less necessary in images with an overall very high luma.

This is [https://git.kageru.moe/kageru/adaptivegrain a port of the VapourSynth adaptive_grain mask.] See the "[https://blog.kageru.moe/legacy/adaptivegrain.html Adaptive Graining Methods]" article for in-depth information.
<br>
<br>
== Requirements ==
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6]
* [x64]: [[AviSynth+]]
* Supported color formats: [[Y8]], [[YV12]], [[YV16]], [[YV24]]
** AviSynth+: All [[planar]] YUV formats (8/10/12/14/16/32-bits) are supported. 
<br>
* [https://support.microsoft.com/en-us/topic/the-latest-supported-visual-c-downloads-2647da03-1eea-4433-9aff-95f26a218cc0 Microsoft Visual C++ 2022 Redistributable Package (x86 / x64)]
:<span style="color:red">***</span> <tt>vcredist_x86.exe</tt> is required for <tt>AGM-x86</tt>
:<span style="color:red">***</span> <tt>vcredist_x64.exe</tt> is required for <tt>AGM-x64</tt>
<br>
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef| AGM (clip input, float "luma_scaling", bool "fade", int "opt")}}
<br>
::{{Par2| |clip| }}
:::A clip to process.
:::Must be in YUV [[planar]] format.
<br>
::{{Par2|luma_scaling|float|10.0}}
:::Grain opacity curve.
:::Lower values will generate more grain even in brighter scenes while higher values will generate less even in dark scenes.
:::Default: 10.0.
<br>
::{{Par2|fade|bool|true}}
:::If the clip has bit depth less than 32-bit, the range must be TV (limited range).
:::True: If the clip has bit depth less than 32-bit - pure white and pure black pixels are copied (16/235 8-bit); pixels with value of 18/17 (8-bit) fades out.
:::If the clip has bit depth 32-bit - pixels with value 0.0 and 1.0 are copied.
:::Default: True.
<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>

== Examples ==
AGM with default settings:
 [[AviSource]]("Blah.avi")
 AGM(luma_scaling=10.0, fade=true, opt=-1)

<br>
== Changelog ==
 Version         Date            Changes<br>
 1.0.0           2022/05/15      - Initial release
                                 - Registered as [[MT_MULTI_INSTANCE]].
<br>

==External Links ==
*[https://github.com/Asd-g/AviSynth-AGM GitHub] - Source code repository.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Effects|External Filters]] &larr;'''