AGM

Latest revision as of 16:48, 15 May 2022

[edit] 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 a port of the VapourSynth adaptive_grain mask. See the "Adaptive Graining Methods" article for in-depth information.

[edit] Requirements

• [x86]: AviSynth+ or 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.

• Microsoft Visual C++ 2022 Redistributable Package (x86 / x64)

*** vcredist_x86.exe is required for AGM-x86

*** vcredist_x64.exe is required for AGM-x64

[edit] Syntax and Parameters

AGM (clip input, float "luma_scaling", bool "fade", int "opt")

clip   =

A clip to process.

Must be in YUV planar format.

float  luma_scaling = 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.

bool  fade = 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.

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

AGM with default settings:

AviSource("Blah.avi")
AGM(luma_scaling=10.0, fade=true, opt=-1)

[edit] Changelog

Version         Date            Changes

1.0.0           2022/05/15      - Initial release
                                - Registered as MT_MULTI_INSTANCE.

[edit] External Links

• GitHub - Source code repository.

Back to External Filters ←