Avisynth wiki - User contributions [en]

File:Crt display.avsi

2025-11-30T19:06:26Z

AmjadSONY: AmjadSONY uploaded a new version of "File:Crt display.avsi"

Crt display

2025-11-30T18:53:48Z

AmjadSONY: add avs+ mod

{{FilterCat4|External_filters|Scripts|Adjustment_filters|Effects}}
{{Filter3
|1={{Author/cretindesalpes}}
|2=v1.0
|3=[http://ldesoras.free.fr/src/avs/crt-display-1.0.zip crt-display-1.0.zip] or avs+ only mod [[Media:Crt_display.avsi‎|Crt_display.avsi]]
|4=Effects
|5=
|6=[https://forum.doom9.org/showthread.php?t=170732 Doom9 Thread]}}
<br>
== Description ==
[[crt_display]] is a function that emulates a CRT display using aperture grille (Trinitron) or Cromaclear technologies. It is slow but gives interesting results. It implements various features like:

*Works at any (non-integer) upscaling factor
*Various ways of adjusting the scanline thickness and beam shape
*Low-pass filtering of the input signal
*Specific gamma target
*Beam glow
*Optional colored phosphor effect and shadow mask
*Colors shift caused by beam misalignment
*Automatic contrast adjustment
*Halation
*Very large upscale is possible, showing the grid of phosphors.

<br>
== Requirements==
* [x86] [[AviSynth+]] or [http://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0] or greater
* [x64] [[AviSynth+]]
* Supported color formats: [[RGB24]], [[RGB32]]
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only

==== Required Plugins ====
Latest version of the following plugins are recommended unless stated otherwise.<br>
* [[Dither]]
<br>

== [[Script variables|Syntax and Parameters]] ==

'''Syntax:'''
<pre>
crt_display (clip src, float sw, float sh, float "voff", float "ppp",
\ float "cutoff", float "scandist", float "sharpv", float "sharph",
\ float "blurh", float "glowgain", float "glowh", float "glowv",
\ float "glowsens", float "contrast", float "gamma", float "softclip",
\ float "mix", float "beamshape", bool "phosphor", bool "pgrid",
\ float "vcs", float "cromaclear", float "maskpp", float "gainb",
\ float "halgain", float "halrange", string "pixel_type")
</pre>

'''Parameters:'''
<pre>
sw
Horizontal scale factor.

sh
Vertical scale factor.

voff
Vertical centering of the scanlines.
Set to 0, the scanlines are centered between two pixels. When set to
0.5, the scanline are centered exactly on a pixel. Default is pixel-
centered.
This is a sensitive setting when the scale factor is a small integer.
When sh = 3, it's recommended to set the value closer to 0 to make
centered the dark gap between the scanlines.

ppp
Number of phosphor triads per source pixel.
It is recommended to select a value that makes the phosphors aligned
with destination pixels (for example 1 phosphor triad = 2 dest pix),
in order to avoid moire patterns and beating.

cutoff
Cutoff frequency of the low-pass filter at the electronic level.
Lowering it thinners 1-pixel wide details.
Good values are between 0.8 and 1. Effect is disabled at 1.0.

scandist
Relative distance between two scanlines.

sharpv
Vertical sharpness of the scanlines.
High sharpness makes the lines look thinner especially at low
luminance and may reduce the overall contrast.
Low sharpness thickens the lines and make them slightly blend.
Use values between 0.5 and 2.0.

sharph
Horizontal beam focus.
Use values between 0.5 and 2.0.

blurh
Amount of horizontal bluring to apply after the final resizing.
Requires phosphor to be set. Set it to 0 to disable bluring.
Sometimes with medium scale factors, when the individual phosphors
have a size close to a single destination pixel, the display becomes
incredibly messy. Blurring in the horizontal direction make the
neighbour phophors slightly merge and reduce the gird artefacts.
Moreover, it alows to amplify more the contrast with reduced
color artefacts.
Usually, values in range 1.0-2.0 give good results.
The sweet spot can be very narrow, don't hesitate to try steps
as small as 0.1. It's also very dependent from other settings,
adjust it after other parameters have changed.

glowgain
Amount of glow left by the beam.
Disabled when set to 0.

glowh
Width of the beam glow, in phosphor triads.

glowv
Height in scanlines of the beam glow.

glowsens
Glow sensitivity to light.
With 1 the glow is uniform. Greater values will leave the dark spots
intact and only make the bright spots glow.

contrast
Manual contrast amplification. The neutral value is 1.
The value of 3 is generally good when the scaling factor is not high
and the individual phosphors overlap. Use a slightly greater value
when cromaclear is enable (should be 4).
Contrast loss caused by thin scanlines or large phosphors is hard to
recover.
When unspecified, the contrast is set as high as possible depending
on the other parameters.

gamma
Gamma of the emulated monitor. Typically 2.4 to 2.8 for CRT monitors.
Default is the sRGB gamma (2.2).

softclip
Gently saturates the pixel values.
Generally in range 0-1. Slightly reduces the overall contrast when
pixel values are not clipping.
Set to 0 for hard-clipping.

mix
Amount of CRT-emulated picture in the result. Does not bypass the
gamma processing.

beamshape
Another way to sharpen the scanlines. The higher the value, the
thinner the beam. Use values between 1 and 3. This gives control on
the thickness of the beam at high luminance.

phosphor
Enable phosphor processing.

pgrid
Enables the black grid enclosing each phosphor, at the price of a
higher calculation cost. Useful only for large scale factors, when
individual phosphors are clearly visible.
Requires phosphor processing.

vcs
Vertical color shift in scanline units, misaligning the red and blue
beams.
Realistic values are between -0.25 and +0.25. When set to 0, the beams
are correctly aligned.

cromaclear
Implements the NEC's cromaclear variant of the aperture grille,
combining it with a shadow mask. The value gives the amount of
horizontal black grid to be mixed.
May reduce the contrast.

maskpp
Number of cromaclear units per scanline. Same as ppp but vertically.

gainb
Manual contrast gain for the blue.
For some reasons, the phosphor mix may generate a yellow tint in the
high luminance ranges, depending on various parameters.
Values ranging from 1.05 to 1.2 are generally enough to fix it without
creating excessive blue tint in the darker colors.
Use a test pattern to adjust the value.

halgain
Amount of halation.
Keep it to a low value, typically in range 0.01-0.05.
Disable it with 0.

halrange
Halation radius, in phosphor triad units.

pixel_type
Final RGB format. "RGB24" or "RGB32".
</pre>
<br>

== Examples ==
See examples in the Doom9 discussion thread.
<br>
<br>
== Changelog ==
Version Date Changes<br>
v1.0 2014/06/05 - Initial release
<br>
==External Links ==
*[https://forum.doom9.org/showthread.php?t=170732 Doom9 Forum] - crt_display discussion.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Effects|External Filters]] ←'''

QTGMC

2025-11-06T22:14:34Z

AmjadSONY: fix Preset typo

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, Dogway, real.finder
| v3.383s
| 3=[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|-
|[[BWDIF]]
|[https://github.com/Asd-g/AviSynth-BWDIF/releases GitHub]
|For EdiMode modes "BWDIF+NNEDI3" and "BWDIF+EEDI3".
|-
|[[Vinverse_avsi]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Vinverse_avsi.avsi GitHub]
|For some new EdiMode modes and EdiExtPre.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than Preset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2025-11-06T22:09:32Z

AmjadSONY: /* Source Match / Lossless */

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, Dogway, real.finder
| v3.383s
| 3=[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|-
|[[BWDIF]]
|[https://github.com/Asd-g/AviSynth-BWDIF/releases GitHub]
|For EdiMode modes "BWDIF+NNEDI3" and "BWDIF+EEDI3".
|-
|[[Vinverse_avsi]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Vinverse_avsi.avsi GitHub]
|For some new EdiMode modes and EdiExtPre.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than SourceMatch'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2022-03-07T06:21:17Z

AmjadSONY:

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, Dogway, real.finder
| v3.383s
| 3=[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|-
|[[BWDIF]]
|[https://github.com/Asd-g/AviSynth-BWDIF/releases GitHub]
|For EdiMode modes "BWDIF+NNEDI3" and "BWDIF+EEDI3".
|-
|[[Vinverse_avsi]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Vinverse_avsi.avsi GitHub]
|For some new EdiMode modes and EdiExtPre.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2022-03-02T18:29:36Z

AmjadSONY: /* Optional Plugins */

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, Dogway, real.finder
| v3.382s
| 3=[https://github.com/realfinder/AVS-Stuff/blob/a487858224a063101b9bfc1e128a0953ee6c5046/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/blob/05ef36cecde1de525fa194ab30c9cb4f17cf7240/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|-
|[[BWDIF]]
|[https://github.com/Asd-g/AviSynth-BWDIF/releases GitHub]
|For EdiMode modes "BWDIF+NNEDI3" and "BWDIF+EEDI3".
|-
|[[Vinverse_avsi]]
|[https://github.com/realfinder/AVS-Stuff/blob/05ef36cecde1de525fa194ab30c9cb4f17cf7240/avs%202.5%20and%20up/Vinverse_avsi.avsi GitHub]
|For some new EdiMode modes and EdiExtPre.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2022-03-02T18:21:38Z

AmjadSONY: /* Optional Plugins */

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, Dogway, real.finder
| v3.382s
| 3=[https://github.com/realfinder/AVS-Stuff/blob/a487858224a063101b9bfc1e128a0953ee6c5046/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/blob/05ef36cecde1de525fa194ab30c9cb4f17cf7240/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|-
|[[Vinverse_avsi]]
|[https://github.com/realfinder/AVS-Stuff/blob/05ef36cecde1de525fa194ab30c9cb4f17cf7240/avs%202.5%20and%20up/Vinverse_avsi.avsi GitHub]
|for some new EdiMode modes and EdiExtPre
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2022-03-02T18:20:21Z

AmjadSONY: /* Optional Plugins */

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, Dogway, real.finder
| v3.382s
| 3=[https://github.com/realfinder/AVS-Stuff/blob/a487858224a063101b9bfc1e128a0953ee6c5046/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/blob/05ef36cecde1de525fa194ab30c9cb4f17cf7240/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|-
|[[Vinverse_avsi]]
|[https://github.com/realfinder/AVS-Stuff/blob/master/avs%202.5%20and%20up/Vinverse_avsi.avsi GitHub]
|for some new EdiMode modes and EdiExtPre
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2022-03-02T18:19:24Z

AmjadSONY: /* Optional Plugins */

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, Dogway, real.finder
| v3.382s
| 3=[https://github.com/realfinder/AVS-Stuff/blob/a487858224a063101b9bfc1e128a0953ee6c5046/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/blob/05ef36cecde1de525fa194ab30c9cb4f17cf7240/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|}
|[[Vinverse_avsi]]
|[https://github.com/realfinder/AVS-Stuff/blob/master/avs%202.5%20and%20up/Vinverse_avsi.avsi GitHub]
|for some new EdiMode modes and EdiExtPre

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2022-03-02T18:00:37Z

AmjadSONY: /* Core Plugins and Scripts */

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, Dogway, real.finder
| v3.382s
| 3=[https://github.com/realfinder/AVS-Stuff/blob/a487858224a063101b9bfc1e128a0953ee6c5046/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/blob/05ef36cecde1de525fa194ab30c9cb4f17cf7240/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2022-03-02T17:51:27Z

AmjadSONY:

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, Dogway, real.finder
| v3.382s
| 3=[https://github.com/realfinder/AVS-Stuff/blob/a487858224a063101b9bfc1e128a0953ee6c5046/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

ConvertStacked

2021-10-28T22:51:22Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. '''''They are intended to serve as a stopgap for plugins that not supporting true high bit depth yet so you shouldn't use them nowadays unless with some rare filters that work only with these High-bit-depth hacks'''''.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' (Stacked 16bit) aka Double Height, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB), hence the name "Double Height". It's used in [[Dither tools]] and many others. (Sometimes in filters is referred as "lsb" only).

*The '''Interleaved 16bit''' aka Double Width is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. It's used in [[https://www.videoartifact.com/hdr/ HDRCore]] and it was also used in [[flash3kyuu_deband]], [[LSMASHSource]] and other filters before they were updated to support 16bit planar (native HBD).

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns 16bit stacked (MSB and LSB stacked one on top of the other in a fake double height "8bit" stream).<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns 16bit interleaved (MSB and LSB interleaved together in a fake double width "8-bit" stream).<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st examples of both Stacked and DoubleWidth below.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## this not needed since Dfttest support HBD, but just for example
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::1st example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|56|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16bit clip with truerange=false
'''ConvertToDoubleWidth'''()
[[f3kdb]](Input_Mode=2, Input_Depth=10, Output_Mode=2, Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

::2nd example,
<div {{BoxWidthIndent|56|4}} >
## 16bit clip here
'''ConvertToDoubleWidth'''()
[[Hqdn3dY|Hqdn3d16Y]]()
'''ConvertFromDoubleWidth'''()
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2021-10-28T22:50:52Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. '''They are intended to serve as a stopgap for plugins that not supporting true high bit depth yet so you shouldn't use them nowadays unless with some rare filters that work only with these High-bit-depth hacks'''.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' (Stacked 16bit) aka Double Height, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB), hence the name "Double Height". It's used in [[Dither tools]] and many others. (Sometimes in filters is referred as "lsb" only).

*The '''Interleaved 16bit''' aka Double Width is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. It's used in [[https://www.videoartifact.com/hdr/ HDRCore]] and it was also used in [[flash3kyuu_deband]], [[LSMASHSource]] and other filters before they were updated to support 16bit planar (native HBD).

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns 16bit stacked (MSB and LSB stacked one on top of the other in a fake double height "8bit" stream).<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns 16bit interleaved (MSB and LSB interleaved together in a fake double width "8-bit" stream).<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st examples of both Stacked and DoubleWidth below.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## this not needed since Dfttest support HBD, but just for example
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::1st example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|56|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16bit clip with truerange=false
'''ConvertToDoubleWidth'''()
[[f3kdb]](Input_Mode=2, Input_Depth=10, Output_Mode=2, Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

::2nd example,
<div {{BoxWidthIndent|56|4}} >
## 16bit clip here
'''ConvertToDoubleWidth'''()
[[Hqdn3dY|Hqdn3d16Y]]()
'''ConvertFromDoubleWidth'''()
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2021-10-28T22:49:26Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap for plugins that not supporting true high bit depth yet so you shouldn't use then nowadays unless with some rare filters that work only with these High-bit-depth hacks.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' (Stacked 16bit) aka Double Height, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB), hence the name "Double Height". It's used in [[Dither tools]] and many others. (Sometimes in filters is referred as "lsb" only).

*The '''Interleaved 16bit''' aka Double Width is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. It's used in [[https://www.videoartifact.com/hdr/ HDRCore]] and it was also used in [[flash3kyuu_deband]], [[LSMASHSource]] and other filters before they were updated to support 16bit planar (native HBD).

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns 16bit stacked (MSB and LSB stacked one on top of the other in a fake double height "8bit" stream).<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns 16bit interleaved (MSB and LSB interleaved together in a fake double width "8-bit" stream).<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st examples of both Stacked and DoubleWidth below.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## this not needed since Dfttest support HBD, but just for example
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::1st example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|56|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16bit clip with truerange=false
'''ConvertToDoubleWidth'''()
[[f3kdb]](Input_Mode=2, Input_Depth=10, Output_Mode=2, Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

::2nd example,
<div {{BoxWidthIndent|56|4}} >
## 16bit clip here
'''ConvertToDoubleWidth'''()
[[Hqdn3dY|Hqdn3d16Y]]()
'''ConvertFromDoubleWidth'''()
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

SMDegrain

2021-04-15T04:09:38Z

AmjadSONY: /* Optional */

{{FilterCat4|External_filters|Denoisers|Spatial-Temporal Denoisers|Deep_color_tools}}
{{Filter
| Caroliano, {{Author/Dogway}}, Real.Finder
| v3.1.2.110s
|
* [https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/SMDegrain.avsi SMDegrain]<br/>
| 4=Spatial-Temporal Denoisers
| 7=[https://forum.videohelp.com/threads/369142-Simple-MDegrain-Mod-v3-0d-A-Quality-Denoising-Solution VideoHelp], [https://forum.doom9.org/showthread.php?t=163604 Doom9], [https://forum.doom9.org/showthread.php?t=174121 Doom9 mod] }}

'''SMDegrain''', the Simple MDegrain Mod, is mainly a convenience function for using [[MVTools]]. It is not a magic function (the magic comes from mvtools), it just takes the repetitive code blocks needed for mvtools+mdegrain denoising and wraps them into this function.

It has internal switches for interlaced or YUY2 content '''''(but you should not use it in avs 2.6 and avs+ and use YV16 instead)''''', saving you from writing long lines of code and preventing from possible mistakes. YUY2 is even automatically detected. Apart of that it adds some small and simple enhancements listed below, like easy prefilters, slightly better motion vectors (thanks to an internal TV->PC luma expansion and the possibility of dark enhancement), easy nnedi3 subpixel accuracy, globals import/export, show panel, and contra-sharpening option.

==Dependencies==
* [[Zs_RF_Shared]]
* [[MVTools]] (mod versions recommended) and [[MaskTools2]] (it's not needed if TV_range set to false)

===Optional===
* [[Dither]] for lsb hack 16 bit processing (v1.26.5 or higher)
* [[RgTools]] and [[MedianBlur2]] for contrasharp=true or prefilter=1 or 2
* [[LSFmod]] for contrasharp > 0.0
* [[dfttest]] for prefilter=3
* [[nnedi3]] for subpixel=3
<strike>''Beware, tp7's plugin mods have no YUY2 support, require AviSynth 2.6a5 or latest Set's MT for v2.6, and Visual C++ 2012 Redistributable.''</strike>

==Aknowledgements==
Original '''SMDegrain()''' by Caroliano

This function uses code from Didée, and cretindesalpes' creations, and has parts inspired by LaTo's functions (old readme, Show panel, etc) and Jawed's Killer() function, apart of relying on third-party tools for certain features.

Special thanks go to: cretindesalpes, Didée, Gavino, Sagekilla, and MVtools people.

==Introduction==
The benefit of using SMDegrain over directly calling MDegrain is:
* '''High bitdepth with lsb denoising''': This is the first wrapper function to support 32bit (16bit pipeline) MDegrain denoising.
* '''Higher temporal radius''' (tr>3): The [[MVTools]] mod (and hence this script) also allows for hack-free higher temporal radius.
* '''Contrasharpening''': The pretty much standarized sharpening method created by Didée is blended into the function, so you can easily use it in 16bit pipelines. An strength biased method is also possible. A ''CClip'' parameter is also supplied so you can choose another source to sharpen from, other than the default '''SMDegrain()''' input.
* '''YUY2 support''': It automatically and fully supports YUY2. (but that not important now after avs 2.6 and avs+)
* '''Interlaced support''': It supports interlaced sources with most parameters as well.
* '''Extended Subpixel Accuracy''': [[nnedi3]] is allowed as a subpixel filter, not necessary in most cases, but if you are quality mad try to set it on.
* '''Better Motion Vectors''': An internal conversion from TV levels (reduced values range) to PC levels (extended values range) is done to the clip the motion analysis will be performed on, so you can get better motion vectors (up to 16%)
* '''Prefilters''': An easy parameter to load generalist prefilters that perform well in most situations. It also accepts loading your personal prefiltered clips.
* '''Motion Filters''': New in version 3.0d. It will allow you to filter those parts where '''SMDegrain()''' couldn't find a matching block for denoising. One use for it would be spatial denoisers or deblockers since high-motion areas are prone to heavy blocking and artifacts.
* '''Global Motion Vector In/Out''': Reuse motion vectors globals for faster processing, or just use '''SMDegrain()''' as a shortcut for creating nice quality motion vectors.
* '''RefineMotion Option''' (MRecalculate): Slower, but sometimes a big quality boost.
* '''Show Panel''': Everything is off by default, but some settings change in context. Check what is happening behind the scenes and have a fast look at all your settings.
* '''Robust''': Everything of the above works with each other no problem (interoperability), also in the process some error proof, bugfixes and bug workarounds were implemented or at least warned so you know that most of what is done is reliable, bugs free and optimized. The general idea is to serve as an user friendly front end for vanilla mvtools2+mdegrain or as the original script creator entitled "To make your scripts shorter and less geeky". Most parameters are turned off or defaulted to mvtools2 defaults and features are based on popular general conceived procedures.

Parameters are arranged in 3 blocks.
*'''Basic''': For people who just need the most basic parameters because either they don't have the time, knowledge or interest into looking for complex settings. Or they are content with defaults (pretty much mvtools defaults)
*'''High Bit Depth (with lsb hack) ((you should not use it in avs+))''': There's not much to think about this. This just enables (default is disabled), high bit depth denoising. That is, more quality, but also needs more processing power hence slower.
*'''Advanced''': If you run into some problems, are nitpicking or just want to fine tune your settings according to the source, have a look at this block, it contains the rest and bulk of the function parameters.

Temporal denoising is a widespread procedure for noise cleaning in most type of video sources. The only limitation for '''SMDegrain()''' being when there are (very) high levels of grain, in which case you would need to rely on more "creative" and source centric solutions (see [https://forum.doom9.org/showthread.php?p=1544619#post1544619 this] and ''prefilter'' notes), but those are the rare cases.

To picture what the function does, a simple '''SMDegrain()''' call matches the next code (for SD resolutions):

super_search = Dither_Luma_Rebuild(S0=1.0,c=0.0625).MSuper(rfilter=4)

bv2 = super_search.MAnalyse(isb = true, delta = 2, overlap= 4)
bv1 = super_search.MAnalyse(isb = true, delta = 1, overlap= 4)
fv1 = super_search.MAnalyse(isb = false, delta = 1, overlap= 4)
fv2 = super_search.MAnalyse(isb = false, delta = 2, overlap= 4)

MDegrain2(MSuper(levels=1), bv1, fv1, bv2, fv2, thSAD=300, thSADC=150)

As you see no wizardry. The only changes made are the TV->PC luma expansion (''Dither_Luma_Rebuild''(S0=1.0,c=0.0625) similar to ''color_yuv''(levels="TV->PC")) so you have more range to detect motion vectors, the ''rfilter''=4 for a bit more quality super search, the changed default of ''overlap'' from 0 to 4 and ''thSAD'' and ''thSADC'' from 400 to 300 and 150 respectively for safer results. Nothing else. The problem is that as soon you want to change a little thing like say temporal radius it requires you to edit in more than a few places, so this is very annoying and so forth the main reason for '''SMDegrain()'''.

==Using the filter==
*Input can be YV12 or YUY2, and '''must''' be TV range (which is normal). It's also recommended to be in modulus 16 size (resolution multiple of 16), although not strictly necessary.
*Crop first (when not interlaced).
*Recommended to deblock if blocking is present, before crop (when cropping) and '''SMDegrain()'''. Or you can use ''prefilter''=3 which is also a good deblocker (dfttest) and let '''SMDegrain()''' clean the blocking for you.
*Default output mode(dithering) for ''lsb''=true (when non interlaced) is ordered dither (optimized for encoding), so it is not recommended to keep filtering non-edge areas of your source, you can instead use ''mode''=6 (error diffusion) or ''lsb_out''=true and keep filtering in 16bit
*Read the ''prefilter'' setting explanation for solutions to problematic sources

==Ready-to-run Samples==

I consider this a good starting point where to start tweaking, whether be it for quality or speed:
SMDegrain(tr=2,thSAD=250,contrasharp=true,refinemotion=true,lsb=true)

A basic, fast, yet very functional call for light grain (mvtools2+masktools2 only needed)
SMDegrain(tr=1,thSAD=300,contrasharp=true)

A typical more worked call compatible with official mvtools2 (mvtools2+masktools2 only needed)
SMDegrain(tr=2,thSAD=300,interlaced=true,prefilter=1,contrasharp=true)

Good compromise between speed and quality (denoising with high precision)
SMDegrain(tr=2,thSAD=300,contrasharp=true,refinemotion=true,lsb=true)

Similar to the previous example, the next is a personal preference. Turned all chroma off for safeness (chroma is rarely temporal-reliable enough) and speed.
SMDegrain(tr=2,thSAD=300,contrasharp=true,refinemotion=true,lsb=true,chroma=false,plane=0)

This is a good example to show that interlaced YUY2 sources can be processed seamlessly.
# mod4 (modulus 4) interlaced YUY2 source
SMDegrain(tr=1,thSAD=250,interlaced=true,contrasharp=true,lsb=true)

HD sources are detected automatically, and as so settings are optimized for speed; ''pel''=1, ''hpad''=0, ''vpad''=0, ''blksize''=32, ''overlap''=16, ''truemotion''=false
# HD source (from 1100px wide or 600px high up)
SMDegrain(tr=2,thSAD=180,prefilter=2,contrasharp=30,refinemotion=true,lsb=true,chroma=false,plane=0)

For dealing with dark scenes (you could also add ''truemotion''=false)
SMDegrain(tr=3,thSAD=300,contrasharp=true,str=2.0,refinemotion=true,lsb=true)

Tackling a grainy source:
pre=fluxsmootht(3).removegrain(11)
SMDegrain(tr=6,thSAD=500,contrasharp=30,prefilter=pre,str=1.2,refinemotion=true,lsb=true)

Here 2 things are shown; how to work on a 16bit pipeline, and reference a prior state of the script for ''contrasharp''.
sharp=last
dfttest(tbsize=1,sigma=10,lsb=true)

SMDegrain(tr=3,thSAD=300,CClip=sharp,lsb_in=true,lsb_out=true)

LinearResize(854,480,lsb_in=true, mode=0)

(Re)using motion vectors globals
SMDegrain(tr=1,thSAD=400,prefilter=3,str=1.4,globals=3) # Output vectors only
MFlowFps(Super, bv1, fv1, num=60,den=1)

==Parameters==
{{FuncDef|SMDegrain}} (clip input, int "tr", int "thSAD", int "thSADC", bool "RefineMotion", val "contrasharp", clip "CClip", bool "interlaced", int "plane", int "Globals", int "pel", int "subpixel", val "prefilter", clip "mfilter", int "blksize", int "overlap", int "search", bool "truemotion", int "limit", int "limitc", int "thSCD1", int "thSCD2", bool "chroma", int "hpad", int "vpad", bool "lsb", bool "lsb_in", bool "lsb_out", int "mode", val "Show", float "Str", float "Amp")

===Basic===

{{ParR|tr|int|2|1-128}}
:Temporal radius, selects the MDegrain to use. This can be considered the strength of the denoising. Higher is generally better, but also much slower and each extra frame gives less improvement.
:tr 4+ requires Dither's MVTools2 mod. Max 64 for interlaced.

{{Par|thSAD|int|300}}
{{Par|thSADC|int|150}}
:"Sum of Absolute Differences" threshold. This is the spatial difference threshold where the motion search will consider whether to denoise given the formula:
::Denoise_Weight = max( 0, 1 - 2*blockSAD² / (thSAD² + blockSAD²) )
:This spatial difference will be compared in blocks (''blksize''). If your noise is not getting into consideration for the denoising try raising this value, or reduce its SAD with previous prefiltering. You can alternatively raise ''blksize'', which will likely even blocks SAD. Low values can result in staggered/blotchy denoising, large values can result in ghosting and artifacts. Values in the range 200~600 are usual.
:thSADC is the same logic applied to chroma planes, since there are less differences on the chroma planes it uses by default thSAD/2 for safer chroma results.
:'''Recommendation''': Use slightly greater values than you are used to in other mdegrain based functions since the internal clip for the motion search in SMDegrain() has the contrast increased.

{{ParR|Contrasharp|bool|False|True/False}}
{{ParR|Contrasharp|int|-|0-100}}
:Contrasharpening is a technique that compares the differences between the clip before blurring (original) and after blurring (filtered), and sharpens locally with consequent strength. By default the "sharp" clip is the input, the "after" clip is the denoised clip. Alternately, a "before" clip can be specified with ''CClip'' (See Advanced).
:*True: use Didée's Contrasharpening() function (ContraHD() for HD) which "Sharpens the denoised clip, but doesn't add more to any pixel than what was removed previously." In the practice you will get a slightly sharper result than the source, which is welcome.
:*An integer: LSFmod() will be used instead. It will be much slower, but maybe better for certain sources. Its value will serve as a contrasharpening multiplier, use one around 50 for similar strength as Contrasharpening(). LSFmod is less-suitable for HD sources.

{{Par|RefineMotion|bool|False}}
:Refines and recalculates motion data of previously estimated (by MAnalyse) motion vectors. Turn it on for better motion vectors, specially when dealing with ghosting issues, small details or lineart fading and whatnot.
:'''Caution''': It won't help much if you use a ''prefilter'' so strong that blurs too much or kills all the details you are aiming to protect in first place.

{{ParR|plane|int|4|0-4}}
:Select the planes you wish to process:
:*0: luma only
:*1: chroma U
:*2: chroma V
:*3: both chromas
:*4: all (Default)
:'''Caution''': plane=1-4 can sometimes create chroma smearing. In such case I recommend denoising chroma planes in the spatial domain.

{{Par|Interlaced|bool|False}}
:If you want to denoise an interlaced source set this parameter to true. Output will also be interlaced. If you pair this with ''lsb_out''=true then you will have to <tt>Weave().DitherPost(mode=6,interlaced=true)</tt> when converting back to 8 bit.

===High Bit Depth Processing And Dithering===
All High Bit Depth parameters require [[Dither]] and [[MVTools]] 2.6+. The [[AviSynth+]] doesn't need these parameters; it automatically outputs the same bitdepth as the input, but if you still need 99% alternative to lsb family there are n16 (don't has n16_in because it don't make any sense in that case).

{{Par|lsb_in|bool|False}}
:Set true if you use a 16 bits filter chain. *(EXPERIMENTAL, use under test environment)

{{Par|lsb_out|bool|False}}
:Output to 16-bit instead of 8-bit. Use the helpers at the end of the SMDegrain() script to use Ditherpost() with YUY2 formats.

{{Par|lsb|bool|False}}
:This enables 32 bit depth precision for denoising. You gain extra denoising accuracy, most noticeable in the prevention of banding in flat areas. Automatically set if either ''lsb_in'' or ''lsb_out'' are enabled.

{{ParR|mode|int|0|-1-8}}
:This is the '''mode''' of [[Dither#DitherPost|DitherPost]] when ''lsb_out''=False, as a dithering method must be chosen for the 32bit->8bit conversion. (Interlaced content is locked to mode=6) The default ''mode''=0 will help you optimize the dithering for optimum encodings when no further non-edge processing is done. Use ''mode''=6 (error diffusion) if further processing will be done.

===Advanced===

{{ParR|pel|int|2|1,2,4}}
:Accuracy of the motion estimation:
:* 1: full-pixel (Default for HD)
:* 2: half-pixel (Default for SD)
:* 4: quarter-pixel (often more accurate, but much slower and not always better)

{{ParR|subpixel|int|2|0-3}}
:Subpixel interpolation method for ''pel''=2 or 4. This is the 'sharp' parameter in MSuper(), although it isn't related to output sharpness but better accuracy for the motion estimation.
:* 0: bilinear (softest)
:* 1: bicubic (4 tap Catmull-Rom)
:* 2: sharper Wiener (6 tap, similar to Lanczos) (Default)
:* 3: [[nnedi3]] (very high quality: useful for small sources but usually overkill. requires plugin)

{{ParR|prefilter|int|-1|-1-3}}
{{Par|prefilter|clip|None}}
:* -1: off (Default)
:* 0: light controlled gauss blur
:* 1: mild median/gauss blur
:* 2: strong median/gauss blur
:* 3: [[dfttest]] (spatial)
:* clip: supply your own
:Denoises a version of the clip that will be used to obtain the motion vectors. Useful for very damaged/grainy sources, this will help to get better motion vectors.
:For sources with Gibbs noise, especially on anime, try ''prefilter''=1 or 2 or better yet strong median filters (through clip input) in order to soothe the high SAD of sharp edges. For blocky sources, or a general more quality/safer prefilter use option 3 (dfttest)
:By default dfttest outputs a sstring txt file to your script folder, you can delete it. This doesn't happen when using the modded dfttest (version 1.9.2 or higher) of the Dither tools.
:For HD sources ''prefilter''=2 makes more sense than 1, because it uses a wider denoising window.
:If instead you want to use your own prefilter denoiser, just define it in a variable and reference it here. Remember to:
:*Feed always 8 bit clips.
:*Input in fields for interlaced content *(read below)
:*Feed here planar ( by using Interleaved2Planar() ) YUY2 clips (not interleaved) when working with YUY2 sources.
:You will likely want to use spatial denoisers like median filters (removegrain=17, medianblur, etc). For very grainy or fizz grain noise you can try prefiltering in temporal or if this is not enough, try adding a new SMDegrain() line again but without globals. Use ''lsb_in'', ''lsb_out'' according so results are smooth. You can even use SMDegrain() as a prefilter for SMDegrain() in very temporal unstable sources.
:Another trick for fizz grain is to serve a prefiltered clip where bright values are more denoised than dark values, you can do this through luma masks with masktools2 code. Search in [https://forum.doom9.org/showthread.php?t=162813 Doom9] for reference.
:For interlaced sources remember:
::Spatial filtering: pre=separatefields().spatial_prefilters_here()
::Temporal filtering: pre=separatefields().interleave(selecteven().temporal_filters(),selectodd().temporal_filters())
:SMDegrain() (and MDegrain) is likely to produce blending artifacts or oversmooth in dark areas specially on cartoons, to tackle this see RefineMotion or expand the luma range in the darks. For this there are many options, you can use your preferred gamma enhancer and input it as the prefilter, or use the examples below for linear brightening (masktools2) and input it as a ''prefilter'' as well. Or at last and the recommended solution, to use the built-in ''Str'' (strength) and ''Amp'' (amplitude) parameters for a curve type dark enhancement, check the effects by enabling Show and changing your previewing conditions to PC levels.
:For brightening dark values linearly (brighter parts less brightening)
str=1
mt_lut("x x "+string(str)+" 6 * - 255 - abs 255 / ^ x 1 - abs +")
:Or for a more contrasty image (although not as much dark enhancing - not linear)
str=40
mt_lut("x x "+string(str)+" 6 * - 255 - abs 255 / ^ "+string(str)+" / x 1 - abs +")
:Good resources for custom prefilters:
:*https://forum.doom9.org/showthread.php?t=162813
:*https://forum.doom9.org/showthread.php?t=132310
:*https://forum.doom9.org/showthread.php?t=133977
:Notes: To sum it up; generally in denoising, temporal filters are always preferred due to its natural look (versus spatial filters). But more often than not for good results prefiltering plays a key role on the output quality, and setting it up nicely can be looked as an art by itself.
:If there's a reached point where no prefiltering, no ''thSAD'' tweaking, etc, makes able to denoise a certain motion part/area/scene, then this is due to the motion vectors preventing them from being "denoised" (also read "artifacted"), in which case you will need to rely on alternative solutions (motion compensation, filters like MCTemporalDenoise(), TemporalDegrain(), [https://forum.doom9.org/showthread.php?p=1544619#post1544619 Multilevel MDegrain], etc) or just use plain spatial filters with motion masks. Creating these discerning masks for static and motion scenes and combining them is a research task on the end user side.

{{Par|mfilter|clip|None}}
:Motion Filter, an optional user-supplied clip that will be passed through those areas where SMDegrain() couldn't find a matching block, normally high motion areas. One use for it would be to to use spatial filters, like deblockers or blurring filters that mimic motion blur.

{{ParR|Str|float|1.0|0.0-8.0}}
:Gamma correction. With this parameter you control the strength of the brightening of the ''prefilter'' clip, good for when problems with dark areas arise. Using this internally instead of externally creates less quantization artifacts, since it's done in the same stage as the TV->PC range conversion.

{{ParR|Amp|float|0.0625|0.0-1.0}}
:Used when ''Str'' <> 1.0. This defines the amplitude of the brightening in the luma range, for example by using 1.0 all the luma range will be used and the brightening will find its peak at luma value 128 in the original. Default is 0.0625 (1.0/16) which just sits over luma value 16 (256/16) This and ''Str'' are extrapolated arguments from [https://forum.doom9.org/showthread.php?p=1548318#post1548318 cretindesalpes' function], you can find a graph and more insight explanations at the original post.
:Check these 2 parameters effects by enabling ''show''.

{{ParR|blksize|int|8 for SD, 16 for HD|4,8,16}}
:Size of a block (horizontal x vertical). Larger blocks are faster and less sensitive to noise, but also less accurate.

{{Par|overlap|int|blksize/2}}
:Must be *even* and *less* than block size. Common values: ''blksize''/4 or ''blksize''/2. Larger ''overlap'' looks slightly better and runs slower.

{{ParR|Search|int|4|0-7}}
:This is the '''search''' of [[MVTools/MAnalyze|MAnalyze]].

{{Par|Truemotion|bool|True for SD, False for HD}}
:''Truemotion'' is a preset of some MVAnalyze parameter values. It allows easy to switch default values of all "true motion" parameters at once. Set it 'true' for true motion search (high vector coherence), set it 'false' to search motion vectors with best SAD. Truemotion is slower and may blur textures and thin details more, but will usually remove more noise.
:For HD sources where the main problems are just excessive grain, I have defaulted it to false, this is not only faster but honors detail accuracy (the main existing point for HD sources) and overall object shading.

{{Par|Chroma|bool|True}}
:Set false to totally ignore chroma for finding motion vectors, for more speed with little cost in quality or when your chroma is too bad to find good matches. Don't process chroma planes without chroma vectors, MVTools doesn't seem to work right.

{{Par|Hpad|int|''blksize'' for SD, 0 for HD}}
{{Par|Vpad|int|''blksize'' for SD, 0 for HD}}
:Horizontal/vertical padding added to source frame (left, right, top, and bottom) for better motion estimation near borders.
:Try to have clean borders in your source (no NAB/black borders) to start with before tweaking this setting. If necessary, crop beforehand ideally in multiples of 16. Turn it to 0 if you are running out of memory.

{{Par|thSCD1|int|based on ''blksize'': 4{{=}}>100, 8{{=}}>400, 16{{=}}>1600}}
:Threshold which decides whether a block has changed between the previous frame and the current one, used to tweak the scene change detection. Raising it will lower the number of blocks detected as changed. It may be useful for noisy or flickered video. To fix blending on scene changes on dark scenes, first try ''Str'' and ''Amp''.

{{ParR|thSCD2|int|130|0-250}}
:Threshold which sets how many blocks have to change for the frame to be considered as a scene change.

{{ParR|limit|int|255|1-255}}
{{ParR|limitC|int|255|1-255}}
:Maximal change of pixel luma/chroma, to prevent some artifacts.

{{Par|CClip|clip|None}}
:Optional sharp version for ''contrasharp'' to compare against; video resolution and properties must be the same (different bit depth is OK). Using this option defaults ''contrasharp'' to True.

{{ParR|Globals|int|0|0-3}}
:With this parameter you can create or load pre-processed motion vectors, to save doing the work for multiple SMDegrain calls.
:*0: Ignore globals, just process
:*1: Read globals and Process
:*2: Process and output globals
:*3: Output globals only, don't process
:Some parameters '''MUST MATCH''' between output and input stages: ''pel'', ''subpixel'', ''chroma'', and ''vpad''/''hpad'' cannot change. When reading (Globals=1) only some parameters work: ''tr'', ''thSAD'', ''plane'', ''limit'', ''limitc'', ''contrasharp'', ''CClip'', ''interlaced'' and the ''lsb'' parameters. Others are ignored.
:Global names that can be reused are: '''Super''', '''bv1''', '''fv1''', '''bv2''', '''fv2''', '''bv3''', '''fv3''', '''bv4''', '''fv4''', '''bv6''', '''fv6''', '''vmulti'''.
SMDegrain(tr=3,thSAD=400,globals=3) # Outputs vectors
SMDegrain(tr=3,thSAD=400,globals=1) # You can use a lower "tr" or "thSAD" if you want
:or
SMDegrain(tr=3,thSAD=400,globals=3) # Outputs vectors
Super = MSuper(levels=1) # Add this line just before if you have some processing between Globals Output and Input.
MDegrain3(Super, bv1, fv1, bv2, fv2, bv3, fv3, thSAD=400)

{{Par|Show|bool|False}}
{{ParR|Show|str|-|"Speed", "Memory", "Quality"}}
:This will show the prefiltered clip to be used for the motion search to the left(<--), and the used parameters list to the right (-->)
:If the parameters panel is broken i.e. overlapping lines, hidden lines, etc, most likely your settings are wrong, (e.g. ''lsb_in''=true when input is 8bit) so it will also work well as a debug function. If you set Show to a string as indicated above, related parameters will be highlighted to guide you on correctly tweaking the function. This is loosely based, so it doesn't exclude you from reading carefully every parameter explanation.
:Even when you are not using any prefiltering, the clip to be used for the motion search where you obtain the motion vectors, will be converted from TV levels to PC levels, the only exception being when using ''Globals''=1 (Read) in which case the "prefiltered" clip will be exactly the same as input clip (that is no luma conversion, although constrained to 8 bit). Additionally you can tweak the dark expansion with ''Str'' and ''Amp'' parameters and check the effects in the left panel, but be aware to change your viewing conditions as it is in PC levels.
:The left panel preserves its properties so you can crop out the right panel and use it as a prefilter clip of any MSuper(). Therefore if you are not processing chroma (''chroma''=false) the prefiltered clip will be green, don't panic, this is correct, this happens when the U and V planes are unset. In this regard for previewing tasks with prefilterings -- or just the ''Str'' and ''Amp'' effect -- set ''chroma'' to true temporally or follow with ''GreyScale''(). For YUY2 sources set ''Planar2Interleaved''() after cropping for previewing.

==Final Notes==
If there is an important parameter not implemented, you have any issue or found a bug, please don't hesitate and ask in its [https://forum.videohelp.com/threads/369142 VideoHelp thread].

==Changelog==
{| class="wikitable" style="border: 1px solid darkgray"
!Version
!Date
!Changes
|-
|v3.1.2.97s
|2018-03-26
|
Fix subpixel=3
Add Prefilter auto 16 (lsb) support<br/>
YUY2 support in avs 2.6 with masktools 2.6<br/>
medianblur2 now will be used in Minblur instead of Quantile RemoveGrainHD in avs 2.6<br/>
Add TV_range bool<br/>
Less lsb if not use lsb things and get ready for yv16 and yv24<br/>
Add dct<br/>
Add device_id for prefilter=4<br/>
No need to use Planar2Interleaved() after cropping in Show with YUY2 (this is old changed, and now with mvtools support yv16 most people will not use YUY2)<br/>
Add MDegrain4 and MDegrain5 and MDegrain6, this will make tr=4-6 faster<br/>
|-
|-
|3.1.2d
|2015-07-21
|
Fixed regression where external prefilters wouldn't be parsed for luma expansion
|-
|-
|3.1.1d
|2015-07-16
|
Workaround to force KNLMeansCL use discrete video card (now required)
|-
|-
|3.1d
|2015-07-14
|
New prefilter mode 4 for grainy sources. GPU based spatio-temporal KNLmeans<br/>
Added dither output mode "Random Dither".<br/>
Added "slices" option from Dither<br/>
Added soft=-2 (automatic) to internal lsfmod<br/>
Added assert for chroma denoise when luma only motion vectors (mvtools bug)<br/>
Improved lsb_in code (now using sub/add method)<br/>
Removed vpad/hpad=0 optimization preset for HD<br/>
Fixed prefilter=3 code for lsb_in YUY2<br/>
More fixes to Show Panel...<br/>
Updated and fixed documentation (notes on YUY2 support)<br/>
|-
|3.0d
|2015-03-27
|
Adjusted SD<>HD discretion<br/>
Added mfilter (Motion Filter) new feature<br/>
subpixel=3 (nnedi3); removed qual=2 due to possible blending bug (quote by cretindesalpes), this also boosts speed<br/>
Lowered the defaults for less aggressive denoise (still somewhat high)<br/>
Fixed chroma not showing in debug (show) mode when lsb=true and prefilter=3 were paired<br/>
Fixed long lasting issues in Show Panel for certain not mod height resolutions<br/>
Now prefilter=0 is minblur(0), lighter denoising than prefilter=1, default is now -1 (off)<br/>
Documentation update (plugin updates, notes, links, examples, etc)
|-
|2.2d
|2013-03-05
|
Removed one residual variable in Contrasharpening function<br/>
Fixed a regression at v2.0 for Interlaced YUY2 sources by changing wrong variable ifC to if0, and...<br/>
...adding a missing weave() to the last MergeChroma() call<br/>
Dropped Dither support. (Will still work/not work as before, but lack of official support renders it to a YMMV condition)
|-
|2.1d
|2012-09-09
|
Fixed Refinemotion Globals Input labels<br/>
Fixed ContrasharpeningHD Vectors for Interlaced HD sources<br/>
Added ability to import Global Vectors even when "tr" is lower than parent instance "tr" (credit to cretindesalpes)<br/>
Expanded support for Interlaced Denoising "tr" up to 64 (credit to cretindesalpes)<br/>
Cosmetics
|-
|2.0d
|2012-06-07
|
Fixed and optimized chroma handling for lsb_in, contrasharpening and YUY2 content v.1.95<br/>
Enhanced Chroma bypass on the sharpening stage<br/>
Merged ContraHD() internally for Contrasharpening in HD sources<br/>
Dropped QTGMC support on import/export motion vectors (small value for increased confusion)<br/>
Fixed Median code for planar inputs in MinBlur() (needs RemoveGrainHD, dropped medianblur requirement)<br/>
Defaulted truemotion to false for HD inputs<br/>
Code Optimization and Clean up<br/>
Others
|-
|1.9d
|2012-03-23
|
Added truemotion parameter (default=true), change it to false (as in MCTemporalDenoise()), so low frequency detail won't be lost (walls...), although it could leave more noise on high frequency details<br/>
Added thSADC, and thSCD1/thSCD2 parameters for finer control<br/>
Tweaked prefilter=3 dfttest sigmas for better low frequency detail protection<br/>
Detached explanation and converted to html. Updated and extended the contents as well<br/>
Fine tuned and robustized the Show Panel<br/>
Optimized and organized code, more precisely the contrasharpening part<br/>
Fixed a few ternary checks for when Globals=3<br/>
Others
|-
|1.8d
|2012-01-18
|
Added automatic dark protection for prefilter=3 (dfttest performs badly in darks) v1.71d and extended its dark protection v1.8<br/>
Fixed chroma variable when chroma=false, from 2 (copy chroma) to 1 (discard chroma) v1.71d<br/>
Explanation and cosmetics v1.71d<br/>
Added acknowledgments and updated explanation<br/>
Added brackets to all functions (it has been reported to cause threading problems under certain circumstances) (https://forum.doom9.org/showthread.php?p=1515886#post1515886)<br/>
Reworked and fixed the parameters panel. Now you have a color guide to have an idea on what to tweak depending on selected mode in Show. For strings: "Speed", "Memory" and "Quality"<br/>
Optimized lsb_in for HD resolutions which was causing memory hogs<br/>
Fixed contrasharpening for YUY2 sources when lsb=true<br/>
Fixed some inconsistencies for YUY2 sources when prefilter=3
|-
|1.7d
|2012-01-11
|
Fixed and extended introduction explanation v.1.61d<br/>
Fixed some issues for Globals=1 (Read) in relation to lsb_in and luma expansion auto-prefilter v.1.61d<br/>
Added mild gauss blur prefilter option as prefilter=1. Consequent modes are displaced v.1.61d<br/>
Changed prefilter 1 and 2 to Minblur (Gauss/Median combination) v.1.63d<br/>
Updated MinBlur function v.1.62d and v.1.66<br/>
Code tidied up v.1.62d<br/>
Updated luma expansion, now you can enhance darks (with 'Str' and 'Amp') in the same step as the TV->PC conversion stage, thus +optimized, +quality. v.1.63d by cretindesalpes (https://forum.doom9.org/showthread.php?p=1548318#post1548318)<br/>
Removed pre_custom. Now use prefilter to load a prefiltered clip, as well as modes 0~3<br/>
Added Show parameter. Now you can see the used and default parameters along the prefilter clip as well<br/>
Fixed one note related to prefilter clip input for interlaced content
|-
|1.6d
|2011-12-24 (first open release)
|
Fixed and extended introduction explanation<br/>
Fixed Ditherpost for interlaced sources<br/>
Fixed a broken reference for reading MRecalculate globals when tr>3<br/>
Fixed a Globals=1 MSuper automatization<br/>
Fixed a plane processing bypass when chroma=false<br/>
Added LSFmod as optional contrasharpening (slower, but biased contrasharpening and probably better depending on source)<br/>
Added default luma expansion auto-prefilter for motion search (16% more values)<br/>
Added YUY2 support<br/>
Added the 'mode' parameter of Ditherpost()<br/>
Added support for interlaced temporal radius up to 6
|-
|1.5d
|2011-10-14
|
Changed "srchSuper" Global variable to "QTGMC_srchSuper", compatible with QTGMC. Anyhow you may probably want to create a new super clip. Test it out! v.1.41d<br/>
Introduction spelling and presentation v.1.42d<br/>
Added lsb and lsb_in for prefilter=2 (dfttest) v.1.43d & v.1.44d<br/>
Some better definitions for the settings help v.1.45d<br/>
pelclip is now subpixel = 3 ('sharp' parameter before) v.1.45d<br/>
Other minor tweaks v.1.45d<br/>
Fixed an important issue when using prefilter with subpixel=3 ('pelclip' parameter before)<br/>
Optimizations in Ditherpost for chroma<br/>
Changed rfilter (hierarchical levels smoothing/scaling) from default 2 to 4. Better results in my judge<br/>
Some more little tweaks in code and introduction
|-
|1.4d
|2011-09-16
|
Added pelclip option for top quality subpixel interpolation when pel > 1<br/>
Changed QTGMCV parameter to Globals, and added a bunch of new features like vectors output from SMDegrain()<br/>
Big introduction and code optimization tweaks
|-
|1.3d
|2011-09-14
|Fixed an important issue on the Interlaced parameter and improved overall handling (v.1.21d & v.1.3d)
|-
|1.2d
|2011-09-13
|
Added Interlaced parameter, for processing interlaced sources<br/>
Some introduction and code optimization tweaks (v.1.12d & v.1.2d)
|-
|1.1d
|2011-09-12
|
Implemented MDegrainN for tr > 3, from the MVTools2 mod of Dither<br/>
Minor introduction and code optimization tweaks
|-
|1.0d
|2011-09-09
|
Added CClip parameter. Reference an earlier stage of your processing chain as your sharp version for the contrasharpening
|-
|0.9d
|2011-09-09
|
Added QTGMCV parameter, for reusing vectors from QTGMC bob deinterlacer
|-
|0.8d
|2011-09-05
|
Fixed a few things related to the lsb_in option<br/>
Minor introduction and code optimization tweaks
|-
|0.7d
|2011-09-05
|
Implemented "fake" lsb_in option. Output will have slightly more quality (if any), and will compress better. (Experimental)<br/>
Fixed a not passed argument in the hpad, vpad parameters
|-
|0.6d
|2011-09-04
|
Minor introduction and code optimization tweaks
|-
|0.5d
|2011-07-19
|
Added dfttest option for preblur (now prefilter) option. Slower but better due to its internal deblock+denoise operation, plus sharper results<br/>
Added pre_custom option for the prefilter process, define here a denoised clip as your prefiltered version<br/>
Updated the introduction help
|-
|0.4d
|2011-06-03
|
Added preblur option for slight vector blurring where motionmatch is bad (https://forum.doom9.org/showthread.php?t=161594)<br/>
Added RefineMotion parameter for better motion vectors. Based off Killer() (https://forum.doom9.org/showthread.php?p=1266572#post1266572)<br/>
Added parameters "lsb" and "lsb_out", for the MVTools2 mod version of cretindesalpes' Dither (https://forum.doom9.org/showthread.php?p=1386559#post1386559)<br/>
Other minor aesthetics and performance adjustments
|-
|0.3d
|2011-03-04
|
First Mod version<br/>
Fixed plane (for MDegrain) and added chroma (for MAnalyse) parameters
|-
|0.2
|2010-01-24
|
Added introductory section<br/>
Added more parameters
|-
|0.1
|
Basic working version<br/>
Not released
|}

SMDegrain

2021-04-15T04:07:06Z

AmjadSONY: /* Dependencies */

{{FilterCat4|External_filters|Denoisers|Spatial-Temporal Denoisers|Deep_color_tools}}
{{Filter
| Caroliano, {{Author/Dogway}}, Real.Finder
| v3.1.2.110s
|
* [https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/SMDegrain.avsi SMDegrain]<br/>
| 4=Spatial-Temporal Denoisers
| 7=[https://forum.videohelp.com/threads/369142-Simple-MDegrain-Mod-v3-0d-A-Quality-Denoising-Solution VideoHelp], [https://forum.doom9.org/showthread.php?t=163604 Doom9], [https://forum.doom9.org/showthread.php?t=174121 Doom9 mod] }}

'''SMDegrain''', the Simple MDegrain Mod, is mainly a convenience function for using [[MVTools]]. It is not a magic function (the magic comes from mvtools), it just takes the repetitive code blocks needed for mvtools+mdegrain denoising and wraps them into this function.

It has internal switches for interlaced or YUY2 content '''''(but you should not use it in avs 2.6 and avs+ and use YV16 instead)''''', saving you from writing long lines of code and preventing from possible mistakes. YUY2 is even automatically detected. Apart of that it adds some small and simple enhancements listed below, like easy prefilters, slightly better motion vectors (thanks to an internal TV->PC luma expansion and the possibility of dark enhancement), easy nnedi3 subpixel accuracy, globals import/export, show panel, and contra-sharpening option.

==Dependencies==
* [[Zs_RF_Shared]]
* [[MVTools]] (mod versions recommended) and [[MaskTools2]] (it's not needed if TV_range set to false)

===Optional===
* [[Dither]] for lsb hack 16 bit processing (v1.26.5 or higher)
* [[RgTools]] for contrasharp=true or prefilter=1 or 2
* [[LSFmod]] for contrasharp > 0.0
* [[dfttest]] for prefilter=3
* [[nnedi3]] for subpixel=3
<strike>''Beware, tp7's plugin mods have no YUY2 support, require AviSynth 2.6a5 or latest Set's MT for v2.6, and Visual C++ 2012 Redistributable.''</strike>

==Aknowledgements==
Original '''SMDegrain()''' by Caroliano

This function uses code from Didée, and cretindesalpes' creations, and has parts inspired by LaTo's functions (old readme, Show panel, etc) and Jawed's Killer() function, apart of relying on third-party tools for certain features.

Special thanks go to: cretindesalpes, Didée, Gavino, Sagekilla, and MVtools people.

==Introduction==
The benefit of using SMDegrain over directly calling MDegrain is:
* '''High bitdepth with lsb denoising''': This is the first wrapper function to support 32bit (16bit pipeline) MDegrain denoising.
* '''Higher temporal radius''' (tr>3): The [[MVTools]] mod (and hence this script) also allows for hack-free higher temporal radius.
* '''Contrasharpening''': The pretty much standarized sharpening method created by Didée is blended into the function, so you can easily use it in 16bit pipelines. An strength biased method is also possible. A ''CClip'' parameter is also supplied so you can choose another source to sharpen from, other than the default '''SMDegrain()''' input.
* '''YUY2 support''': It automatically and fully supports YUY2. (but that not important now after avs 2.6 and avs+)
* '''Interlaced support''': It supports interlaced sources with most parameters as well.
* '''Extended Subpixel Accuracy''': [[nnedi3]] is allowed as a subpixel filter, not necessary in most cases, but if you are quality mad try to set it on.
* '''Better Motion Vectors''': An internal conversion from TV levels (reduced values range) to PC levels (extended values range) is done to the clip the motion analysis will be performed on, so you can get better motion vectors (up to 16%)
* '''Prefilters''': An easy parameter to load generalist prefilters that perform well in most situations. It also accepts loading your personal prefiltered clips.
* '''Motion Filters''': New in version 3.0d. It will allow you to filter those parts where '''SMDegrain()''' couldn't find a matching block for denoising. One use for it would be spatial denoisers or deblockers since high-motion areas are prone to heavy blocking and artifacts.
* '''Global Motion Vector In/Out''': Reuse motion vectors globals for faster processing, or just use '''SMDegrain()''' as a shortcut for creating nice quality motion vectors.
* '''RefineMotion Option''' (MRecalculate): Slower, but sometimes a big quality boost.
* '''Show Panel''': Everything is off by default, but some settings change in context. Check what is happening behind the scenes and have a fast look at all your settings.
* '''Robust''': Everything of the above works with each other no problem (interoperability), also in the process some error proof, bugfixes and bug workarounds were implemented or at least warned so you know that most of what is done is reliable, bugs free and optimized. The general idea is to serve as an user friendly front end for vanilla mvtools2+mdegrain or as the original script creator entitled "To make your scripts shorter and less geeky". Most parameters are turned off or defaulted to mvtools2 defaults and features are based on popular general conceived procedures.

Parameters are arranged in 3 blocks.
*'''Basic''': For people who just need the most basic parameters because either they don't have the time, knowledge or interest into looking for complex settings. Or they are content with defaults (pretty much mvtools defaults)
*'''High Bit Depth (with lsb hack) ((you should not use it in avs+))''': There's not much to think about this. This just enables (default is disabled), high bit depth denoising. That is, more quality, but also needs more processing power hence slower.
*'''Advanced''': If you run into some problems, are nitpicking or just want to fine tune your settings according to the source, have a look at this block, it contains the rest and bulk of the function parameters.

Temporal denoising is a widespread procedure for noise cleaning in most type of video sources. The only limitation for '''SMDegrain()''' being when there are (very) high levels of grain, in which case you would need to rely on more "creative" and source centric solutions (see [https://forum.doom9.org/showthread.php?p=1544619#post1544619 this] and ''prefilter'' notes), but those are the rare cases.

To picture what the function does, a simple '''SMDegrain()''' call matches the next code (for SD resolutions):

super_search = Dither_Luma_Rebuild(S0=1.0,c=0.0625).MSuper(rfilter=4)

bv2 = super_search.MAnalyse(isb = true, delta = 2, overlap= 4)
bv1 = super_search.MAnalyse(isb = true, delta = 1, overlap= 4)
fv1 = super_search.MAnalyse(isb = false, delta = 1, overlap= 4)
fv2 = super_search.MAnalyse(isb = false, delta = 2, overlap= 4)

MDegrain2(MSuper(levels=1), bv1, fv1, bv2, fv2, thSAD=300, thSADC=150)

As you see no wizardry. The only changes made are the TV->PC luma expansion (''Dither_Luma_Rebuild''(S0=1.0,c=0.0625) similar to ''color_yuv''(levels="TV->PC")) so you have more range to detect motion vectors, the ''rfilter''=4 for a bit more quality super search, the changed default of ''overlap'' from 0 to 4 and ''thSAD'' and ''thSADC'' from 400 to 300 and 150 respectively for safer results. Nothing else. The problem is that as soon you want to change a little thing like say temporal radius it requires you to edit in more than a few places, so this is very annoying and so forth the main reason for '''SMDegrain()'''.

==Using the filter==
*Input can be YV12 or YUY2, and '''must''' be TV range (which is normal). It's also recommended to be in modulus 16 size (resolution multiple of 16), although not strictly necessary.
*Crop first (when not interlaced).
*Recommended to deblock if blocking is present, before crop (when cropping) and '''SMDegrain()'''. Or you can use ''prefilter''=3 which is also a good deblocker (dfttest) and let '''SMDegrain()''' clean the blocking for you.
*Default output mode(dithering) for ''lsb''=true (when non interlaced) is ordered dither (optimized for encoding), so it is not recommended to keep filtering non-edge areas of your source, you can instead use ''mode''=6 (error diffusion) or ''lsb_out''=true and keep filtering in 16bit
*Read the ''prefilter'' setting explanation for solutions to problematic sources

==Ready-to-run Samples==

I consider this a good starting point where to start tweaking, whether be it for quality or speed:
SMDegrain(tr=2,thSAD=250,contrasharp=true,refinemotion=true,lsb=true)

A basic, fast, yet very functional call for light grain (mvtools2+masktools2 only needed)
SMDegrain(tr=1,thSAD=300,contrasharp=true)

A typical more worked call compatible with official mvtools2 (mvtools2+masktools2 only needed)
SMDegrain(tr=2,thSAD=300,interlaced=true,prefilter=1,contrasharp=true)

Good compromise between speed and quality (denoising with high precision)
SMDegrain(tr=2,thSAD=300,contrasharp=true,refinemotion=true,lsb=true)

Similar to the previous example, the next is a personal preference. Turned all chroma off for safeness (chroma is rarely temporal-reliable enough) and speed.
SMDegrain(tr=2,thSAD=300,contrasharp=true,refinemotion=true,lsb=true,chroma=false,plane=0)

This is a good example to show that interlaced YUY2 sources can be processed seamlessly.
# mod4 (modulus 4) interlaced YUY2 source
SMDegrain(tr=1,thSAD=250,interlaced=true,contrasharp=true,lsb=true)

HD sources are detected automatically, and as so settings are optimized for speed; ''pel''=1, ''hpad''=0, ''vpad''=0, ''blksize''=32, ''overlap''=16, ''truemotion''=false
# HD source (from 1100px wide or 600px high up)
SMDegrain(tr=2,thSAD=180,prefilter=2,contrasharp=30,refinemotion=true,lsb=true,chroma=false,plane=0)

For dealing with dark scenes (you could also add ''truemotion''=false)
SMDegrain(tr=3,thSAD=300,contrasharp=true,str=2.0,refinemotion=true,lsb=true)

Tackling a grainy source:
pre=fluxsmootht(3).removegrain(11)
SMDegrain(tr=6,thSAD=500,contrasharp=30,prefilter=pre,str=1.2,refinemotion=true,lsb=true)

Here 2 things are shown; how to work on a 16bit pipeline, and reference a prior state of the script for ''contrasharp''.
sharp=last
dfttest(tbsize=1,sigma=10,lsb=true)

SMDegrain(tr=3,thSAD=300,CClip=sharp,lsb_in=true,lsb_out=true)

LinearResize(854,480,lsb_in=true, mode=0)

(Re)using motion vectors globals
SMDegrain(tr=1,thSAD=400,prefilter=3,str=1.4,globals=3) # Output vectors only
MFlowFps(Super, bv1, fv1, num=60,den=1)

==Parameters==
{{FuncDef|SMDegrain}} (clip input, int "tr", int "thSAD", int "thSADC", bool "RefineMotion", val "contrasharp", clip "CClip", bool "interlaced", int "plane", int "Globals", int "pel", int "subpixel", val "prefilter", clip "mfilter", int "blksize", int "overlap", int "search", bool "truemotion", int "limit", int "limitc", int "thSCD1", int "thSCD2", bool "chroma", int "hpad", int "vpad", bool "lsb", bool "lsb_in", bool "lsb_out", int "mode", val "Show", float "Str", float "Amp")

===Basic===

{{ParR|tr|int|2|1-128}}
:Temporal radius, selects the MDegrain to use. This can be considered the strength of the denoising. Higher is generally better, but also much slower and each extra frame gives less improvement.
:tr 4+ requires Dither's MVTools2 mod. Max 64 for interlaced.

{{Par|thSAD|int|300}}
{{Par|thSADC|int|150}}
:"Sum of Absolute Differences" threshold. This is the spatial difference threshold where the motion search will consider whether to denoise given the formula:
::Denoise_Weight = max( 0, 1 - 2*blockSAD² / (thSAD² + blockSAD²) )
:This spatial difference will be compared in blocks (''blksize''). If your noise is not getting into consideration for the denoising try raising this value, or reduce its SAD with previous prefiltering. You can alternatively raise ''blksize'', which will likely even blocks SAD. Low values can result in staggered/blotchy denoising, large values can result in ghosting and artifacts. Values in the range 200~600 are usual.
:thSADC is the same logic applied to chroma planes, since there are less differences on the chroma planes it uses by default thSAD/2 for safer chroma results.
:'''Recommendation''': Use slightly greater values than you are used to in other mdegrain based functions since the internal clip for the motion search in SMDegrain() has the contrast increased.

{{ParR|Contrasharp|bool|False|True/False}}
{{ParR|Contrasharp|int|-|0-100}}
:Contrasharpening is a technique that compares the differences between the clip before blurring (original) and after blurring (filtered), and sharpens locally with consequent strength. By default the "sharp" clip is the input, the "after" clip is the denoised clip. Alternately, a "before" clip can be specified with ''CClip'' (See Advanced).
:*True: use Didée's Contrasharpening() function (ContraHD() for HD) which "Sharpens the denoised clip, but doesn't add more to any pixel than what was removed previously." In the practice you will get a slightly sharper result than the source, which is welcome.
:*An integer: LSFmod() will be used instead. It will be much slower, but maybe better for certain sources. Its value will serve as a contrasharpening multiplier, use one around 50 for similar strength as Contrasharpening(). LSFmod is less-suitable for HD sources.

{{Par|RefineMotion|bool|False}}
:Refines and recalculates motion data of previously estimated (by MAnalyse) motion vectors. Turn it on for better motion vectors, specially when dealing with ghosting issues, small details or lineart fading and whatnot.
:'''Caution''': It won't help much if you use a ''prefilter'' so strong that blurs too much or kills all the details you are aiming to protect in first place.

{{ParR|plane|int|4|0-4}}
:Select the planes you wish to process:
:*0: luma only
:*1: chroma U
:*2: chroma V
:*3: both chromas
:*4: all (Default)
:'''Caution''': plane=1-4 can sometimes create chroma smearing. In such case I recommend denoising chroma planes in the spatial domain.

{{Par|Interlaced|bool|False}}
:If you want to denoise an interlaced source set this parameter to true. Output will also be interlaced. If you pair this with ''lsb_out''=true then you will have to <tt>Weave().DitherPost(mode=6,interlaced=true)</tt> when converting back to 8 bit.

===High Bit Depth Processing And Dithering===
All High Bit Depth parameters require [[Dither]] and [[MVTools]] 2.6+. The [[AviSynth+]] doesn't need these parameters; it automatically outputs the same bitdepth as the input, but if you still need 99% alternative to lsb family there are n16 (don't has n16_in because it don't make any sense in that case).

{{Par|lsb_in|bool|False}}
:Set true if you use a 16 bits filter chain. *(EXPERIMENTAL, use under test environment)

{{Par|lsb_out|bool|False}}
:Output to 16-bit instead of 8-bit. Use the helpers at the end of the SMDegrain() script to use Ditherpost() with YUY2 formats.

{{Par|lsb|bool|False}}
:This enables 32 bit depth precision for denoising. You gain extra denoising accuracy, most noticeable in the prevention of banding in flat areas. Automatically set if either ''lsb_in'' or ''lsb_out'' are enabled.

{{ParR|mode|int|0|-1-8}}
:This is the '''mode''' of [[Dither#DitherPost|DitherPost]] when ''lsb_out''=False, as a dithering method must be chosen for the 32bit->8bit conversion. (Interlaced content is locked to mode=6) The default ''mode''=0 will help you optimize the dithering for optimum encodings when no further non-edge processing is done. Use ''mode''=6 (error diffusion) if further processing will be done.

===Advanced===

{{ParR|pel|int|2|1,2,4}}
:Accuracy of the motion estimation:
:* 1: full-pixel (Default for HD)
:* 2: half-pixel (Default for SD)
:* 4: quarter-pixel (often more accurate, but much slower and not always better)

{{ParR|subpixel|int|2|0-3}}
:Subpixel interpolation method for ''pel''=2 or 4. This is the 'sharp' parameter in MSuper(), although it isn't related to output sharpness but better accuracy for the motion estimation.
:* 0: bilinear (softest)
:* 1: bicubic (4 tap Catmull-Rom)
:* 2: sharper Wiener (6 tap, similar to Lanczos) (Default)
:* 3: [[nnedi3]] (very high quality: useful for small sources but usually overkill. requires plugin)

{{ParR|prefilter|int|-1|-1-3}}
{{Par|prefilter|clip|None}}
:* -1: off (Default)
:* 0: light controlled gauss blur
:* 1: mild median/gauss blur
:* 2: strong median/gauss blur
:* 3: [[dfttest]] (spatial)
:* clip: supply your own
:Denoises a version of the clip that will be used to obtain the motion vectors. Useful for very damaged/grainy sources, this will help to get better motion vectors.
:For sources with Gibbs noise, especially on anime, try ''prefilter''=1 or 2 or better yet strong median filters (through clip input) in order to soothe the high SAD of sharp edges. For blocky sources, or a general more quality/safer prefilter use option 3 (dfttest)
:By default dfttest outputs a sstring txt file to your script folder, you can delete it. This doesn't happen when using the modded dfttest (version 1.9.2 or higher) of the Dither tools.
:For HD sources ''prefilter''=2 makes more sense than 1, because it uses a wider denoising window.
:If instead you want to use your own prefilter denoiser, just define it in a variable and reference it here. Remember to:
:*Feed always 8 bit clips.
:*Input in fields for interlaced content *(read below)
:*Feed here planar ( by using Interleaved2Planar() ) YUY2 clips (not interleaved) when working with YUY2 sources.
:You will likely want to use spatial denoisers like median filters (removegrain=17, medianblur, etc). For very grainy or fizz grain noise you can try prefiltering in temporal or if this is not enough, try adding a new SMDegrain() line again but without globals. Use ''lsb_in'', ''lsb_out'' according so results are smooth. You can even use SMDegrain() as a prefilter for SMDegrain() in very temporal unstable sources.
:Another trick for fizz grain is to serve a prefiltered clip where bright values are more denoised than dark values, you can do this through luma masks with masktools2 code. Search in [https://forum.doom9.org/showthread.php?t=162813 Doom9] for reference.
:For interlaced sources remember:
::Spatial filtering: pre=separatefields().spatial_prefilters_here()
::Temporal filtering: pre=separatefields().interleave(selecteven().temporal_filters(),selectodd().temporal_filters())
:SMDegrain() (and MDegrain) is likely to produce blending artifacts or oversmooth in dark areas specially on cartoons, to tackle this see RefineMotion or expand the luma range in the darks. For this there are many options, you can use your preferred gamma enhancer and input it as the prefilter, or use the examples below for linear brightening (masktools2) and input it as a ''prefilter'' as well. Or at last and the recommended solution, to use the built-in ''Str'' (strength) and ''Amp'' (amplitude) parameters for a curve type dark enhancement, check the effects by enabling Show and changing your previewing conditions to PC levels.
:For brightening dark values linearly (brighter parts less brightening)
str=1
mt_lut("x x "+string(str)+" 6 * - 255 - abs 255 / ^ x 1 - abs +")
:Or for a more contrasty image (although not as much dark enhancing - not linear)
str=40
mt_lut("x x "+string(str)+" 6 * - 255 - abs 255 / ^ "+string(str)+" / x 1 - abs +")
:Good resources for custom prefilters:
:*https://forum.doom9.org/showthread.php?t=162813
:*https://forum.doom9.org/showthread.php?t=132310
:*https://forum.doom9.org/showthread.php?t=133977
:Notes: To sum it up; generally in denoising, temporal filters are always preferred due to its natural look (versus spatial filters). But more often than not for good results prefiltering plays a key role on the output quality, and setting it up nicely can be looked as an art by itself.
:If there's a reached point where no prefiltering, no ''thSAD'' tweaking, etc, makes able to denoise a certain motion part/area/scene, then this is due to the motion vectors preventing them from being "denoised" (also read "artifacted"), in which case you will need to rely on alternative solutions (motion compensation, filters like MCTemporalDenoise(), TemporalDegrain(), [https://forum.doom9.org/showthread.php?p=1544619#post1544619 Multilevel MDegrain], etc) or just use plain spatial filters with motion masks. Creating these discerning masks for static and motion scenes and combining them is a research task on the end user side.

{{Par|mfilter|clip|None}}
:Motion Filter, an optional user-supplied clip that will be passed through those areas where SMDegrain() couldn't find a matching block, normally high motion areas. One use for it would be to to use spatial filters, like deblockers or blurring filters that mimic motion blur.

{{ParR|Str|float|1.0|0.0-8.0}}
:Gamma correction. With this parameter you control the strength of the brightening of the ''prefilter'' clip, good for when problems with dark areas arise. Using this internally instead of externally creates less quantization artifacts, since it's done in the same stage as the TV->PC range conversion.

{{ParR|Amp|float|0.0625|0.0-1.0}}
:Used when ''Str'' <> 1.0. This defines the amplitude of the brightening in the luma range, for example by using 1.0 all the luma range will be used and the brightening will find its peak at luma value 128 in the original. Default is 0.0625 (1.0/16) which just sits over luma value 16 (256/16) This and ''Str'' are extrapolated arguments from [https://forum.doom9.org/showthread.php?p=1548318#post1548318 cretindesalpes' function], you can find a graph and more insight explanations at the original post.
:Check these 2 parameters effects by enabling ''show''.

{{ParR|blksize|int|8 for SD, 16 for HD|4,8,16}}
:Size of a block (horizontal x vertical). Larger blocks are faster and less sensitive to noise, but also less accurate.

{{Par|overlap|int|blksize/2}}
:Must be *even* and *less* than block size. Common values: ''blksize''/4 or ''blksize''/2. Larger ''overlap'' looks slightly better and runs slower.

{{ParR|Search|int|4|0-7}}
:This is the '''search''' of [[MVTools/MAnalyze|MAnalyze]].

{{Par|Truemotion|bool|True for SD, False for HD}}
:''Truemotion'' is a preset of some MVAnalyze parameter values. It allows easy to switch default values of all "true motion" parameters at once. Set it 'true' for true motion search (high vector coherence), set it 'false' to search motion vectors with best SAD. Truemotion is slower and may blur textures and thin details more, but will usually remove more noise.
:For HD sources where the main problems are just excessive grain, I have defaulted it to false, this is not only faster but honors detail accuracy (the main existing point for HD sources) and overall object shading.

{{Par|Chroma|bool|True}}
:Set false to totally ignore chroma for finding motion vectors, for more speed with little cost in quality or when your chroma is too bad to find good matches. Don't process chroma planes without chroma vectors, MVTools doesn't seem to work right.

{{Par|Hpad|int|''blksize'' for SD, 0 for HD}}
{{Par|Vpad|int|''blksize'' for SD, 0 for HD}}
:Horizontal/vertical padding added to source frame (left, right, top, and bottom) for better motion estimation near borders.
:Try to have clean borders in your source (no NAB/black borders) to start with before tweaking this setting. If necessary, crop beforehand ideally in multiples of 16. Turn it to 0 if you are running out of memory.

{{Par|thSCD1|int|based on ''blksize'': 4{{=}}>100, 8{{=}}>400, 16{{=}}>1600}}
:Threshold which decides whether a block has changed between the previous frame and the current one, used to tweak the scene change detection. Raising it will lower the number of blocks detected as changed. It may be useful for noisy or flickered video. To fix blending on scene changes on dark scenes, first try ''Str'' and ''Amp''.

{{ParR|thSCD2|int|130|0-250}}
:Threshold which sets how many blocks have to change for the frame to be considered as a scene change.

{{ParR|limit|int|255|1-255}}
{{ParR|limitC|int|255|1-255}}
:Maximal change of pixel luma/chroma, to prevent some artifacts.

{{Par|CClip|clip|None}}
:Optional sharp version for ''contrasharp'' to compare against; video resolution and properties must be the same (different bit depth is OK). Using this option defaults ''contrasharp'' to True.

{{ParR|Globals|int|0|0-3}}
:With this parameter you can create or load pre-processed motion vectors, to save doing the work for multiple SMDegrain calls.
:*0: Ignore globals, just process
:*1: Read globals and Process
:*2: Process and output globals
:*3: Output globals only, don't process
:Some parameters '''MUST MATCH''' between output and input stages: ''pel'', ''subpixel'', ''chroma'', and ''vpad''/''hpad'' cannot change. When reading (Globals=1) only some parameters work: ''tr'', ''thSAD'', ''plane'', ''limit'', ''limitc'', ''contrasharp'', ''CClip'', ''interlaced'' and the ''lsb'' parameters. Others are ignored.
:Global names that can be reused are: '''Super''', '''bv1''', '''fv1''', '''bv2''', '''fv2''', '''bv3''', '''fv3''', '''bv4''', '''fv4''', '''bv6''', '''fv6''', '''vmulti'''.
SMDegrain(tr=3,thSAD=400,globals=3) # Outputs vectors
SMDegrain(tr=3,thSAD=400,globals=1) # You can use a lower "tr" or "thSAD" if you want
:or
SMDegrain(tr=3,thSAD=400,globals=3) # Outputs vectors
Super = MSuper(levels=1) # Add this line just before if you have some processing between Globals Output and Input.
MDegrain3(Super, bv1, fv1, bv2, fv2, bv3, fv3, thSAD=400)

{{Par|Show|bool|False}}
{{ParR|Show|str|-|"Speed", "Memory", "Quality"}}
:This will show the prefiltered clip to be used for the motion search to the left(<--), and the used parameters list to the right (-->)
:If the parameters panel is broken i.e. overlapping lines, hidden lines, etc, most likely your settings are wrong, (e.g. ''lsb_in''=true when input is 8bit) so it will also work well as a debug function. If you set Show to a string as indicated above, related parameters will be highlighted to guide you on correctly tweaking the function. This is loosely based, so it doesn't exclude you from reading carefully every parameter explanation.
:Even when you are not using any prefiltering, the clip to be used for the motion search where you obtain the motion vectors, will be converted from TV levels to PC levels, the only exception being when using ''Globals''=1 (Read) in which case the "prefiltered" clip will be exactly the same as input clip (that is no luma conversion, although constrained to 8 bit). Additionally you can tweak the dark expansion with ''Str'' and ''Amp'' parameters and check the effects in the left panel, but be aware to change your viewing conditions as it is in PC levels.
:The left panel preserves its properties so you can crop out the right panel and use it as a prefilter clip of any MSuper(). Therefore if you are not processing chroma (''chroma''=false) the prefiltered clip will be green, don't panic, this is correct, this happens when the U and V planes are unset. In this regard for previewing tasks with prefilterings -- or just the ''Str'' and ''Amp'' effect -- set ''chroma'' to true temporally or follow with ''GreyScale''(). For YUY2 sources set ''Planar2Interleaved''() after cropping for previewing.

==Final Notes==
If there is an important parameter not implemented, you have any issue or found a bug, please don't hesitate and ask in its [https://forum.videohelp.com/threads/369142 VideoHelp thread].

==Changelog==
{| class="wikitable" style="border: 1px solid darkgray"
!Version
!Date
!Changes
|-
|v3.1.2.97s
|2018-03-26
|
Fix subpixel=3
Add Prefilter auto 16 (lsb) support<br/>
YUY2 support in avs 2.6 with masktools 2.6<br/>
medianblur2 now will be used in Minblur instead of Quantile RemoveGrainHD in avs 2.6<br/>
Add TV_range bool<br/>
Less lsb if not use lsb things and get ready for yv16 and yv24<br/>
Add dct<br/>
Add device_id for prefilter=4<br/>
No need to use Planar2Interleaved() after cropping in Show with YUY2 (this is old changed, and now with mvtools support yv16 most people will not use YUY2)<br/>
Add MDegrain4 and MDegrain5 and MDegrain6, this will make tr=4-6 faster<br/>
|-
|-
|3.1.2d
|2015-07-21
|
Fixed regression where external prefilters wouldn't be parsed for luma expansion
|-
|-
|3.1.1d
|2015-07-16
|
Workaround to force KNLMeansCL use discrete video card (now required)
|-
|-
|3.1d
|2015-07-14
|
New prefilter mode 4 for grainy sources. GPU based spatio-temporal KNLmeans<br/>
Added dither output mode "Random Dither".<br/>
Added "slices" option from Dither<br/>
Added soft=-2 (automatic) to internal lsfmod<br/>
Added assert for chroma denoise when luma only motion vectors (mvtools bug)<br/>
Improved lsb_in code (now using sub/add method)<br/>
Removed vpad/hpad=0 optimization preset for HD<br/>
Fixed prefilter=3 code for lsb_in YUY2<br/>
More fixes to Show Panel...<br/>
Updated and fixed documentation (notes on YUY2 support)<br/>
|-
|3.0d
|2015-03-27
|
Adjusted SD<>HD discretion<br/>
Added mfilter (Motion Filter) new feature<br/>
subpixel=3 (nnedi3); removed qual=2 due to possible blending bug (quote by cretindesalpes), this also boosts speed<br/>
Lowered the defaults for less aggressive denoise (still somewhat high)<br/>
Fixed chroma not showing in debug (show) mode when lsb=true and prefilter=3 were paired<br/>
Fixed long lasting issues in Show Panel for certain not mod height resolutions<br/>
Now prefilter=0 is minblur(0), lighter denoising than prefilter=1, default is now -1 (off)<br/>
Documentation update (plugin updates, notes, links, examples, etc)
|-
|2.2d
|2013-03-05
|
Removed one residual variable in Contrasharpening function<br/>
Fixed a regression at v2.0 for Interlaced YUY2 sources by changing wrong variable ifC to if0, and...<br/>
...adding a missing weave() to the last MergeChroma() call<br/>
Dropped Dither support. (Will still work/not work as before, but lack of official support renders it to a YMMV condition)
|-
|2.1d
|2012-09-09
|
Fixed Refinemotion Globals Input labels<br/>
Fixed ContrasharpeningHD Vectors for Interlaced HD sources<br/>
Added ability to import Global Vectors even when "tr" is lower than parent instance "tr" (credit to cretindesalpes)<br/>
Expanded support for Interlaced Denoising "tr" up to 64 (credit to cretindesalpes)<br/>
Cosmetics
|-
|2.0d
|2012-06-07
|
Fixed and optimized chroma handling for lsb_in, contrasharpening and YUY2 content v.1.95<br/>
Enhanced Chroma bypass on the sharpening stage<br/>
Merged ContraHD() internally for Contrasharpening in HD sources<br/>
Dropped QTGMC support on import/export motion vectors (small value for increased confusion)<br/>
Fixed Median code for planar inputs in MinBlur() (needs RemoveGrainHD, dropped medianblur requirement)<br/>
Defaulted truemotion to false for HD inputs<br/>
Code Optimization and Clean up<br/>
Others
|-
|1.9d
|2012-03-23
|
Added truemotion parameter (default=true), change it to false (as in MCTemporalDenoise()), so low frequency detail won't be lost (walls...), although it could leave more noise on high frequency details<br/>
Added thSADC, and thSCD1/thSCD2 parameters for finer control<br/>
Tweaked prefilter=3 dfttest sigmas for better low frequency detail protection<br/>
Detached explanation and converted to html. Updated and extended the contents as well<br/>
Fine tuned and robustized the Show Panel<br/>
Optimized and organized code, more precisely the contrasharpening part<br/>
Fixed a few ternary checks for when Globals=3<br/>
Others
|-
|1.8d
|2012-01-18
|
Added automatic dark protection for prefilter=3 (dfttest performs badly in darks) v1.71d and extended its dark protection v1.8<br/>
Fixed chroma variable when chroma=false, from 2 (copy chroma) to 1 (discard chroma) v1.71d<br/>
Explanation and cosmetics v1.71d<br/>
Added acknowledgments and updated explanation<br/>
Added brackets to all functions (it has been reported to cause threading problems under certain circumstances) (https://forum.doom9.org/showthread.php?p=1515886#post1515886)<br/>
Reworked and fixed the parameters panel. Now you have a color guide to have an idea on what to tweak depending on selected mode in Show. For strings: "Speed", "Memory" and "Quality"<br/>
Optimized lsb_in for HD resolutions which was causing memory hogs<br/>
Fixed contrasharpening for YUY2 sources when lsb=true<br/>
Fixed some inconsistencies for YUY2 sources when prefilter=3
|-
|1.7d
|2012-01-11
|
Fixed and extended introduction explanation v.1.61d<br/>
Fixed some issues for Globals=1 (Read) in relation to lsb_in and luma expansion auto-prefilter v.1.61d<br/>
Added mild gauss blur prefilter option as prefilter=1. Consequent modes are displaced v.1.61d<br/>
Changed prefilter 1 and 2 to Minblur (Gauss/Median combination) v.1.63d<br/>
Updated MinBlur function v.1.62d and v.1.66<br/>
Code tidied up v.1.62d<br/>
Updated luma expansion, now you can enhance darks (with 'Str' and 'Amp') in the same step as the TV->PC conversion stage, thus +optimized, +quality. v.1.63d by cretindesalpes (https://forum.doom9.org/showthread.php?p=1548318#post1548318)<br/>
Removed pre_custom. Now use prefilter to load a prefiltered clip, as well as modes 0~3<br/>
Added Show parameter. Now you can see the used and default parameters along the prefilter clip as well<br/>
Fixed one note related to prefilter clip input for interlaced content
|-
|1.6d
|2011-12-24 (first open release)
|
Fixed and extended introduction explanation<br/>
Fixed Ditherpost for interlaced sources<br/>
Fixed a broken reference for reading MRecalculate globals when tr>3<br/>
Fixed a Globals=1 MSuper automatization<br/>
Fixed a plane processing bypass when chroma=false<br/>
Added LSFmod as optional contrasharpening (slower, but biased contrasharpening and probably better depending on source)<br/>
Added default luma expansion auto-prefilter for motion search (16% more values)<br/>
Added YUY2 support<br/>
Added the 'mode' parameter of Ditherpost()<br/>
Added support for interlaced temporal radius up to 6
|-
|1.5d
|2011-10-14
|
Changed "srchSuper" Global variable to "QTGMC_srchSuper", compatible with QTGMC. Anyhow you may probably want to create a new super clip. Test it out! v.1.41d<br/>
Introduction spelling and presentation v.1.42d<br/>
Added lsb and lsb_in for prefilter=2 (dfttest) v.1.43d & v.1.44d<br/>
Some better definitions for the settings help v.1.45d<br/>
pelclip is now subpixel = 3 ('sharp' parameter before) v.1.45d<br/>
Other minor tweaks v.1.45d<br/>
Fixed an important issue when using prefilter with subpixel=3 ('pelclip' parameter before)<br/>
Optimizations in Ditherpost for chroma<br/>
Changed rfilter (hierarchical levels smoothing/scaling) from default 2 to 4. Better results in my judge<br/>
Some more little tweaks in code and introduction
|-
|1.4d
|2011-09-16
|
Added pelclip option for top quality subpixel interpolation when pel > 1<br/>
Changed QTGMCV parameter to Globals, and added a bunch of new features like vectors output from SMDegrain()<br/>
Big introduction and code optimization tweaks
|-
|1.3d
|2011-09-14
|Fixed an important issue on the Interlaced parameter and improved overall handling (v.1.21d & v.1.3d)
|-
|1.2d
|2011-09-13
|
Added Interlaced parameter, for processing interlaced sources<br/>
Some introduction and code optimization tweaks (v.1.12d & v.1.2d)
|-
|1.1d
|2011-09-12
|
Implemented MDegrainN for tr > 3, from the MVTools2 mod of Dither<br/>
Minor introduction and code optimization tweaks
|-
|1.0d
|2011-09-09
|
Added CClip parameter. Reference an earlier stage of your processing chain as your sharp version for the contrasharpening
|-
|0.9d
|2011-09-09
|
Added QTGMCV parameter, for reusing vectors from QTGMC bob deinterlacer
|-
|0.8d
|2011-09-05
|
Fixed a few things related to the lsb_in option<br/>
Minor introduction and code optimization tweaks
|-
|0.7d
|2011-09-05
|
Implemented "fake" lsb_in option. Output will have slightly more quality (if any), and will compress better. (Experimental)<br/>
Fixed a not passed argument in the hpad, vpad parameters
|-
|0.6d
|2011-09-04
|
Minor introduction and code optimization tweaks
|-
|0.5d
|2011-07-19
|
Added dfttest option for preblur (now prefilter) option. Slower but better due to its internal deblock+denoise operation, plus sharper results<br/>
Added pre_custom option for the prefilter process, define here a denoised clip as your prefiltered version<br/>
Updated the introduction help
|-
|0.4d
|2011-06-03
|
Added preblur option for slight vector blurring where motionmatch is bad (https://forum.doom9.org/showthread.php?t=161594)<br/>
Added RefineMotion parameter for better motion vectors. Based off Killer() (https://forum.doom9.org/showthread.php?p=1266572#post1266572)<br/>
Added parameters "lsb" and "lsb_out", for the MVTools2 mod version of cretindesalpes' Dither (https://forum.doom9.org/showthread.php?p=1386559#post1386559)<br/>
Other minor aesthetics and performance adjustments
|-
|0.3d
|2011-03-04
|
First Mod version<br/>
Fixed plane (for MDegrain) and added chroma (for MAnalyse) parameters
|-
|0.2
|2010-01-24
|
Added introductory section<br/>
Added more parameters
|-
|0.1
|
Basic working version<br/>
Not released
|}

SMDegrain

2021-03-31T05:38:59Z

AmjadSONY:

{{FilterCat4|External_filters|Denoisers|Spatial-Temporal Denoisers|Deep_color_tools}}
{{Filter
| Caroliano, {{Author/Dogway}}, Real.Finder
| v3.1.2.110s
|
* [https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/SMDegrain.avsi SMDegrain]<br/>
| 4=Spatial-Temporal Denoisers
| 7=[https://forum.videohelp.com/threads/369142-Simple-MDegrain-Mod-v3-0d-A-Quality-Denoising-Solution VideoHelp], [https://forum.doom9.org/showthread.php?t=163604 Doom9], [https://forum.doom9.org/showthread.php?t=174121 Doom9 mod] }}

'''SMDegrain''', the Simple MDegrain Mod, is mainly a convenience function for using [[MVTools]]. It is not a magic function (the magic comes from mvtools), it just takes the repetitive code blocks needed for mvtools+mdegrain denoising and wraps them into this function.

It has internal switches for interlaced or YUY2 content '''''(but you should not use it in avs 2.6 and avs+ and use YV16 instead)''''', saving you from writing long lines of code and preventing from possible mistakes. YUY2 is even automatically detected. Apart of that it adds some small and simple enhancements listed below, like easy prefilters, slightly better motion vectors (thanks to an internal TV->PC luma expansion and the possibility of dark enhancement), easy nnedi3 subpixel accuracy, globals import/export, show panel, and contra-sharpening option.

==Dependencies==
* [[Zs_RF_Shared]]
* [[MVTools]] (mod versions recommended) and [[MaskTools2]] (you will not needed if you set TV_range to false)

===Optional===
* [[Dither]] for 16 bit processing (v1.26.5 or higher)
* [[RgTools]] for contrasharp=true or prefilter=1 or 2
* [[LSFmod]] for contrasharp > 0.0
* [[dfttest]] for prefilter=3
* [[nnedi3]] for subpixel=3
<strike>''Beware, tp7's plugin mods have no YUY2 support, require AviSynth 2.6a5 or latest Set's MT for v2.6, and Visual C++ 2012 Redistributable.''</strike>

==Aknowledgements==
Original '''SMDegrain()''' by Caroliano

This function uses code from Didée, and cretindesalpes' creations, and has parts inspired by LaTo's functions (old readme, Show panel, etc) and Jawed's Killer() function, apart of relying on third-party tools for certain features.

Special thanks go to: cretindesalpes, Didée, Gavino, Sagekilla, and MVtools people.

==Introduction==
The benefit of using SMDegrain over directly calling MDegrain is:
* '''High bitdepth with lsb denoising''': This is the first wrapper function to support 32bit (16bit pipeline) MDegrain denoising.
* '''Higher temporal radius''' (tr>3): The [[MVTools]] mod (and hence this script) also allows for hack-free higher temporal radius.
* '''Contrasharpening''': The pretty much standarized sharpening method created by Didée is blended into the function, so you can easily use it in 16bit pipelines. An strength biased method is also possible. A ''CClip'' parameter is also supplied so you can choose another source to sharpen from, other than the default '''SMDegrain()''' input.
* '''YUY2 support''': It automatically and fully supports YUY2. (but that not important now after avs 2.6 and avs+)
* '''Interlaced support''': It supports interlaced sources with most parameters as well.
* '''Extended Subpixel Accuracy''': [[nnedi3]] is allowed as a subpixel filter, not necessary in most cases, but if you are quality mad try to set it on.
* '''Better Motion Vectors''': An internal conversion from TV levels (reduced values range) to PC levels (extended values range) is done to the clip the motion analysis will be performed on, so you can get better motion vectors (up to 16%)
* '''Prefilters''': An easy parameter to load generalist prefilters that perform well in most situations. It also accepts loading your personal prefiltered clips.
* '''Motion Filters''': New in version 3.0d. It will allow you to filter those parts where '''SMDegrain()''' couldn't find a matching block for denoising. One use for it would be spatial denoisers or deblockers since high-motion areas are prone to heavy blocking and artifacts.
* '''Global Motion Vector In/Out''': Reuse motion vectors globals for faster processing, or just use '''SMDegrain()''' as a shortcut for creating nice quality motion vectors.
* '''RefineMotion Option''' (MRecalculate): Slower, but sometimes a big quality boost.
* '''Show Panel''': Everything is off by default, but some settings change in context. Check what is happening behind the scenes and have a fast look at all your settings.
* '''Robust''': Everything of the above works with each other no problem (interoperability), also in the process some error proof, bugfixes and bug workarounds were implemented or at least warned so you know that most of what is done is reliable, bugs free and optimized. The general idea is to serve as an user friendly front end for vanilla mvtools2+mdegrain or as the original script creator entitled "To make your scripts shorter and less geeky". Most parameters are turned off or defaulted to mvtools2 defaults and features are based on popular general conceived procedures.

Parameters are arranged in 3 blocks.
*'''Basic''': For people who just need the most basic parameters because either they don't have the time, knowledge or interest into looking for complex settings. Or they are content with defaults (pretty much mvtools defaults)
*'''High Bit Depth (with lsb hack) ((you should not use it in avs+))''': There's not much to think about this. This just enables (default is disabled), high bit depth denoising. That is, more quality, but also needs more processing power hence slower.
*'''Advanced''': If you run into some problems, are nitpicking or just want to fine tune your settings according to the source, have a look at this block, it contains the rest and bulk of the function parameters.

Temporal denoising is a widespread procedure for noise cleaning in most type of video sources. The only limitation for '''SMDegrain()''' being when there are (very) high levels of grain, in which case you would need to rely on more "creative" and source centric solutions (see [https://forum.doom9.org/showthread.php?p=1544619#post1544619 this] and ''prefilter'' notes), but those are the rare cases.

To picture what the function does, a simple '''SMDegrain()''' call matches the next code (for SD resolutions):

super_search = Dither_Luma_Rebuild(S0=1.0,c=0.0625).MSuper(rfilter=4)

bv2 = super_search.MAnalyse(isb = true, delta = 2, overlap= 4)
bv1 = super_search.MAnalyse(isb = true, delta = 1, overlap= 4)
fv1 = super_search.MAnalyse(isb = false, delta = 1, overlap= 4)
fv2 = super_search.MAnalyse(isb = false, delta = 2, overlap= 4)

MDegrain2(MSuper(levels=1), bv1, fv1, bv2, fv2, thSAD=300, thSADC=150)

As you see no wizardry. The only changes made are the TV->PC luma expansion (''Dither_Luma_Rebuild''(S0=1.0,c=0.0625) similar to ''color_yuv''(levels="TV->PC")) so you have more range to detect motion vectors, the ''rfilter''=4 for a bit more quality super search, the changed default of ''overlap'' from 0 to 4 and ''thSAD'' and ''thSADC'' from 400 to 300 and 150 respectively for safer results. Nothing else. The problem is that as soon you want to change a little thing like say temporal radius it requires you to edit in more than a few places, so this is very annoying and so forth the main reason for '''SMDegrain()'''.

==Using the filter==
*Input can be YV12 or YUY2, and '''must''' be TV range (which is normal). It's also recommended to be in modulus 16 size (resolution multiple of 16), although not strictly necessary.
*Crop first (when not interlaced).
*Recommended to deblock if blocking is present, before crop (when cropping) and '''SMDegrain()'''. Or you can use ''prefilter''=3 which is also a good deblocker (dfttest) and let '''SMDegrain()''' clean the blocking for you.
*Default output mode(dithering) for ''lsb''=true (when non interlaced) is ordered dither (optimized for encoding), so it is not recommended to keep filtering non-edge areas of your source, you can instead use ''mode''=6 (error diffusion) or ''lsb_out''=true and keep filtering in 16bit
*Read the ''prefilter'' setting explanation for solutions to problematic sources

==Ready-to-run Samples==

I consider this a good starting point where to start tweaking, whether be it for quality or speed:
SMDegrain(tr=2,thSAD=250,contrasharp=true,refinemotion=true,lsb=true)

A basic, fast, yet very functional call for light grain (mvtools2+masktools2 only needed)
SMDegrain(tr=1,thSAD=300,contrasharp=true)

A typical more worked call compatible with official mvtools2 (mvtools2+masktools2 only needed)
SMDegrain(tr=2,thSAD=300,interlaced=true,prefilter=1,contrasharp=true)

Good compromise between speed and quality (denoising with high precision)
SMDegrain(tr=2,thSAD=300,contrasharp=true,refinemotion=true,lsb=true)

Similar to the previous example, the next is a personal preference. Turned all chroma off for safeness (chroma is rarely temporal-reliable enough) and speed.
SMDegrain(tr=2,thSAD=300,contrasharp=true,refinemotion=true,lsb=true,chroma=false,plane=0)

This is a good example to show that interlaced YUY2 sources can be processed seamlessly.
# mod4 (modulus 4) interlaced YUY2 source
SMDegrain(tr=1,thSAD=250,interlaced=true,contrasharp=true,lsb=true)

HD sources are detected automatically, and as so settings are optimized for speed; ''pel''=1, ''hpad''=0, ''vpad''=0, ''blksize''=32, ''overlap''=16, ''truemotion''=false
# HD source (from 1100px wide or 600px high up)
SMDegrain(tr=2,thSAD=180,prefilter=2,contrasharp=30,refinemotion=true,lsb=true,chroma=false,plane=0)

For dealing with dark scenes (you could also add ''truemotion''=false)
SMDegrain(tr=3,thSAD=300,contrasharp=true,str=2.0,refinemotion=true,lsb=true)

Tackling a grainy source:
pre=fluxsmootht(3).removegrain(11)
SMDegrain(tr=6,thSAD=500,contrasharp=30,prefilter=pre,str=1.2,refinemotion=true,lsb=true)

Here 2 things are shown; how to work on a 16bit pipeline, and reference a prior state of the script for ''contrasharp''.
sharp=last
dfttest(tbsize=1,sigma=10,lsb=true)

SMDegrain(tr=3,thSAD=300,CClip=sharp,lsb_in=true,lsb_out=true)

LinearResize(854,480,lsb_in=true, mode=0)

(Re)using motion vectors globals
SMDegrain(tr=1,thSAD=400,prefilter=3,str=1.4,globals=3) # Output vectors only
MFlowFps(Super, bv1, fv1, num=60,den=1)

==Parameters==
{{FuncDef|SMDegrain}} (clip input, int "tr", int "thSAD", int "thSADC", bool "RefineMotion", val "contrasharp", clip "CClip", bool "interlaced", int "plane", int "Globals", int "pel", int "subpixel", val "prefilter", clip "mfilter", int "blksize", int "overlap", int "search", bool "truemotion", int "limit", int "limitc", int "thSCD1", int "thSCD2", bool "chroma", int "hpad", int "vpad", bool "lsb", bool "lsb_in", bool "lsb_out", int "mode", val "Show", float "Str", float "Amp")

===Basic===

{{ParR|tr|int|2|1-128}}
:Temporal radius, selects the MDegrain to use. This can be considered the strength of the denoising. Higher is generally better, but also much slower and each extra frame gives less improvement.
:tr 4+ requires Dither's MVTools2 mod. Max 64 for interlaced.

{{Par|thSAD|int|300}}
{{Par|thSADC|int|150}}
:"Sum of Absolute Differences" threshold. This is the spatial difference threshold where the motion search will consider whether to denoise given the formula:
::Denoise_Weight = max( 0, 1 - 2*blockSAD² / (thSAD² + blockSAD²) )
:This spatial difference will be compared in blocks (''blksize''). If your noise is not getting into consideration for the denoising try raising this value, or reduce its SAD with previous prefiltering. You can alternatively raise ''blksize'', which will likely even blocks SAD. Low values can result in staggered/blotchy denoising, large values can result in ghosting and artifacts. Values in the range 200~600 are usual.
:thSADC is the same logic applied to chroma planes, since there are less differences on the chroma planes it uses by default thSAD/2 for safer chroma results.
:'''Recommendation''': Use slightly greater values than you are used to in other mdegrain based functions since the internal clip for the motion search in SMDegrain() has the contrast increased.

{{ParR|Contrasharp|bool|False|True/False}}
{{ParR|Contrasharp|int|-|0-100}}
:Contrasharpening is a technique that compares the differences between the clip before blurring (original) and after blurring (filtered), and sharpens locally with consequent strength. By default the "sharp" clip is the input, the "after" clip is the denoised clip. Alternately, a "before" clip can be specified with ''CClip'' (See Advanced).
:*True: use Didée's Contrasharpening() function (ContraHD() for HD) which "Sharpens the denoised clip, but doesn't add more to any pixel than what was removed previously." In the practice you will get a slightly sharper result than the source, which is welcome.
:*An integer: LSFmod() will be used instead. It will be much slower, but maybe better for certain sources. Its value will serve as a contrasharpening multiplier, use one around 50 for similar strength as Contrasharpening(). LSFmod is less-suitable for HD sources.

{{Par|RefineMotion|bool|False}}
:Refines and recalculates motion data of previously estimated (by MAnalyse) motion vectors. Turn it on for better motion vectors, specially when dealing with ghosting issues, small details or lineart fading and whatnot.
:'''Caution''': It won't help much if you use a ''prefilter'' so strong that blurs too much or kills all the details you are aiming to protect in first place.

{{ParR|plane|int|4|0-4}}
:Select the planes you wish to process:
:*0: luma only
:*1: chroma U
:*2: chroma V
:*3: both chromas
:*4: all (Default)
:'''Caution''': plane=1-4 can sometimes create chroma smearing. In such case I recommend denoising chroma planes in the spatial domain.

{{Par|Interlaced|bool|False}}
:If you want to denoise an interlaced source set this parameter to true. Output will also be interlaced. If you pair this with ''lsb_out''=true then you will have to <tt>Weave().DitherPost(mode=6,interlaced=true)</tt> when converting back to 8 bit.

===High Bit Depth Processing And Dithering===
All High Bit Depth parameters require [[Dither]] and [[MVTools]] 2.6+. The [[AviSynth+]] doesn't need these parameters; it automatically outputs the same bitdepth as the input, but if you still need 99% alternative to lsb family there are n16 (don't has n16_in because it don't make any sense in that case).

{{Par|lsb_in|bool|False}}
:Set true if you use a 16 bits filter chain. *(EXPERIMENTAL, use under test environment)

{{Par|lsb_out|bool|False}}
:Output to 16-bit instead of 8-bit. Use the helpers at the end of the SMDegrain() script to use Ditherpost() with YUY2 formats.

{{Par|lsb|bool|False}}
:This enables 32 bit depth precision for denoising. You gain extra denoising accuracy, most noticeable in the prevention of banding in flat areas. Automatically set if either ''lsb_in'' or ''lsb_out'' are enabled.

{{ParR|mode|int|0|-1-8}}
:This is the '''mode''' of [[Dither#DitherPost|DitherPost]] when ''lsb_out''=False, as a dithering method must be chosen for the 32bit->8bit conversion. (Interlaced content is locked to mode=6) The default ''mode''=0 will help you optimize the dithering for optimum encodings when no further non-edge processing is done. Use ''mode''=6 (error diffusion) if further processing will be done.

===Advanced===

{{ParR|pel|int|2|1,2,4}}
:Accuracy of the motion estimation:
:* 1: full-pixel (Default for HD)
:* 2: half-pixel (Default for SD)
:* 4: quarter-pixel (often more accurate, but much slower and not always better)

{{ParR|subpixel|int|2|0-3}}
:Subpixel interpolation method for ''pel''=2 or 4. This is the 'sharp' parameter in MSuper(), although it isn't related to output sharpness but better accuracy for the motion estimation.
:* 0: bilinear (softest)
:* 1: bicubic (4 tap Catmull-Rom)
:* 2: sharper Wiener (6 tap, similar to Lanczos) (Default)
:* 3: [[nnedi3]] (very high quality: useful for small sources but usually overkill. requires plugin)

{{ParR|prefilter|int|-1|-1-3}}
{{Par|prefilter|clip|None}}
:* -1: off (Default)
:* 0: light controlled gauss blur
:* 1: mild median/gauss blur
:* 2: strong median/gauss blur
:* 3: [[dfttest]] (spatial)
:* clip: supply your own
:Denoises a version of the clip that will be used to obtain the motion vectors. Useful for very damaged/grainy sources, this will help to get better motion vectors.
:For sources with Gibbs noise, especially on anime, try ''prefilter''=1 or 2 or better yet strong median filters (through clip input) in order to soothe the high SAD of sharp edges. For blocky sources, or a general more quality/safer prefilter use option 3 (dfttest)
:By default dfttest outputs a sstring txt file to your script folder, you can delete it. This doesn't happen when using the modded dfttest (version 1.9.2 or higher) of the Dither tools.
:For HD sources ''prefilter''=2 makes more sense than 1, because it uses a wider denoising window.
:If instead you want to use your own prefilter denoiser, just define it in a variable and reference it here. Remember to:
:*Feed always 8 bit clips.
:*Input in fields for interlaced content *(read below)
:*Feed here planar ( by using Interleaved2Planar() ) YUY2 clips (not interleaved) when working with YUY2 sources.
:You will likely want to use spatial denoisers like median filters (removegrain=17, medianblur, etc). For very grainy or fizz grain noise you can try prefiltering in temporal or if this is not enough, try adding a new SMDegrain() line again but without globals. Use ''lsb_in'', ''lsb_out'' according so results are smooth. You can even use SMDegrain() as a prefilter for SMDegrain() in very temporal unstable sources.
:Another trick for fizz grain is to serve a prefiltered clip where bright values are more denoised than dark values, you can do this through luma masks with masktools2 code. Search in [https://forum.doom9.org/showthread.php?t=162813 Doom9] for reference.
:For interlaced sources remember:
::Spatial filtering: pre=separatefields().spatial_prefilters_here()
::Temporal filtering: pre=separatefields().interleave(selecteven().temporal_filters(),selectodd().temporal_filters())
:SMDegrain() (and MDegrain) is likely to produce blending artifacts or oversmooth in dark areas specially on cartoons, to tackle this see RefineMotion or expand the luma range in the darks. For this there are many options, you can use your preferred gamma enhancer and input it as the prefilter, or use the examples below for linear brightening (masktools2) and input it as a ''prefilter'' as well. Or at last and the recommended solution, to use the built-in ''Str'' (strength) and ''Amp'' (amplitude) parameters for a curve type dark enhancement, check the effects by enabling Show and changing your previewing conditions to PC levels.
:For brightening dark values linearly (brighter parts less brightening)
str=1
mt_lut("x x "+string(str)+" 6 * - 255 - abs 255 / ^ x 1 - abs +")
:Or for a more contrasty image (although not as much dark enhancing - not linear)
str=40
mt_lut("x x "+string(str)+" 6 * - 255 - abs 255 / ^ "+string(str)+" / x 1 - abs +")
:Good resources for custom prefilters:
:*https://forum.doom9.org/showthread.php?t=162813
:*https://forum.doom9.org/showthread.php?t=132310
:*https://forum.doom9.org/showthread.php?t=133977
:Notes: To sum it up; generally in denoising, temporal filters are always preferred due to its natural look (versus spatial filters). But more often than not for good results prefiltering plays a key role on the output quality, and setting it up nicely can be looked as an art by itself.
:If there's a reached point where no prefiltering, no ''thSAD'' tweaking, etc, makes able to denoise a certain motion part/area/scene, then this is due to the motion vectors preventing them from being "denoised" (also read "artifacted"), in which case you will need to rely on alternative solutions (motion compensation, filters like MCTemporalDenoise(), TemporalDegrain(), [https://forum.doom9.org/showthread.php?p=1544619#post1544619 Multilevel MDegrain], etc) or just use plain spatial filters with motion masks. Creating these discerning masks for static and motion scenes and combining them is a research task on the end user side.

{{Par|mfilter|clip|None}}
:Motion Filter, an optional user-supplied clip that will be passed through those areas where SMDegrain() couldn't find a matching block, normally high motion areas. One use for it would be to to use spatial filters, like deblockers or blurring filters that mimic motion blur.

{{ParR|Str|float|1.0|0.0-8.0}}
:Gamma correction. With this parameter you control the strength of the brightening of the ''prefilter'' clip, good for when problems with dark areas arise. Using this internally instead of externally creates less quantization artifacts, since it's done in the same stage as the TV->PC range conversion.

{{ParR|Amp|float|0.0625|0.0-1.0}}
:Used when ''Str'' <> 1.0. This defines the amplitude of the brightening in the luma range, for example by using 1.0 all the luma range will be used and the brightening will find its peak at luma value 128 in the original. Default is 0.0625 (1.0/16) which just sits over luma value 16 (256/16) This and ''Str'' are extrapolated arguments from [https://forum.doom9.org/showthread.php?p=1548318#post1548318 cretindesalpes' function], you can find a graph and more insight explanations at the original post.
:Check these 2 parameters effects by enabling ''show''.

{{ParR|blksize|int|8 for SD, 16 for HD|4,8,16}}
:Size of a block (horizontal x vertical). Larger blocks are faster and less sensitive to noise, but also less accurate.

{{Par|overlap|int|blksize/2}}
:Must be *even* and *less* than block size. Common values: ''blksize''/4 or ''blksize''/2. Larger ''overlap'' looks slightly better and runs slower.

{{ParR|Search|int|4|0-7}}
:This is the '''search''' of [[MVTools/MAnalyze|MAnalyze]].

{{Par|Truemotion|bool|True for SD, False for HD}}
:''Truemotion'' is a preset of some MVAnalyze parameter values. It allows easy to switch default values of all "true motion" parameters at once. Set it 'true' for true motion search (high vector coherence), set it 'false' to search motion vectors with best SAD. Truemotion is slower and may blur textures and thin details more, but will usually remove more noise.
:For HD sources where the main problems are just excessive grain, I have defaulted it to false, this is not only faster but honors detail accuracy (the main existing point for HD sources) and overall object shading.

{{Par|Chroma|bool|True}}
:Set false to totally ignore chroma for finding motion vectors, for more speed with little cost in quality or when your chroma is too bad to find good matches. Don't process chroma planes without chroma vectors, MVTools doesn't seem to work right.

{{Par|Hpad|int|''blksize'' for SD, 0 for HD}}
{{Par|Vpad|int|''blksize'' for SD, 0 for HD}}
:Horizontal/vertical padding added to source frame (left, right, top, and bottom) for better motion estimation near borders.
:Try to have clean borders in your source (no NAB/black borders) to start with before tweaking this setting. If necessary, crop beforehand ideally in multiples of 16. Turn it to 0 if you are running out of memory.

{{Par|thSCD1|int|based on ''blksize'': 4{{=}}>100, 8{{=}}>400, 16{{=}}>1600}}
:Threshold which decides whether a block has changed between the previous frame and the current one, used to tweak the scene change detection. Raising it will lower the number of blocks detected as changed. It may be useful for noisy or flickered video. To fix blending on scene changes on dark scenes, first try ''Str'' and ''Amp''.

{{ParR|thSCD2|int|130|0-250}}
:Threshold which sets how many blocks have to change for the frame to be considered as a scene change.

{{ParR|limit|int|255|1-255}}
{{ParR|limitC|int|255|1-255}}
:Maximal change of pixel luma/chroma, to prevent some artifacts.

{{Par|CClip|clip|None}}
:Optional sharp version for ''contrasharp'' to compare against; video resolution and properties must be the same (different bit depth is OK). Using this option defaults ''contrasharp'' to True.

{{ParR|Globals|int|0|0-3}}
:With this parameter you can create or load pre-processed motion vectors, to save doing the work for multiple SMDegrain calls.
:*0: Ignore globals, just process
:*1: Read globals and Process
:*2: Process and output globals
:*3: Output globals only, don't process
:Some parameters '''MUST MATCH''' between output and input stages: ''pel'', ''subpixel'', ''chroma'', and ''vpad''/''hpad'' cannot change. When reading (Globals=1) only some parameters work: ''tr'', ''thSAD'', ''plane'', ''limit'', ''limitc'', ''contrasharp'', ''CClip'', ''interlaced'' and the ''lsb'' parameters. Others are ignored.
:Global names that can be reused are: '''Super''', '''bv1''', '''fv1''', '''bv2''', '''fv2''', '''bv3''', '''fv3''', '''bv4''', '''fv4''', '''bv6''', '''fv6''', '''vmulti'''.
SMDegrain(tr=3,thSAD=400,globals=3) # Outputs vectors
SMDegrain(tr=3,thSAD=400,globals=1) # You can use a lower "tr" or "thSAD" if you want
:or
SMDegrain(tr=3,thSAD=400,globals=3) # Outputs vectors
Super = MSuper(levels=1) # Add this line just before if you have some processing between Globals Output and Input.
MDegrain3(Super, bv1, fv1, bv2, fv2, bv3, fv3, thSAD=400)

{{Par|Show|bool|False}}
{{ParR|Show|str|-|"Speed", "Memory", "Quality"}}
:This will show the prefiltered clip to be used for the motion search to the left(<--), and the used parameters list to the right (-->)
:If the parameters panel is broken i.e. overlapping lines, hidden lines, etc, most likely your settings are wrong, (e.g. ''lsb_in''=true when input is 8bit) so it will also work well as a debug function. If you set Show to a string as indicated above, related parameters will be highlighted to guide you on correctly tweaking the function. This is loosely based, so it doesn't exclude you from reading carefully every parameter explanation.
:Even when you are not using any prefiltering, the clip to be used for the motion search where you obtain the motion vectors, will be converted from TV levels to PC levels, the only exception being when using ''Globals''=1 (Read) in which case the "prefiltered" clip will be exactly the same as input clip (that is no luma conversion, although constrained to 8 bit). Additionally you can tweak the dark expansion with ''Str'' and ''Amp'' parameters and check the effects in the left panel, but be aware to change your viewing conditions as it is in PC levels.
:The left panel preserves its properties so you can crop out the right panel and use it as a prefilter clip of any MSuper(). Therefore if you are not processing chroma (''chroma''=false) the prefiltered clip will be green, don't panic, this is correct, this happens when the U and V planes are unset. In this regard for previewing tasks with prefilterings -- or just the ''Str'' and ''Amp'' effect -- set ''chroma'' to true temporally or follow with ''GreyScale''(). For YUY2 sources set ''Planar2Interleaved''() after cropping for previewing.

==Final Notes==
If there is an important parameter not implemented, you have any issue or found a bug, please don't hesitate and ask in its [https://forum.videohelp.com/threads/369142 VideoHelp thread].

==Changelog==
{| class="wikitable" style="border: 1px solid darkgray"
!Version
!Date
!Changes
|-
|v3.1.2.97s
|2018-03-26
|
Fix subpixel=3
Add Prefilter auto 16 (lsb) support<br/>
YUY2 support in avs 2.6 with masktools 2.6<br/>
medianblur2 now will be used in Minblur instead of Quantile RemoveGrainHD in avs 2.6<br/>
Add TV_range bool<br/>
Less lsb if not use lsb things and get ready for yv16 and yv24<br/>
Add dct<br/>
Add device_id for prefilter=4<br/>
No need to use Planar2Interleaved() after cropping in Show with YUY2 (this is old changed, and now with mvtools support yv16 most people will not use YUY2)<br/>
Add MDegrain4 and MDegrain5 and MDegrain6, this will make tr=4-6 faster<br/>
|-
|-
|3.1.2d
|2015-07-21
|
Fixed regression where external prefilters wouldn't be parsed for luma expansion
|-
|-
|3.1.1d
|2015-07-16
|
Workaround to force KNLMeansCL use discrete video card (now required)
|-
|-
|3.1d
|2015-07-14
|
New prefilter mode 4 for grainy sources. GPU based spatio-temporal KNLmeans<br/>
Added dither output mode "Random Dither".<br/>
Added "slices" option from Dither<br/>
Added soft=-2 (automatic) to internal lsfmod<br/>
Added assert for chroma denoise when luma only motion vectors (mvtools bug)<br/>
Improved lsb_in code (now using sub/add method)<br/>
Removed vpad/hpad=0 optimization preset for HD<br/>
Fixed prefilter=3 code for lsb_in YUY2<br/>
More fixes to Show Panel...<br/>
Updated and fixed documentation (notes on YUY2 support)<br/>
|-
|3.0d
|2015-03-27
|
Adjusted SD<>HD discretion<br/>
Added mfilter (Motion Filter) new feature<br/>
subpixel=3 (nnedi3); removed qual=2 due to possible blending bug (quote by cretindesalpes), this also boosts speed<br/>
Lowered the defaults for less aggressive denoise (still somewhat high)<br/>
Fixed chroma not showing in debug (show) mode when lsb=true and prefilter=3 were paired<br/>
Fixed long lasting issues in Show Panel for certain not mod height resolutions<br/>
Now prefilter=0 is minblur(0), lighter denoising than prefilter=1, default is now -1 (off)<br/>
Documentation update (plugin updates, notes, links, examples, etc)
|-
|2.2d
|2013-03-05
|
Removed one residual variable in Contrasharpening function<br/>
Fixed a regression at v2.0 for Interlaced YUY2 sources by changing wrong variable ifC to if0, and...<br/>
...adding a missing weave() to the last MergeChroma() call<br/>
Dropped Dither support. (Will still work/not work as before, but lack of official support renders it to a YMMV condition)
|-
|2.1d
|2012-09-09
|
Fixed Refinemotion Globals Input labels<br/>
Fixed ContrasharpeningHD Vectors for Interlaced HD sources<br/>
Added ability to import Global Vectors even when "tr" is lower than parent instance "tr" (credit to cretindesalpes)<br/>
Expanded support for Interlaced Denoising "tr" up to 64 (credit to cretindesalpes)<br/>
Cosmetics
|-
|2.0d
|2012-06-07
|
Fixed and optimized chroma handling for lsb_in, contrasharpening and YUY2 content v.1.95<br/>
Enhanced Chroma bypass on the sharpening stage<br/>
Merged ContraHD() internally for Contrasharpening in HD sources<br/>
Dropped QTGMC support on import/export motion vectors (small value for increased confusion)<br/>
Fixed Median code for planar inputs in MinBlur() (needs RemoveGrainHD, dropped medianblur requirement)<br/>
Defaulted truemotion to false for HD inputs<br/>
Code Optimization and Clean up<br/>
Others
|-
|1.9d
|2012-03-23
|
Added truemotion parameter (default=true), change it to false (as in MCTemporalDenoise()), so low frequency detail won't be lost (walls...), although it could leave more noise on high frequency details<br/>
Added thSADC, and thSCD1/thSCD2 parameters for finer control<br/>
Tweaked prefilter=3 dfttest sigmas for better low frequency detail protection<br/>
Detached explanation and converted to html. Updated and extended the contents as well<br/>
Fine tuned and robustized the Show Panel<br/>
Optimized and organized code, more precisely the contrasharpening part<br/>
Fixed a few ternary checks for when Globals=3<br/>
Others
|-
|1.8d
|2012-01-18
|
Added automatic dark protection for prefilter=3 (dfttest performs badly in darks) v1.71d and extended its dark protection v1.8<br/>
Fixed chroma variable when chroma=false, from 2 (copy chroma) to 1 (discard chroma) v1.71d<br/>
Explanation and cosmetics v1.71d<br/>
Added acknowledgments and updated explanation<br/>
Added brackets to all functions (it has been reported to cause threading problems under certain circumstances) (https://forum.doom9.org/showthread.php?p=1515886#post1515886)<br/>
Reworked and fixed the parameters panel. Now you have a color guide to have an idea on what to tweak depending on selected mode in Show. For strings: "Speed", "Memory" and "Quality"<br/>
Optimized lsb_in for HD resolutions which was causing memory hogs<br/>
Fixed contrasharpening for YUY2 sources when lsb=true<br/>
Fixed some inconsistencies for YUY2 sources when prefilter=3
|-
|1.7d
|2012-01-11
|
Fixed and extended introduction explanation v.1.61d<br/>
Fixed some issues for Globals=1 (Read) in relation to lsb_in and luma expansion auto-prefilter v.1.61d<br/>
Added mild gauss blur prefilter option as prefilter=1. Consequent modes are displaced v.1.61d<br/>
Changed prefilter 1 and 2 to Minblur (Gauss/Median combination) v.1.63d<br/>
Updated MinBlur function v.1.62d and v.1.66<br/>
Code tidied up v.1.62d<br/>
Updated luma expansion, now you can enhance darks (with 'Str' and 'Amp') in the same step as the TV->PC conversion stage, thus +optimized, +quality. v.1.63d by cretindesalpes (https://forum.doom9.org/showthread.php?p=1548318#post1548318)<br/>
Removed pre_custom. Now use prefilter to load a prefiltered clip, as well as modes 0~3<br/>
Added Show parameter. Now you can see the used and default parameters along the prefilter clip as well<br/>
Fixed one note related to prefilter clip input for interlaced content
|-
|1.6d
|2011-12-24 (first open release)
|
Fixed and extended introduction explanation<br/>
Fixed Ditherpost for interlaced sources<br/>
Fixed a broken reference for reading MRecalculate globals when tr>3<br/>
Fixed a Globals=1 MSuper automatization<br/>
Fixed a plane processing bypass when chroma=false<br/>
Added LSFmod as optional contrasharpening (slower, but biased contrasharpening and probably better depending on source)<br/>
Added default luma expansion auto-prefilter for motion search (16% more values)<br/>
Added YUY2 support<br/>
Added the 'mode' parameter of Ditherpost()<br/>
Added support for interlaced temporal radius up to 6
|-
|1.5d
|2011-10-14
|
Changed "srchSuper" Global variable to "QTGMC_srchSuper", compatible with QTGMC. Anyhow you may probably want to create a new super clip. Test it out! v.1.41d<br/>
Introduction spelling and presentation v.1.42d<br/>
Added lsb and lsb_in for prefilter=2 (dfttest) v.1.43d & v.1.44d<br/>
Some better definitions for the settings help v.1.45d<br/>
pelclip is now subpixel = 3 ('sharp' parameter before) v.1.45d<br/>
Other minor tweaks v.1.45d<br/>
Fixed an important issue when using prefilter with subpixel=3 ('pelclip' parameter before)<br/>
Optimizations in Ditherpost for chroma<br/>
Changed rfilter (hierarchical levels smoothing/scaling) from default 2 to 4. Better results in my judge<br/>
Some more little tweaks in code and introduction
|-
|1.4d
|2011-09-16
|
Added pelclip option for top quality subpixel interpolation when pel > 1<br/>
Changed QTGMCV parameter to Globals, and added a bunch of new features like vectors output from SMDegrain()<br/>
Big introduction and code optimization tweaks
|-
|1.3d
|2011-09-14
|Fixed an important issue on the Interlaced parameter and improved overall handling (v.1.21d & v.1.3d)
|-
|1.2d
|2011-09-13
|
Added Interlaced parameter, for processing interlaced sources<br/>
Some introduction and code optimization tweaks (v.1.12d & v.1.2d)
|-
|1.1d
|2011-09-12
|
Implemented MDegrainN for tr > 3, from the MVTools2 mod of Dither<br/>
Minor introduction and code optimization tweaks
|-
|1.0d
|2011-09-09
|
Added CClip parameter. Reference an earlier stage of your processing chain as your sharp version for the contrasharpening
|-
|0.9d
|2011-09-09
|
Added QTGMCV parameter, for reusing vectors from QTGMC bob deinterlacer
|-
|0.8d
|2011-09-05
|
Fixed a few things related to the lsb_in option<br/>
Minor introduction and code optimization tweaks
|-
|0.7d
|2011-09-05
|
Implemented "fake" lsb_in option. Output will have slightly more quality (if any), and will compress better. (Experimental)<br/>
Fixed a not passed argument in the hpad, vpad parameters
|-
|0.6d
|2011-09-04
|
Minor introduction and code optimization tweaks
|-
|0.5d
|2011-07-19
|
Added dfttest option for preblur (now prefilter) option. Slower but better due to its internal deblock+denoise operation, plus sharper results<br/>
Added pre_custom option for the prefilter process, define here a denoised clip as your prefiltered version<br/>
Updated the introduction help
|-
|0.4d
|2011-06-03
|
Added preblur option for slight vector blurring where motionmatch is bad (https://forum.doom9.org/showthread.php?t=161594)<br/>
Added RefineMotion parameter for better motion vectors. Based off Killer() (https://forum.doom9.org/showthread.php?p=1266572#post1266572)<br/>
Added parameters "lsb" and "lsb_out", for the MVTools2 mod version of cretindesalpes' Dither (https://forum.doom9.org/showthread.php?p=1386559#post1386559)<br/>
Other minor aesthetics and performance adjustments
|-
|0.3d
|2011-03-04
|
First Mod version<br/>
Fixed plane (for MDegrain) and added chroma (for MAnalyse) parameters
|-
|0.2
|2010-01-24
|
Added introductory section<br/>
Added more parameters
|-
|0.1
|
Basic working version<br/>
Not released
|}

EdgeFixer

2021-03-28T05:38:55Z

AmjadSONY:

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Borders and Cropping|Deep_color_tools}}
{{Filter3
|[https://github.com/sekrit-twc sekrit-twc]
|25 Mar 2019
|3=[http://s000.tinyupload.com/index.php?file_id=15734691908025476289 EdgeFixer.7z]
|4=Borders and Cropping
|5=
|6=
}}

== Description ==
EdgeFixer repairs bright and dark line artifacts near the border of an image. When an image is resampled with a negative-lobe kernel, such as Bicubic or Lanczos, a series of bright and dark lines may appear around the image borders. These lines need not be cropped, as they contain spatial information that can be recovered. EdgeFixer uses least squares regression to correct the offending lines based on a reference line. ContinuityFixer uses the adjacent line as the reference, whereas ReferenceFixer uses an external reference image.

See [https://github.com/sekrit-twc/EdgeFixer#edgefixer Github homepage for examples].
<br>
<br>
== Requirements ==
* [[AviSynth+]] (x86 / x64)
* Supported color formats: 8...16-bit, [[Y8]], [[YV12]], [[YV16]], [[YV24]]

<br>
== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|ContinuityFixer (clip clip, int "left", int "top", int "right", int "bottom", int "radius")}}
:{{Template:FuncDef|ReferenceFixerFixer (clip clip, clip ref, int "left", int "top", int "right", int "bottom", int "radius")}}
<br>
::{{Par2| |clip| }}
:::Input clip.

::{{Par2| |clip| }}
:::Reference clip, only applicable to ReferenceFixer.

::{{Par2|left|int|0}}
::{{Par2|top|int|0}}
::{{Par2|right|int|0}}
::{{Par2|bottom|int|0}}
:::The number of lines to filter along each edge.

::{{Par2|radius|int|0}}
:::Limit the window used for the least squares regression, useful in the presence of overlaid content.

<br>

== Examples ==
[[AviSource]]("Blah.avi")
ContinuityFixer (left=2, top=4, right=0, bottom=2, radius=0)
<br>

[[AviSource]]("Blah.avi")
ReferenceFixer ([[FastBlur]](0.8125, 0, iterations = 1, gamma = false), left=10)
<br>

== Changelog ==
Version Date Changes<br>
25 Mar 2019 2019/03/25 - Compiled with Microsoft Visual Studio C++ 2017.
r1 2018/01/13 - first release
<br>
== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!r1
|
|
|}
<br>
== External Links ==
*[https://github.com/sekrit-twc/EdgeFixer GitHub] - Source code
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Borders_and_Cropping| External Filters]] ←'''

Zs RF Shared

2021-03-27T09:45:21Z

AmjadSONY: /* Requirements */

{{FilterCat4|External_filters|Scripts|Other_filters|Multipurpose Filters}}
{{Filter3
| real.finder, Multi Peoples
| v1.143
| [https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi Zs_RF_Shared.avsi]
| Multipurpose Filters
|
|6=[http://forum.doom9.org/showpost.php?p=1665492&postcount=27 Doom9 Thread]}}

== Description ==
<tt>[[Zs_RF_Shared]]</tt> - Shared Functions and utility.
<br>
<br>
== Requirements ==
* AviSynth 2.5.7 or [http://sourceforge.net/projects/avisynth2/ greater]or [[AviSynth+]]
**It will work better and with more things (features and advantages) in AviSynth 2.6 and even better in AviSynth+.

== Changelog ==
Version Date(D/M/Y) Changes<br>
v1.143 11/12/2020 -
<br>

==External Links==
*[https://forum.doom9.org/showthread.php?t=174121 Doom9 Forum] - See this thread for support.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Multipurpose_Filters|External Filters]] ←'''
-----------------------------------------------

FixChromaBleedingMod

2021-03-27T09:27:49Z

AmjadSONY:

{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}
{{Filter3
|AmjadSONY
|1.35
|3=[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/FixChromaBleedingMod.avsi FixChromaBleedingMod.avsi]
|4=Chroma Correction
|5=
|6=[http://forum.doom9.org/showthread.php?t=77074#post1673932 Doom9 thread]}}

== Description ==
A script to reduce color bleeding, over-saturation, and color shifting mainly in red and blue areas. This script is based on [[FixChromaBleeding]].
<br>
<br>
== Requirements ==
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only or Fields
* Supported color formats: [[YUY2]], [[YV12]], [[YV411]]
=== Required Plugins and Scripts ===
Latest versions of the following filters are recommended unless stated otherwise.<br>
*[[Zs_RF_Shared]]
*[[ChromaShift]]
*[[ChromaShiftSP]]
*[[MaskTools2]]
<br>

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|FixChromaBleedingMod (clip input, int "cxShift", int "cyShift", float "thr", float "strength", bool "f", float "opacity", bool "n", bool "xysh", bool "Bic")}}
<br>
::{{Par2| |clip| }}
:::Input clip.
<br>
::{{Par2|cxShift|int|-4}}
::{{Par2|cyShift|int|-4}}
:::Horizontal and vertical chroma shift; vertical shift is ignored when <code>{{Template:FuncDef|xysh}}=false</code> (default).
:::*When <code>{{Template:FuncDef|xysh}}=false</code>, positive values shift chroma to the right, negative values shift to left.
:::*When <code>{{Template:FuncDef|xysh}}=true</code>, positive values shift chroma to the left/up, negative values shift right/down.
<br>
::{{Par2|thr|float|4.0}}
:::Masking threshold, higher values treat more areas as color bleed.
<br>
::{{Par2|strength|float|0.8}}
:::[[Tweak|Saturation]] strength in clip to be merged with the original chroma. Values below 1.0 reduce the saturation, a value of 1.0 leaves the saturation intact.
<br>
::{{Par2|f|bool|true}}
:::Set to <tt>true</tt> to enable fast processing on the mask clip (default).
<br>
::{{Par2|opacity|float|1.0}}
:::[[Overlay|Opacity]] strength when blending the original chroma with the corrected one. Range is from 0.0 to 1.0.
<br>
::{{Par2|n|bool|false}}
:::Set to <tt>true</tt> to blur the mask clip. This parameter is ignored when <code>{{Template:FuncDef|f}}=true</code>.
<br>
::{{Par2|xysh|bool|false}}
:::Set to <tt>true</tt> to shift chroma with <tt>[[ChromaShiftSP]]</tt> which also allows vertical shifting.
<br>
::{{Par2|Bic|bool|false}}
:::Set to <tt>true</tt> to scale the mask with [[BicubicResize]] instead of [[BilinearResize]]. This parameter is ignored when <code>{{Template:FuncDef|f}}=false</code>.
<br>

== Examples ==
FixChromaBleedingMod with default settings:
[[AviSource]]("Blah.avi")
FixChromaBleedingMod(cxShift=-4, cyShift=-4, thr=4.0, strength=0.8, f=true, opacity=1.0, n=false, xysh=flase, Bic=false)

<br>
== Changelog ==
Version Date(D/M/Y) Changes<br>
1.35 30/04/2015 - [http://pastebin.com/gbmD61RF]
1.34 29/04/2015 - [http://pastebin.com/XmVym47E]
1.32 09/04/2015 - [http://pastebin.com/puA4NrTj]
1.3 22/03/2015 - [http://pastebin.com/y3JfEFdf]
1.2 06/02/2014 - [http://pastebin.com/Y0RQYJNr]
1.1 06/02/2014 - [http://pastebin.com/1GL9pfZ7]
1.0 31/01/2014 - [http://pastebin.com/5PLa9RwJ] (initial release)
<br>

== External Links ==
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Chroma_correction|External Filters]] ←'''

DeHaloHmod

2021-03-27T09:26:43Z

AmjadSONY:

{{FilterCat4|External_filters|Scripts|Restoration_filters|Dehalo}}
{{Filter3
|AmjadSONY
|11/11/2016
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/DeHaloH.avsi DeHaloHmod.avsi]
|Dehalo
|
|6=[http://forum.doom9.org/showthread.php?t=145898#post1675762 Doom9 Thread]}}
== Description ==
[[DeHaloHmod]] - a modfificaition of <tt>DeHaloH</tt> by Vitaliy Gorbatenko.<br>
<br>
== Requirements ==
*AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
*[[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] input only
*Supported color formats: [[YV12]]

=== Required Plugins ===
Latest versions of the following filters are recommended unless stated otherwise.<br>
*[[Zs_RF_Shared]]
*[[MaskTools2]]
*[[SmoothUV]] 
*[[TBilateral]]
<br>

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|DeHaloHmod (clip input, int "Radius", int "Str", bool "Maska", bool "strong", int "mode", int "thr", string "exdehalo", bool "analog", bool "dirty", bool "smooth")}}
<br>
::{{Par2|clp|clip| }}
:::Input clip.
<br>
::{{Par2|Radius|int|2}}
:::Radius, the default value is 2 but it's set to 6 when <code>dirty=true</code>, and 4 when <code>smooth=true</code> and <code>dirty=false</code>.
<br>
::{{Par2|Str|int|3}}
:::Strength, the default value is 3 but it's set to 5 when <code>smooth=true</code>.
<br>
::{{Par2|Maska|bool|false|}}
:::Set to <tt>true</tt> to show mask.
<br>
::{{Par2|strong|bool|true}}
:::Only has an effect when mode is set to 0.
<br>
::{{Par2|mode|int|3}}
:::Masking mode.
<br>
::{{Par2|thr|int|140}}
:::Threshold, Only has an effect when mode is not set to 0.
<br>
::{{Par2|exdehalo|string| }}
:::You can use it with an external dehalo filter like this: <code>DeHaloHmod(exdehalo="[[BlindDeHalo3]](4,4)")</code>.
<br>
::{{Par2|analog|bool|false}}
:::When set to <code>true</code>, the edge mask is processed with <code>[[ColorYUV|ColorYUV(autogain=true)]]</code>.
<br>
::{{Par2|dirty|bool|false}}
:::When set to true, a smoothed clip will be use to create the edge mask.
<br>
::{{Par2|smooth|bool|false}}
:::When set to true, it wiil make the Invert mask smoothed by mt_inflate(155,155) and if exdehalo is not used DeHalo_alpha, YAHR2, and TBilateral will be use to create the smoothed and DeHalo clip. When set to false, only TBilateral is used.
<br>

== Examples ==
DeHaloHmod with default values.
[[AviSource]]("Blah.avi")
DeHaloHmod(Radius=2, Str=3, Maska=false, strong=true, mode=3, thr=140, analog=false, dirty=false, smooth=false)
<br>
== Changelog ==
Version Date(D/M/Y) Changes<br>
11/11/2016 - [http://pastebin.com/tA7aHtYP]
09/05/2016 - [http://pastebin.com/KkuiDtiK]
09/05/2016 - [http://pastebin.com/jRFB4NDp]
22/10/2015 - [http://pastebin.com/D6M00iYG]
30/10/2014 - [http://pastebin.com/GhVpsids]
27/08/2014 - Initial release[http://pastebin.com/LtaC7ECe]
<br>
== External Links ==
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Dehaloing|External Filters]] ←'''
-----------------------------------------------

YAHRmod source

2021-03-27T09:24:15Z

AmjadSONY:

[[Category:Scripts]]
source: https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/YAHR.avsi
<pre>
# Y'et A'nother H'alo R'educing script
# YAHR A.SONY mod 1.38, original YAHR was by Didée
# good deHalo for modern DVD and other cases

function YAHR2(clip clp, int "depth", int "blur", bool "useawarp4", int "depthV", int "blurV")
{

depth = Default(depth, 8)
useawarp4 = Default(useawarp4, false)

blur = defined(blurV) && !defined(blur) ? depth==0 ? 0 : blur : blur

defined(depthV) ? depthV != 0 && depth==0 ? eval("blurV=defined(blurV) ? blurV : blur Chr(3) blur=defined(blur) ? blur : 0") : depthV==0 && depth != 0 ? eval("blurV=defined(blurV) ? blurV : 0") : nop() : nop()

awarp_params = defined(depthV) ? ",depthV=" + string(depthV) : ""
awarp_params = defined(blurV) ? awarp_params + ",blurV=" + string(blurV) : defined(depthV) ? depthV==0 ? ",blurV=0" : awarp_params : awarp_params

b1 = clp.minblur(2).removegrain(11,-1)
b1D = mt_makediff(clp,b1)
w1 = useawarp4 ? clp.aWarpSharp4xx(depth=depth,blur=blur,chroma=1,useawarp4=true,depthV=depthV,blurV=blurV) : eval("clp.aWarpSharp2(depth=depth,blur=blur,chroma=1" + awarp_params + ")")
w1b1 = w1.minblur(2,1).removegrain(11,-1)
w1b1D = mt_makediff(w1,w1b1)
DD = b1D.repair(w1b1D,13)
DD2 = mt_makediff(b1D,DD)
clp.mt_makediff(DD2,U=2,V=2)
}
</pre>

External filters

2021-03-27T09:23:00Z

AmjadSONY: /* Spatio-Temporal Denoisers */

Rough classification of third-party filters for AviSynth - a perpetual work in progress.

This page lists both scripts (see [[Import]]) and plugins (see [[Plugins]]).

== Introduction ==

==== Download sites ====
A large list of filters can be downloaded from the following sites but be aware that some plugins listed '''may be outdated''', only recommended as a backup.

*[https://web.archive.org/web/20130803185015/http://www.64k.it:80/andres/dettaglio.php?sez=avisynth Andres' Filter Collection]
*[https://chaosking.de/repo/avsfilters/ AviSynth Filter DB by ChaosKing] | [https://web.archive.org/web/20140412062911/http://chaosking.de/avisynth-filter-db mirror]
*[http://www.avisynth.info/?plugin=attach&pcmd=list&refer=%E3%82%A2%E3%83%BC%E3%82%AB%E3%82%A4%E3%83%96 AviSynth.info Filter Archive]
*[http://xhmikosr.1f0.de/_old/avisynth/plugins/ XhmikosR's Builds]
*[http://www.avisynth.nl/users/warpenterprises/ Warp Enterprises' AviSynth Filter Collection]

====64-bit filters====
'''[[AviSynth%2B_x64_plugins|Comprehensive list of AviSynth+ 64-bit filters]] →'''

====Outdated AviSynth plugins====
[[External plugins old|External plugins (old)]] - these older plugins are not recommended, page is there mainly for historical purposes.

==== Using filters ====
Most scripts will apply filters in the following order:

# Create an AviSynth clip from a video file using a source filter.
# Correct or remove any unwanted features in the video (e.g. dot crawl, field blending or telecine).
# Denoise the video (optional).
# Manipulate the video into the desired format (by e.g. changing the size and frame rate).



== Source Filters ==

{{FilterTable}}
| [https://forum.doom9.org/showthread.php?t=135855 BassAudio]
| [https://www.un4seen.com/ Bass Audio] decoder. Supports wav, aiff, mp3, mp2, mp1, ogg. Support for aac, ac3, alac, ape, cd, flac, midi, mpc, ofr, spx, tta, wma, wv with additional included dll's. The filter is included in the Behappy package.
| N/A
| [https://forum.doom9.org/showthread.php?t=135855 Plugin]
| dimzon
|-
|[[BestAudioSource]]
|A new sample accurate but somewhat slow FFmpeg based audio source filter for AviSynth+. No indexing required and only available in 64-bit.
|N/A
|[[BestAudioSource|Plugin]]
|{{Author/Myrsloik}}
|-
| [http://www.gyroshot.com/cmvsource.htm CMVSource]
| Load [http://www.bay12games.com/dwarves/ Dwarf Fortress] CMV and CCMV movies.
| [[RGB32]]
| [http://forum.doom9.org/showthread.php?t=162850 Plugin]
| {{Author/Robert Martens}}
|-
| [http://forum.doom9.org/showthread.php?t=122598 DGAVCDecode]
| AVC/H.264 decoder plug-in.
| [[YV12]]
| [http://www.videohelp.com/tools/DGAVCDec Plugin]
| {{Author/Donald Graft}}
|-
| [[DGDecode]]
| Decode MPEG1/MPEG2 streams from: DVD VOBs, captured transport streams, *.mpg/*.m2v/*.pva files, etc. Use this instead of MPEGDecoder/MPEG2Dec3.
| [[RGB24]], [[YUY2]], [[YV12]], [[I420]]
| [{{N2Moved}}/dgmpgdec/dgmpgdec.html Plugin]
| {{Author/Donald Graft}}
|-
|[http://forum.doom9.org/showthread.php?t=170107 DGMVCSource]
|MVC source filter for AviSynth.
| [[YV12]]
|[http://rationalqm.us/dgmvcsource/dgmvcsource100b26.zip Plugin]
|{{Author/Donald Graft}}
|-
| DVInfo
| Grabs the timestamp and recording date info from a DV-AVI. See [http://forum.doom9.org/showthread.php?t=61688 discussion].
| N/A
| [http://www.avisynth.nl/users/warpenterprises/files/dvinfo_20100602.zip Plugin] [http://forum.doom9.org/showthread.php?p=1740824#post1740824 Update]
| {{Author/WarpEnterprises}}
|-
| [http://web.archive.org/web/20071025023927/http://mvideo.ddpp.net/eng/dvtimestampex.htm DVTimeStampEx]
| Shows DV timestamp information over a DV clip.
| N/A
| [http://web.archive.org/web/20071024123608/http://mvideo.ddpp.net/downld/dvtimestampex_0_5_5.zip Plugin] - [http://web.archive.org/web/20071024123608/http://mvideo.ddpp.net/downld/dvtimestampex_0_5_5_src.zip source code]
| [http://web.archive.org/web/20071025023932/http://mvideo.ddpp.net/eng/index.htm basilik]
|-
| [http://forum.doom9.org/showthread.php?t=134275 DSS2]
| DirectShowSource2 that uses the installed Haali Media Splitter along with its ''avss.dll'' AviSynth plugin. It can convert VFR files to CFR in order to support frame-accurate seeking. Not recommended due to the fact that Haali Media Splitter is considered outdated, '''use DDS2mod'''.
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [http://web.archive.org/web/20130923230211/http://haali.su/mkv/ Plugin]
| Haali
|-
| [[DSS2mod]]
| DirectShowSource2 mod, this version does not require Haali Media Splitter.
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [[DSS2mod|Plugin]]
| forclip
|-
| [[FFmpegSource]]
| Decodes all ffmpeg ([http://en.wikipedia.org/wiki/Libavcodec libavcodec]) supported A/V formats with frame accurate seeking in AVI, MKV and MP4. See [http://forum.doom9.org/showthread.php?t=127037 discussion].
| [[RGB]], [[YUY2]], [[YV12]], [[I420]]
| [http://github.com/FFMS/ffms2/releases Plugin]
| {{Author/Myrsloik}}, TheFluff, Plorkyeran, others
|-
|[http://forum.doom9.org/showthread.php?t=169651 FRIMSource]
|FRIMSource is an AviSynth plugin for sequential reading of elementary or transport streams (MPEG2, H.264 AVC/MVC-3D, VC1).
|[[YV12]]
|[http://forum.doom9.org/showthread.php?t=169651 Plugin]
|videofan3d
|-
| [http://forum.doom9.org/showthread.php?t=110021 HDVInfo]
| Grabs the timestamp and recording date info out of a M2T-D2V file
| N/A
| [http://web.archive.org/web/20120419204535/http://strony.aster.pl/paviko/hdvinfo0.93.zip Plugin]
| {{Author/paviko}}
|-
| [[ImageSequence]]
| Load png, jpg, bmp, pcx, tga and gif image sequences using the [http://corona.sourceforge.net/ Corona Image I/O Library]. CoronaSequence/RawSequence.
| [[RGB32]]
| [http://www.avisynth.nl/users/warpenterprises/files/imagesequence_20101115.zip Plugin]
| {{Author/WarpEnterprises}}
|-
| [http://forum.doom9.org/showthread.php?t=135928 Immaavs]
| ImmaRead uses the ImageMagick libraries to read images. Many formats are supported including animations, multipage files, image sequences and images with different sizes.
|
| [http://www.wilbertdijkhof.com/ Plugin]
| {{Author/Wilbert Dijkhof}}
|-
| IUF
| Import Uncompressed File. Must be uncompressed! Supported uncompressed Formats: avi, omf(avid), pxr(pixar), mov(24/32bit quicktime), cineon. Can export as well. See [http://forum.doom9.org/showthread.php?t=51227 discussion].
| [[RGB]]
| [http://web.archive.org/web/20091016215740/http://geocities.com/hanfrunz/iuf_v1.5.zip Plugin]
| hanfrunz
|-
| [[JpegSource]]
| An advanced JPEG decoder for Avisynth 2.6. See [http://forum.doom9.org/showthread.php?t=170028 discussion].
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://dl.dropboxusercontent.com/s/rjnt0y3ead2c6ef/JpegSource_20140419.7z Plugin]
| SEt
|-
| [[LSMASHSource]]
| A source plugin for audio and video, it uses Libav ([http://en.wikipedia.org/wiki/Libav#Contained_codecs libavcodec]) to decode all supported A/V formats. See [http://forum.doom9.org/showthread.php?t=167435 discussion.]
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[LSMASHSource|Plugin]]
| {{Author/VFR-maniac}}
|-
|[[MPEG2DecPlus]]
|MPEG2DecPlus is a MPEG-1/2 decoder plug-in. MPEG2DecPlus is a project to modernize "[[DGDecode]].dll" for AviSynth+.
|[[YV12]], [[YV16]]
|[[MPEG2DecPlus|Plugin]]
|{{Author/Chikuzen}}
|-
| [[NicAudio]]
| Audio Plugins for Audio: MPEGAudio/AC3/DTS/LPCM and other uncompressed formats. Formerly known As EvilMPASource. See [http://forum.doom9.org/showthread.php?s=&threadid=89629 discussion], [http://forum.doom9.org/showthread.php?t=135876 continued discussion].
| N/A
| [[NicAudio|Plugin]]
| {{Author/Nic}}
|-
| [http://forum.doom9.org/showthread.php?t=103931 OmfSource]
| Opens the AVID OMF file format (video only, and only works with captured files). See [http://forum.doom9.org/showthread.php?t=103931 discussion].
| [[YUY2]], [[YV12]]
| [http://www.tateu.net/software/ Plugin]
| {{Author/tateu}}
|-
| [[QTSource]]
| Quicktime Import/Export Filter using an existing installation of Quicktime 6/7. See [http://forum.doom9.org/showthread.php?t=104293 discussion].
| [[RGB32]], [[RGB24]], [[YUY2]]
| [http://www.tateu.net/software/ Plugin]
| {{Author/tateu}}
|-
| [http://web.archive.org/web/20120124010957/http://arenafilm.hu/alsog/avisynthr3d/ R3DSource]
| Redcode RAW source plugin to load R3D clips. See [http://reduser.net/forum/showthread.php?25398 discussion].
| [[RGB32]]
| [http://web.archive.org/web/20120124010957/http://arenafilm.hu/alsog/avisynthr3d/ Plugin]
| {{Author/Kertai Gábor}}
|-
| [[RawSource26]]
| Loads raw video data directly from files. Further modifications (most raw formats, YUV4MPEG2 compatible with latest spec).
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[RawSource26|Plugin]]
| {{Author/Chikuzen}}
|-
| [http://forum.doom9.org/showthread.php?p=1403600 Sashimi]
(function "RawReader")
| Loads raw video data directly from files, similarly to RawSource, but also allows for skipping headers, and extra formats (long list to help anyone doing a search): GREY, Y8, interleaved RGB, BGR (which is RGB24), BGRA (which is RGB32), ARBG, ABGR, RGBA, interleaved YUV (which is YCbCr), YUY2, UYVY, AYUV, planar YUV formats YUV444, YUV422, YUV420 (as YV12), YUV420 (as IMC2), and some raw ImageMagick formats. Some supports for different bit-depths. Includes YUVInterleaved.avsi, InterleavedConversions.avsi, and PlanarConversions.avsi. [http://forum.doom9.org/showthread.php?p=1403600 Discussion].
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [http://sites.google.com/site/ourenthusiasmsasham/soft Plugin with scripts]
| [http://sites.google.com/site/ourenthusiasmsasham/ PitifulInsect]
|-
| [[VapourSource]]
| VapourSynth script reader for AviSynth+ and AviSynth2.6x.
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[VapourSource|Plugin]]
| {{Author/Chikuzen}}
|-
|[http://forum.doom9.org/showthread.php?t=170311 VideoInputSource]
| Capture video frames from video capture card or webcam in real-time.
|[[RGB24]]
|[http://github.com/fieliapm/himawari_avs_plugin/raw/master/VideoInputSource/VideoInputSource.dll Plugin]
|[http://github.com/fieliapm fieliapm]
|-
|[https://github.com/slavanap/ssifSource ssifSource]
| Open m2ts, ssif and mpls files located in decrypted Blu-ray and Blu-ray 3D discs. Supports horizontal of vertical stack of views as output, views selection and swap autodetection.
|[[YV12]]
|[https://github.com/slavanap/ssifSource/releases plugin]
|[http://github.com/slavanap slavanap]
|}

== Restoration Filters ==

These remove effects or artifacts introduced (deliberately or accidentally) into the source video. Denoisers are classified separately.

=== Anti-[[aliasing]] ===

{{FilterTable}}
| [[DAA]]
| Anti-aliasing with contra-sharpening.
| [[YV12]]
| Script
| {{Author/Didée}}
|-
| mcDAA3
| Motion-Compensated Anti-aliasing with contra-sharpening, can deal with ifade too, created because when applied daa3 to fixed scenes, it could damage some details and other issues. See [http://forum.doom9.org/showthread.php?p=1639679#post1639679 discussion]
| [[YV12]]
| [http://www.mediafire.com/?wqkob7zx1p119e0 Script]
| AmjadSONY
|-
| [[MAA2]]
| Updated version of the MAA antialising script.
| [[Y8]], [[YV12]], [[YV24]]
| [http://web.archive.org/web/20140624125132/https://raw.githubusercontent.com/AviSynth/avs-scripts/master/maa2.avsi Script]
| line0
|-
| [[santiag]]
| Simple anti-aliasing with independent horizontal and vertical anti-aliasing strength.
| [[YV12]]
| [http://forum.doom9.org/showpost.php?p=1393006 Script]
| {{Author/cretindesalpes}}
|-
| SharpAAMCmod
| High quality MoComped AntiAliasing script, also a line darkener since it uses edge masking to apply tweakable warp-sharpening, "normal" sharpening and line darkening with optional temporal stabilization of these edges. Part of [[AnimeIVTC]]. See [http://forum.doom9.org/showthread.php?t=138305] and [http://forum.doom9.org/showthread.php?t=140031]
| [[YV12]]
| Script
| thetoof
|-
| [[TIsophote]]
| A level-set (isophote) smoothing filter.
| [[YUY2]], [[YV12]]
| [http://web.archive.org/web/20070222162751/http://bengal.missouri.edu/~kes25c/TIsophotev091.zip Plugin]
| {{Author/tritical}}
|-
|[[xaa]]
|Versatile anti-aliasing script.
|[[Y8]], [[YV12]], [[YV24]]
|[http://www.mediafire.com/download/sygi04y47eknvc2/xaa_v1.1.1.avsi Script]
|Desbreko
|}

=== Chroma correction ===

{{FilterTable}}
| [{{N2Archived}}/trbarry/Readme_BT709ToBT601.txt BT709ToBT601]
| Convert from BT.709 (HDTV) to BT.601 (SDTV) colorimetry.
| [[YV12]]
| [{{N2Archived}}/trbarry/BT709ToBT601.zip Plugin]
| {{Author/Tom Barry}}
|-
|[[caf]]
|Chromatic Aberration Fixer.
| [[YV12]]
| [http://avisynth.nl/images/ChromaShiftSP.avsi Script]
| Torchlight
|-
| [[ChromaShift]]
| This filter will shift the chrominance information by an even number of pixels, in either horizontal direction. It can also apply an overall vertical shift of the total chrominance information, up or down. It is primarily intended to correct improper colour registration. See [http://forum.doom9.org/showthread.php?t=33302 discussion.]
| [[YV12]], [[YUY2]], [[RGB32]]
| [http://web.archive.org/web/20091026153334/http://www.geocities.com/siwalters_uk/chromashift27.zip Plugin]
| {{Author/Simon Walters}}
|-
| [[ChromaShiftSP]]
| This script can shift chroma in all directions with subpixel accuracy.
| [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://avisynth.nl/images/ChromaShiftSP.avsi Script]
| IanB, McCauley
|-
| [[ColorMatrix]]
| ColorMatrix corrects the colors of MPEG-2 streams. More correctly, many MPEG-2 streams use slightly different coefficients (called Rec.709) for storing the color information than AviSynth's color conversion routines or the XviD/DivX decoders (called Rec.601) do, with the result that DivX/XviD clips or MPEG-2 clips encoded by TMPGEnc/QuEnc are displayed with slighty off colors. This can be checked by opening the MPEG-2 stream directly in VDubMod.
| [[YV12]], [[YUY2]]
| [[ColorMatrix|Plugin]]
| {{Author/Wilbert Dijkhof}}, {{Author/tritical}}
|-
| [[FixChromaBleeding]]
| Fixes area of chroma bleeding by shifting the chroma and lowering the saturation in the affected areas. See [http://forum.doom9.org/showthread.php?t=77074 discussion]
| [[YV12]]
| [http://web.archive.org/web/20091026141730/http://www.geocities.com/alex_j_jordan/chroma.txt Script]
| {{Author/Alex Jordan}}
|-
| [[FixChromaBleedingMod]]
| Fixes area of chroma bleeding by shifting the chroma and lowering the saturation in the affected areas. See [http://forum.doom9.org/showthread.php?t=77074#post1673932 discussion]
| [[YV12]], [[YUY2]], [[YV411]]
| [[FixChromaBleedingMod_source|Script]]
| AmjadSONY
|-
| [[FixChromaticAberration]]
| FixChromaticAberration resizes (and crops) the red/green/blue channels of the image separately. This helps to minimize the colored edges next to the image corners that result from lenses with chromatic aberration. See [http://forum.doom9.org/showthread.php?p=1520786#post1520786 discussion.]
| [[RGB24]], [[RGB32]]
| [http://avisynth.nl/index.php/FixChromaticAberration Script]
| Martin Wagener
|-
| [[MoveChroma]]
| Chroma shifting filter; can be used to independently shift the U/V channels left or right.
| [[YUY2]], [[YV12]]
| [[MoveChroma|Plugin]]
| [http://noraneco.ddo.jp/apechironnup]
|-
| [[ReInterpolate411]]
| This is a fast and simple filter to correct the improper 4:1:1 => 4:2:2 conversion that seems to occur with some DV/4:1:1 codecs.
| [[YUY2]]
| [{{N2Archived}}/trbarry/ReInterpolate411.zip Plugin]
| {{Author/Tom Barry}}
|-
| [http://www.avisynth.nl/users/fizick/reinterpolate420/reinterpolate420.html ReInterpolate420]
| Usually, DV decoders upsample [[PAL]] DV (which is YV12) to YUY2 using point sampling. This plugin re-interpolates the original chroma samples.
| [[YUY2]]
| [http://www.avisynth.nl/users/fizick/reinterpolate420/reinterpolate420_v3.zip Plugin]
| {{Author/Wilbert Dijkhof}}
{{Author/Fizick}} (v3)
|}

=== Debanding ===

{{FilterTable}}
| AdaptDBMC
| Luma / Fade / Blue adaptive debanding script.
| [[YV12]]
| [http://www.nmm-hd.org/newbbs/viewtopic.php?f=7&t=512 Script]
| {{Author/06_taro}}
|-
| [[GradFun2db]]
| A simple and fast debanding filter.
| [[YV12]]
| [[GradFun2db|Plugin]]
| Prunedtree
|-
| [[GradFun2DBmod]]
| An advanced debanding script based on GradFun2DB.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=144537 Script]
| {{Author/LaTo}}
|-
| [[Dither_tools#GradFun3|GradFun3]]
| This debanding script, part of the [[Dither_tools|Dither]] package, has several gradient smoothing algorithms, including a bilateral filter. It uses an ordered dithering, which has a good resilience to lossy compression.
| [[YV12]], [[YV16]], [[YV24]], [[Y8]], [[YV411]]
| [[Dither_tools|Script]]
| {{Author/cretindesalpes}}
|-
| [[f3kdb|flash3kyuu_deband]]
| Fast debanding plugin ported from AviUtl.
| [[YV12]], [[YUY2]], [[YV16]], [[YV24]], [[Y8]], [[YV411]]
| [[f3kdb|Plugin]]
| [http://github.com/SAPikachu/ SAPikachu]
|-
| LumaDB
| Fast 8-bit debanding filter with luma-adaptive grain and mask. Used to process luma only. See [http://www.nmm-hd.org/newbbs/viewtopic.php?f=7&t=668 discussion.]
| [[YV12]]
| [http://web.archive.org/web/20131111114932/http://www.nmm-hd.org/upload/get~3YK_B5TfcyI/LumaDB-0.7.rar Script]
| {{Author/06_taro}}
|-
| LumaDBL
| Fast 16-bit debanding filter with luma-adaptive grain and mask. Used to process luma only. Works in 16-bit internally and can also input/output 16-bit. See [http://www.nmm-hd.org/newbbs/viewtopic.php?f=7&t=668 discussion.]
| [[YV12]]
| [http://web.archive.org/web/20131111114947/http://www.nmm-hd.org/upload/get~mQYIS9H6Qas/LumaDBL-0.7.rar Script]
| {{Author/06_taro}}
|}

=== Deblocking ===

{{FilterTable}}
| BlockKiller
| Deblocking filter, see [http://forum.doom9.org/showthread.php?p=1410479#post1410479 discussion].
| [[YUY2]], [[YV12]]
| [http://forum.doom9.org/showpost.php?p=1410479&postcount=19 Script]
| Jawed
|-
| BlockTerminator
| Deblocking filter, see [http://forum.doom9.org/showthread.php?p=831936#post831936 discussion.]
| [[YUY2]], [[YV12]]
| [http://forum.doom9.org/showpost.php?p=831936&postcount=24 Script]
| foxyshadis
|-
| [[DeBlock]]
| Deblocking filter. DGDecode also uses DeBlock.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], <br>all 8-32bit Y/YUV [[planar]] colorspaces
| [[DeBlock|Plugin]]
| {{Author/Fizick}} / {{Author/Manao}}
|-
| [[Deblock_QED]]
| "A postprocessed Deblock(): Uses full frequencies of Deblock's changes on block borders, but DCT-lowpassed changes on block interiours." [http://forum.doom9.org/showpost.php?p=913365&postcount=4 Didée]. See [http://forum.doom9.org/showthread.php?p=944459 discussion.] For updated Deblock QED see this [http://forum.doom9.org/showthread.php?t=154777 discussion]
| [[YV12]]
| [http://avisynth.nl/images/Deblock_QED_MT2Mod.avsi Script]
| {{Author/Didée}}
|-
|[[DeblockPP7]]
| A port of the MPlayer PP7 deblocking filter.
|[[YUY2]], [[YV12]]
|[[DeblockPP7|Plugin]]
|John Doe
|-
| [[FunkyDeBlock]]
| Deblocking script based on BlindPP and high/low pass separation. See [http://forum.doom9.org/showthread.php?t=72431 discussion].
| [[YV12]]
| Script
| Mug Funky
|-
| [[MDeblock]]
| Plugin for removing block artifacts.
| [[YV12]]
| [[MDeblock|Plugin]]
| {{Author/kassandro}}
|-
| [[SmoothD]]
| Filter to deblock frames while keeping high frequency detail.
| [[YV12]]
| [[SmoothD|Plugin]]
| Tobias Bergmann
|-
| [[SmoothD2]]
| Deblocking filter. Rewrite of SmoothD. Faster, better detail preservation, optional chroma deblocking.
| [[YV12]]
| [[SmoothD2|Plugin]]
| Jim Conklin
|-
| SmoothDeblock
| Slow and complex, but produces very good results - especially on severely blocky sources - in a similar manner to TempGaussMC and QTGMC. See [http://forum.doom9.org/showthread.php?t=111526 discussion] and an [http://forum.doom9.org/showthread.php?p=945261#post945261 overall comment].
| [[YV12]]
| [http://forum.doom9.org/showthread.php?p=1553458#post1553458 Script]<br>[[SmoothDeblock_source|(alt source)]]
| redfordxx
|-
|[http://avisynth.org.ru/unblock/unblock.html Unblock]
|UnBlock is a filter that removes the "blockiness" of heavily or moderately compressed images with statistical approach. See [http://forum.doom9.org/showthread.php?t=133059 discussion].
|[[YV12]]
|[http://avisynth.org.ru/unblock/unblock11.zip Plugin]
|{{Author/Fizick}}
|-
|[[vsDeblockPP7]]
|A port of the MPlayer PP7 deblocking filter. Includes high bit-depth support.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], <br>all 8-32bit [[planar]] colorspaces
|[[vsDeblockPP7|Plugin]]
|Asd-d
|}

=== Dehaloing ===

{{FilterTable}}
| [[abcxyz]]
| Filter to remove halos. See [http://forum.doom9.org/showthread.php?t=144982 discussion].
| [[YV12]]
| [[Media:abcxyz_MT2.avsi|Script]]
| {{Author/Didée}}
|-
| [[BlindDeHalo3]]
| Filter to remove edge enhancement artifacts. See [http://forum.doom9.org/showthread.php?p=622289#post622289 discussion].
| [[YV12]]
| [http://forum.doom9.org/attachment.php?attachmentid=5599&d=1143030001 Script]
| {{Author/Didée}}
|-
| [[DeHalo_alpha]]
| Very powerful filter to remove edge enhancement artifacts. See [http://forum.doom9.org/showthread.php?p=777956#post777956 discussion].
| [[YV12]]
| [http://avisynth.nl/images/Dehalo_alpha_mt.avsi Script]
| {{Author/Didée}}
|-
|[[DeHaloHmod]]
| Another halo reducer, it includes lots of options to tweak for best performance. See [http://forum.doom9.org/showthread.php?p=1675762#post1675762 discussion]
|[[YV12]]
| [[DeHaloHmod|Script]]
|AmjadSONY
|-
|[[FineDehalo]]
|Halo removal script that uses DeHalo_alpha with a few masks and optional contra-sharpening to try remove halos without removing important details (like line edges).
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[http://avisynth.nl/images/FineDehalo.avsi Script]
|{{Author/cretindesalpes}}
|-
|[https://forum.doom9.org/showthread.php?t=172599 HaloBuster]
|Really slow high quality halo remover.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[https://forum.doom9.org/showthread.php?t=172599 Script]
|feisty2
|-
| Mask_DHA
| A combination of the best of DeHalo_alpha and BlindDeHalo3, plus a few minor tweaks to the masking. See [http://forum.doom9.org/showthread.php?t=148498 discussion].
| [[YV12]]
| Script
| 'Orum
|-
| [[VHSHaloremover]]
| Quick & dirty halo removal. Will introduce some blurriness, but the halos are so huge you can’t avoid it. See [http://forum.doom9.org/showthread.php?p=1758184#post1758184]
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [http://pastebin.com/s24mSgJ5 Script]
| {{Author/cretindesalpes}}
|-
| [[YAHR]]
| Basic filter with no variables to remove edge enhancement artifacts. See [http://forum.doom9.org/showthread.php?p=1205653#post1205653]
| [[YV12]]
| [http://avisynth.nl/images/YAHR.avsi Script]
| {{Author/Didée}}
|-
| YAHRmod
| Basic filter used to reduce halos in modern DVD and other cases.
| [[YV12]]
| [[YAHRmod_source|Script]]
| AmjadSONY
|}

=== Deringing & Mosquito Noise ===

{{FilterTable}}
| [[aWarpSharpDering]]
| Tries to clean up slight ringing around edges by heavily aWarpSharp-ing the image and then applying it only to the areas where the difference is small enough so detail isn't destroyed.
| [[YV12]]
| [http://avisynth.nl/images/AWarpSharpDering.avsi Script]
| [http://leak.no-ip.org/AviSynth/ Leak]
|-
| [http://rationalqm.us/dgmpgdec/DGDecodeManual.html#BlindPP BlindPP]
| Deblocking & deringing filter; part of [[DGDecode]]. <br>Mosquito noise removal: <code>BlindPP(quant=16, cpu2="ooooxx")</code>
| [[YV12]], [[YUY2]]
| [{{N2Moved}}/dgmpgdec/dgmpgdec.html Plugin]
| {{Author/Donald Graft}}
|-
| [http://forum.doom9.org/showthread.php?p=636297#post636297 BlindDeRing]
| Deringing filter.
| [[YV12]]
| [http://chaosking.de/wp-content/uploads/avsfilters/Restoration_Filters/Deringing/BlindDeRing___(2005).7z Plugin]
| krieger2005
|-
|[https://gist.github.com/acuozzo/940869257cc79016215600a2392b33eb Deemphasize]
|This AviSynth function deemphasizes ringing common to SD video signals resulting from a playback device in the transfer chain poorly compensating for pre-emphasis baked into the source signal.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[https://gist.github.com/acuozzo/940869257cc79016215600a2392b33eb Script]
|[https://github.com/acuozzo acuozzo]
|-
|[https://sourceforge.net/projects/avisynth-dering/ Dering]
|Deringing filter intended for deringing VHS captured video.
|[[YUY2]], [[YV12]]
|[https://sourceforge.net/projects/avisynth-dering/files/release4/ C-Plugin]
|[https://sourceforge.net/u/alexrayne/profile/ alexrayne]
|-
| [[EdgeCleaner]]
| A simple edge cleaning and weak dehaloing function. See [http://forum.doom9.org/showthread.php?t=164592 discussion.]
| [[YV12]]
| [http://forum.doom9.org/showpost.php?p=1568521&postcount=13 Script]
| [http://forum.doom9.org/member.php?u=80518 canuckerfan]
|-
| [[HQDering]]
| Applies deringing by using a smart smoother near edges (where ringing occurs) only. See [http://forum.doom9.org/showthread.php?p=1043583#post1043583 here] and [http://forum.doom9.org/showthread.php?s=&threadid=67532 here] for details.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?p=793930#post793930 Script]
| {{Author/mf}}
|-
| [[HQDering mod]]
| Applies deringing by using a smart smoother near edges (where ringing occurs) only.
| [[YV12]]
| [http://web.archive.org/web/20140711173345/http://www.nmm-hd.org/upload/get~08CusazVphU/HQDeringmod_v1.8.avsi Script]
| [http://www.nmm-hd.org/newbbs/memberlist.php?mode=viewprofile&u=479&sid=ff62d0f6c22fcfdbe97b53c8351429bc mawen1250]
|-
| [[LazyDering]]
| Tries to clean up slight ringing around edges by applying [[aWarpSharp2]] only to areas where the difference is small enough so detail isn't destroyed.
| [[YV12]]
| [http://web.archive.org/web/20131103155455/http://anime-addict.ani-x.com/files/avisynth/scripts/LazyDering_v0.1.avsi Script]
| [http://leak.no-ip.org/AviSynth/ Leak], RazorbladeByte
|-
| [[MosquitoNR]]
| A noise reduction filter designed for mosquito noise, which is often caused by lossy compression.
| [[Y8]], [[YV411]], [[YV12]], [[YV16]], [[YV24]], [[YUY2]]
| [[MosquitoNR|Plugin]]
| {{Author/b_inary}}
|-
|ungibbs
|ungibbs, a gibbs artifact remover.
|[[YV12]]
|[http://forum.doom9.org/showthread.php?t=134502 Script]
|*.mp4 guy
|-
|WarpDeRing
|Uses aWarpSharp2's flattening to clean out ringing/smaller halos, then runs some masks to preserve the edges and avoid the thinning.
|[[YV12]]
|[[WarpDeRing_source|Script]]
|mirkosp
|-
|WarpDeRing_faster
|Same as WarpDeRing but may be a bit faster.
|[[YV12]]
|[[WarpDeRing_faster_source|Script]]
|mirkosp
|}

=== Deinterlacing ===

{{FilterTable}}
| Area
| A port of Gunnar Thalin's VirtualDub filter "Deinterlace - area based" to AviSynth.
| [[RGB32]]
| [http://www.avisynth.nl/users/warpenterprises/files/area_5F25_dll_20030217.zip Plugin]
| {{Author/Donald Graft}} // {{Author/Gunnar Thalin}}
|-
| BlendBob
| Filter designed for use after a smart bob; blends every other frame with the closest matching neighbouring frame. See [http://forum.doom9.org/showthread.php?threadid=80289 discussion].
| [[YV12]]
| [http://leak.no-ip.org/AviSynth/BlendBob/ Plugin]
| {{Author/Leak}}
|-
|[[BWDIF]]
|Motion adaptive deinterlacing based on yadif with the use of w3fdif and cubic interpolation algorithms.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], all 8-32bit [[planar]] colorspaces
|[[BWDIF|Plugin]]
|Asd-g
|-
| DGBob
| This filter splits each field of the source into its own frame and then adaptively creates the missing lines either by interpolating the current field or by using the previous field's data. See [http://forum.doom9.org/showthread.php?s=&threadid=55598 discussion].
| [[RGB]], [[YUY2]], [[YV12]]
| [{{N2Moved}}/dgbob/dgbob.html Plugin]
| {{Author/Donald Graft}}
|-
| [[Decomb]]
| The FieldDeinterlace filter provides functionality similar to the postprocessing function of Telecide. You can use it for pure interlaced streams (that is, those not containing telecined progressive frames). The name refers to the fact that field mode differencing is used.
| [[YUY2]], [[YUY2]]
| [[Decomb|Plugin]]
| {{Author/Donald Graft}}
|-
| [[EEDI2]]
| EEDI2 resizes an image by 2x in the vertical direction by copying the existing image to 2*y(n) and interpolating the missing field. It is intended for edge-directed interpolation for deinterlacing (i.e. not really made for resizing a normal image, but can do that as well).
| [[YUY2]], [[YV12]]
| [[EEDI2|Plugin]]
| {{Author/tritical}}
|-
| [[eedi3|EEDI3]]
| Another edge directed interpolation filter. Works by minimizing a cost functional involving every pixel in a scan line. eedi3 is good for deinterlacing and enlarging images by the powers of 2.
| [[RGB24]], [[YUY2]], [[YV12]]
| [[eedi3|Plugin]]
| {{Author/tritical}}
|-
|[[FieldHint]]
|FieldHint combines arbitrary fields from the input clip, and optionally adds Telecide-compatible postprocessing hints.
|[[YV12]]
|[http://web.archive.org/web/20120223025813/http://ivtc.org/yatta%20support/fieldhint-0.12.rar Plugin]
|{{Author/akupenguin}}
|-
| IBob
| Interpolating Bob works identically to the Avisynth built-in [[Bob]] filter except that it uses linear interpolation instead of bicubic resizing. See [http://forum.doom9.org/showthread.php?s=&threadid=62142 discussion].
| [[YUY2]], [[YV12]]
| [http://kevin.atkinson.dhs.org/ibob/ Plugin]
| {{Author/Kevin Atkinson}}
|-
| KernelDeint
| This filter deinterlaces using a kernel approach. It gives greatly improved vertical resolution in deinterlaced areas compared to simple field discarding. Superceded by [[LeakKernelDeint]], see the description below in this table.
| [[RGB]], [[YUY2]], [[YV12]]
| [{{N2Moved}}/kerneldeint/kerneldeint.html Plugin]
| {{Author/Donald Graft}}
|-
| [[LeakKernelDeint]]
| This filter deinterlaces using a kernel approach. It gives greatly improved vertical resolution in deinterlaced areas compared to simple field discarding. Compared to KernelDeint, it is low-level optimized (for speed) and provides some useful new functionality. As the original author of KernelDeint() states, LeakKernelDeint() is the preferred version to use.
| [[RGB32]], [[YUY2]], [[YV12]]
| [http://leak.no-ip.org/AviSynth/LeakKernelDeint/LeakKernelDeint_1.5.4.zip Plugin]
| {{Author/Leak}}
|-
| [[nnedi3]]
| nnedi3 is an intra-field only deinterlacer. It takes in a frame, throws away one field, and then interpolates the missing pixels using only information from the kept field. It also has same rate and double rate modes.
| [[RGB24]], [[YUY2]], [[YV12]]
| [[nnedi3|Plugin]]
| {{Author/tritical}}
|-
| [[nnedi3ocl]]
| OpenCL rewrite of [[nnedi3]]. See [http://forum.doom9.org/showthread.php?t=169766 discussion].
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://dl.dropboxusercontent.com/s/bmemjsu7jqnlk65/nnedi3ocl_20131208.7z Plugin]
| SEt
|-
| [[QTGMC]]
| by -Vit- [http://forum.doom9.org/showthread.php?t=156028] A new deinterlacer based on TempGaussMC_beta2. It's faster and has a presets system for speed/quality selection. There are also several new features including progressive support and noise/grain processing. The script also contains extensive comments to better describe the settings and the workings of the TGMC algorithm.
| [[YUY2]], [[YV12]]
| [[QTGMC|Script]]
| -Vit-
|-
| [[SangNom2]]
| Reimplementation of the old [[SangNom]] plugin.
| [[Y8]],[[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[SangNom2|Plugin]]
| {{Author/tp7}}
|-
| [http://www.guthspot.se/video/AVSPorts/SmoothDeinterlacer/ SmoothDeinterlace]
| This contains an adaptive deinterlacer plugin for (AVISynth). It is based on Gunnar Thalin's [http://www.guthspot.se/video/index.htm#deinterlacesmooth Smooth Deinterlace plugin] for VirtualDub.<br>
See also [[SmoothDeinterlaceFunctions]]
| [[RGB32]], [[YUY2]], [[YV12]]
| [http://www.guthspot.se/video/AVSPorts/SmoothDeinterlacer/AVSSmoothDeinterlacer.zip Plugin]
| {{Author/Gunnar Thalin}}
|-
| [[TDeint]]
| TDeint is a bi-directionally, motion adaptive (sharp) deinterlacer. It can also adaptively choose between using per-field and per-pixel motion adaptivity. It can use cubic interpolation, kernel interpolation (with temporal direction switching), or one of two forms of modified ELA interpolation which help to reduce "jaggy" edges in moving areas where interpolation must be used. TDeint also supports user overrides through an input file, and can act as a smart bobber or same frame rate deinterlacer, as well as an IVTC post-processor. See [http://forum.doom9.org/showthread.php?s=&threadid=82264 discussion].
| [[YUY2]], [[YV12]]
| [[TDeint|Plugin]]
| {{Author/tritical}}
|-
| [[TelecideHints]]
| The filter process the stats file to get the usual progressive matches and identify VFR sections.
| [[YUY2]], [[YV12]]
| [http://mod16.org/fansub/Telecidehints11.rar Plugin]
| {{Author/Myrsloik}}
|-
| [[TempGaussMC]]
| Motion-compensated bob deinterlacer, based on temporal gaussian blurring. reduces noise/grain of the source and does NOT leave the original fields unchanged. Output is rich with details and very stable. Is SLOW
| [[YV12]]
| [[TempGaussMC|Script]]
| {{Author/Didée}}
|-
|[https://forum.doom9.org/showthread.php?p=1734089#post1734089 w3fdif]
|Weston 3 Field Deinterlacing Filter (very beta).
|[[YV12]]
|[http://horman.net/avisynth/download/w3fdif.zip Plugin]
|{{Author/David Horman}}
|-
| [[Yadif]]
| Port of YADIF (Yet Another DeInterlacing Filter) from MPlayer by Michael Niedermayer (http://www.mplayerhq.hu). It check pixels of previous, current and next frames to re-create the missed field by some local adaptive method (edge-directed interpolation) and uses spatial check to prevent most artifacts.
| [[YUY2]], [[YV12]]
| [[Yadif|C-Plugin]]
| {{Author/Fizick}}
|-
| [[yadifmod]]
| Modified version of Fizick's avisynth filter port of yadif from mplayer. This version doesn't internally generate spatial predictions, but takes them from an external clip. It also is not an Avisynth_C plugin (just a normal one).
| [[YUY2]], [[YV12]]
| [[yadifmod|Plugin]]
| {{Author/tritical}}
|-
| [[yadifmod2]]
| Yadif + yadifmod for avisynth2.6/avisynth+.
| [[YV24]], [[YV16]], [[YV12]], [[YV411]], [[Y8]]
| [[yadifmod2|Plugin]]
| {{Author/Chikuzen}}
|}

=== Duplicate Frame Detectors ===

{{FilterTable}}
| [[ApparentFPS]]
| Shows underlying framerate where a clip has had many duplicates inserted, easier than counting unique frames.
| (see [[ApparentFPS|docs]])
| [[ApparentFPS|Plugin]]
| StainlessS
|-
| [[DeDup]]
| Remove (drop) duplicate frames in the interest of compression quality and speed. Resulting clip will have a variable frame rate.
| [[YV12]], [[YUY2]]
| [[DeDup]]
| {{Author/akupenguin}}
|-
| [[Dup]]
| A robust duplicate frame detector; a frame that is determined to be close enough to its predecessor to be considered a duplicate will be replaced by a copy of the predecessor. This can significantly reduce the size of encoded clips with virtually no visual effect. Provides the capability to replace frames with a blend of all the duplicates, providing a valuable noise reduction.
| [[YV12]], [[YUY2]]
| [[Dup|Plugin]]
| {{Author/Donald Graft}}
|-
|[https://forum.doom9.org/showthread.php?t=175357 Duplicity2/DropDeadGorgeous]
|A two faced scheming and double dealing [on your behalf] dupe tool.
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[https://forum.doom9.org/showthread.php?t=175357 Script]
|StainlessS
|-
| [http://forum.doom9.org/showthread.php?t=134930 Dupped]
| Another frame duplication function, similar to Dup, but hopefully more accurate.
| [[YV12]]
| [http://web.archive.org/web/20140420181919/http://www.randomdestination.com/members/corran/misc/dupped/dupped.avsi Script]
| [https://github.com/eparsons Corran]
|-
| [[DupStep]]
| Duplicate frame detector/decimator filter for [[AviSynth+]], 64-bit version only.
| [[YV12]], [[YV16]], [[YV24]], [[YV411]], [[Avisynthplus_color_formats|8-16 bits]]
| [[DupStep|Plugin]]
| [http://github.com/Orum Orum]
|-
|[[ExactDedup]]
| ExactDedup is a filter intended to remove frames that are exact duplicates of each other, leaving only the first and (optionally) last frames of a run intact, and generates a Matroska v2 timecodes file with timing information for the ensuing stream.
| [[RGB24]] [[RGB32]], [[Y8]], [[YV12]] [[YV16]], [[YV24]]
| [[ExactDedup|Plugin]]
|Steve Melenchuk, Arick Chan, StainlessS
|-
| [http://avisynth.org.ru/getdups/getdups.html GetDups]
| Selecting unique duplicate frames from clip, it return frames which have copies only, by one from the series (group). Made for 8mm films.
| [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://avisynth.nl/users/fizick/getdups/getdups096.zip Plugin]
| {{Author/Fizick}}
|-
| [http://forum.doom9.org/showthread.php?t=164372 MorphDups]
| Replace duplicate frames by interpolations.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=164372 Script]
| sven_x
|}

=== Fieldblending and Frameblending removal ===

{{FilterTable}}
| [[c_deblend]]
| c_deblend is a simple blend replacing function like unblend or removeblend. Superseded by [[srestore]].
| [[YV12]]
| Script
| MOmonster
|-
| [[Cdeint]]
| Restores 24fps FILM out of a fieldblended FILM -> Telecine -> [[NTSC]] -> Blendconversion -> [[PAL]] - Video (alternative for Restore24).
| [[YV12]]
| Script
| MOmonster
|-
| [[Deblend]]
| See [http://forum.doom9.org/showthread.php?p=760375#post760375 discussion].
|
| Script
| actionman133
|-
| [[ExBlend]]
| ExBlend is a plugin to repair damage caused by blend deinterlacing of telecined clips, which results in a double blend, every five frames, GGGBBGGGBBGGGBB etc where 'G' is good and 'B' is blend.
| [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[ExBlend|Plugin]]
| StainlessS
|-
| [[FixBlendIVTC]]
| A blend replacing/frame restoring function for doubleblends caused by blend-deinterlacing of telecined sources. Superseded by [[srestore]].
| [[YV12]]
| Script
| MOmonster
|-
| [[mrestore]]
| Uses conditional frame evaluation to undo standard conversions with blends. Superseded by [[srestore]].
| [[YV12]]
| Script
| MOmonster
|-
| [[RemoveBlend]]
| This filter is used to remove blended fields/frames. See [http://forum.doom9.org/showthread.php?t=75772 discussion.]
| [[YV12]]
| [//web.archive.org/web/20061113201230/http://bossanovaguitar.com/video/removeblend-0.3.zip Plugin]
| {{Author/violao}}
|-
| [[Restore24]]
| Restore24 is an AviSynth filter that is able to do the nearly impossible: Restore 24fps FILM out of a fieldblended FILM -> Telecine -> [[NTSC]] -> Blendconversion -> [[PAL]] - Video. See [http://forum.doom9.org/showthread.php?s=&threadid=75432 discussion].
|[[YV12]]
| Script
| scharfis_brain
|-
| [[RestoreFPS]]
| RestoreFPS reverses the kind of blending generated by [[ConvertFPS]], restoring original framerate. It will work perfectly well on any regular blend pattern.
| [[YV12]]
| [http://wilbertdijkhof.com/mg262/Restorefps_v10.zip Plugin]
| {{Author/mg262}}
|-
| [[Srestore]]
| Replacement function for mrestore, c_deblend, FixBlendIVTC and DupHq.
| [[YV12]]
| [[Srestore|script]]
| MOmonster
|-
| Specials
| Helps restore video with blended fields/frames using a reference source. See [http://forum.doom9.org/showthread.php?t=165030 discussion] and much more information [http://horman.net/doctorwho/specials.php here] and [http://forum.doom9.org/showthread.php?t=168832 here].
| [[YV12]]
| [http://horman.net/specials.zip Plugin]
| {{Author/David Horman}}
|-
| Unblend
| Unblend is based on warpenterprise's deblend algorithm and neuron2's decimate code, with YV12 support only. The aim is the same of deblend. See [http://forum.doom9.org/showthread.php?t=55019 discussion].
| [[YV12]]
| [http://avisynth.nl/users/warpenterprises/files/unblend_5F25_dll_2003.zip Plugin]
| Bach
|}

=== Film Damage correction ===

{{FilterTable}}
|[[DePulse]]
|DePulse is dropout remover, removes white/black noise horizontal streaking in analogue captures.
|[[YUY2]]
|[[DePulse|Plugin]]
|
|-
| [[DeScratch]]
| DeScratch removes vertical scratches from films. Also it can be used for removing of horizontal noise lines such as drop-outs from analog VHS captures (after image rotation).
| [[YV12]]
| [[DeScratch|Plugin]]
| {{Author/Fizick}}
|-
| [[DeSpot]]
| This filter is designed to remove temporal noise in the form of dots (spots) and streaks found in some videos. The filter is also useful for restoration (cleaning) of old telecined 8mm (and other) films from spots (from dust) and some stripes (scratches).
| [[YV12]]
| [[DeSpot|Plugin]]
| {{Author/Fizick}}
|-
| [[deVCR]]
| deVCR eliminates (to a certain degree) the annoying horizontal lines that keep crawling around your VHS or Beta recorded video.
| 8-bit RGB/YUV
| [[DeVCR#Script|Script]]
| Ricardo Garcia
|-
|[[KillPulse]]
|KillPulse is dropout remover, removes white/black noise horizontal streaking in analogue captures.
|[[YUY2]]
|[[KillPulse|Plugin]]
|
|-
| [[RemoveDirt]]
| RemoveDirt is a temporal cleaner for AviSynth 2.6 and AviSynth+.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[RemoveDirt|Plugin]]
| {{Author/kassandro}}, {{Author/pinterf}}
|-
|[http://forum.doom9.org/showthread.php?t=121197 RemoveLine]
|Script for removal of horizontal stripes.
|[[YV12]]
|Script
|Yup
|-
|[https://forum.doom9.org/showthread.php?t=181777 SpotLess]
|Script filter to remove spots and noise using mvTools2 and Medianblur2. Copes with spots on multiple consecutive frames, setting RadT accordingly.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[HBD]]
|Script
|StainlessS
|-
| [http://forum.doom9.org/showthread.php?t=144271 VideoFred's Film Restoring]
| A suite of scripts for film restoring.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=144271 Script]
| videoFred
|}

=== Frequency Interference removal ===

{{FilterTable}}
| [http://avisynth.org.ru/defreq/defreq.html DeFreq]
| Defreq uses Fast Fourier Transform method for frequency selecting an removing. See [http://forum.doom9.org/showthread.php?t=82978 discussion].
| [[YV12]], [[YUY2]]
| [http://avisynth.org.ru/defreq/defreq07.zip Plugin]
| {{Author/Fizick}}
|-
| [http://avisynth.nl/users/vcmohan/FanFilter/FanFilter.html FanFilter]
| Regular vertical frequency interference is filtered in spatial domain.
| [[YV12]], [[YUY2]], [[RGB32]], [[RGB24]]
| [http://www.avisynth.nl/users/vcmohan/FanFilter/FanFilter.zip Plugin]
| {{Author/vcmohan}}
|}

=== IVTC & Decimation ===

{{FilterTable}}
| [[AnimeIVTC]]
| What it does:
* High quality adaptative field matching for hard telecine
* Bob, remove the blends and decimate back to the desired framerate for DHT/field-blended
* Creating a VFR clip for hybrid sources
* Bob the interlaced credits, blend-deinterlacing the background while doing minimal damage on the progressive credits, convert their framerate to match the episode's and splice them with it OR leave them @ 30p to create a VFR clip
* Very good combing removal and anti-aliasing functions
See [http://forum.doom9.org/showthread.php?t=138305] and See [http://forum.doom9.org/showthread.php?p=1673928] for mod version.
| [[YV12]]
| Script
| thetoof
|-
|[[DecombUCF]]
|Decomb Using Clean Field. This function removes noise generated in one field, such as BS/terrestrial digital video scene changes and moving scenes. (Used after reverse telecine)
|[[YV12]]
|[[DecombUCF|Script]]
|tyottoenc
|-
| [http://forum.doom9.org/showthread.php?t=158230 DOCI]
| Destruction of Chroma Interlacing fixes a problem where you captured pulleddown video in YV12. In the combed frames, the chroma from two frames has been blended, leading to a ghosting effect when IVTC'd. This filter reconstructs the chroma exactly and fixes the problem.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=158230 Script]
| jmac698
|-
| [[FDecimate]]
| The FDecimate() filter provides extended decimation capabilities not available from Decimate(). It can remove frames from a clip to achieve the desired frame rate, while retaining audio/video synchronization. It preferentially removes duplicate frames where possible. ("FDecimate" stands for "Free Decimate", which implies that the output frame rate may be freely chosen, and is not limited to 1-in-N decimation).
| [[YUY2]], [[YV12]]
| [[FDecimate|Plugin]]
| {{Author/Donald Graft}}
|-
| [[FDecimate2]]
| FDecimate2 is based on FDecimate v1.0.2. FDecimate2, fixes some problems with bugged metrics in FDecimate v1.0.2.
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[FDecimate2|Plugin]]
| {{Author/StainlessS}}
|-
| [[IT]]
| Inverse Telecine plugin.
| [[YUY2]], [[YV12]]
| [[IT|Plugin]]
| {{Author/thejam79}} / {{Author/minamina}}
|-
| [[IVTC_txt60mc|ivtc_txt60mc]]
| Deinterlaces telecined footage with that has been overlayed scrolling text at 60i.
| [[YV12]]
| [[IVTC_txt60mc|Script]]
| {{Author/cretindesalpes}}
|-
|JIVTC
|JIVTC applies inverse telecine in a way to minimize artifacts often seen on Japanese TV broadcasts followed by recalculating the fields that might still contain some.
|[[YV12]]
|[http://raw.githubusercontent.com/lovesyk/avisynth-scripts/master/JIVTC.avsi Script]
|[http://github.com/lovesyk lovesyk]
|-
|[[MDec2]]
|MDec2 is a 2 pass decimating filter, acting much like the MultiDecimate filter.
|[[RGB32]], [[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[MDec2|Plugin]]
|StainlessS
|-
| MultiDecimate
| Removes N out of every M frames, taking the frames most similar to their predecessors. See [http://forum.doom9.org/showthread.php?s=&threadid=51901&perpage=20&pagenumber=2 discussion].
| [[YUY2]]
| [{{N2Moved}}/multidecimate/multidecimate.html Plugin]
| {{Author/Donald Graft}}
|-
| RePal
| [http://forum.doom9.org/showthread.php?t=48401 Discussion] / [http://forum.doom9.org/showthread.php?p=1092552#post1092552 repal_29.97Hz_mod]
| [[YUY2]], [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/repal_5F25_dll_20030523.zip Plugin] - [http://forum.doom9.org/attachment.php?attachmentid=8028&d=1201414683 Mod]
| Bach
|-
| [[Decomb]]
| The Telecide and Decimate filters can be combined to implement IVTC.
| [[YUY2]], [[YV12]]
| [[Decomb|Plugin]]
| {{Author/Donald Graft}}
|-
|[https://forum.doom9.org/showthread.php?t=182369 TelecineBob]
|If your source soffers from field blending, as long as no deinterlacing is made you will find out that conveniently the blended fields are often paired with a clean one. FieldDeBlend takes advantage of that and checks for frames whose fields don't match to replace the frame with a clean one as long there is one.
|[[YV12]]
|[https://www.mediafire.com/file/sa1oae96m63mkje/TelecineBob.zip/file Plugin]
|Ceppo
|-
| [[TIVTC]]
| A package containing these 7 filters: TFM, TDecimate, MergeHints, FrameDiff, FieldDiff, ShowCombedTIVTC, and RequestLinear. Also contains these 3 conditional functions: IsCombedTIVTC, CFieldDiff, and CFrameDiff. Designed primarily for IVTC operations.
| [[YUY2]], [[YV12]]
| [[TIVTC|Plugin]]
| {{Author/tritical}}
|-
| TPRIVTC
| TPRIVTC stands for TMPEG InVerse Telecine, i.e. the process where an 29.97fps interlaced NTSC clip is converted to 23.976fps while removing interlaced frames. [http://web.archive.org/web/20030808191810/http://kurosu.inforezo.org/avs/TPRIVTC/index.html Readme]
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/tprivtc_5F25_dll_20040930.zip Plugin]
| daxab, {{Author/Kurosu}}
|-
| [http://forum.doom9.org/showthread.php?t=167875 WeaveMan]
| Remove arbitrary pulldown patterns manually; meant for perfectionists to undo non-standard 24->25 fps, 25->29.97 fps, etc. telecine conversions, along with other weird telecine anomalies created by broadcasters speeding up film-sourced content. See sample case [http://forum.doom9.org/showthread.php?p=1630931&highlight=weaveman#post1630931 here].
| [[YUY2]], [[YV12]]
| [http://web.archive.org/web/20131208232913/http://chidragon.thedessie.com/Doom9/WeaveMan-v0.2.zip Plugin]
| ChiDragon
|-
| [[IvtcBlend]]
| Waka demonstrated an IvtcBlend function that uses the information in the "extra" fields of a telecined source to help combat temporal noise.
|
| Script
|
|}

=== Ghost Removal ===

{{FilterTable}}
| FixVHSOversharp
| FixVHSOversharp attempts to repair the light and dark halos that follow high contrast edges found in VHS sources. See [http://web.archive.org/web/20131014010552/http://www.videohelp.eu/forum/avisynth/2851-avisynth-fixvhsoversharp-beta.html discussion.]
| | [[YUY2]]
| [http://web.archive.org/web/20091026142456/http://www.geocities.com/mrtibsvideo/fixvhsoversharp.html Plugin]
| [http://web.archive.org/web/20091027001215/http://geocities.com/mrtibsvideo/ MrTibs]
|-
| [[GhostBuster|Ghostbuster]]
| A filter for the removal of ghosting.
| [[YUY2]]
| [[GhostBuster|Plugin]]
| {{Author/SansGrip}}
|-
| [[LGhost]]
| Plugin intended for ghost removal but can also reduce edge (ringing) artifacts.
| [[YV12]], [[YUY2]]
| [[LGhost|Plugin]]
| {{Author/minamina}}
|}

=== Logo Removal ===

{{FilterTable}}
| [[AvsInpaint]]
| This plugin comes with the intention to provide a suit for the removal of logos, whether opaque or transparent. It provides algorithms for these tasks: logo detection, deblending, and logo inpainting.
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
| [[AvsInpaint|C-Plugin]]
| AMSS0815, {{Author/pinterf}}
|-
| [[DeKafka]]
| This fairly simple filter washes away those annoying bugs from broadcast clips.
| Any
| Script
| poptone
|-
| DeLogo
| DeLogo Filter for VirtualDub. Removes static elements, e.g. logos or watermarks, from the video stream. It can remove either opaque elements or alpha blended, the latter even without destroying the picture beneath.
| [[RGB32]]
| [{{N2Moved}}/delogo132/delogo.html Plugin] & [http://forum.doom9.org/showthread.php?t=119447 Script]
| Karel Suhajda
|-
|[[DelogoHD]]
|DelogoHD is an overhaul of the original delogo filter, which was originally written by MakKi many years ago.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], <br> 8-16bit planar YUV
|[[DelogoHD|Plugin]]
|MeteorRain
|-
| [[ExInpaint]]
| Exemplar-Based Image Inpainting. See [http://forum.doom9.org/showthread.php?t=133773 discussion]
| [[RGB24]] [[RGB32]], [[YUY2]], [[YV12]]
| [[ExInpaint|Plugin]]
| {{Author/Fizick}}
|-
|[https://forum.doom9.org/showthread.php?t=176860 InpaintDelogo]
|InpaintDelogo is an advanced logo and watermark removal function using inpainting and deblending with an adjustable fine process to hide artifacts and get best delogo results.
Can remove opaque, transparent, semi-transparent and some dynamic logos from video.
|Any
|[https://forum.doom9.org/showthread.php?t=176860 Script]
|VoodooFX
|-
| [[InpaintFunc]]
| Script for logo removal using inpainting. Can remove alpha blended or opaque logos with a basic postprocessing to hide artifacts.
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
| [[InpaintFunc|Script]]
| Reuf Toc
|-
| [[rm_logo]]
| Combination of deblending and inpainting to remove logos with adjustable postprocessing to further hide artifacts. See [http://forum.doom9.org/showthread.php?t=134919]
| [[YV12]]
| [http://avisynth.nl/images/Rm_logo.avs Script]
| Spuds
|-
|[http://forum.doom9.org/showthread.php?t=154559 s_ExLogo]
|De-logo function with clipping (Dekafka mod).
|[[YUY2]]
|[http://www.mediafire.com/download/40cpnnctd0uutpv/s_ExLogo_1.1.zip Script]
|{{Author/StainlessS}}
|-
| [[Uglarm]]
| Filter for blurring a logo, using LogoAway style Uglarm Interpolation method.
| [[RGB24]] [[RGB32]],[[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]]
| [[Uglarm|Plugin]]
| {{Author/StainlessS}}
|-
| [[X-Logo]]
| X-Logo AviSynth plugin and VirtualDub filter. Removes opaque logos.
| [[RGB32]], [[YUY2]], [[YV12]]
| [[X-Logo|Plugin]]
| [http://web.archive.org/web/20041204210505/http://members.verizon.net/~vze3kkvm/filters.html Leuf]
|}

=== Luma Equalization ===

{{FilterTable}}
| [[Antiflicker]]
| "A quick-and-dirty port of my VirtualDub filter (which sucks, by the way; it was one of my first filters)."
See [http://forum.doom9.org/showthread.php?p=224573#post224573 discussion.]
| [[YUY2]]
| [http://www.avisynth.nl/users/warpenterprises/files/antiflicker_5F25_dll_20030304.zip Plugin]
| {{Author/Donald Graft}}
|-
| [[DeFlicker]]
| Can remove old film intensity flicker by temporal mean luma smoothing. Can also correct blinding of automatic gain control after flashes.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], [[YUY2]]
| [[DeFlicker|Plugin]]
| {{Author/Fizick}}, {{Author/pinterf}}
|-
| [http://forum.doom9.org/showthread.php?p=1326599#post1326599 Dumb Deflicker]
| Gathers average luma of frames, smoothens that with TemporalSoften, and applies the obtained difference to the original input. It is pretty simple, read "dumb". See [http://forum.doom9.org/showthread.php?p=1326599#post1326599 discussion]
| [[YV12]]
| [http://forum.doom9.org/showthread.php?p=1326599#post1326599 Script]
| {{Author/Didée}}
|-
| [[EquLines]]
| Equalizes total luminosity in pairs of even and odd lines. Useful for removing inter-line differences from telecined films.
| [[YV12]], [[YUY2]]
| [[EquLines|Plugin]]
| {{Author/Fizick}}
|-
| [[LMFlicker]]
| LMFlicker is intended to reduce flickering in some film/VHS transfers. FieldFade is a similar concept, but applied on a per-field basis, to reduce combing in a video where fades were applied after telecine.
| [[YV12]]
| [[LMFlicker|Plugin]]
| {{Author/akupenguin}}
|-
| [http://forum.doom9.org/showthread.php?t=159493 Local Deflicker]
| Deflickers only part of a frame. See [http://forum.doom9.org/showthread.php?t=159493 discussion.]
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=159493 Script]
| prokhozhijj
|-
| [[ReduceFlicker]]
| Plugin to reduce temporal oscillations.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[ReduceFlicker|Plugin]]
| {{Author/kassandro}}, {{Author/Chikuzen}}
|-
| [[TimeLapseDF]]
| Designed to remove luminosity flicker in time lapse photography. Unlike most other flicker removal filters, utilizes cumulative distribution function in addition to average frame luminosity.
| [[YV12]], [[YUY2]]
| [[TimeLapseDF|Plugin]]
| {{Author/Denis Zhitenev}}
|-
| [[Vinverse]]
| A simple but effective plugin to remove residual combing.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[Vinverse|Plugin]]
| {{Author/Didée}}, {{Author/tritical}}, {{Author/tp7}}
|-
| [http://forum.doom9.org/showthread.php?t=106898 wdeflicker]
| Modifies luma of a source clip by refering to a temporally super-smoothed clip. Heights of source and reference clips must match.
| [[YV12]], [[YUY2]]
| [http://forum.doom9.org/attachment.php?attachmentid=5417&d=1139174468 Plugin]
| Osmiridium
|}

=== [[:Category:Rainbow & Dot Crawl Removal|Rainbow & Dot Crawl Removal]] ===

{{FilterTable}}
| [[Bifrost]]
| Bifrost uses temporal blending to remove or at least reduce the effect of rainbows.
| [[YV12]]
| [[Bifrost|Plugin]]
| {{Author/Myrsloik}}, dubhater
|-
| [[CC]]
| Dot crawl and rainbow removal.
| [[YV12]], [[YUY2]]
| [http://www.chiyoclone.net/dl/cc_20040522.lzh Plugin]
| {{Author/chiyo-clone}}
|-
| [[Checkmate]]
| Spatial-temporal dot crawl removal.
| [[YV12]]
| [[Checkmate|Plugin]]
| {{Author/mf}} / prunedtree
|-
| [[ChubbyRain]]
| Spatial-temporal rainbow reducing script.
| [[YV12]]
| [http://avisynth.nl/images/ChubbyRain.avsi Script]
| Mug Funky
|-
| [[ChubbyRain2]]
| Spatial-temporal rainbow reducing script based on [[ChubbyRain]].
| [[YV12]]
| [http://avisynth.nl/images/ChubbyRain2.avsi Script]
| Lothar
|-
| [[DeCrawl]]
| Spatial and temporal dot crawl removal, particularly for animated material.
| [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/decrawl_20060924.zip Plugin]
| Dan Donovan
|-
| [[DeCross]]
| Cross Color Reduction. Also known as rainbows.
| [[YV12]], [[YUY2]]
| [[DeCross|Plugin]]
| {{Author/minamina}}
|-
| [[DeDot]]
| Removes dot crawl and may also be useful for rainbows.
| [[YV12]], [[YUY2]]
| [[DeDot|Plugin]]
| {{Author/thejam79}} / {{Author/minamina}}
|-
| [[DeRainbow]]
| A simple script to reduce rainbows. See [http://forum.doom9.org/showthread.php?p=398106#post398106 discussion.]
| [[YV12]], [[YUY2]]
| [http://avisynth.nl/images/DeRainbow.avsi Script]
| sh0dan
|-
| [[DFMDeRainbow]]
| Creates mask to process only edges; rainbows are removed by hitting chroma planes with two passes of FluxSmooth (hence "Double-Flux-Mask").
| [[YV12]]
| [http://avisynth.nl/images/DFMDeRainbow-20140223.avsi Script]
| {{Author/Scintilla}}
|-
|[https://forum.doom9.org/showthread.php?t=170328 FadeDeRainbow]
|Another de-rainbowing script.
|[[YV12]]
|[https://forum.doom9.org/showthread.php?t=170328 Script]
|bxyhxyh
|-
| [http://avisynth.org.ru/docs/english/externalfilters/guavacomb.htm GuavaComb]
| Removes dot crawl, rainbows, and some kinds of shimmering. See [http://forum.doom9.org/showthread.php?t=37456 discussion]
| [[YUY2]]
| [http://avisynth.nl/users/warpenterprises/files/guavacomb_5F25_dll_20030801.zip Plugin]
| {{Author/Lindsey Dubb}}
|-
| [[LUTDeCrawl]]
| Purely spatial; only targets pixels for dot crawl removal if luma is fluctuating and (optionally) chroma is not.
| [[YV12]]
| [http://web.archive.org/web/20140421001939/http://www.aquilinestudios.org/scripts/LUTDeCrawl-20081003.avsi Script]
| {{Author/Scintilla}}
|-
| [[LUTDeRainbow]]
| Purely spatial; only targets pixels for derainbowing if chroma is fluctuating and (optionally) luma is not.
| [[YV12]]
| [http://web.archive.org/web/20140421001939/http://www.aquilinestudios.org/scripts/LUTDeRainbow-20081003.avsi Script]
| {{Author/Scintilla}}
|-
| [[mfRainbow]]
| Derainbows in areas of high Y, U and V frequencies, which fluctuate heavily.
| [[YV12]]
| [http://avisynth.nl/images/MfRainbow-v0.32.avsi Script]
| {{Author/mf}}
|-
| [[Rainbow_Smooth]]
| A small spatial derainbow function. It uses [[SmoothUV]] to smooth out chroma and edge masking to prevent color bleeding.
| [[YV12]]
| [http://avisynth.nl/images/Rainbow_smooth.avsi Script]
| MOmonster
|-
| [[SmartSSIQ]]
| SSIQ can alter the color on the entire picture. So this script first applies SSIQ to the entire picture. Then it locates the edges. Finally, it layers ONLY the de-rainbowed edges onto the original video.
| [[YV12]]
| [http://avisynth.nl/images/SmartSSIQ.avsi Script]
| LB
|-
| [[SSIQ]]
| Rainbow remover. A port of the VirtualDub plugin [http://www.doki.ca/filters/ Smart Smoother IQ.]
| [[YV12]], [[YUY2]], [[RGB32]]
| [http://avisynth.nl/users/warpenterprises/files/ssiq_20070304.zip Plugin]
| {{Author/Myrsloik}}
|-
| [[TComb]]
| A temporal comb filter (it reduces cross-luminance (rainbowing) and cross-chrominance (dot crawl) artifacts in static areas of the picture).
| [[YV12]], [[YUY2]]
| [[TComb|Plugin]]
| {{Author/tritical}}
|-
| [[YARK]]
| Yet Another Rainbow Killer. Based on mfRainbow v0.31, chubbyrain2, and various other scripts shown [http://forum.doom9.org/showthread.php?t=141165 here].
| [[YV12]]
| [[YARK|Script]]
| jase99
|-
| [[ASTDR]]
| ASTDR uses mt_motion for motion and edge to deal with moving Rainbow and apply mask once more in the opposite way to keep around the lines as they are. It uses DeCross and other filters to remove Rainbow. ASTDRmc avoids chroma bleeding in moving scenes. See [http://forum.doom9.org/showpost.php?p=1665492&postcount=27 post on doom9.org].
| [[YV12]]
| [[ASTDR|Script]]
| AmjadSONY
|}

=== Stabilization ===

{{FilterTable}}
| [[CelStabilize]]
| Script which holds a fixed background steady. Doesn't work well with pans or fades.
| [[YV12]]
| [http://avisynth.nl/index.php/CelStabilize Script]
| mg262
|-
| [[DePan]]
| Tools for estimation and compensation of global motion (pan).
| [[YUY2]], [[YV12]]
| [[DePan|Plugin]]
| {{Author/Fizick}}
|-
|[[Depansafe]]
|Another DePan stabilization script.
|[[YV12]]
|[[DepanSafe|Script]]
|[http://pastebin.com/u/tophf tophf]
|-
| [[Deshaker3D]]
| Experimental 3D image stabilizer (VDub [http://www.guthspot.se/video/deshaker.htm Deshaker] required).
| [[RGB32]]
| [[Deshaker3D|Plugin]]
| {{Author/David Horman}}
|-
|[http://forum.doom9.org/showthread.php?t=172136 SpatialAlign]
|Fix spatial alignment between two clips containing similar scenes.
|Any?
|[http://forum.doom9.org/showthread.php?t=172136 Script]
|StainlessS
|-
| [[Stab]]
| Simple but powerful script to remove small high frequency jitter that appears often on old/bad transfers.
| [[YV12]]
| [[Stab|Script]]
| g-force
|-
|[http://forum.videohelp.com/threads/371336-Stabilization-Tools-Pack-v1-8 Stabilization Tools Pack]
| A set of tools to work with common stabilization issues, mainly from telecine process.
|[[YV12]]
|[http://forum.videohelp.com/threads/371336-Stabilization-Tools-Pack-v1-8 Script]
|{{Author/Dogway}}
|-
| [http://web.archive.org/web/20151223052321/http://code.google.com/p/avisynthrestoration/wiki/TBC TBC]
| Stabilizes horizontal jitter in video from analog VCRs, similar to the function of a Time Base Corrector.(note: will cause SEt's Avisynth 2.6 MT to stop working)
| [[YV12]]
| [http://web.archive.org/web/20151223052318/https://code.google.com/p/avisynthrestoration/downloads/list Script]
| halifaxgeorge
|}

== Denoisers ==
Strength/Quality of Denoisers

(need subclassification)

{{FilterTable}}
| [[AdaptiveMedian]]
| This is an adaptive Median Filter for eliminating certain types of noise. It uses local statistics (minimum, maximum and median values) of a moving local grid, and changes grid size depending on local statistics.
| [[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[AdaptiveMedian|Plugin]]
|{{Author/vcmohan}}
|-
| Atc
| Alternate Temporal Cleaner; a fast temporal cleaner with some cool stuff.
| [[YV12]]
| [http://ziquash.chez-alice.fr/atc%20beta%201.zip Plugin]
| {{Author/Marc FD}}
|-
| ColourizeSmooth
| ColourizeSmooth uses a general colourizing algorithm to smooth a given clip. ColourizeSmooth is based on this [http://www.cs.huji.ac.il/~yweiss/Colorization algorithm.] See [http://forum.doom9.org/showthread.php?t=91344 discussion]
| [[YUY2]], [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/colourizesmooth_5F25_dll_20050429.zip Plugin]
| insanedesio
|-
| [http://www.kevina.org/temporal_median/ ConditionalTemporalMedian]
|This filter is designed to remove temporal noise in the form of small dots and streaks found in some videos. A common cause of this is dirty VHS heads but I have also seen small black or white streaks in broadcast material.
| [[YV12]]
| [http://www.kevina.org/temporal_median/CondTemporalMedian-0.93.zip Plugin]
| {{Author/Kevin Atkinson}}
|-
|[[Deathray]]
|OpenCL GPU accelerated spatial/temporal non-local means de-noising.
|[[YV12]]
|[[Deathray|Plugin]]
|[http://github.com/JawedAshraf Jawed]
|-
| [[DeNoise]]
| This is an adaptive local noise reduction filter. It uses global variance of the noise, local mean and local variance in a moving grid of specified size. It tries to preserve edges as closely as possible. The global variance value can be specified or it can be computed from a window. The global variance can have one value for the entire clip or can vary frame to frame linearly or computed from a window with its coordinates linearly moving with frame numbers.
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [[DeNoise|Plugin]]
| {{Author/vcmohan}}
|-
| [http://web.archive.org/web/20071105084352/http://www.geocities.com/fredthompson6/Kiraru2002/Kiraru2002sROOM.htm#dnr2 DNR2]
| Dynamic Noise Reduction 2 is based on the VirtualDub [http://www.shdon.com/vid/dnr DNR] filter by Steve Don and Avery Lee.
| [[RGB32]], [[YUY2]], [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/dnr2_5F25_dll_20021225.zip Plugin]
| {{Author/kiraru2002}}
|-
| [[DeSaltPepper]]
| Remove white and black noise.
| Any
| [[DeSaltPepper|Plugin]]
| {{Author/vcmohan}}
|-
| [[ExtendedBilateral]]
| ExtendedBilateral extends the regular bilateral filtering process by adding an "initial estimation preprocess." It is similar in operation to [[TBilateral]] and offers many of the same options (though not all) while adding the preprocess.
| [[YUY2]], [[YV12]]
| [[ExtendedBilateral|Plugin]]
|insanedesio
|-
| [[FFTQuiver]]
| Remove periodic noise. Useful for analog interference.
| [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[FFTQuiver|Plugin]]
| {{Author/vcmohan}}
|-
| SmootherHiQ
| VirtualDub's ''Smart Smoother High Quality'' for AviSynth, see archived [http://web.archive.org/web/20040611013235/http://cultact-server.novi.dk/kpo/avisynth/smooth_hiq_as.html documentation].
| [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/smoothhiq_5F25_dll_20030208.zip Plugin]
| {{Author/Sh0dan}}
|-
| [[TNLMeans]]
| TNLMeans is an implementation of the NL-means denoising algorithm.
*[http://forum.doom9.org/showthread.php?t=171817 TfNLMeans] - an AviSynth 2.6 fork of TNLMeans 1.0.3
| [[YV12]], [[YUY2]]
| [[TNLMeans|Plugin]]
| {{Author/tritical}}
|-
| [[KNLMeansCL]]
| KNLMeans is an optimized OpenCL implementation of the Non-local means denoising algorithm.
| [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[KNLMeansCL|Plugin]]
| [http://github.com/Khanattila Khanattila]
|-
|[http://forum.doom9.org/showthread.php?t=172966 xNLMeans]
|xNLMeans is an AviSynth plugin implementation of the Non Local Means denoising proposition. This implementation provides several optimizations and extensions over the original proposition and other implementations.
|[[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[http://www.mediafire.com/download/4stpv24pvpfclzm/xNLMeans_0.03_20160324.zip Plugin] 
|martin53
|}

=== Spatial Denoisers ===

{{FilterTable}}
| [[_2DCleanYUY2]]
| Averages pixels in a configurable radius around a source pixel that are within a configurable threshold of the central pixel. A port of the VirtualDub plugin [{{N2Moved}}/2dcleaner.html 2D Cleaner.]
| [[YV12]], [[YUY2]]
| [http://dl.dropboxusercontent.com/s/vh7a5xmdpyj3d8u/_2DCleanYUY2_v0_10_mod_for_smp_YV12.zip Plugin]
| {{Author/kiraru2002}}, {{Author/xeon533}}
|-
| [[DctFilter]]
| An experimental filter that operates on DCT coefficients.
| [[YV12]], [[YUY2]]
| [[DctFilter|Plugin]]
| {{Author/Tom Barry}}
|-
| [[DCTFun]]
| A fast spatial denoiser that does a hard thresholding of a complete 4x4 ICT transform.
| [[YV12]]
| [http://avisynth.nl/index.php/DCTFun Plugin]
| Prunedtree
|-
| eDeen
| eDeen is a ultra powerfull spatial denoiser for very experienced encoders only.
| [[YV12]]
| [http://ziquash.chez-alice.fr/eDeen%20beta%201.zip Plugin]
| {{Author/Marc FD}}
|-
| [[frfun3b]]
| Fractal denoising. See [http://forum.doom9.org/showthread.php?t=110200 discussion]
| [[YV12]]
| [http://web.archive.org/web/20080905123941/http://soulhunter.chronocrossdev.com/data/frfun3b_rev3.zip Plugin]
| prunedtree
|-
| [[frfun3d]]
| Fractal denoising; frfun3d is a quality optimized frfun3b. See [http://forum.doom9.org/showthread.php?t=110200 discussion]
| [[YV12]]
| [http://dl.dropboxusercontent.com/s/xqxfy59pcv3ea1q/frfun3d_r1.zip Plugin]
| prunedtree
|-
| [[frfun7]]
| Fractal denoising. See [http://forum.doom9.org/showthread.php?t=110200 discussion]
| [[YV12]]
| [[Frfun7|Plugin]]
| prunedtree
|-
|-
| [http://web.archive.org/web/20101201051903/http://gpubilateral.sourceforge.net/ GPUBilateral]
| In short, bilateral filter is a edge-preserving smooth filter. See [http://forum.doom9.org/showthread.php?t=136370 discussion.]
| [[RGB32]]
| [http://sourceforge.net/projects/gpubilateral/files/ Plugin]
| Sompon Virojanadara
|-
|Kuwahara
|This filter is an edge preserving spatial noise reduction filter. It applies spatial smoothing while preserving the edges. See [http://forum.doom9.org/showthread.php?p=1689773 discussion]
|[[RGB24]], [[RGB32]]
|[http://www.wilbertdijkhof.com/Kuwahara_v11.zip Plugin]
|{{Author/Wilbert Dijkhof}}
|-
|[[MiniDeen]]
|MiniDeen is a spatial denoising filter. It replaces every pixel with the average of its neighbourhood. This is a port of the "a2d" method from the AviSynth plugin [[Deen]], version beta 2.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], 8-16bit planar YUV in AviSynth+
|[[MiniDeen|Plugin]]
|dubhater / MeteorRain
|-
| [{{N2Moved}}/msmooth/msmooth.html Msmooth]
| Masked smoother, designed specifically for anime.
| [[YV12]], [[RGB32]]
| [{{N2Moved}}/msmooth/msmooth202.zip Plugin]
| {{Author/Donald Graft}}
|-
|[[Neo_VagueDenoiser]]
|Wavelet based Denoiser. Refactored version of the original VagueDenoiser; includes optimizations, additional colorspaces, and high bit depth support.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], 8-16bit planar YUV in AviSynth+
|[[Neo_VagueDenoiser|Plugin]]
| HolyWu, [https://github.com/msg7086 MeteorRain]
|-
| [[SmoothUV]]
| A spatial denoising plugin based on [{{N2Moved}}/smooth.html Smart Smoother] and [{{N2Moved}}/hiq/smoothhiq.html Smart Smooth HiQ].
| [[YV12]]
| [[SmoothUV|Plugin]]
| {{Author/Kurosu}}
|-
| [[SmoothUV2]]
| SmoothUV2 is a spatial derainbow filter. This filter performs structure-preserving smoothing (blurring) on the U/V (chrominance or colour) information of the image, leaving Y (luminance) intact.
| [[YV12]], [[YV16]], [[YV24]]
| [[SmoothUV2|Plugin]]
| [https://github.com/dubhater dubhater], [https://github.com/Asd-g asd-g]
|-
|[[SPresso]]
|A fast script to make SD content compress better while keeping the "original look".
|[[YV12]]
|[http://forum.doom9.org/showpost.php?p=867316&postcount=23 Script]
|{{Author/Didée}}
|-
| [[TBilateral]]
| TBilateral is a spatial smoothing filter that uses the bilateral filtering algorithm. It does a nice job of smoothing while retaining picture structure.
| [[YV12]], [[YUY2]]
| [[TBilateral|Plugin]]
| {{Author/tritical}}
|-
| [[UnDot]]
| UnDot is a simple median filter for removing dots, that is stray orphan pixels and mosquito noise. It clips each pixel value to stay within min and max of its eight surrounding neighbors. See [http://forum.doom9.org/showthread.php?s=&postid=205442#post205442 discussion].
| [[YUY2]], [[YV12]]
| [http://web.archive.org/web/20130207143129/http://neuron2.net/trbarry/UnDot.zip Plugin]
| {{Author/Tom Barry}}
|-
| [[VagueDenoiser]]
| This is a Wavelet based Denoiser. Basically, it transforms each frame from the video input into the wavelet domain, using various wavelet filters. Then it applies some filtering to the obtained coefficients.
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [[VagueDenoiser|Plugin]]
| {{Author/Lefungus}}, {{Author/Kurosu}}, {{Author/Fizick}}
|-
| [[VerticalCleaner]]
| Fast vertical cleaner.
| [[YV12]], [[YUY2]]
| [[VerticalCleaner|Plugin]]
| {{Author/kassandro}}
|-
|[[vsMSmooth]]
|vsMSmooth is a spatial smoother that doesn't touch edges.
||[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], all planar Y, YUV, and RGB formats, 8 to 16 bit
|[[vsMSmooth|Plugin]]
|Dubhater, Asd-g
|}

=== Temporal Denoisers ===

{{FilterTable}}
| [[Cnr2]]
| A fast chroma denoiser. Very effective against stationary rainbows and huge analogic chroma activity. Useful to filter VHS/TV caps.
| [[YV12]], [[YUY2]]
| [[Cnr2|Plugin]]
| {{Author/Marc FD}}, {{Author/tritical}}
|-
| [[FluxSmooth]]
| Examines each pixel and compares it to the corresponding pixel in the previous and last frame.
| [[YV12]], [[YUY2]]
| [[FluxSmooth|Plugin]]
| {{Author/SansGrip}}, {{Author/Sh0dan}}
|-
| [http://avisynth.org.ru/docs/english/externalfilters/grapesmoother.htm GrapeSmoother]
| This filter averages out visual noise between frames.
| [[YUY2]]
| [http://avisynth.nl/users/warpenterprises/files/grapesmoother_5F25_dll_20030801.zip Plugin]
| {{Author/Lindsey Dubb}}
|-
| MVDegrain
| Strong and effective temporal denoiser. Part of the [[MVTools]] package.
| [[YV12]], [[YUY2]]
| [[MVTools|Plugin]]
| {{Author/Fizick}}
|-
| [http://avisynth.nl/users/fizick/docs/english/externalfilters/temporalcleaner.htm TemporalCleaner]
| TemporalCleaner is an AviSynth port of the original port of the VirtualDub filter TemporalCleaner made by [http://home.earthlink.net/~casaburi/download/#temporalcleaner Jim Casaburi.]
| [[YV12]], [[YUY2]]
| [http://avisynth.nl/users/warpenterprises/files/temporalcleaner_5F25_dll.zip Plugin]
| vlad59
|-
| [[TTempSmooth]]
| TTempSmooth is a motion adaptive (it only works on stationary parts of the picture), temporal smoothing filter.
| [[YV12]], [[YUY2]]
| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TTempSmoothv094.zip Plugin]
| {{Author/tritical}}
|-
| [[Temporal Degrain]]
| SLOW but very effective at removing most grain from video sources.
| [[YV12]]
| [http://avisynth.nl/images/TemporalDegrain.avs Script]
| Didée, Sagekilla
|-
| [[TemporalDegrain2]]
| Temporal Degrain enhanced with parts of QTGMC, potentially slower but more effective at removing grain from video sources while retaining more details.
| [[YV12]]
| [http://avisynth.nl/images/TemporalDegrain-v2.avsi Script]
| Didée, Sagekilla, Vit, real.finder, ErazorTT
|-
|[[vsTTempSmooth]]
|vsTTempSmooth is a motion adaptive (it only works on stationary parts of the picture), temporal smoothing filter.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], all planar Y, YUV, and YUVA (8-32 bit)
|[[vsTTempSmooth|Plugin]]
|HolyWu, Asd-g
|}

=== Spatio-Temporal Denoisers ===

{{FilterTable}}
| [[Convolution3D]]
| Convolution3D is a spatio-temporal smoother, it applies a 3D convolution filter to all pixels of consecutive frames.
| [[YV12]]
| [[Convolution3D|Plugin]]
| {{Author/Vlad59}}
|-
| [[Deen]]
| Deen is a set of assembly-optimised denoisers, like various 3d and 2d convolutions.
| [[YV12]]
| [[Deen|Plugin]]
| {{Author/Marc FD}}
|-
| DenoiseMF
| A fast and accurate denoiser for a Full HD video from a H.264 camera. See [http://forum.doom9.org/showthread.php?t=162603 discussion].
| [[YV12]]
| [http://web-beta.archive.org/web/20160315085026/http://forum.doom9.org/showthread.php?t=162603 Script]
| rean
|-
| [[dfttest]]
| A 2D/3D frequency domain denoiser.
| [[YUY2]], [[YV12]], [[YV16]], [[YV24]]
| [[dfttest|Plugin]]
| {{Author/tritical}}
|-
| dfttestMC
| A script that motion compensates dfttest. See [http://forum.doom9.org/showthread.php?t=147676 discussion.]
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=147676 Script]
| thewebchat
|-
| [[DeGrainMedian]]
| Two stage Spatio-Temporal Limited Median filter for grain removal.
| [[YV12]], [[YUY2]]
| [[DeGrainMedian|Plugin]]
| {{Author/Fizick}}
|-
| [[FFT3DFilter]]
| A 3D Frequency Domain filter - gives strong denoising and moderate sharpening.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], [[YUY2]], any Y, YUV and Planar RGB 8-32 bit
| [[FFT3DFilter|Plugin]]
| {{Author/Fizick}}, martin53, {{Author/pinterf}}
|-
| [[FFT3DGPU]]
| Similar algorithm to FFT3DFilter, but uses graphics hardware for increased speed.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], [[YUY2]], Planar RGB 8 bit
| [[FFT3DGPU|Plugin]]
| {{Author/tsp}}, {{Author/pinterf}}
|-
| [[hqdn3d]]
| High Quality DeNoise 3D is an Avisynth 2.5 port of the MPlayer filter of the same name. It performs a 3-way low-pass filter, which can completely remove high-frequency noise while minimizing blending artifacts.
| [[YV12]]
| [[hqdn3d|Plugin]]
| {{Author/akupenguin}}
|-
|[https://forum.doom9.org/showthread.php?t=174804 mclean]
|Typical spatial filters work by removing large variations in the image on a small scale, reducing noise but also making the image less sharp or temporally stable. mClean removes noise whilst retaining as much detail as possible, as well as provide optional image enhancement.
|[[YV12]], [[HBD]]
|[https://forum.doom9.org/showthread.php?t=174804 Script]
|burfadel
|-
| [[MC_Spuds]]
| Motion compensated noise removal with sharpening. Extremely slow, but extremely effective.
| [[YV12]]
| [[MC_Spuds|Script]]
| Spuds, {{Author/Didée}}
|-
| [[MCTemporalDenoise]]
| Another high quality motion compensated noise removal script with an accompanying post-processing component (with loads of excess feature such as MC-Post-sharpening, MC-antialiasing, deblock, edgeclean and much more)
| [[YV12]]
| [[MCTemporalDenoise|Script]]
| {{Author/LaTo}}
|-
| [http://avisynth.org.ru/docs/english/externalfilters/mipsmooth.htm MipSmooth]
| MipSmooth is a reinvention of [[SmoothHiQ]] and [[Convolution3D]]. MipSmooth was made to enable smoothing of larger pixel areas than 3x3(x3), to remove blocks and smoothing out low-frequency noise. See [http://forum.doom9.org/showthread.php?t=64940 discussion.]
| [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/mipsmooth_5F25_dll_20051223.zip Plugin]
| {{author/Sh0dan}}
|-
| [http://avisynth.org.ru/docs/english/externalfilters/nomosmooth.htm NoMoSmooth]
| NoMoSmooth temporally denoises relatively static areas and a spatially denoises moving parts. In addition to this motion-based approach, NoMoSmooth employs another technique to try to retain as much existing detail as possible: only pixels that are "fluctuating" are smoothed. See [http://forum.doom9.org/showthread.php?t=37471 discussion.]
| [[YUY2]]
| [http://www.avisynth.nl/users/warpenterprises/files/nomosmooth_5F25_dll_200309015.zip Plugin]
| SansGrip
|-
| [http://avisynth.org.ru/docs/english/externalfilters/peachsmoother.htm PeachSmoother]
| PeachSmoother was designed to cope with the oddities of analog broadcast TV.
| [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/peachsmoother_5F25_dll_20030801.zip Plugin]
| {{Author/Lindsey Dubb}}
|-
| RemoveDirtMC
| See [http://forum.doom9.org/showthread.php?p=1485300#post1485300 discussion].
| [[YV12]]
| [https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/RemoveDirtMC_SE.avsi Script]
| Nephilis/A.SONY
|-
| [[RemoveGrain]]
| RemoveGrain is a plugin package containing various plugins for spatial and temporal denoising, repairing, sharpening, deinterlacing, and other utility functions.
| [[YV12]], [[YUY2]]
| [[RemoveGrain|Plugin]]
| {{Author/kassandro}}
|-
| [[RemoveGrainHD]]
| RemoveGrainHD is like RemoveGrain but intended for high definition content. It includes various spatial and temporal functions. See [http://web.archive.org/web/20130412014246/http://www.removegrainhd.de.tf/ documentation.]
| [[YV12]], [[YUY2]]
| [[RemoveGrainHD|Plugin]]
| {{Author/kassandro}}
|-
|-
| RemoveNoiseMC
| Motion compensated filter for removing noise, larger spots and other dirt. Written as an alternative to the old Dust. Last update Nov 2006. It uses mvtools v1. Jenyok collected together all RemoveNoise and various filters functions and adapted to MVTools v2.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=110078 Script]
| Heini011
|-
| [[RgTools]]
| Modern rewrite of <tt>[[RgTools/RemoveGrain|RemoveGrain]]</tt>, <tt>[[RgTools/Repair|Repair]]</tt>, <tt>[[RgTools/BackwardClense|BackwardClense]]</tt>, <tt>[[RgTools/Clense|Clense]]</tt>, <tt>[[RgTools/ForwardClense|ForwardClense]]</tt> and <tt>[[RgTools/VerticalCleaner| VerticalCleaner]]</tt> all in a single plugin.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[RgTools|Plugin]]
| {{Author/tp7}}, {{Author/pinterf}}
|-
|[[SMDegrain]]
|SMDegrain is a convenience function for using MDegrain, including 16bit and interlaced support, with extra capabilities for light sharpening and spatial filtering.
| [[YUY2]], [[YV12]]
|[[SMDegrain|Script]]
|{{Author/Dogway}}
|-
|[[STMedianFilter]]
|STMedianFilter is a (slightly motion compensated) spatial/temporal median filter. It fairly very fine grained, using only adjacent pixels in space and time, so it looks at the adjacent 26 locations to filter each location.
|[[YUY2]], [[YV12]]
|[http://web.archive.org/web/20130207143129/http://neuron2.net/trbarry/STMedianFilter.zip Plugin]
|{{Author/Tom Barry}}, {{Author/Fizick}}
|-
|[[STPresso]]
|A fast script to make SD/720p content compress better without losing detail and original grain structure.
|[[YV12]]
|[[STPresso|Script]]
|{{Author/Didée}}
|-
| zzz_denoise
| Simple wrapper around a combination of dfttest and MDegrain3. Requires the [[External_filters#Deepcolor_Filters|Dither]] package.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?p=1390594#post1390594 Script]
| {{Author/cretindesalpes}}
|}

== Adjustment Filters ==

=== Averaging/Layering/Masking ===

{{FilterTable}}
| [[Average]]
| A simple plugin that calculates weighted frame-by-frame average from multiple clips.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[Average|Plugin]]
| {{Author/tp7}}, {{Author/mg262}}
|-
|[[AviSynthGimpLayer]]
|AviSynth Gimp-style Layer merge plugin.
|[[RGB24]], [[RGB32]]
|[[AviSynthGimpLayer|Plugin]]
| [http://sourceforge.net/u/panzerboy66/profile/ panzerboy66]
|-
|[[AVS_SoftLight]]
|AviSynth+ plugin. It makes a softlight blend with a negative of average. Only x64 version available and with CUDA support.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[AVS_SoftLight|Plugin]]
|Argaricolm
|-
| BlockAverage
| A simple filter that just averages the Y values of each 2x2 pixel block in a YV12 image – U and V values are left alone as they already common to each 2x2 block in a progressive YV12 image. Just made to see if it satisfies the requirements in [http://forum.doom9.org/showthread.php?s=&threadid=91580&perpage=10&pagenumber=1 this thread].
| [[YV12]]
| [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/blockaverage01.zip Plugin]
| {{Author/Simon Walters}}
|-
|CheckMask
|A YV12 spatial dot finding filter for AviSynth.
|[[YV12]]
|[http://www.avisynth.nl/users/warpenterprises/files/checkmask_5F25_dll_20050310.zip Plugin]
|[http://web.archive.org/web/20090618112048/http://kawaii-shoujo.net/AntiAliased/index.html Dan Donovan]
|-
|[[ClipBlend]]
|Filter to blend consecutive frames in a clip.
|[[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[[ClipBlend|Plugin]]
|StainlessS
|-
|[[ColorScreenMask]]
|ColorScreenMask is a special effects plugin for processing chroma key (i.e., a green screen or blue screen) backgrounds. It uses color thresholds rather than absolute values as the criteria for setting the alpha channel transparency.
|[[RGB32]]
|[[ColorScreenMask|Plugin]]
|Grandpa Oddball
|-
|[[ColourMask]]
|Creates colour masks.
|[[YV12]]
|[[ColourMask|Plugin]]
|{{Author/mg262}}
|-
|[[CombMask]]
|A filter to create and process comb masks. These filters were written from scratch, but most of logic comes from tritical's [[TIVTC]] plugin.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[CombMask|Plugin]]
|{{Author/Chikuzen}}
|-
|[[Fusion]]
|Pyramidal image processing for video, it uses image pyramids to blend clips together (more commonly used in the creation of HDR images and image stitching).
|[[RGB32]]
|[[Fusion|Plugin]]
|{{Author/David Horman}}
|-
| [[GraMaMa]]
| Gradient Mask Maker: Creates a mask (either a gradient or black/white) given a prescribed shape (such as circle, ellipse, line, square or rectangle).
| [[YV12]]
| [[GraMaMa|Plugin]]
| {{author/E-Male}},
{{author/Wilbert Dijkhof}}
|-
|[http://umezawa.dyndns.info/archive/imck/imck-2.3.0-readme.html ImasMultiColorKeying]
|Chroma keying filter (Japanese)
|[[RGB32]]
|[http://umezawa.dyndns.info/archive/imck/ Plugin]
|Umezawa Takeshi
|-
|MaskCrop
|Non-clip plugin and function to speed up filtering with a mask.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://www.dropbox.com/s/8c4rxlwbs020ib1/MaskCrop0.1.2.7z?dl=1 Plugin] 
|
|-
|[http://forum.videohelp.com/threads/369143-ResizersPack-MasksPack-PlaygroundPack-SmoothContrast-Logo-mod-functions?s=7811fcf9c429ffb99f2e0a4b8043832d&p=2364052&viewfull=1#post2364052 MasksPack]
|This is a set of functions related to masks, so localized filtering will be able, giving you finer control on how and where to filter or protect certain zones.
|[[YV12]]
|[http://www.mediafire.com/download/mch99c0z5957u9z/MasksPack2.3.zip Script]
|{{Author/Dogway}}
|-
|[[Median]]
|A filter plugin for AviSynth which generates a pixel-by-pixel median of several clips. This is particularly useful for filtering out noise and glitches from multiple VHS/SVHS/8mm/Hi8 tape captures, but can be used for other purposes also.
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
|[[Median|Plugin]]
|{{Author/ajk}}
|-
|[[MTCombMask]]
|This filter produces a mask showing areas that are combed, it uses 3-point sampling to determine combing in a pixel.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], 8-16bit planar Y/YUV/YUVA
|[[MTCombMask|Plugin]]
|{{Author/Manao}}, [https://github.com/Asd-g Asd-g]
|-
| ParameterisedBlend
| ParameterisedBlend allows you to blend any number of frames within a clip, or blend any number of different clips together. You can use it as an extended, gamma-aware replacement for Merge().
| [[YV12]]
| [http://sites.google.com/site/ourenthusiasmsasham/soft#TOC-ParameterisedBlend Plugin]
| [http://sites.google.com/site/ourenthusiasmsasham/ PitifulInsect]
|-
|[http://forum.doom9.org/showthread.php?t=172388 Polygon]
|The very raw beginning of a plugin for drawing high quality polygons (mainly to be used as masks) in AviSynth.
| [[RGB32]]
| [http://forum.doom9.org/showthread.php?t=172388 Plugin]
| {{Author/David Horman}}
|-
|[[RedAverage]]
|Frame-by-frame averaging/merging of multiple clips. Includes a masked average, weighted average, and a merge filter.
|[[YV12]]
|[[RedAverage|Plugin]]
|redfordxx
|-
|[http://github.com/jojje/shapemask ShapeMask]
|A filter plugin for AviSynth that identifies bright areas such as projector screens at conferences and creates a mask out of them. The use case for which it was created is to deal with overly bright lectures, such as screen casts or talks where the speaker or producer hasn't followed presentation 101; Use light text on a dark background! See [http://forum.doom9.org/showthread.php?t=172308 discussion.]
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
|[http://web.archive.org/web/20150702103042/http://snarl.zapto.org/files/ShapeMask-1.0.zip Plugin]
|[http://github.com/jojje jojje]
|-
|[[TColorMask]]
|A simple color masking plugin for AviSynth.
| [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[TColorMask|Plugin]]
|{{Author/tp7}}
|-
|[[TCombMask]]
|TCombMask is a simple filter that creates a comb map that can (could) be used by other filters. It currently supports optional motion adaption, optional spatial adaption, optional luma <-> chroma linking, different thresholds for chroma and luma, and much more.
|[[YUY2]], [[YV12]]
|[[TCombMask|Plugin]]
|{{Author/tritical}}
|-
|[[TempLinearApproximate]]
|TempLinearApproximate takes several frames and for each pixel calculates linear approximation of its values through time, then returns its value in the middle (unless close to beginning or end of clip) of that line.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[[TempLinearApproximate|Plugin]]
|Mystery Keeper
|-
|[[TMaskCleaner]]
|A really simple mask cleaning plugin for AviSynth based on mt_hysteresis.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[TMaskCleaner|Plugin]]
|{{Author/tp7}}
|-
| [[TMM]]
| TMM builds a motion-mask for TDeint, which TDeint uses via its 'emask' parameter.
| [[YUY2]], [[YV12]]
| [[TMM|Plugin]]
| {{Author/tritical}}
|-
| [[TMM2]]
| A rewrite of TMM
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[TMM2|Plugin]]
| {{Author/Chikuzen}}
|-
| [[Unpremultiply]]
| This plugin convert the input RGBA clip from premultiplied alpha to straight matted alpha.
| [[RGB32]]
| [[Unpremultiply|Plugin]]
| [http://web.archive.org/web/20160610124858/http://code.google.com/p/avisynth-unpremultiply/ Josh Sutinen]
|-
| [[uu_mt_blend]]
| ''Blend'' (''[[Overlay]], [[Layer]]'') two clips using [[MaskTools2|MaskTools]]. Wide selection of blend modes.
| [[YV12]],[[RGB24]],[[RGB32]]
| [[Media:UU_mt_blend.avs|Script]]
| rafriff42
|-
|[[Watermark2]]
|Creates a transparent deformation in the video akin to a watermark. The watermark is defined by a black and white image which may be a dynamic image. The intensity of the effect is controlled by several parameters.
|[[RGB32]]
|[[Watermark2|Plugin]]
|[http://sourceforge.net/u/phillvanleersum/profile/ DrPhill], {{Author/StainlessS}}
|-
| [[YRangeMask]]
| AviSynth script to create a mask by specifying the range of the brightness.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[YRangeMask|Script]]
| Chikuzen
|}

=== Blurring ===

{{FilterTable}}
|[https://www.animemusicvideos.org/forum/viewtopic.php?t=101724 BlurMod/ApplyOnAngle]
|BlurMod() shrinks, blurs, then resizes; resulting in a very strong blur. ApplyonAngle() rotates, filters, then rotates back; making any filter appear as if applied on an angle.
|[[YV12]]
|Script
|Phantasmagoriat
|-
| [[BucketMedian]]
| BucketMedian is an implementation of spatial median filter adapting bucket (counting) sort algorithm.
| [[Y8]], [[YV411]], [[YV12]], [[YV16]], [[YV24]]
| [[BucketMedian|Plugin]]
| {{Author/Chikuzen}}
|-
| [[FastBlur]]
| Fast approximate Gaussian blurs.
| [[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[FastBlur|Plugin]]
| {{Author/David Horman}}
|-
| [[GBlur]]
| Gaussian blur.
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[GBlur|Plugin]]
| {{Author/vcmohan}}
|-
|[[MedianBlur]]
| A plugin with 5 different types of median blur filters.
| [[YV12]]
| [[MedianBlur|Plugin]]
| {{Author/tsp}}
|-
|[[MedianBlur2]]
| Implementation of [http://nomis80.org/ctmf.html constant time median filter] for AviSynth 2.6, similar to MedianBlur.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[MedianBlur2|Plugin]]
| {{Author/tp7}}
|-
| [[VariableBlur]]
| VariableBlur is a Gaussian, binomial or average blur filter with a variable radius (variance).
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]],
| [[VariableBlur|Plugin]]
| {{Author/tsp}}, {{Author/tritical}}
|-
| [[VariableMedian]]
| A simple median filter. See [http://forum.doom9.org/showthread.php?t=83985 discussion]
| [[RGB32]]
| [http://web.archive.org/web/20091027134543if_/http://www.geocities.com/siwalters_uk/variablemedian.zip Plugin]
| {{Author/Simon Walters}}
|}

=== Borders and Cropping ===

{{FilterTable}}
|[[BorderControl]]
| It's designed to allow you to manipulate the regions at the top, bottom and sides of a frame. Set a black border, set a border region to be faded out and you can "smear" the border to save having to crop and resize the whole frame for the sake of a few pixels. Each border (top,bottom.left and right) can be manipulated independently. See [http://forum.doom9.org/showthread.php?t=33479 discussion] and [http://avisynth.org.ru/docs/english/externalfilters/bordercontrol.htm documentation].
| [[YUY2]], [[YV12]]
|[http://web.archive.org/web/20140709005736/http://www.geocities.com/siwalters_uk/bordercontrol14.zip Plugin]
|{{Author/Simon Walters}}
|-
|[[EdgeFixer]]
|EdgeFixer repairs bright and dark line artifacts near the border of an image.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[[EdgeFixer]]
|[https://github.com/sekrit-twc sekrit-twc]
|-
|[[FillBorders]]
|This is a simple filter that fills the borders of a clip, without changing the clip's dimensions.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[[FillBorders]]
|[http://github.com/dubhater dubhater] / Asd
|-
|[[FillMargins]]
|FillMargins is a simple AviSynth filter that fills the four margins of a video clip with the outer pixels of the unfilled portion. It takes integer 4 parameters specifying the size of the left, top, right, and bottom margins. These may be any value and do not have to be any particular multiple. See discussion [http://forum.doom9.org/showthread.php?t=50132 here] and [http://forum.doom9.org/showthread.php?t=55881 here], additional [http://avisynth.org.ru/docs/english/externalfilters/fillmargins.htm documentation]
|[[YV12]]
|[http://web.archive.org/web/20130207143129/http://neuron2.net/trbarry/FillMargins.zip Plugin]
|{{Author/Tom Barry}}
|-
| Padding
| Duplicate edge pixels to the outside with [[PointResize]]. See [http://forum.doom9.org/showthread.php?t=165946 discussion.]
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV16]], [[YV24]], [[YV411]]
| [http://forum.doom9.org/showpost.php?p=1596804&postcount=5 Script]
| {{Author/Didée}}
|-
|[[AutoCrop]]
|Automatically crops black borders ([http://en.wikipedia.org/wiki/Letterbox wikipedia:Letterbox], [http://en.wikipedia.org/wiki/Pillar_box_%28film%29 wikipedia:Pillar box], [http://en.wikipedia.org/wiki/Windowbox_%28film%29 wikipedia:Windowbox]) from a clip. Operates in preview mode (overlays the recommended cropping information) or cropping mode. Can also ensure width and height are multiples of specified numbers. See original [http://forum.doom9.org/showthread.php?t=37204 discussion] and updated AutoCrop [http://forum.doom9.org/showthread.php?t=87602 discussion]
| [[YUY2]], [[YV12]]
| [http://len0x.leffe.dnsalias.com/autocrop12.zip Plugin]
| [http://web.archive.org/web/20050404182221/http://www.videofringe.com/autocrop/ Glenn Bussell], len0x
|-
|[https://github.com/slavanap/ssifSource CropDetect]
| Plugin to detect black bounding box in video and crop it easily. See [http://forum.doom9.org/showthread.php?p=1761842#post1761842 discussion]. Note, CropDetect small plugin merged within ssifSource project. Look for "CropDetect" function in Sub3D.dll
|[[RGB32]]
|[https://github.com/slavanap/ssifSource/releases plugin]
|[http://github.com/slavanap slavanap]
|-
|[[RoboCrop]]
| RoboCrop is an automatic cropping solution to crop black borders from video clips, loosely based on (but using no code from) AutoCrop by Glenn Bussell. See [http://forum.doom9.org/showthread.php?t=168053 discussion.]
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV16]], [[YV24]], [[YV411]]
| [http://www.mediafire.com/file/krdo0aye4dlvpit/RoboCrop_25%2626_dll_v1-10_20160825.zip Plugin]
| StainlessS
|}

=== Colourspace Conversion ===

{{FilterTable}}
| [{{N2Moved}}/autoyuy2/autoyuy2.html AutoYUY2]
| This filter is correctly converts YV12 to YUY2 without color bias.
| [[YV12]]
| Plugin
| {{Author/Donald Graft}}
|-
|[http://forum.doom9.org/showthread.php?t=171786 Cnv2]
| Universal [[Convert|ConvertTo...()]] wrapper with some additional features. Requires [http://forum.doom9.org/showthread.php?t=147846 GScript]
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://forum.doom9.org/showthread.php?t=171786 Script]
| martin53
|-
| ConvertToYCgCo
| Converts to the YCgCo colorspace. See [http://forum.doom9.org/showthread.php?t=161736 discussion.]
| [[RGB24]], [[RGB32]]
| [http://forum.doom9.org/attachment.php?attachmentid=12748&d=1331769022 Plugin]
| xv
|-
| InterleavedConversions
| Tools for interleaving and de-interleaving 2, 3, and 4-channel data.
|
| Script
| PitifulInsect
|-
| ManualColorMatrix
| Can perform any matrix-based color conversion. See [http://forum.doom9.org/showthread.php?t=161777 discussion.]
| [[RGB24]], [[RGB32]], [[YV24]]
| [http://forum.doom9.org/attachment.php?attachmentid=12346&d=1309522614 Plugin]
| xv
|-
|[[nnedi3_resize16]]
|An advanced script for high quality 16-bit image resizing and colorspace conversion.
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[http://avisynth.nl/index.php/Nnedi3_resize16 Script]
|mawen1250
|-
|[[PlanarTools]]
|This plugin is a set of filters that offers converting packed(interleaved) formats to planar formats and vice versa.
|[[RGB24]], [[RGB32]], [[YUY2]], [[YV16]]
|[[PlanarTools|Plugin]]
|{{Author/Chikuzen}}
|-
| YUY2inRGB
| A quick filter that stuffs YUY2 into RGB24. See [http://forum.doom9.org/showthread.php?p=639948#post639948 discussion.]
| [[YUY2]]
| [http://trevlac.us/YUY2inRGB.zip Plugin]
| {{Author/Trevlac}}
|-
| YUY2toRGB219
| Converts YUY2 to studioRGB. With this kind of conversion, luma will not change, meaning no quantization error on luma. See [http://forum.doom9.org/showthread.php?p=639432#post639432 discussion.]
| [[YUY2]]
| [http://trevlac.us/colorCorrection/YUY2toRGB219.zip Plugin]
| {{Author/Trevlac}}
|-
|[[YV12To422]]
|YV12 to YV16/YUY2 converter for AviSynth 2.6.
|[[YV12]]
|[[YV12To422|Plugin]]
|{{Author/Chikuzen}}
|}

=== Effects ===

{{FilterTable}}
| [[AddGrainC]]
| Generates film like grain or other effects (like rain) by adding random noise to clip. Noise can be horizontally or vertically correlated causing streaking. Contains AddGrain & AddGrainC
| [[RGB24]], [[RGB32]], [[YUY2]],
[[Y8]], [[YV411]], [[YV12]], [[YV16]], [[YV24]]
| [[AddGrainC|Plugin]]
|{{Author/Tom Barry}}, {{Author/Foxyshadis}}<br>
{{Author/LaTo}}, {{Author/cretindesalpes}}
|-
| AddStaticGrainM
| This function adds static grain in dark areas based on a mask.
| [[YV12]]
| [[AddStaticGrainM_source|Script]]
| [http://canihaziframe.wordpress.com/2011/02/23/addstaticgrainm/ Daiz]
|-
| [http://kvcd.net/sansgrip/avisynth/Blockbuster-readme.html AddNoise/Blockbuster]
| Makes encoder allocate more bits to darker areas, thus eliminating DCT blocks by decreasing the clips compressibility.
|
| [http://www.avisynth.nl/users/warpenterprises/files/blockbuster_5F25_src_20021229.zip Plugin]
| Ross Thomas
|-
| [http://forum.doom9.org/showthread.php?t=87295 AviShader]
| generic plugin that uses your 3D card's hardware to assist with rendering
| [[RGB32]]
| [http://www.avisynth.nl/users/warpenterprises/files/avishader_5F25_dll_20041228.zip Plugin]
| Antitorgo
|-
| [[ColorLooks]]
| This plugin is based on Trev's VDub filter Colorlooks and Donald Graft's Colorize (well it works a bit similar). I also added some new stuff. The plugin contains the following filters: Technicolor, Colorize, Sepia and Posterize.
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [[ColorLooks|Plugin]]
| {{author/Wilbert Dijkhof}}
|-
| [http://forum.doom9.org/showthread.php?t=170732 crt_display]
| CRT emulation with scanline and phosphor effects. crt_display emulates a CRT display using aperture grille (Trinitron) or Cromaclear technologies. See [http://forum.doom9.org/showthread.php?t=170732 discussion.]
| [[RGB24]], [[RGB32]]
| [http://forum.doom9.org/showthread.php?t=170732 Script]
|{{Author/cretindesalpes}}
|-
| [[EffectsMany]]
| Creates 34 types of special "animated" effects. Effects act on the input clip in the range of the frame numbers specified. The Audio is not affected.
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[EffectsMany|Plugin]]
| {{Author/vcmohan}}
|-
| [[EffectsPlus]]
| '''AviSynth+ only'''. Creates 26 types of special "animated" effects. Effects act on the input clip in the range of the frame numbers specified. The Audio is not affected.
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[HBD]] colorspaces
| [[EffectsPlus|Plugin]]
| {{Author/vcmohan}}
|-
| [[f3kgrain]]
| Another 8/16-bit luma adaptive grain generator.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [http://web.archive.org/web/20131111114900/http://www.nmm-hd.org/upload/get~ElhZlazJbsQ/f3kgrain_v0.4.avsi Script]
| {{Author/06_taro}}
|-
|[[Fingerprint]]
|Video fingerprint filter.
|[[RGB32]]
|[[Fingerprint|Plugin]]
|{{Author/David Horman}}
|-
| [[GNoise]]
| Adds random noise to a clip. See [http://forum.doom9.org/showthread.php?p=841700#post841700 duscussion.]
| [[YV12]]
| [http://web.archive.org/web/20080905123941/http://soulhunter.chronocrossdev.com/data/gnoise_r5.zip Plugin]
| {{Author/mf}}
|-
| [[GrainFactory3]]
| Noise generator that tries to simulate the behavior of silver grain on film. See [http://forum.doom9.org/showthread.php?t=141303 discussion.]
| [[YV12]]
| [[GrainFactory3|Script]]
| {{Author/Didée}}
|-
| [[GrainFactory3mod]]
| Luma adaptive grain generating filter in 8-bit precision. Based on Didée's [[GrainFactory3]] script.
| [[YV12]]
| [http://web.archive.org/web/20140722190952/http://www.nmm-hd.org/upload/get~kvNvGpuyxfc/GrainFactory3mod_v1.2.avsi Script]
| {{Author/06_taro}}
|-
| [[GrainFactoryLite]]
| Luma adaptive grain generating filter with stacked 16-bit input/output support. Based on Didée's [[GrainFactory3]] script, processing in 16-bit precision, and some commonly unused parameters removed.
| [[YV12]]
| [http://web.archive.org/web/20140722185917/http://www.nmm-hd.org/upload/get~FaqsQaMom9s/GrainFactoryLite_v1.2.avsi Script]
| {{Author/06_taro}}
|-
| [http://www.avisynth.nl/users/vcmohan/HollywoodSq/HollywoodSq.html HollywoodSQ]
| Creates popup album, akin to Hollywood squares TV show
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [http://avisynth.nl/users/vcmohan/HollywoodSq/HollywoodSq.html Plugin]
| {{Author/vcmohan}}
|-
| KenBurnsEffect
| Given clip, zooms, pans & rotates clip. See [http://en.wikipedia.org/wiki/Ken_Burns_Effect wikipedia:Ken Burns Effect]
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [http://forum.doom9.org/showthread.php?t=135776 Script]
| mikeytown2
|-
| [[MPlayerNoise]]
| Noise Generator ported from MPlayer. See [http://forum.doom9.org/showthread.php?t=84181 discussion.]
| [[YV12]]
| [http://avisynth.nl/users/warpenterprises/files/bergfiltercollection_5F25_dll_20041019.zip Plugin]
| {{Author/bergi}}
|-
| [[NoiseGenerator]]
| Newer function based off of Blockbuster. Adds random noise to clip.
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [http://www.avisynth.nl/users/warpenterprises/files/noisegenerator_5F25_dll_20050616.zip Plugin]
| Shubin
|-
| [[Scanlines]]
| Add Scanlines (black horizontal bars) to a video. see [http://en.wikipedia.org/wiki/Scan_line wikipedia:Scan Line]
| [[YV12]]
| [http://avisynth.nl/users/warpenterprises/files/scanlines_5F25_dll_20031103.zip Plugin]
| turulo
|-
|[[ShufflessS]]
|Shuffle spacial columns or rows (1D), or blocks(2D) of frames, or temporal shuffle (frame order), all shuffles Inversable, ie undoable.
|[[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], [[HBD]] formats in AviSynth+
|[[ShufflessS|Plugin]]
|{{Author/StainlessS}}
|-
| [[StaticNoiseC]]
| Generates static grain using the Mersenne Twister random number generator. See [http://www.nmm-hd.org/newbbs/viewtopic.php?f=8&t=118&start=20#p772 discussion.]
| [[YV12]]
| [http://web.archive.org/web/20131228160225/http://www.nmm-hd.org/upload/get~YnWFecZw0Uo/StaticNoiseC20110108b.zip Plugin]
| histamine
|-
|[https://github.com/sorayuki/TawawaFilter TawawaFilter]
|An AviSynth plugin to make video in blue color.
|[[RGB24]]
|[https://github.com/sorayuki/TawawaFilter/releases/ Plugin]
|[https://github.com/sorayuki sorayuki]
|-
| [[TurnsTile]]
| Applies mosaic and/or palette effects to a clip.
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [[TurnsTile|Plugin]]
| {{Author/Robert Martens}}
|}

=== Field Order ===

{{FilterTable}}
| PFR
| Tries to restore the original progressive field order of a movie (or any predominantly filmed material transferred to video) where the field order changes at scene changes in a seemingly random fashion! See [http://forum.doom9.org/showthread.php?t=49815 discussion.]
| [[YV12]], [[YUY2]]
| [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/pfravs.html Plugin]
| {{Author/Simon Walters}}
|-
| ReverseFieldDominance
| This filter is intended to reverse the field dominance of [[PAL]] DV video. See [http://forum.doom9.org/showthread.php?t=46765 discussion.]
| [[YUY2]], [[RGB24]], [[RGB32]]
| [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/reversefielddominance.html Plugin]
| {{Author/Simon Walters}}
|}

=== Frame Rate Conversion ===

{{FilterTable}}
| [[AlterFPS]]
| AlterFPS can be used to speed up or slow down a video by adding or removing fields. It works like the 3:2 pulldown of NTSC film material, except you can choose your new speed. It can also blend frames for progressive frame results, and blend fields like ConvertFPS.
| Any
| Script
| actionman133
|-
| [[convert60ito24p]]
| convert60ito24p converts a 60fps interlaced NTSC Video into a 24fps progressive Video using different blending techniques.
| [[RGB32]], [[RGB24]], [[YUY2]]
| Script
| scharfis_brain
|-
|[[FixFPS]]
|Fix the frames to a more consistent pattern with the help of Matroska Version 2 Timecodes. Mostly useful for fixing weird framerate from using a third party program to capture (ex. .kkapture with Mupen). Generally used with the plugin ExactDedup. It should be noted that FixFPS would try it's best not to lose any frames from the source. It does this by pushing frames to the next available spot, if possible, but it can cause side effects. See [http://tasvideos.org/forum/viewtopic.php?t=18914 discussion].
|Any
|[https://www.mediafire.com/?7bip52hu7v1pps2 Plugin]
|Aktan
|-
| [http://github.com/arkeet/fpsdown/blob/master/README.md FPSDown]
| This filter reduces the framerate of a video by 1/2, by blending odd and even frames together. However, it does this in a smart way such that in case of duplicate frames, it will do the smart thing to remove unnecessary blurring in the output video.
| [[RGB32]]
| [http://github.com/arkeet/fpsdown/blob/master/README.md Plugin]
| [http://github.com/arkeet/ arkeet]
|-
| [[FrameDbl]]
| FrameDbl will generate extra frames to double the frame rate. It does this using a motion compensated approach to interpolating between frames. See [http://forum.doom9.org/showthread.php?t=56036 discussion.]
| [[YV12]]
| [{{N2Archived}}/trbarry/FrameDbl.zip Plugin]
| {{Author/Tom Barry}}
|-
| [[FrameRateConverter]]
| FrameRateConverter uses motion interpolation with fine artifact removal.
| [[YV24]], [[YV16]], [[YV12]], [[Y8]]
| [[FrameRateConverter|Plugin]]
| [https://github.com/mysteryx93 MysteryX]
|-
| [http://www.spirton.com/uploads/InterFrame/InterFrame2.html InterFrame]
| Frame rate conversion script. Interframe works very well at converting 24FPS to 60FPS; converts videos to higher frame rates like newer TVs do. Common names are frame doubling, smooth motion, among others. See [http://forum.doom9.org/showthread.php?t=160226 discussion.]
| [[YV12]]
| [http://forum.doom9.org/showpost.php?p=1486831&postcount=1 Script]
|{{Author/SubJunk}}
|-
|[http://www.compression.ru/video/frame_rate_conversion/index_en_msu.html MSU_FRC]
|The filter is intended for video frame rate up-conversion. It increases the frame rate integer times. It allows, for example, to convert a video with 15 fps into a video with 30 fps.
|[[YV12]]
|[http://www.compression.ru/video/frame_rate_conversion/src/msu_frc.zip Plugin]
|Dmitriy Vatolin, et al.
|-
| Motion
| Fast true-motion motion-compensation functions for AviSynth. [http://forum.doom9.org/showthread.php?t=101859 Discussion], [http://web.archive.org/web/20060103143553/http://people.pwf.cam.ac.uk/mg262/posts/Motion/motion.html Documentation]
| [[YV12]]
| [http://wilbertdijkhof.com/mg262/Motion_v10.zip plugin]
| mg262
|-
| NTSC tools
| Automatic [[NTSC]] to [[PAL]] conversion with 24p, 30p, 60i detection. See [http://forum.doom9.org/showthread.php?t=114054 discussion].
| [[YV12]]
| [http://avisynth.nl/images/NTSC_tools.avsi Script]
| Mug Funky
|-
| [[SalFPS3]]
| A modded version of MotionProtectedFPS for extra protection.
| [[YV12]]
| [http://avisynth.nl/images/SalFPS3.avs Script]
| Mug Funky, {{Author/Didée}}
|-
| [[SickJumps]]
| Speed ramping, aka time-remapping (smooth speed changes). Processes both video and audio.
| [[RGB]], [[YUV]]
| [[SickJumps|Plugin]]
| {{Author/Robert Martens}}
|-
| [[SVPflow]]
| SVPflow provides fast and high quality GPU accelerated frame rate interpolation.
| [[YV12]]
| [[SVPflow|Plugin]]
| [http://www.svp-team.com/wiki/Credits SVP Team]
|-
| [http://github.com/gnaggnoyil/tc2cfr tc2cfr]
| This plugin that can read a timecode file and convert a given video clip in to one with a constant framerate by adding duplicate frames. Note: only supports Matroska V1 timecodes.
| [[YV12]]
| [http://github.com/gnaggnoyil/tc2cfr/releases Plugin]
| [http://github.com/gnaggnoyil gnaggnoyil]
|-
| [[TimecodeFPS]]
| Converts clip from VFR to CFR. Timing information from clip is discarded, and matroska v2 timecodes from the timecodes file are used instead.
| Any
| [[TimecodeFPS|C-Plugin]]
| natt
|-
| [[VFRtoCFR]]
| Converts a variable frame rate (VFR) video to a constant frame rate (CFR) video with the help of Matroska Version 2 Timecodes.
| [[YV12]]
| [[VFRtoCFR|Plugin]]
| Aktan
|-
| [[VfrToCfr]]
| This plugin converts variable frame rate clips to constant frame rate by introducing null frames.
| [[YV12]]
| [[VfrToCfr|Plugin]]
| joyje
|-
|[[YFRC]]
| Yushko Frame Rate Converter - doubles the frame rate with strong artifact detection and scene change detection.
|[[YV12]]
|[http://avisynth.nl/images/YFRC-01dd-10mm-2015yyyy.avsi Script]
| Oleg Yushko
|}

=== Frame Replacement/Range Processing ===

{{FilterTable}}
|[[ApplyEvery]]
|A collection of AviSynth functions that operate at regular intervals in a clip.
|
|[[ApplyEvery|Plugin]]
|{{Author/stickboy}}
|-
|[http://www.avisynth.nl/users/fizick/badframes/badframes.html BadFrames]
|Replaces given bad frames by neighbors or blend (interpolation). Useful for frames with very large defects.
|
|[http://www.avisynth.nl/users/fizick/badframes/badframes20.zip Plugin]
|{{Author/Fizick}}
|-
|[[ClipClop]]
|Clipclop is a simple plugin to replace ranges in a source clip with the same range, from a replacement clip. Supports up to 255 replacement clips, with unlimited number of replacements into output clip.
|
|[[ClipClop|Plugin]]
|StainlessS
|-
|[[FrameRepeat]]
|FrameRepeat() is a simple plugin to select frames to repeat. Requires AviSynth 2.6.
|
|[[FrameRepeat|Plugin]]
|StainlessS
|-
|[[FrameSel|FrameSel/FrameRep]]
|FrameSel() is a simple plugin to select individual frames from a clip. Can select frames numbers by direct arguments to filter, or in a string, or in a command file.
|
|[[FrameSel|Plugin]]
|StainlessS
|-
|[http://forum.doom9.org/showthread.php?t=164766 MatchFrames/LocateFrames]
|MatchFrames, intended for matched frames extraction,LocateFrames, intended to be usable by other scripts to identify matches.
|
|[http://www.mediafire.com/folder/hb26mthbjz7z6/StainlessS Script]
|StainlessS
|-
|[[RemapFrames]]
|A collection of functions to rearrange frames between clips. Remaps the frame indices in a clip or from a second clip as specified by an input text file or by an input string. Efficient alternatives to long chains of <tt>FreezeFrame, DeleteFrame, or ApplyRange</tt>.
|
|[[RemapFrames|Plugin]]
|{{Author/stickboy}}, {{Author/cretindesalpes}}
|-
|[[Prune]]
|Prune is a simple plugin to trim() multiple source clips and splice the results into a new clip. Supports up to 256 source clips, with unlimited number of trims/splices into output clip. Prune can fade Audio (to reduce clicks between splices) for supported audio formats. The plugin will do [[AlignedSplice]] only.
|
|[[Prune|Plugin]]
|StainlessS
|}

=== Levels and Chroma ===

{{FilterTable}}
| [[AutoAdjust]]
| A high quality automatic adjustement filter. It calculates statistics of clip, averages them temporally to stabilize data and uses them to adjust luminance gain & color balance.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[AutoAdjust|Plugin]]
| {{Author/LaTo}}
|-
|[http://forum.doom9.org/showthread.php?t=173208#post1757661 AutoContrast]
|Auto contrast adjustment.
|[[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[http://forum.doom9.org/showthread.php?t=173208#post1757661 Script]
|{{Author/StainlessS}}
|-
| [[Autolevels]]
| Improvement of the [[ColorYUV]] filter's autogain feature. It stretches the luma histogram to use the entire specified range, averaging the amount of "gain" over consecutive frames to better handle flashes and to avoid flickering.
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[Autolevels|Plugin]]
| {{Author/frustum}} & Theodor Anschütz & StainlessS
|-
|[[AVSCube]]
|[[AviSynth+]] plugin to load and apply .cube [http://en.wikipedia.org/wiki/3D_lookup_table 3D LUTs].
|[[Avisynthplus_color_formats|RGBP16]]
|[[AVSCube|Plugin]]
|{{Author/Donald Graft}}
|-
| [http://forum.doom9.org/showthread.php?t=16806 AWB]
| Automatic white balance for real world footage, similar to the known function in digital cameras.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=168062 Script]
| martin53
|-
| [[ChanMix]]
| Creates a grayscale image from an RGB24 source, it has 3 parameters to specify how much of each color-channel is used.
| [[RGB24]]
| [[ChanMix|Plugin]]
| E-Male
|-
| [[ChannelMixer]]
| Very similar to the ChannelMixer function found in Photoshop. 9 Adjustments are possible, 3 for each color channel.
| [[RGB24]], [[RGB32]]
| [[ChannelMixer|Plugin]]
| Gustaf Ullberg
|-
| [https://forum.doom9.org/showthread.php?t=173364 ChromaJig]
| Automatic Colorization.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?p=1775733#post1775733 Script]
| MWilson
|-
| [[ColorBalance]]
| Same tool that is found in Gimp & Cinepaint.
| [[RGB24]], [[RGB32]]
| [[ColorBalance|Plugin]]
| Gavino & mikeytown2
|-
|[[ColorLooks]]
| The plugin contains the following filters: Technicolor, Colorize, Sepia and Posterize.
|[[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
|[[ColorLooks|Plugin]]
|{{Author/Wilbert Dijkhof}}
|-
|[[ColorYUV2]]
|YUV color adjustment plugin with a graffer.
|[[YV12]]
|[[ColorYUV2|Plugin]]
|{{Author/StainlessS}}
|-
| [[ColourLike]]
| Makes a clip look like a 'reference' clip by adjusting each colour mask.
| [[RGB32]], [[YV12]]
| [[ColourLike|Plugin]]
| {{Author/mg262}}
|-
| [[ColourWarp]]
| Smooth remapping of UV colour values using control points for colour correction.
| [[YV12]], [[YV16]], [[YV24]]
| [[ColourWarp|Plugin]]
| {{Author/David Horman}}
|-
|[[DGHDRtoSDR]]
|[[AviSynth+]] plugin to convert UHD BluRay HDR10 to SDR. (GPU accelerated - CUDA)
|[[Avisynthplus_color_formats|YUV420P16]]
|[[DGHDRtoSDR|Plugin]]
|{{Author/Donald Graft}}
|-
|[[DGPQtoHLG]]
|[[AviSynth+]] plugin to convert UHD BluRay HDR10 PQ to HDR10 HLG. GPU accelerated - CUDA)
|[[Avisynthplus_color_formats|YUV420P16]]
|[[DGPQtoHLG|Plugin]]
|{{Author/Donald Graft}}
|-
|[[DGTonemap]]
|[[AviSynth+]] plugin for basic Reinhard tonemapping for HDR->SDR.
|[[Avisynthplus_color_formats|RGBPS]]
|[[DGTonemap|Plugin]]
|{{Author/Donald Graft}}
|-
| [[ExpLabo]]
| ExpLabo is a multi-filters plugin, focused on the non-linear transformation of image color space.
| [[RGB24]], [[RGB32]]
| [[ExpLabo|Plugin]]
| brabbudu
|-
|[https://web.archive.org/web/20180916224719/http://mpierce.pie2k.com/pages/211.php Exposure]
|Exposure function for AviSynth.
|[[RGB24]]
|[https://web.archive.org/web/20171023011558if_/http://mpierce.pie2k.com/downloads/exposure.zip Plugin]
|Matt Pierce
|-
| [[FlimsYlevels]]
| Luma adjustment function to give a more "film-ish" look. (Based on {{Author/Didée}}'s [[Ylevels]]).
| [[YV12]]
| Script
| FlimsyFeet
|-
|[[GamMac]]
|Useful to correct color cast on old 8mm films.
|[[RGB32]], [[RGB24]]
|[[GamMac|Plugin]]
|{{Author/StainlessS}}
|-
|[[GamMatch]]
|Gamma Matcher; useful to correct bad color clip where there is a better color source of perhaps lower rez available.
|[[RGB32]], [[RGB24]]
|[[GamMatch|Plugin]]
|{{Author/StainlessS}}
|-
| [[GiCocu]]
| Use GIMP/Photoshop curve files.
| [[RGB24]], [[RGB32]]
| [[GiCocu|Plugin]]
| E-Male
|-
|[[GradationCurve]]
|[[AviSynth+]] plugin that loads Photoshop ACV and GIMP crv curve files. Also can compute the gradation curve through given anchor points. Like what Photoshop and Gimp do in the Curves setting.
|[[Avisynthplus_color_formats|PlanarRGB, PlanarYUV]]
|[[GradationCurve|Plugin+Script]]
|ErazorTT
|-
|[http://forum.doom9.org/showthread.php?t=167027#post1629321 Gray_Balance]
|A gray balance script, which is based on Black/White/Gray balance picker.
|[[RGB24]], [[YUY2]], [[YV12]]
|[http://forum.doom9.org/showthread.php?t=167027#post1629321 Script]
|Kisa_AG
|-
| [[HDRAGC]]
| High Dynamic Range Automatic Gain Control - Increase dynamic range of video clips (enhance shadows). It's "simply" gaining (brightening) dark areas of image without causing blow of highlights. Amount of gain is calculated automatically, but can be influenced by parameters.
| [[YUY2]], [[YV12]]
| [[HDRAGC|Plugin]]
| {{Author/paviko}}
|-
|[[HDRTools]]
|HDR color conversion plugin for AviSynth+.
|[[RGB32]], [[RGB64]], Planar YUV/RGB (8-16 and 32bit)
|[[HDRTools|Plugin]]
|[https://github.com/jpsdr jpsdr]
|-
| [http://forum.doom9.org/showthread.php?t=161986 HighlightLimiter]
| "Darkening highlight". Works well on over exposed clips. It can also be combined with ContrastMask to create HDR effect
| [[YV12]]
| [http://forum.doom9.org/showthread.php?p=1522100#post1522100 Script]
| javlak
|-
| [[HistogramAdjust]]
| Adjusts the histogram of a frame by either equalizing it or by matching with histogram of another image, or with given histogram table of values.
| [[YV12]], [[YUY2]]
| [[HistogramAdjust|Plugin]]
| {{Author/vcmohan}}
|-
| [[Histograms in RGB & CMY]]
| Similar to Histogram("levels") but for RGB and CMY instead of YUV. It also includes a RGB parade color scope.
| [[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[Histograms in RGB & CMY|Script]]
| -Vit-
|-
|[https://github.com/magiblot/HSLTint HSLTint]
|An [[AviSynth+]] filter for creating monochromatic tints with user-defined hue and saturation.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]] - all bit-depths
|[https://github.com/magiblot/HSLTint/blob/master/HSLTint.avsi Script]
|magiblot
|-
|[[HSVAdjust]]
|HSVAdjust/HSLAdjust/HSIAdjust let's you rotate hues, control the strength of color (saturation), or modify the brightness of a clip. The type of brightness depends on the filter. It's value for HSVAdjust, lightness for HSLAdjust or intensity for HSIAdjust.
|[[RGB24]], [[RGB32]]
|[[HSVAdjust|Plugin]]
|{{Author/Wilbert Dijkhof}}
|-
|[[Hue]]
|This plugin is a port of Donald Graft's VirtualDub [http://rationalqm.us/hue.html Hue] filter.
|[[RGB24]], [[RGB32]]
|[[Hue|Plugin]]
|{{Author/Wilbert Dijkhof}}
|-
|[https://forum.doom9.org/showthread.php?t=176091 LinearTransformation]
|This script performs Linear Transformations based on a matrix conversion. Matrices are made by Francesco Bucciantini (FranceBB).
|[[YV12]], [[YV16]], [[YV24]], [[RGB24]], [[RGB32]], [[RGB32]], [[RGB48]],[[RGBPS]]
|[https://github.com/FranceBB/LinearTransformation Linear Transformation]
|[https://forum.doom9.org/member.php?u=219051 FranceBB]
|-
|[[MatchHistogram]]
| Tries to modify the histogram of the input clip to match that of a reference clip. Should be used for analysis only, not for production.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[MatchHistogram|Plugin]]
| {{Author/LaTo}}
|-
| [[OutRange]]
| A simple function to scan the whole video and output a log file, in which out-of-tv-range frames are logged.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[OutRange|Script]]
| 06_taro
|-
|[[RGBAdapt]]
|Another RGB color correction plugin, it also also includes a graffer.
|[[RGB24]], [[RGB32]]
|[[RGBAdapt|Plugin]]
|{{Author/StainlessS}}
|-
|[[RgbAmplifier]]
|An AviSynth forensic plugin to amplify color shifts.
|[[RGB24]], [[RGB32]]
|[[RgbAmplifier|Plugin]]
|{{Author/StainlessS}}
|-
| [https://forum.doom9.org/showthread.php?t=181857 SafeColorLimiter]
| Automatic Clipping to get a broadcast safe output in Limited TV Range.
| [[Y8]], [[Y10]], [[Y12]], [[Y14]], [[Y16]], [[Y32]], [[YV12]], [[YV411]], [[YUY2]], [[YV16]], [[YV24]]
| [https://github.com/FranceBB/SafeColorLimiter Script]
| [http://forum.doom9.org/member.php?u=219051 FranceBB]
|-
|[[SelectiveColour]]
|AviSynth implementation of Photoshop's selective colour adjustment.
|[[RGB32]]
|[[SelectiveColour|Plugin]]
|{{Author/David Horman}}
|-
| [[SGradation]]
| SGradation is much like a gamma function, but '2nd order'.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| Script
| martin53
|-
|[[ShowChannels]]
|Simple plugin whose only function is to display the average Y,U and V values for a YUV frame or R,G, and B for an RGB frame. Also shows accumulated average for all frames visited so far.
|[[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[ShowChannels|Plugin]]
|{{Author/StainlessS}}
|-
| [[ShowOverRange]]
| Shows illegal "TV range" by painting pixels blue for anything less than 16 and red for anything greater than 235.
| [[YUY2]], [[YV12]]
| [[ShowOverRange|Plugin]]
| {{Author/SAPikachu}}
|-
| [[SmoothAdjust]]
| SmoothAdjust is a set of 5 plugins to make YUV adjustments. These 5 plugins have a smoothing & dithering algorithm to avoid banding issue. SmoothAdjust is [[SmoothLevels|SmoothLevels']] successor.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[SmoothAdjust|Plugin]]
| {{Author/LaTo}}
|-
| [[Tint]]
| Tints the image toward a specified colour.
| [[YUY2]], [[YV12]]
| Script
| actionman133
|-
| [[TweakColor]]
| Target specific hue and saturation ranges for hue and saturation adjustments.
| [[YV12]], [[YUY2]]
| [[TweakColor|Plugin]]
| {{Author/Trevlac}}
|-
| [[VideoScope]]
| Similar to Histogram("classic") but with additional features, it shows waveform monitors and a vectorscope.
| [[YUY2]]
| [[VideoScope|Plugin]]
| {{Author/Randy French}}
|-
| [http://forum.doom9.org/showthread.php?p=1832763#post1832763 VideoTek]
| VideoTek is a Tektronix-like waveform monitor for AviSynth.
| [[YV12]], [[YV16]], [[YV24]]
| [https://github.com/FranceBB/VideoTek/blob/master/VideoTek.avsi Script]
| [http://forum.doom9.org/member.php?u=219051 FranceBB]
|-
| [[WhiteBalance]]
| Correct the white balance of a clip with a large degree of control and accuracy over other methods of correcting white balance.
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [[WhiteBalance|Plugin]]
| SomeJoe
|-
| [[Ylevels]]
| A simple replacement for Avisynth's internal [[Levels]] command, with a few neat differences.
| [[YV12]]
| Script
| {{Author/Didée}}
|}

=== Line Darkening ===

{{FilterTable}}
| FastLineDarkenMOD
| Line darkening script. See original [http://forum.doom9.org/showthread.php?t=82125 discussion.] Updated [http://forum.doom9.org/showthread.php?p=1060081#post1060081 script.] Additional [http://forum.doom9.org/showthread.php?p=1023638#post1023638 information.]
| [[YV12]]
| [http://forum.doom9.org/showthread.php?p=1060081#post1060081 Script]
| Vectrangle / {{Author/Didée}}
|-
|[[Hysteria]]
|Hysteria, a line darkening script by Scintilla.
|[[YV12]]
|[http://pastebin.com/raw/fvDdiV6m Script]
|Scintilla
|-
|[http://forum.doom9.org/showpost.php?p=993939&postcount=2 LineDarkenToon]
| LineDarkenToon use the idea of mf_toon (0.5) for linedarken. I wanted a really small fast code like FastLineDarken but with similar output like mf_toon and this is the result.
|[[YV12]]
| [http://forum.doom9.org/showpost.php?p=993939&postcount=2 Script]
| MOmonster
|-
| [[mfToon]]
| mfToon darkens cartoon edges. In default operation, it performs line darkening, Xsharpening, and warp sharpening.
See [http://forum.doom9.org/showthread.php?t=53364 discussion.] Additional information [http://forum.doom9.org/showthread.php?t=125128 here] and [http://forum.doom9.org/showthread.php?t=52066 here]
| [[YV12]]
| [http://web.archive.org/web/20090212071718/http://mf.creations.nl/avs/functions/mfToon-v0.52.avs Script]
| {{Author/mf}}
|-
|[[proToon]]
|Line darkening script, used to be known as vmToon and before that mfToon.
|[[YV12]]
|[http://pastebin.com/raw/Aw9En26L Script]
|TheProfileth
|-
| [[SuperToon]]
| An attempt to optimize/speed up the previous versions of mfToon, vmToon, etc. See [http://forum.doom9.org/showthread.php?t=163987 discussion]
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=163987 Script]
| Hadien
|-
| [[Toon]]
| Simple and fast line darkener.
| [[YV12]]
| [http://dl.dropbox.com/s/guk5plphkthdy2f/Toon-v1.1.7z Plugin]
| {{Author/mf}}
|-
| [[ToonLite]]
| It's the same as [[Toon]], just without the warpsharp processing..
| [[YV12]]
| [http://web.archive.org/web/20090218093135/http://mf.creations.nl/avs/filters/Toon-v1.0-lite.dll Plugin]
| {{Author/mf}}
|-
| [[vmToon]]
| The successor to mfToon. Darkens lines, thins lines, and does supersampled sharpening all in one, but slow.
| [[YV12]]
| [http://avisynth.nl/images/Vmtoon-v0.74.avsi Script]
| Vectrangle
|}

=== Resizers ===

{{FilterTable}}
|[https://forum.doom9.org/showthread.php?t=181665 AiUpscale]
|An AviSynth+ implementation of some Super-Resolution Convolutional Neural Networks.
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[Avisynthplus_color_formats|plus HBD formats in AVS+]]
|[https://github.com/Alexkral/AviSynthAiUpscale Script]
|[https://github.com/Alexkral Alexkral]
|-
|[[Anime4KCPP]]
|Anime4K is a simple high-quality anime upscale algorithm with GPU acceleration support. [[AviSynth+]] x64 only.
|[[RGB24]], [[YV24]], [[YV16]], [[YV12]]
|[[Anime4KCPP|Plugin]]
|TianZerL
|-
| [[avsresize]]
| [http://github.com/sekrit-twc/zimg z.lib] resizers for [[AviSynth+]]. avsresize provides resizing, colorspace and bit depth conversation.
| [[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], [[Avisynthplus_color_formats|plus HBD formats in AVS+]]
| [[avsresize|Plugin]]
| [http://github.com/sekrit-twc sekrit-twc]
|-
| [[AreaResize]]
| An area-average resizer plugin; only use to downscale.
| [[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[AreaResize|Plugin]]
| {{Author/Chikuzen}}, Aktanusa
|-
| [[Debicubic]]
| This filter is designed to reverse the effects of bicubic upsampling.
| [[RGB24]], [[RGB32]], [[YV12]]
| [http://web.archive.org/web/20140622040033/http://rgb.chromashift.org/debicubic%20r2.zip Plugin]
| Prunedtree
|-
| [[Debilinear]]
| This filter is designed to reverse the effects of bilinear upsampling.
| [[RGB24]], [[RGB32]], [[YV12]]
| [http://web.archive.org/web/20140214021604/http://rgb.chromashift.org/debilinear%20r6.zip Plugin]
| Prunedtree
|-
|[https://gist.github.com/kgrabs/b042214d715176ac9ab563c188995457 Desample]
|Desampling functions for AviSynth+, replaces DebilinearM and lineart_rpow2. Also includes DeCrossConversionMT which is a replacement for ccc, ccc_720.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[Avisynthplus_color_formats|plus HBD formats in AVS+]]
|[https://gist.github.com/kgrabs/b042214d715176ac9ab563c188995457 Script]
|[https://github.com/kgrabs kgrabs]
|-
|[http://forum.doom9.org/showthread.php?p=1738351#post1738351 edi_rpow2]
|An improved rpow2 function for nnedi3, nnedi3ocl, eedi3, and eedi2. Requires [http://www.mediafire.com/download/lcbtb7uta4ta5pc/ResizeX_v1.0.avsi ResizeX]
|[[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[http://www.mediafire.com/view/pcmkxaauku375xd/edi_rpow2_v1.0.avsi Script]
|Desbreko
|-
|[[FCBI]]
|Fast Curvature Based Interpolation.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[[FCBI|Plugin]]
|{{Author/Chikuzen}}
|-
| [[JincResize]]
| Jinc (EWA Lanczos) Resampler Plugin for AviSynth/AviSynth+.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[JincResize|Plugin]]
| innocenat
|-
| Lanczosplusv3
| Very slow, but high quality resizer. See [http://forum.doom9.org/showthread.php?t=136690]
|
| Script
| *.mp4 guy
|-
|[[nnedi3/nnedi3_rpow2|nnedi3_rpow2]]
| Enlarge images by the powers of 2 using Neural Network New-Edge Directed Interpolation ; nnedi3_rpow2 is a function included in [[nnedi3]].
|[[RGB24]], [[YUY2]], [[YV12]]
|[[nnedi3|Plugin]]
|{{Author/tritical}}
|-
|[[nnedi3ocl/nnedi3x_rpow2|nnedi3x_rpow2]]
| Enlarge images by the powers of 2 using Neural Network New-Edge Directed Interpolation ; nnedi3x_rpow2 is a script function included in [[nnedi3ocl]].
|[[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[nnedi3ocl|Script and Plugin]]
|SeT
|-
|[[nnedi3_resize16]]
|An advanced script for high quality image resizing and colorspace conversion.
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[http://avisynth.nl/index.php/Nnedi3_resize16 Script]
|mawen1250
|-
| [[PointSize]]
| A set of [http://en.wikipedia.org/wiki/Image_scaling pixel art resizers]; Includes Scale2x/3x, LQ2x/3x/4x, HQ2x/3x/4x, xBRZ (2x to 6x).
| [[RGB32]]
| [[PointSize|Plugin]]
| `Orum
|-
| [[ResampleHQ]]
| ResampleHQ provides gamma-aware resizing and colorspace conversion.
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [[ResampleHQ|Plugin]]
| Cory Nelson
|-
|[[ResampleMT]]
|Internaly multi-threaded resampling functions, also includes desampling functions (DeBilinear, DeBicubic,...).
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[Avisynthplus_color_formats|plus HBD formats in AVS+]]
|[[ResampleMT|Plugin]]
|[http://github.com/jpsdr jpsdr]
|-
|[[Resize8]]
|<tt>Resize8()</tt> works just like AviSynth's internal resizers but with some extra features. It had correct chroma placement, optional adaptive anti-ringing algorithm and few other features.
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[http://web.archive.org/web/20150911013350/http://www.nmm-hd.org/upload/get~8y1IjaaqvoI/Resize8_v1.2.avsi Script]
|mawen1250
|-
|ResizeX
|ResizeX is a wrapper function for AviSynth's internal resizers and Dither_resize16 that corrects for the chroma shift caused by the internal resizers when they're used on horizontally subsampled chroma with MPEG2 placement.
|[[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[http://www.mediafire.com/download/lcbtb7uta4ta5pc/ResizeX_v1.0.avsi Script]
|Desbreko
|-
| [http://forum.doom9.org/showthread.php?t=135735 Seamer]
| Seam Carving/Liquid Rescale for Content-Aware Image Resizing. See [http://en.wikipedia.org/wiki/Seam_carving wikipedia:Seam Carving]
| [[RGB24]], [[RGB32]]
| [http://avisynth.nl/users/vcmohan/Seamer/Seamer.html Plugin]
| {{Author/vcmohan}}
|-
|SincResize
|SincResize is an experimental plugin that uses DCT to perform resizing. See [http://forum.doom9.org/showthread.php?p=953002#post953002 discussion], read on for more information.
|[[YV12]]
|[http://cafxx.strayorange.com/files/SincResize4.7z Plugin]
|[http://cafxx.strayorange.com/ CAFxX]
|-
| [[SimpleResize]]
| Resizing plugin with 4 filters: SimpleResize, WarpResize, InterlacedResize and InterlacedWarpedResize.
| [[YV12]], [[YUY2]]
| [[SimpleResize|Plugin]]
| {{Author/Tom Barry}}
|-
| [http://forum.doom9.org/showthread.php?t=147117 SplineResize]
| SplineResize contains two kinds of spline based resizers: The first ones are the (cubic) spline based resizers from Panorama tools: Spline100Resize (using 10 sample points) and Spline144Resize (using 12 sample points) are examples. Other ones are available in AviSynth itself. The second ones are natural cubic splines that use the kernel itself as a spline.
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [http://www.wilbertdijkhof.com/SplineResize_v02.zip Plugin]
| {{Author/Wilbert Dijkhof}}
|-
|[http://forum.doom9.org/showthread.php?t=175945 Unwiden/Widen]
|Resize filters to unwiden/widen, see discussion.
|[[RGB32]], [[YV24]]
|[http://forum.doom9.org/showthread.php?t=175945 Plugin]
|{{Author/David Horman}}
|-
|[http://github.com/sunnyone/Waifu2xAvisynth waifu2x]
|Single-Image Super-Resolution for anime/fan-art using Deep Convolutional Neural Networks.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[http://github.com/sunnyone/Waifu2xAvisynth/releases Plugin]
|[http://github.com/sunnyone sunnyone]
|-
| [http://forum.doom9.org/showthread.php?p=1111789#post1111789 ZoomBox]
| Replacement for ResizeKAR. Resizes clip Keeping the Aspect Ratio. Can set Source/Target PAR/DAR, option to zoom in/out in order to hide/show black borders.
|
| Script
| mikeytown2
|}

=== Sharpeners ===

{{FilterTable}}
| [[aSharp]]
| Simple unsharp mask filter with optional adaptive sharpening.
| [[YV12]]
| [[aSharp|Plugin]]
| {{Author/Marc FD}}
|-
|[[AVSShock]]
|This Shock Filter sharpens edges of images by applying erosions or dilations depending on the sign of the Laplacian (or the so called Haralick-Canny edge detector).
|[[YUY2]], [[YV12]]
|[[AVSShock|C-Plugin]]
|AMSS0815
|-
| [[aWarpSharp2]]
| A modern rewrite of aWarpSharp with several bugfixes and optimizations.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], all planar Y, YUV formats, 8 to 16-bit
| [[aWarpSharp2|Plugin]]
| {{Author/SEt}}
|-
| [[blah]]
| Sharpening. See [http://forum.doom9.org/showthread.php?t=155030 discussion.]
| [[YV12]]
| [http://forum.doom9.org/showpost.php?p=1406843 Script]
| *.mp4 guy
|-
|[[CAS]]
|Contrast Adaptive Sharpening.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], all planar Y, YUV(A), RGB(A) formats, 8 to 32-bit
|[[CAS|Plugin]]
|Asd-g
|-
| [[FineSharp]]
| Small and relatively fast realtime-sharpening function, designed for 1080p, or after scaling 720p -> 1080p during playback (to make 720p look more being like 1080p). See [http://forum.doom9.org/showthread.php?p=1569035#post1569035 discussion].
| [[YV12]]
| [http://forum.doom9.org/showthread.php?p=1569035#post1569035 Script]
| {{Author/Didée}}
|-
| [[LimitedSharpen]]
| LimitedSharpen can be used like a traditional sharpener, but producing much less artifacts. It can be used as a replacement for the common "resize(x4)-XSharpen-resize(x1)" combo, with very similar results (perhaps even better) - but at least 2 times faster, since it requires much less oversampling.
| [[YV12]]
| [http://avisynth.nl/images/LimitedSharpenFaster.avsi Script]
| {{Author/Didée}}
|-
| [[LSFmod]]
| A LimitedSharpenFaster mod with a lot of new features and optimizations.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=142706 Script]
| {{Author/LaTo}}
|-
|[http://forum.doom9.org/showthread.php?t=173515 MCLS_16]
|Motion Compensate Limited Sharpen 16bit
|[[YV12]]
|[http://forum.doom9.org/showthread.php?t=173515 Script]
|Motenai Yoda
|-
|[http://forum.doom9.org/showthread.php?t=153201 MedSharp]
|Soft thresholded median sharpening function. See [http://forum.doom9.org/showthread.php?t=153201 discussion].
|[[YV12]]
|[http://forum.doom9.org/showthread.php?t=153201 Script]
|*.mp4 guy
|-
| [[MSharpen]]
| <tt>MSharpen</tt> is a very simple masked sharpening plugin for AviSynth. This version is a reimplementation of neuron2's old <tt>MSharpen</tt> plugin.
| [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[MSharpen|Plugin]]
| {{Author/tp7}}
|-
| [[NonlinUSM]]
| Non-linear Unsharp Masking.
| [[YV12]]
| [http://forum.doom9.org/showpost.php?p=1555234&postcount=46 Script]
| {{Author/Didée}}
|-
| [[pSharpen]]
| Performs two-point sharpening to avoid overshoot. See [http://forum.doom9.org/showthread.php?t=172422 discussion].
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=172422#post1732663 Script]
| ilpippo80, colours
|-
|[[ReCon]]
|'''ReCon'''volution - makes things sharp by mixing pixels together. See [http://forum.doom9.org/showthread.php?t=153201 discussion].
|[[YV12]]
|[http://forum.doom9.org/showthread.php?p=1409582#post1409582 Script]
|*.mp4 guy
|-
| [[SeeSaw]]
| SeeSaw uses a balance of denoising and sharpening to enhance a clip. The aim is to enhance weak detail without over-sharpening or creating jaggies on strong detail, and produce a result that is temporally stable without detail shimmering.
| [[YV12]]
| [http://avisynth.nl/images/SeeSaw.avs Script]
| {{Author/Didée}}
|-
| SharpenComplex2
| Port of MPC-HC's Sharpen Complex 2 to AviSynth. Despite the name, this script is very simple, see [http://forum.doom9.org/showthread.php?t=158385 discussion.]
| [[YV12]]
| [[SharpenComplex2_source|Script]]
|
|-
| SSXSharpen
| Included in SharpTools. Sharpens the picture using [[supersampling]] techniques.
| [[YV12]]
| [http://web.archive.org/web/20100120201434/http://mf.creations.nl/avs/functions/SharpTools-v0.3.avs Script]
| {{Author/mf}}, {{Author/Didée}}
|-
| [[SSSharp]]
| Also known as Super Slow Sharpen - a very slow, but high quality sharpener. See [http://forum.doom9.org/showthread.php?t=132330 discussion]
| [[YV12]]
| [http://forum.doom9.org/showpost.php?p=1071731 Script]
| *.mp4 guy
|-
| [[TUnsharp]]
| TUnsharp is a basic sharpening filter that uses a couple different variations of unsharp masking and allows for controlled sharpening based on edge magnitude and min/max neighborhood value clipping.
| [[YUY2]], [[YV12]]
| [[TUnsharp|Plugin]]
| {{Author/tritical}}
|-
| [[UnFilter]]
| This filter softens/sharpens a clip. It implements horizontal and vertical filters designed to (slightly) reverse previous efforts at softening or edge enhancement that are common (but ugly) in DVD mastering.
| [[YUY2]], [[YV12]]
| [[UnFilter|Plugin]]
| {{Author/Tom Barry}}
|-
| [[UnsharpHQ]]
| A strong and fast unsharp mask with some new features.
| [[YV12]]
| [[UnsharpHQ|Plugin]]
| list
|-
|[[vsMSharpen]]
|vsMSharpen is a sharpener that tries to sharpen only edges. This plugin is a port of the VapourSynth plugin MSharpen.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], all planar Y, YUV, and RGB formats, 8 to 16 bit
|[[vsMSharpen|Plugin]]
|Dubhater, Asd-g
|-
| [[WarpSharp]]
| WarpSharp contains these sharpeners: <tt>UnsharpMask, WarpSharp, Xsharpen</tt>.
| [[YUY2]], [[YV12]]
| [[WarpSharp|Plugin]]
|???, {{Author/seraphy}}
|}

=== Rotation/Shear/Skew/Perspective ===

{{FilterTable}}
| [[DeBarrel]]
| Remove barrel and pincushion distortion, where straight lines appear curved.
| [[RGB24]], [[RGB32]], [[Y8]]
| [[DeBarrel|Plugin]]
| {{Author/vcmohan}}
|-
|[[Defish]]
|Barrel and pincushion distortion correction filter.
|[[RGB32]]
|[[Defish|Plugin]]
|{{Author/David Horman}}
|-
|[http://forum.doom9.org/showthread.php?t=171922 Defish Different Projections]
|Defish with different map projections, like Lambert Cylindrical Equal Area, Mercator and Miller projections.
|[[RGB32]]
|[http://forum.doom9.org/showthread.php?t=171922 Script]
|Kisa_AG
|-
| [[FTurn]]
| Fast implementation of [[TurnLeft]](), [[TurnRight]]() and [[Turn180]]() AviSynth functions.
| [[Y8]], [[YV12]],[[YV24]]
| [[FTurn|Plugin]]
| {{Author/tp7}}
|-
|[http://forum.doom9.org/showthread.php?t=165978 Quad]
|An Avisynth plugin to perform quadrilateral transformations. Quad is now superseded by [[warp]].
|[[RGB32]]
|[http://horman.net/quad.zip Plugin] -- [http://forum.doom9.org/showpost.php?p=1602709&postcount=22 no SSE]
|{{Author/David Horman}}
|-
| [[Reform]]
| Skewed images are corrected or vice versa, useful if video is recorded with slightly incorrectly located camera. Sometimes referred to as perspective correction.
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
| [[Reform|Plugin]]
| {{Author/vcmohan}}
|-
| [[Reformer]]
| Perspective correction and warping.
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[Reformer|Plugin]]
| {{Author/vcmohan}}
|-
| [[Rotate]]
| Rotate or shear on any given angle.
| [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[Rotate|Plugin]]
| {{Author/Fizick}}
|-
| [http://www.avisynth.nl/users/vcmohan/Spinner/Spinner.html Spinner]
| Spinner plugin rotates a frame or selected part of it about the given axis coordinates in floating point precision.
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [http://www.avisynth.nl/users/vcmohan/Spinner/Spinner_2_6.zip Plugin]
| {{Author/vcmohan}}
|-
|[[warp]]
|A collection of geometry correction filters (also includes new version of Quad).
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
|[[warp|Plugin]]
|{{Author/David Horman}}
|-
|[[xyremap]]
|xyremap is a filter for remapping pixels using formulae written in [http://en.wikipedia.org/wiki/Reverse_Polish_notation reverse Polish notation].
|[[RGB32]]
|[[xyremap|Plugin]]
|{{Author/David Horman}}
|-
| [[Zoom]]
| Zoom, Pan & Rotate Clip. Adds alpha layer to clip.
| [[RGB32]]
| [[Zoom|Plugin]]
| {{Author/WarpEnterprises}}
|}

=== Subtitling ===

{{FilterTable}}
| [[AssRender]]
| Libass-based subtitle renderer.
| [[RGB32]], [[RGB24]], [[YV24]], [[YV12]], [[Y8]]
| [[AssRender|C-Plugin]]
| lachs0r, TheFluff
|-
|[[FreeSub]]
|Subtitle with bdf fonts.
|[[RGB24]], [[RGB32]], [[YV24]]
|[[FreeSub|C-Plugin]]
|Natt
|-
|[https://github.com/slavanap/ssifSource sub3d]
|Plugin for rendering subtitles on 3D video with correct depth.
|[[RGB32]]
|[https://github.com/slavanap/ssifSource/tree/master/Sub3D Sources] [https://github.com/slavanap/ssifSource/releases Binaries][http://forum.doom9.org/showthread.php?t=173143 Discussion]
|slavanap
|-
| [[SubtitleEx]]
| Similar to the original [[Subtitle]] function but can do more: apply text to range; effects - bold, underline, italic, center, fading, motion, blur, emboss, etc...; alpha channel.
| [[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[SubtitleEx|Plugin]]
|[http://web.archive.org/web/20070821222318/http://mvideo.ddpp.net/eng/index.htm basilik]
|-
|[http://forum.doom9.org/showthread.php?t=119390 SUPtext]
|Overlays SUP-subtitles on a video clip.
|[[RGB32]], [[YV12]]
|[http://forum.doom9.org/attachment.php?attachmentid=7846&d=1196858433 Plugin]
|emmel
|-
| [[SupTitle]]
| Blu-ray PGS .SUP Subtitle Renderer Plugin for AviSynth. See [http://forum.doom9.org/showthread.php?t=148167 discussion]
| [[YV12]]
| [[SupTitle|Plugin]]
| {{Author/ZachSaw}}
|-
| [http://avisynth.org.ru/docs/english/externalfilters/vsfilter.htm VSFilter]
| Supported Subtitle Formats: VOBsub (.sub/.idx), SubStation Alpha/Advanced SubStation Alpha (.ssa/.ass), SubRip (.srt), MicroDVD (.sub), SAMI (.smi), PowerDivX (.psb), Universal Subtitle Format (.usf), Structured Subtitle Format (.ssf). See [http://en.wikipedia.org/wiki/VSFilter]
|
| [http://sourceforge.net/project/showfiles.php?group_id=205650&package_id=246121&release_id=541232 Plugin]
|
|-
| [[VSFilterMod]]
| VSFilterMod is modification of original VSFilter subtitle renderer by Gabest. This mod brings up new features and some minor bugfixes.
|[[RGB24]], [[RGB32]], [[YV12]]
| [[VSFilterMod|Plugin]]
|
|-
|[[xy-VSFilter]]
|High performance VSFilter compatible subtitle filters.
|[[RGB24]], [[RGB32]], [[YV12]]
|[[xy-VSFilter|Plugin]]
|
|}

=== Transitions ===

{{FilterTable}}
| DissolveAGG
| Wipe Transition with a soft edge. See [http://forum.doom9.org/showthread.php?t=118016 discussion].
'''Note:''' There exist multiple variants of the script as the result of the interaction between authors in that discussion.
|
| [http://forum.doom9.org/showthread.php?p=900674#post900674 Script (v1)], [http://forum.doom9.org/showthread.php?p=1152440#post1152440 Script (v2)], [http://forum.doom9.org/showthread.php?p=1152632#post1152632 Script (v3)]
| {{Author/zemog}}, {{Author/mikeytown2}}, {{Author/Gavino}} and others
|-
| [http://forum.doom9.org/showthread.php?t=62277 JDL_MaskTransition]
| Combines two clips using the specified mask clip. The audio tracks are blended during the transition. About any transition can be made with this function.
|
| [http://avisynth.nl/users/stickboy/jdl-effects.avsi Script]
| {{Author/stickboy}}
|-
| [[TransAll]]
| Around 150 distinct transitions can be created with this plugin.
| [[RGB]], [[YUY2]], [[YV12]]
| [[TransAll|Plugin]]
| {{Author/vcmohan}}
|-
| [[Transition_AlbertGasset|Transition (Albert Gasset)]]
| Various wipe and random block modes. Has 19 built in patterns or it can use an external file.
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [[Transition_AlbertGasset|C-Plugin]]
| {{Author/Albert Gasset}}
|-
| [[Transition_Shubin|Transition (Shubin)]]
| Contains 2 transition modes: circle and line.
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [[Transition_Shubin|Plugin]]
| {{Author/shubin}}
|}

== Other Filters ==

=== Debugging/Diagnostic Filters ===

{{FilterTable}}
| AVInfo
| AVIInfo gives information about the streams in the clip without loading any frames. filename can be a WAV file or an AVI file with several audio streams (it won't open AVI files with embedded subtitles though). It will return the info as a string.
|
| [http://www.avisynth.nl/users/warpenterprises/files/avinfo_5F25_dll_20050417.zip Plugin]
| trevlac, wilbert
|-
| [http://forum.doom9.org/showthread.php?t=174797 AVSMeter]
| AVSMeter is a CLI (command line interface) tool which measures the speed/efficiency of Avisynth scripts and checks if Avisynth and its plugin sub-system are set up and working correctly. Documentation for usage and features is included in the distribution package.
|
| Command line executable
| Groucho2004
|-
| [http://forum.doom9.org/showthread.php?t=176079 Avisynth Info Tool]
| This program performs a thorough test of your Avisynth installation and associated plugins, checking if external dependencies are installed, etc.
|
| Windows application with graphical user interface
| Groucho2004
|-
|[http://forum.doom9.org/showthread.php?t=173259 avsr]
|CLI (command line interface) tool which simply executes an Avisynth script. This is useful when, for example, you want to write an image sequence to the disk by using "ImageWriter".
|
| Command line executable
| Groucho2004
|-
|[[Butteraugli]]
|Butteraugli is an estimating filter for the psychovisual similarity of two images.
|[[RGBP8]]
|[[Butteraugli|Plugin]]
|{{Author/Asd-g}}
|-
|[[ColorDiff]]
|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.
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
|[[ColorDiff|C-Plugin]]
|Ignus2
|-
| [[DumpPixelValues]]
| Samples the colors from selected pixels for every frame in a video source and outputs the data to a text or binary file. See [http://www.theneitherworld.com/mcpoodle/Tools/DumpPixelValues.html homepage.]
| [[RGB32]], [[YUY2]]
| [http://www.theneitherworld.com/mcpoodle/Tools/DumpPixelValues.zip Plugin]
| [http://www.theneitherworld.com/mcpoodle/Tools/index.html McPoodle]
|-
|[[FFTSpectrum]]
|FFTSpectrum is a filter that displays the FFT frequency spectrum of a given clip.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[FFTSpectrum|Plugin]]
|{{Author/Asd-g}}
|-
|[[GrainEvaluate]]
| A script to analyze and log the strength of grain for each frame. See [http://forum.doom9.org/showthread.php?t=167455 discussion.]
| [[YV12]]
|[http://www.nmm-hd.org/upload/get~-eJfUjEXJY4/GrainEvaluate.avsi Script]
|{{Author/06_taro}}
|-
| [http://forum.doom9.org/showpost.php?p=1462931&postcount=81 Glitch Analyzer]
| Glitch Analyzer generates a diagnostic video, then analyzes the recorded version of it, to detect swapped, dropped, or repeated fields.
| [[YUY2]], [[YV12]]
| [http://forum.doom9.org/showthread.php?p=1467907#post1467907 Script]
| jmac698
|-
| [[Grid]]
| Overlays a grid, useful for pixel counting.
| Any
| [http://www.avisynth.nl/users/vcmohan/Grid/Grid.zip Plugin]
| {{Author/vcmohan}}
|-
|[[Info2]]
| A faster, prettier alternative to info().
|Any
|[[Info2|Plugin]]
|{{Author/David Horman}}
|-
|[[KPassFilterCL]]
|KPassFilterCL is a set of tools in the frequency domain.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[KPassFilterCL|Plugin]]
|[http://github.com/Khanattila Khanattila ]
|-
|[[MaxCLLFind]]
| PQ HDR Analyzer plugin for [[AviSynth+]], analyzes MaxCLL and MaxFALL and writes it to a text file.
|[[RGB64]]
|[[MaxCLLFind|Plugin]]
|Tom Arrow
|-
| [http://web.archive.org/web/20160610124531/http://code.google.com/p/avisynthrestoration/wiki/Measure Measure]
| Measures luminence of greyscale bars and prints results on-screen. Can be used to set brightness/contrast in capture settings accurately.
| [[YV12]]
| [http://web.archive.org/web/20151223052318/https://code.google.com/p/avisynthrestoration/downloads/list Script]
| halifaxgeorge
|-
|[[Pixelscope]]
|This debugging filter displays individual pixel values.
|[[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[http://forum.doom9.org/showthread.php?t=175688 Plugin]
|{{Author/David Horman}}
|-
|[http://github.com/lcferrum/segment-display-ocr SegmentDisplayOCR]
|SegmentDisplayOCR is a seven-segment display recognition filter for AviSynth. It has built in logging functionality (it will log frame recognition results) and also can be used in AviSynth conditional filters. The main purpose of this filter is to process readings of various digital instruments (e.g. digital multimeters) captured on video. So if your favourite instrument lacks interface for connecting it to PC you can capture it's readings on cam and convert them to computer readable format with SegmentDisplayOCR filter.
| [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[http://sourceforge.net/projects/segmentdisplayocr/files/SegmentDisplayOCR/ Plugin]
|[http://github.com/lcferrum lcferrum]
|-
|[[SSIM]]
|A filter that compute an objective video quality metric between two videos. Based on SSIM work from [http://web.archive.org/web/20060515090025/http://www.cns.nyu.edu/~zwang/files/research/ssim/index.html Zhou Wang]. It has been created with the help of Mfa.
|[[YV12]]
|[[SSIM|Plugin]]
|[http://web.archive.org/web/20060507012947/http://perso.wanadoo.fr/reservoir/ Lefungus]
|-
| [[ShowPixelValues]]
| This filter displays the actual Y U and V (or R G and B) values from pixels within a frame. See [http://forum.doom9.org/showthread.php?t=64192 discussion] and [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/showpixelvalues.html homepage.]
| [[RGB32]], [[YUY2]]
| [http://web.archive.org/web/20091028122947/http://geocities.com/siwalters_uk/showpixelvalues1.4c.zip Plugin]
| {{Author/Simon Walters}}
|-
|[https://forum.doom9.org/showthread.php?t=176131 SysInfo]
|This plugin returns info about OS/CPU*/Memory/Screen/AviSynth.
|Any
|[https://forum.doom9.org/showthread.php?t=176131 Plugin]
|Groucho2004
|-
|[https://forum.doom9.org/showthread.php?t=168241 Timer]
|AviSynth script to add a highly customizable timer to your video.
|Any
|[https://forum.doom9.org/showthread.php?t=168241 Script]
|djcj
|-
| [http://web.archive.org/web/20151223052321/http://code.google.com/p/avisynthrestoration/wiki/Testpatterns Testpatterns]
| This filter creates a sinewave frequency sweep directly in YV12, useful to measuring video response.
| [[YV12]]
| [http://web.archive.org/web/20151223052318/https://code.google.com/p/avisynthrestoration/downloads/list Script]
| halifaxgeorge
|-
| [http://avisynth.org.ru/docs/english/externalfilters/tmonitor.htm TMonitor]
| TMonitor is a filter very similar to AVSMon. It enables monitoring of an Avisynth clip via previewing the video, viewing clip information (such as video width, height, colorspace, number of frames, audio samples, sample rate, number of audio channels, and more), and adjusting the audio delay. It also supports multiple instances per script, allowing viewing of differences between different parts of a processing chain.
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TMonitorv094.zip Plugin]
|{{Author/tritical}}
|-
| [http://forum.doom9.org/showthread.php?t=53238 ViewFields/UnViewFields]
| [http://web.archive.org/web/20140709004333/http://www.geocities.com/siwalters_uk/unviewfields.html UnViewFields], [http://web.archive.org/web/20140708181324/http://www.geocities.com/siwalters_uk/viewfields.html ViewFields]
|
| Plugin
| {{Author/Simon Walters}}
|-
|[[VMAF]]
|VMAF is a perceptual video quality assessment algorithm developed by Netflix.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]],<br> 8-16bit planar YUV
|[[VMAF|Plugin]]
|{{Author/Asd-g}}
|-
| [[Comptest]]
| The script Compressibility test can be used for a compressibility test on a clip.
|
| Script
|
|-
| [[SeeTheDifference]]
| SeeTheDifference just makes the difference visible between an encoded and an original videoclip. So you can see what you really "lose" when encoding a video.
|
| Script
|
|}

=== Edge Detection ===

{{FilterTable}}
| [[aWarpsharp2/aSobel|aSobel]]
| Sobel edge dectecion filter included in [[aWarpSharp2]].
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[aWarpSharp2| Plugin]]
| {{Author/SEt}}
|-
|[[MaskTools2/Mt edge| mt_edge]]
| Edge detection filter included in [[MaskTools2]].
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [[MaskTools2|Plugin]]
| {{Author/Manao}}
|-
|[[scharr]]
|Edge detection using the [https://en.wikipedia.org/wiki/Sobel_operator#Alternative_operators Scharr operator].
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[scharr|Script]]
|zorr
|-
| [[tcanny]]
| Contains a canny edge detection filter and distance transform filter.
| [[YUY2]], [[YV12]]
| [http://web.archive.org/web/20140804144614/http://bengal.missouri.edu/~kes25c/tcanny.zip Plugin]
| {{Author/tritical}}
|-
| [[TCannyMod]]
| Canny edge detection filter for Avisynth 2.6. Reimplementation of tcanny. See [http://forum.doom9.org/showthread.php?t=168449 discussion]
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://github.com/chikuzen/TCannyMod/releases/ Plugin]
| {{Author/Chikuzen}}
|-
| [[TEdgeMask]]
| TEdgeMask creates an edge mask based off gradient vector magnitude.
| [[YUY2]], [[YV12]]
| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TEdgeMaskv09.zip Plugin]
| {{Author/tritical}}
|-
| [[TEMmod]]
| TEdgeMask modified for Avisynth 2.6. It creates an edge mask using gradient vector magnitude. See [http://forum.doom9.org/showthread.php?t=168390 discussion]
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://github.com/chikuzen/TEMmod/releases Plugin]
| {{Author/Chikuzen}}
|}

=== Export Filters ===

These filters can write directly to media files.

{{FilterTable}}
| [http://forum.doom9.org/showthread.php?t=135928 Immaavs]
| ImmaWrite uses the ImageMagick libraries to write images. Many formats are supported including animations and multipage files.
|
| [http://www.geocities.com/wilbertdijkhof/ Plugin]
| {{author/Wilbert Dijkhof}}
|-
| [http://forum.doom9.org/showthread.php?t=172837 TWriteAVI]
| Serve AVI file to program requesting it as well as write an avi file. Useful for speeding up 2 pass encodes at the cost of hard drive space. [http://forum.doom9.org/showthread.php?t=172761 Update for AviSynth 2.6]. [http://forum.doom9.org/showthread.php?p=1750415#post1750415 Usage]. [http://forum.doom9.org/showthread.php?p=1073371#post1073371 Old mod by squid_80].
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
| [http://www.mediafire.com/download/84csi0174ettu5l/TWriteAVI_dll_v2.03-20160603.zip Plugin]
| {{Author/tritical}}
|-
| [http://forum.doom9.org/showthread.php?p=1403600 Sashimi]
(function "RawWriter")
| Sashimi writes (and reads) almost any regular raw uncompressed data format you can define. You'll find a fuller description under [[#Source_Filters|Source Filters]].
| [[RGB]], [[YUY2]],[[YV12]]
| [http://sites.google.com/site/ourenthusiasmsasham/soft Plugin with scripts]
| [http://sites.google.com/site/ourenthusiasmsasham/ PitifulInsect]
|-
| [[SoundOut]]
| SoundOut is a GUI driven sound file output module for AviSynth (it exports audio to several compressors).
| All audio.
| [[SoundOut|Plugin]]
| {{Author/Sh0dan}}
|}

=== Import Filters ===

These filters are used to import filters written for other audio and video packages.

{{FilterTable}}
| [http://forum.doom9.org/showthread.php?threadid=92174 FreeFrame]
| Allows [http://freeframe.sourceforge.net/ freeframe] filters (mostly effects) to be used directly in AviSynth.
| [[RGB24]], [[RGB32]]
| [http://www.avisynth.nl/users/warpenterprises/files/freeframe_5F25_dll_20050426.zip Plugin]
| {{Author/Myrsloik}}
|}

=== Meta-Filters ===

These filters are primarily designed to be used with other filters, to restrict or augment their effect.

{{FilterTable}}
|[[AVSTP]]
|A library for multithreaded plug-in development
|Any
|[[AVSTP|Plugin]]
|{{Author/cretindesalpes}}
|-
|[[MP_Pipeline]]
|Run parts of an AviSynth script in external processes.
|Any
|[[MP_Pipeline|Plugin]]
|[http://github.com/SAPikachu/ SAPikachu]
|-
| [[MT]]
| MT is a filter that enables other filters to run multithreaded. This should hopefully speed up processing on hyperthreaded/multicore processors or multiprocessor systems. See [http://forum.doom9.org/showthread.php?t=94996]
| Any
| [http://www.avisynth.nl/users/warpenterprises/files/mt_20070301.zip Plugin]
| tsp
|-
| [[MVTools]]
| MVTools provides filters for estimation and compensation of objects' motion in video clips. Motion compensation may be used for strong temporal denoising, advanced framerate conversions, image restoration and other tasks. See [http://forum.doom9.org/showthread.php?t=131033]
| [[YUY2]], [[YV12]]
| [[MVTools|Plugin]]
| {{Author/Fizick}}
|-
|[http://forum.doom9.org/showthread.php?t=164073 SoraThread]
|Sora's avs multi-process/multi-thread plugin package
|Any
|[http://forum.doom9.org/showthread.php?t=164073 Plugin]
|leiming2006
|-
|[http://forum.doom9.org/showthread.php?t=154886 ThreadRequest]
|Yet another plugin for multithread processing. [http://web.archive.org/web/20130124045626/http://lantis.homeunix.org/avisynth.shtml Archive homepage (Japanese)]
|Any
|[http://www.mediafire.com/download/4xux7d7l1u3toy8/ThreadRequest+102a.rar Plugin]
|lantis
|}

=== Multipurpose Filters ===

{{FilterTable}}
|[http://forum.doom9.org/showthread.php?t=174433 amDCT]
|amDCT() is an adaptive video filter providing deblocking, sharpening, local range expansion, smoothing, and bright noise removal in a single filter that can be used on video of any level of quality. These four operations work synergistically to drastically reduce block artifacts while maintaining detail and increasing local contrast.
|[[YV12]]
|[http://sites.google.com/site/amdctfilter/ Plugin]
|jconklin
|-
|[[AVExtensions]]
|Audio-video extensions is a collection of various AviSynth filters used to modify audio or video.
|[[RGB24]], [[RGB32]]
|[[AVExtensions|Plugin]]
|nutbread
|-
|[[AviSynthShader]]
|This plugin allows running HLSL pixel shaders within AviSynth. This gives access to various HLSL filters that haven't been programmed in AviSynth.
|[[RGB32]], [[YV24]], [[YV12]]
|[[AviSynthShader|Plugin]]
|[http://github.com/mysteryx93 MysteryX]
|-
|[[CLExpr]]
|AviSynth Expr filter implemented in OpenCL for runtime calculation of expressions on 8 and 16-bit depths clips. Makes mt_lutxy and mt_lutxyz possible on 16-bit.
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[CLExpr|Plugin]]
|{{Author/tp7}}
|-
| [http://forum.doom9.org/showthread.php?t=166061 HybridFuPP]
| An adaptive processor, allowing picture cleaning and compressibility gain. Original [http://forum.doom9.org/showthread.php?t=146632 discussion.]
| [[YV12]]
| [http://www.mediafire.com/download/6g09aazs4z7m11a/HybridFuPP_0.992b.zip Script]
| Fupp
|-
| [[MaskTools2]]
| This plugin provides tools for the creation, enhancement and manipulation of masks for each [[YUV]] component.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]
| [[MaskTools2|Plugin]]
| {{Author/Manao}}, {{Author/tp7}}
|-
| [[MVTools]]
| This plugin provides a collection of functions for motion estimation and compensation.
| [[YV12]], [[YUY2]]
| [[MVTools|Plugin]]
| Various
|}

=== Scene Change Detection ===

{{FilterTable}}
|[http://forum.doom9.org/showthread.php?t=171624 DBSC]
|A scene change detection tool set/kit/box (work-in-progress).
|All
|[http://forum.doom9.org/showthread.php?t=171624 Script]
|{{Author/StainlessS}}
|-
| [http://forum.doom9.org/showthread.php?t=145143 EDLmaker]
| Simple scenechange detector that writes to EDL file.
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=145143 Script]
| Mug Funky
|-
| [[MVTools2/MSCDetection|MSCDetection]]
| Part of MVTools2; MSCDetection creates a scene detection mask clip from motion vectors data.
| [[YV12]], [[YUY2]]
| [[MVTools|Plugin]]
| {{Author/Fizick}}
|-
| SCDetect
| Detect scene change and output scene change frames to a file.
| [[YV12]]
| [http://web.archive.org/web/20140614152525/http://www.nmm-hd.org/upload/get~TfPm2QO4jbk/SCDetect_v0.3.rar Script]
| {{Author/06_taro}}
|-
| [http://akuvian.org/src/avisynth/sclavc/readme.txt SceneChangeLavc]
| SClavc is an AviSynth plugin intended to allow access to libavcodec's scene-change metrics. See [http://akuvian.org/src/avisynth/sclavc/ homepage.]
| [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/scenechangelavc_5F25_dll_20041201.zip Plugin]
| {{Author/akupenguin}}
|-
| [[SCXvid]]
| SCXvid produces first pass Xvid logs from AviSynth at the equivalent of the default VFW preset. These logs are primarily intended to get scene change information from but may have other uses.
| [[YV12]]
| [http://dl.dropbox.com/s/402hlckyn669p9n/SCXvid-1.1.rar Plugin]
| {{Author/Myrsloik}}
|-
| [[SCXvidMask]]
| A tiny AviSynth plugin that reads an SCXvid log and creates a binary mask based on it.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://github.com/tp7/SCXvidMask/releases Plugin]
| {{Author/tp7}}
|}

=== Support filters ===

These filters are primarily designed to augment the creation of custom script-based filters.

{{FilterTable}}
| [[ApplyInterlacedFilter]]
| ApplyInterlacedFilter safely processes interlaced video with spatial and temporal filters.
|
| Script
|
|-
|[http://forum.doom9.org/showthread.php?t=162874 ArcFuns]
|This plugin expands the available numerical functions with missing inverse trig functions.
|N/A
|[http://forum.doom9.org/attachment.php?attachmentid=12494&d=1319627190 Plugin]
|{{Author/Gavino}}
|-
|[[AvsFilterNet]]
|The main objective of AvsFilterNet is to provide a wrapper for AviSynth, making it possible to write simple filter in any .Net languages.
|N/A
|[[AvsFilterNet|Plugin]]
|SAPikachu
|-
|[[AvsMotion]]
|AviSynth plugin for animating clips with AAE motion tracking data.
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
|[[AvsMotion|Plugin]]
|{{Author/tp7}}
|-
| [http://forum.doom9.org/showthread.php?t=46506 Call]
| Call an external program from the script.
| N/A
| [http://avisynth.nl/users/warpenterprises/files/call_5F25_dll_20030310.zip Plugin]
| Nic, DDogg
|-
|[[CallCmd]]
|Plugin to execute command on selectable frames or at startup or closedown. Based on [http://forum.doom9.org/showthread.php?t=46506 Call by Nic].
|N/A
|[[CallCmd|Plugin]]
|StainlessS
|-
|[[ClipBoard]]
|Get text from Clipboard.
|N/A
|[[ClipBoard|Plugin]]
|StainlessS
|-
|[[FileSize]]
|Plugin to get filesize.
|N/A
|[[FileSize|Plugin]]
|pureexe
|-
|[https://www.roelofs-coaching.nl/blobs/downloads/ProgramName.html GetProgramName]
|An AviSynth plug-in to retrieve the name of the calling application.
|N/A
|[https://www.roelofs-coaching.nl/blobs/downloads/ProgramName.zip Plugin]
|[http://www.roelofs-coaching.nl/J.M. Roelofs]
|-
|[[GetProgramName2]]
|GetProgramName2 is similar to GetProgramName by JM Roelofs, but this plugin is a newly written.
|N/A
|[[GetProgramName2|Plugin]]
|[https://github.com/enccc enccc]
|-
| GetSystemEnv
| An AviSynth plug-in to retrieve information from the system.
| N/A
| [http://www.avisynth.nl/users/stickboy/GetSystemEnv.zip Plugin]
| {{Author/stickboy}}
|-
| [[GRunT]]
| Extends AviSynth's [[Runtime_environment|Runtime Environment]], making it easier to use, especially inside script functions.
| Any
| [[GRunT|Plugin]]
| {{Author/Gavino}}
|-
| [[GScript]]
| Extends the Avisynth scripting language to provide additional control-flow constructs: multi-line conditionals (if-then-else blocks), 'while' loops and 'for' loops.
| Any
| [[GScript|Plugin]]
| {{Author/Gavino}}
|-
|[[LoadDLL]]
| Used to manually load dll files in AviSynth. Useful if a filter relies on an external dll that is not in the system PATH.
| N/A
| [[LoadDLL|Plugin]]
|{{Author/tsp}}
|-
| [http://forum.doom9.org/showthread.php?t=97748 PlaneMinMax]
| Frame-based YV12 plane Min/Max/Avg functions without [[ConditionalFilter]].
| [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/planeminmax_5F25_dll_20050727.zip Plugin]
| Bart Silverstein
|-
|[http://forum.doom9.org/showthread.php?t=83451 pop]
|A filter to get values from variables that may not yet be initialized.
|Any
|[http://www.tsp.person.dk/pop.zip Plugin] 
|{{Author/tsp}}
|-
| [[RT_Stats]]
| Compile-time/Runtime Functions.
| N/A
| [[RT_Stats|Plugin]]
| StainlessS
|-
|[[StrFmt]]
|Simple plugin to produce formatted string, and additional function to string replace with another string.
|Any
|[[StrFmt|Plugin]]
|StainlessS
|-
|[https://forum.doom9.org/showthread.php?t=174387 StrResolve]
|String Variables Resolving Plugin (for masktools expressions)
|Any
|[http://www.mediafire.com/file/wu6zexhssd0y77i/170310_StrResolve_v050.zip Plugin]
|martin53
|}

=== Deepcolor Filters ===
(also check the [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|High Bit-Depth]] page and the [[:Category:Deep_color_tools|Deep Color Tools]] category)

{{FilterTable}}
| [[Dither_tools|Dither]]
| Generates video with up to 16 bits per component after denoising and dithers back to 8 bits for storage. Primarily written to smooth fine gradients to remove color banding during/after denoising. Can also recover high bitdepth data potentially contained in a noisy clip; dither a high bitdepth picture into a standard YV12; and perform basic operations (masking, curves...) on high bitdepth pictures, as they cannot be manipulated safely with conventional AviSynth filters.
| [[Planar]] colorspaces
| [[Dither_tools|Plugin + scripts]]
| {{Author/cretindesalpes}}
|}

=== 3D Filters ===

{{FilterTable}}
|[https://sourceforge.net/projects/voix/files/2d3/ 2Dto3D]
|2Dto3D is a collection of scripts for 2D to 3D conversion. Conversion is good but not perfect.
|[[YV12]]
|[https://sourceforge.net/projects/voix/files/2d3/ Script]
|[https://sourceforge.net/u/brankoj/profile/ brankoj]
|-
| [http://web.archive.org/web/20110809073332/http://arenafilm.hu/alsog/anaglyph/ Analglyph]
| This filter produces analglyph video from a stereo pair. Analglyph is a 3d viewing method which uses colored glasses. The plugin supports the advanced [http://web.archive.org/web/20130706165544/www.site.uottawa.ca/~edubois/anaglyph/ Dubois] algorithm, which is able to reduce the ghosting effect that is possible in the conversion.
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [http://chaosking.de/wp-content/uploads/avsfilters/Unclassified/Anaglyph___(0.85_-_2010-08-29).7z Plugin] / [http://web.archive.org/web/20140412062911/http://chaosking.de/wp-content/uploads/avsfilters/Unclassified/Anaglyph___(0.85_-_2010-08-29).7z mirror]
| {{Author/Kertai Gábor}}
|-
| Anaglypher
| A plugin for combining stereopairs into single anaglyph image.
| [[RGB32]], [[RGB24]]
| [http://shura.luberetsky.ru/anaglypher/Anaglypher.zip Plugin]
| [http://shura.luberetsky.ru/ Shura Luberetsky]
|-
|[http://forum.doom9.org/showthread.php?t=162616 Displace / McM_2D_to_3D]
|Plugin and script that enables you to convert 2d to 3d stereo with bidirectional pulfrich effect + add depth to stationary objects.
|[[RGB32]]
|[http://forum.doom9.org/showthread.php?t=162616#post1539121 Plugin/Script]
|Mcmount
|-
|[http://forum.doom9.org/showthread.php?t=143855 fauxD]
|2D to stereo-3D conversion in real-time.
|[[RGB24]], [[RGB32]]
|[http://forum.doom9.org/attachment.php?attachmentid=9278&d=1232092731 Plugin]
|eslave
|-
| [http://www.pantarheon.org/AviSynth3DToolbox/ Pantarheon 3D AviSynth Toolbox]
| The Toolbox contains a number of basic functions which allow you to multiplex the left and right views found in two separate videos into one video, using several of the common methods currently in use.
| [[YUY2]], [[YV12]]
| [http://www.pantarheon.org/AviSynth3DToolbox/zip/ Script]
| [http://www.pantarheon.org/ G. Adam Stanislav]
|}

=== Libraries ===

{{FilterTable}}
|[http://avslib.sourceforge.net/ AVSLib]
|General purpose toolkit/extension library enhancing AviSynths ability to perform complex linear and non-linear video editing tasks. Includes support for Array containers & operators, debugging tools, math & string functions, filters and many more.
|
|[http://sourceforge.net/projects/avslib/ AVSLib]
|[http://gzarkadas.users.sourceforge.net/ gzarkadas]
|}

== Audio Filters ==

{{FilterTable}}
| [[AddAudio]]
| A function that adds silent audio to a clip. Needed for CCE 2.50 users.
| N/A
| Script
|
|-
|[http://forum.doom9.org/showthread.php?p=1861891#post1861891 Audiofix]
|Plugin to fix a specific audio problem, see [http://forum.doom9.org/showthread.php?t=175991 discussion].
|
|[http://forum.doom9.org/showthread.php?p=1861891#post1861891 Plugin]
|{{Author/David Horman}}
|-
| [[AudioGraph]]
| Displays the audio waveform superimposed on the video. Intended to help with editing rather than for final output. Useful for finding specific dialog or sound, and for checking A/V sync.
| [[RGB32]], [[RGB24]], [[YUY2]]
| [[AudioGraph|Plugin]]
| Richard Ling, {{author/Sh0dan}}
|-
|[[AudioLimiter]]
| To increase volume for silent sounds a lot, to increase volume for middle-volume sounds a little and to keep hi-volume sounds untoched.
| N/A
|[[AudioLimiter|Plugin]]
|dimzon
|-
|[[AudioTimeline]]
|Displays a audio timeline track under the frame. It is especially suited for thumbsheets, where it allows to estimate the audio track of the thumbnailed clip.
|[[RGB24]], [[RGB32]], [[Y8]], [[YV16]], [[YV24]], [[YV411]]
|[[AudioTimeline|Plugin]]
|martin53
|-
| [[BeFa]]
| Band Eliminate Filter for Audio.
| N/A
| [[BeFa|Plugin]]
| {{Author/kiraru2002}}
|-
| [[FindAudioSyncScript]]
| FindAudioSyncScript helps you to find the appropriate audio delays, if you have desync'ed audio.
| N/A
| Script
| IanB
|-
| [[MinMaxAudio]]
| Computes the root mean square, maximal or minimal value over all samples in all channels,or just over all samples in channel, and outputs the value (in decibels) as a float. It's a conditional audio filter, so the computation is done framewise.
| N/A
| [[MinMaxAudio|Plugin]]
| {{author/Wilbert Dijkhof}}
|-
|[[Normalize2]]
|Audio normalizing plugin. The main difference between this plugin and the built-in normalizing plugin [[Normalize]]() is that this plugin can store the peak level value in an external file and uses a lookup table to do the actual normalizing (for speed).
|N/A
|[[Normalize2|Plugin]]
|[http://sourceforge.net/u/jcsston/profile/ jcsston]
|-
| [[SoxFilter]]
| Use [http://sox.sourceforge.net/ SOX] audio effects within AviSynth. Most effects are supported, and multiple effects can be stacked after each other.
| N/A
| [[SoxFilter|Plugin]]
| {{author/Sh0dan}}
|-
|[[Spectrogram]]
|Linear [http://en.wikipedia.org/wiki/Spectrogram spectrogram] for AviSynth 2.6.
|Any
|[[Spectrogram|Plugin]]
|[http://github.com/innocenat innocenat]
|-
|SwitchByAudio
|Plugin to switch video source based on audio. See [http://forum.doom9.org/showthread.php?t=167011 discussion]
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
|[http://www.avisynth.nl/users/vcmohan/SwitchByAudio/SwitchByAudio.zip Plugin]
|{{Author/vcmohan}}
|-
|[http://forum.doom9.org/showpost.php?p=1722472&postcount=20 TimeStretchPlugin]
|[[TimeStretch]] with multichannel support and updated SoundTouch library.
|N/A
|[http://www.wilbertdijkhof.com/TimeStretch_v258.zip Plugin]
|{{Author/Wilbert Dijkhof}}
|-
| [[ViewAudio]]
| Includes two filters: ViewAudio and CacheAudio.
| [[YUY2]], [[YV12]]
| [[ViewAudio|Plugin]]
| {{Author/minamina}}
|-
| VUmeter
| Classic analog-style VU meter; see [https://forum.doom9.org/showthread.php?t=175370 discussion]. Uses MinMaxAudio.
| Any
| [https://github.com/raffriff42/AvisynthPlusUtilities script]
| raffriff42
|-
| [[Waveform]]
| Displays audio waveforms superimposed on the video, similar to AudioGraph below but with multi-channel support and consistent support for all colourspaces.
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
| [http://horman.net/avisynth/download/waveform0.3.zip Plugin]
| {{Author/David Horman}}
|}

== As Yet Unclassified ==

{{FilterTable}}
| [http://forum.doom9.org/showthread.php?p=397426#post397426 Adjust]
| Generic Y-Channel mapping. Can define a function for the Y Channel. See [http://forum.doom9.org/showthread.php?p=397426 discussion.]
| [[RGB24]], [[RGB32]], [[YUY2]]
| [http://avisynth.nl/users/warpenterprises/files/adjust_5F25_dll_20031110.zip Plugin]
| [http://avisynth.nl/users/warpenterprises/ WarpEnterprises]
|-
|[http://forum.doom9.org/showthread.php?t=166588 Adaptive Lens Blur Repair]
|This function adaptively repairs video damaged by lens blur, using a frame-adaptive repair mask, a selection of sharpeners and multi-stage motion-compensated artifact removal.
|[[YV12]]
| [http://forum.doom9.org/attachment.php?attachmentid=13154&stc=1&d=1354907363 Script]
| fvisagie
|-
|[[amp]]
|Inspired by [http://forum.doom9.org/showthread.php?t=168293 RgbAmplifier], it performs temporal smoothing, then (optionally) enhances the difference between the windowed average and the current frame.
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]
| [[amp|Plugin]]
| {{Author/David Horman}}
|-
|[[AutoOverlay]]
|Auto-aligned optimal overlay of one video clip onto another with color adjustment.
| [[RGB32]], [[YV24]], [[YV12]]
| [https://github.com/introspected/AutoOverlay/releases Plugin]
| [https://github.com/introspected introspected]
|-
|[http://github.com/Xenoveritas/AviSynth-Stuff/tree/master/AutoTrace AutoTraceFilter]
|An intentionally useless plugin that uses [http://autotrace.sourceforge.net/ AutoTrace] to trace and then resize a source video, rendering the result using GDI+.
|[[RGB24]]
| [http://github.com/Xenoveritas/AviSynth-Stuff/tree/master/AutoTrace Plugin]
| [http://github.com/Xenoveritas Xenoveritas]
|-
| [http://forum.doom9.org/showthread.php?p=675275#post675275 BeforeAfter]
| See the difference before and after; similar discussion [http://forum.doom9.org/showthread.php?t=98876 here]. (missing [http://www.animemusicvideos.org/forum/viewtopic.php?f=11&t=45223 BeforeAfterDiff] and BeforeAfterLine scripts.)
| any
| Script
| Corran
|-
|[http://forum.doom9.org/showthread.php?t=158696 ccc]
|A plugin specifically designed for Cross-Conversion Correction.
|[[YV12]]
|[http://web.archive.org/web/20150403181720/http://japland.org/ccc/ccc_v0.4a_avs.zip Plugin]
|Daemon404
|-
| [http://www.avisynth.nl/users/vcmohan/ColorIt/ColorIt.html Colorit]
| Color a black and white image or recolor a color image. See [http://forum.doom9.org/showthread.php?t=93990 discussion.]
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
| [http://www.avisynth.nl/users/vcmohan/ColorIt/Colorit.zip Plugin]
| {{Author/vcmohan}}
|-
| CutFrames
| Cut a range of frames from a single a/v clip. Opposite of Trim with extras.
|
| [http://forum.doom9.org/showthread.php?t=135423 Script]
| mikeytown2
|-
| DCT
| Plugin with the following functions: IDCT, IDCT2, FDCT, FDCT2. See [http://forum.doom9.org/showthread.php?p=667382#post667382 discussion]
| [[YUY2]]
| [http://alainmuchembled.free.fr/DCT.zip Plugin]
| lcld
|-
| [http://forum.doom9.org/showthread.php?p=1444027#post1444027 DDigit]
| DDigit Plugin Text Rendering Pack for Plugin writers. See [http://forum.doom9.org/showthread.php?t=156888 discussion.]
|
| [http://www.mediafire.com/download/bfhj5crwaxbupeh/DDigitTest_25%2626_v1-06_dll_20150330-RECOMPILE.zip Plugin]
| {{Author/StainlessS}}
|-
| [http://forum.doom9.org/showthread.php?t=80419 DeBlot]
| Color Blot Reduction.
| [[YUY2]],[[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/deblot_5F25_dll_20030628.zip Plugin]
| {{Author/minamina}}
|-
|[http://forum.doom9.org/showthread.php?t=95193 DeJump]
| This is a specific filter which might be used to stabilize some "jumpy" video sources captured from VHS.
|[[YUY2]]
| [http://forum.doom9.org/attachment.php?attachmentid=3988&d=1117479069 Plugin]
| dinstun
|-
|[[FFAvisynth]]
| A plugin which lets you directly use [http://en.wikipedia.org/wiki/Ffdshow ffdshow] video and audio filters from AviSynth scripts.
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]
| [http://sourceforge.net/projects/ffdshow-tryout/ Plugin]
| Milan Cutka
|-
|[http://github.com/Youka/FLuaG FLuaG]
| FLuaG (Floating Lua Graphics) is an AviSynth plugin for video/audio data editing via Lua scripting. See [http://forum.doom9.org/showthread.php?t=161852 discussion]
| [[RGB32]]
| [http://github.com/Youka/FLuaG/archive/master.zip Plugin]
| [http://github.com/Youka Youka]
|-
| [http://forum.doom9.org/showthread.php?t=150291 FritzPhoto]
| Use Avisynth to process still images.
|
| [http://forum.doom9.org/showthread.php?t=150291 FritzPhoto]
|
|-
|[http://forum.doom9.org/showthread.php?p=1600151#post1600151 FSubstitute]
|Tries to automate the task of replacing bad frames using adjacent or close-by frames.
|[[YV12]]
|[http://forum.doom9.org/showthread.php?p=1600151#post1600151 Script]
|martin53
|-
|[http://forum.doom9.org/showthread.php?t=130611 GrainOptimizer]
|The only temporal-only grain reducer! See discussion for more information. Related topics: [http://forum.doom9.org/showthread.php?t=137117 x264: Film Grain Optimization], [http://web.archive.org/web/20090916181521/http://x264dev.blogspot.com/2008/05/film-grain-optimization.html]
|[[YV12]]
|[http://web.archive.org/web/20081228144846/http://mirror05.x264.nl/Dark/force.php?file=./GrainOptimizer_2.02.zip Plugin]
|Dark Shikari
|-
|[http://github.com/Youka/LVS LVS]
| LVS (Lua Video Sync) is a video frameserver plugin to edit video frames with the capability of scripting language Lua + 2D image processing functionality. See [http://forum.doom9.org/showthread.php?t=167716 discussion]. [https://github.com/Youka/LVS GitHub]
| [[RGB32]], [[RGB24]]
| [http://sourceforge.net/projects/lua-video-sync/files/ Plugin]
| [http://github.com/Youka Youka]
|-
| [http://www.avisynth.nl/users/vcmohan/NeuralNet/NeuralNet.html NeuralNet]
| Neural networks through back propagation learn and filter some types of noise. Classification and linear type networks are included.
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
| [http://www.avisynth.nl/users/vcmohan/NeuralNet/NeuralNet.zip Plugin]
| {{Author/vcmohan}}
|-
| PseudoColor
| This filter first converts clip to b/w, then colors it to pseudorandom colors according to brightness. See [http://forum.doom9.org/showthread.php?t=61570 discussion.]
| [[RGB32]], [[RGB24]], [[YV12]]
| [http://www.avisynth.nl/users/warpenterprises/files/pseudocolor_5F25_dll_20030919.zip Plugin]
| Shubin
|-
|[http://github.com/jeremypoulter/QRCodeSource QRCodeSource]
|AviSynth plugin to provide a means to embed QR codes in video.
|[[RGB32]]
|[http://github.com/jeremypoulter/QRCodeSource/releases Plugin]
|[http://github.com/jeremypoulter jeremypoulter]
|-
|RemoveDeadPixels
|See [http://forum.doom9.org/showthread.php?p=699915#post699915 here] and [http://videoprocessing.fr.yuku.com/topic/27/Removedeadpixels here].
|[[YUY2]]
|[http://web.archive.org/web/20160610103945/http://home.arcor.de/kassandro/RemoveDeadPixels.rar Plugin]
|{{Author/kassandro}}
|-
|[http://forum.doom9.org/showthread.php?t=172601 rgba_rpn]
|A filter for manipulating the pixels of [[RGB]] (and also [[YUV]]) clips using [http://en.wikipedia.org/wiki/Reverse_Polish_notation reverse Polish notation.]
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]
|[http://horman.net/avisynth/downloads/rgba_rpn0.1.zip Plugin]
|{{Author/David Horman}}
|-
| [[SegmentedAmp]]
| Image is segmented with watershed algorithm for smoothing and/or sharpening.
| [[RGB32]], [[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| [http://avisynth.nl/index.php/SegmentedAmp Plugin]
| {{Author/vcmohan}}
|-
|[http://forum.doom9.org/showthread.php?t=172377 SmoothSkip]
|In tribute to tritical's awesome filter, this one tackles the inverse problem of [[TIVTC/TDecimate|TDecimate]]; allowing for addressing frames that have non-smooth, skippy motion. For source code see [http://github.com/jojje/SmoothSkip GitHub repository].
|[[YUY2]], [[YV12]]
|[http://github.com/jojje/SmoothSkip/releases/download/v1.0.2/SmoothSkip-1.0.2.zip Plugin]
|[http://github.com/jojje jojje]
|-
| [[Soothe]]
| Lessens the temporal instability and aliasing caused by sharpening, by comparing the original and sharpened clip, leaving a smoother and slightly softer output. See [http://forum.doom9.org/showthread.php?t=99679 discussion.]
| [[YV12]]
| [http://forum.doom9.org/showthread.php?t=99679 Script]
| {{Author/Didée}}
|-
|[https://sourceforge.net/projects/ssbrenderer/ SSBRenderer]
|SSBRenderer is a plugin for AviSynth to render 2D graphics and subtitles by SSB (Substation Beta) data on frames of video streams. [https://forum.doom9.org/showthread.php?t=169951 Doom9 Forum discussion], [https://github.com/Youka/SSBRenderer GitHub]
|[[RGB24]], [[RGB32]]
|[https://sourceforge.net/projects/ssbrenderer/files/ C-Plugin]
|[https://github.com/Youka Youka ]
|-
| [http://sourceforge.net/projects/avisynthtrackin/ Tracking]
| Use computer vision to track objects in the video, and produce ConditionalReader input. Demo at [http://www.youtube.com/watch?v=SQ-JtJs7US0 Youtube].
| [[RGB24]]
| [http://sourceforge.net/projects/avisynthtrackin/files/1.1/AvisynthTrackin.1.1.binary.zip/download Plugin]
| [http://avisynthtrackin.sourceforge.net/ Shlomo Matichin]
|-
| UnSmooth
| What does it do. It amplifies noise, small detail, and artifacts. Doesn't sound very attractive, but there can still be some detail left in over smoothed encodes. See [http://forum.doom9.org/showthread.php?t=63361 discussion.]
| [[YV12]]
| [http://web.archive.org/web/20090821183550/http://mf.creations.nl/avs/functions/UnSmooth-v0.1.avs Script]
| {{Author/mf}}
|-
| [http://www.avisynth.nl/users/vcmohan/WaterShed/Watershed.html WaterShed]
| Assuming image grey values to be elevations, it is segmented into basins and watershed lines. Useful in certain medical image analysis and recoloring work.
| [[RGB32]], [[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
| AviSynth 2.5.8: [http://www.avisynth.nl/users/vcmohan/WaterShed/Watershed.zip Plugin]
AviSynth 2.6.0: [http://www.avisynth.nl/users/vcmohan/WaterShed/Watershed_2_6.zip Plugin]
| {{Author/vcmohan}}
|-
|[http://github.com/Xenoveritas/AviSynth-Stuff/tree/master/xvplugins xvplugins]
|This is simply a bunch of AviSynth stuff that isn't (really) possible using plain AviSynth and instead required a plugin.
|[[RGB32]]
| [http://github.com/Xenoveritas/AviSynth-Stuff/tree/master/xvplugins Plugin]
| [http://github.com/Xenoveritas Xenoveritas]
|}
<br/>

[[Category:AviSynth_Usage]]
[[Category:External_filters]]

QTGMC

2021-03-27T09:20:28Z

AmjadSONY: /* Core Plugins and Scripts */

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, real.finder
| v3.364s
| 3=[https://raw.githubusercontent.com/realfinder/AVS-Stuff/master/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

Zs RF Shared

2021-03-27T09:20:05Z

AmjadSONY: Created page with "{{FilterCat4|External_filters|Scripts|Other_filters|Multipurpose Filters}} {{Filter3 | real.finder, Multi Peoples | v1.143 | [https://github.com/realfinder/AVS-Stuff/raw/maste..."

{{FilterCat4|External_filters|Scripts|Other_filters|Multipurpose Filters}}
{{Filter3
| real.finder, Multi Peoples
| v1.143
| [https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi Zs_RF_Shared.avsi]
| Multipurpose Filters
|
|6=[http://forum.doom9.org/showpost.php?p=1665492&postcount=27 Doom9 Thread]}}

== Description ==
<tt>[[Zs_RF_Shared]]</tt> - Shared Functions and utility.
<br>
<br>
== Requirements ==
* AviSynth 2.5.7 or [http://sourceforge.net/projects/avisynth2/ greater]

== Changelog ==
Version Date(D/M/Y) Changes<br>
v1.143 11/12/2020 -
<br>

==External Links==
*[https://forum.doom9.org/showthread.php?t=174121 Doom9 Forum] - See this thread for support.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Multipurpose_Filters|External Filters]] ←'''
-----------------------------------------------

ASTDR

2021-03-27T09:09:50Z

AmjadSONY:

{{FilterCat4|External_filters|Scripts|Restoration_filters|Rainbow & Dot Crawl Removal}}
{{Filter3
| AmjadSONY
| v1.78
| [https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/ASTDR.avsi ASTDR.avsi]
| Rainbow & Dot Crawl Removal
|
|6=[http://forum.doom9.org/showpost.php?p=1665492&postcount=27 Doom9 Thread]}}

== Description ==
<tt>[[ASTDR]]</tt> - A Spatio-Temporal DeRainbowing function. <tt>{{Template:FuncDef|ASTDRmc}}</tt> is a motion-compensated variant that helps avoid chroma bleeding in moving scenes.
<br>
<br>
== Requirements ==
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]
* [[FAQ_different_types_content#How_do_I_recognize_progressive.2C_interlaced.2C_telecined.2C_hybrid_and_blended_content.3F|Progressive]] or Field Based input
* Supported color formats: [[YV12]]

=== Required Plugins ===
Latest versions of the following filters are recommended unless stated otherwise.<br>
*[[Zs_RF_Shared]]
*[[aWarpSharp2]]
*[[DeCross]]
*[[FluxSmooth]]
*[[hqdn3d]]
*[[MaskTools2]]

<tt>{{Template:FuncDef|ASTDRmc}}</tt> requires a few more plugins: [[MVTools]] and [[TEMmod]] if you're using AviSynth 2.6 or [[TEdgeMask]] for 2.5.
<br>
<br>

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|ASTDR (clip input, int "strength", int "tempsoftth", int "tempsoftrad", int "tempsoftsc", float "blstr", int "tht", int "FluxStv", int "dcn", bool "edgem", bool "exmc", clip "edgemprefil", bool "nomask")}}
:{{Template:FuncDef|ASTDRmc (clip input, int "strength", int "tempsoftth", int "tempsoftrad", int "tempsoftsc", float "blstr", int "tht", int "FluxStv", int "dcn", bool "edgem", int "thSAD", clip "prefil", bool "chroma", clip "edgemprefil", bool "nomask")}}
<br>
::{{Par2| |clip| }}
:::Input clip.
<br>
::{{Par2|strength|int|5}}
:::[[hqdn3d|hqdn3d's]] <tt>cs</tt> and <tt>ct</tt> parameters.
<br>
::{{Par2|tempsoftth|int|30}}
::{{Par2|tempsoftrad|int|3}}
::{{Par2|tempsoftsc|int|3}}
:::[[TemporalSoften|TemporalSoften's]] <tt>chroma_threshold</tt>, <tt>radius</tt>, and <tt>scenechange</tt> parameters.
<br>
::{{Par2|blstr|float|0.5}}
:::[[Blur]] strength.
<br>
::{{Par2|tht|int|255}}
:::[[MaskTools2/Mt_motion|mt_motion's]] <tt>thT</tt> parameter.
<br>
::{{Par2|FluxStv|int|75}}
:::[[FluxSmooth|FluxSmoothST's]] <tt>temporal_threshold</tt> and <tt>spatial_threshold</tt> parameters.
<br>
::{{Par2|dcn|int|15}}
:::[[DeCross|DeCross']] <tt>Noise</tt> parameter.
<br>
::{{Par2|edgem|bool|false}}
:::Set to <tt>true</tt> to use an edge mask.
<br>

== Examples ==
ASTDR with default settings:
[[AviSource]]("Blah.avi")
ASTDR(strength=5, tempsoftth=30, tempsoftrad=3, tempsoftsc=3, blstr=0.5, tht=255, FluxStv=75, dcn=15, edgem=false)
<br>
== Changelog ==
Version Date(D/M/Y) Changes<br>
v1.76 11/07/2019 - [http://pastebin.com/j5JVNwSP]
v1.75 15/08/2018 - [http://pastebin.com/LiVG4NFh]
v1.74 11/11/2017 - [http://pastebin.com/xyVhfQFe]
v1.72 07/11/2017 - [http://pastebin.com/b03M4Xav]
v1.61 02/01/2017 - [http://pastebin.com/vnQs8Dxi]
v1.59 01/01/2017 - [http://pastebin.com/sVEPMJ8N]
v1.53 06/10/2016 - [http://pastebin.com/QQ5ycB6f]
v1.52 25/01/2016 - [http://pastebin.com/A6F1TLL4]
v1.51 07/06/2015 - [http://pastebin.com/P3uun3x4]
v1.50 10/05/2015 - [http://pastebin.com/UfKWfb8Z]
v1.49 27/04/2015 - [http://pastebin.com/HqPCrDF6] [http://pastebin.com/GyzH6gfZ]
v1.47 22/12/2014 - [http://pastebin.com/dzszpfLk]
v1.45 21/12/2014 - [http://pastebin.com/jLQ4qrFi]
v1.4 21/12/2014 - [http://pastebin.com/jcfDpcdz]
v1.2 04/02/2014 - [http://pastebin.com/0D16eaHv]
v1.0 04/02/2014 - [http://pastebin.com/06EfSweJ] Initial release
<br>

==External Links==
*[https://forum.doom9.org/showthread.php?t=174121 Doom9 Forum] - See this thread for support.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Rainbow_.26_Dot_Crawl_Removal|External Filters]] ←'''
-----------------------------------------------

AssRender

2021-03-04T14:21:02Z

AmjadSONY:

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Subtitling|Deep_color_tools}}
{{Filter3
|1=pinterf, vadosnaprimer, Blitzker, pingplug, lachs0r, TheFluff
|2=v0.35
|3=[https://github.com/pinterf/assrender/releases/ assrender-0.35.7z]
|4=Subtitling
|5=Source code is MIT license, binaries are GPL
|6=[https://forum.doom9.org/showthread.php?t=148926 Doom9 Thread]}}
<br>
== Description ==
AssRender is an AviSynth plugin that renders ASS/SSA and SRT (without the HTML-like markup) subtitles. It uses libass to render the subtitles.

This also means that it is much more picky about script syntax than VSFilter and friends, so keep that in mind before blaming the filter. Yes, people have reported a lot of errors that were actually the script author’s fault and libass vs VSFilter compatibility.
<br>
<br>
<span style="color:red">'''Note:'''</span> AssRender 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.6]
* [x64]: [[AviSynth+]]
* Supported color formats: [[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
** AviSynth+: all [[planar]] formats (8/10/12/14/16bit, Y/YUV/RGB with or without alpha) are supported. [[RGB48]] and [[RGB64]] are also supported.
<br>

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|assrender (clip, string file, string "vfr", int "hinting", float "scale", float "line_spacing", float "dar", float "sar", int "top", int "bottom", int "left", int "right", string "charset", int "debuglevel", string "fontdir", string "srt_font", string "colorspace") }}
<br>
::{{Par2||clip| }}
:::Input clip.
<br>
::{{Par2||string|}}
:::Your subtitle file. May be ASS, SSA or SRT.
<br>
::{{Par2|vfr|string| }}
:::Specify timecodes v1 or v2 file when working with VFRaC.
<br>
::{{Par2|hinting|int|0}}
:::Font hinting mode. Choose between:
:::*none (0, default), light (1), normal (2) and Freetype native (3) autohinting.
<br>
::{{Par2|scale|float|1.0}}
:::Font scale. Defaults to 1.0.
<br>
::{{Par2|line_spacing|float|1.0}}
:::Line spacing in pixels. Defaults to 1.0 and won’t be scaled with frame size.
<br>
::{{Par2|dar|float| }}
::{{Par2|sar|float| }}
:::Aspect ratio. Of course you need to set both parameters.
<br>
::{{Par2|top|int|0}}
::{{Par2|bottom|int|0}}
::{{Par2|left|int|0}}
::{{Par2|right|int|0}}
:::Margins. They will be added to the frame size and may be negative.
<br>
::{{Par2|charset|string|"UTF-8"}}
:::Character set to use, in GNU iconv or enca format. Defaults to UTF-8.
:::Example enca format: enca:pl:cp1250 (guess the encoding for Polish, fall back on cp1250)
<br>
::{{Par2|debuglevel|int|0}}
:::How much crap assrender is supposed to spam to stderr.
<br>
::{{Par2|fontdir|string|""}}
:::Additional font directory.
:::Useful if you are lazy but want to keep your system fonts clean.
<br>
::{{Par2|srt_font|string|"Sans"}}
:::Font to use for SRT subtitles. Defaults to whatever Fontconfig chooses for “Sans”.
<br>
::{{Par2|colorspace|string|""}}
:::The color space of your (YUV) video. Possible values:
:::* "Rec2020", "BT.2020"
:::* "Rec709", "BT.709"
:::* "Rec601", "BT.601"
:::* "PC.709"
:::* "PC.601"
:::* "TV.fcc", "PC.fcc"
:::* "TV.240m", "PC.240m"
:::* "none", "guess"
:::Default is to use the ASS script's "YCbCr Matrix" or "Video Colorspace" property.
:::Recognized .ASS properties: "TV.601" "TV.709", "PC.601" "PC.709" "TV.240m" "PC.240m" "TV.fcc" "PC.fcc" and "none".

:::"none" and "guess" decides upon on video resolution: width > 1280 or height > 576 → BT.709, else → BT.601. When no hint found in ASS script and 'colorspace' parameter is empty then the default is BT.601.
<br>

== Examples ==

[[AviSource]]("Blah.avi")
AssRender("subtitles.ass")

<br>

== Changelog ==
<pre>
2021-03-04 - pinterf
* Version 0.35:
- Windows MSVC: Update to libass v0.15 (git submodule update --init --recursive --remote)
For changes since v0.14 see https://github.com/libass/libass/blob/master/Changelog
- don't guess base on video resolution (realfinder)
if .ass file has no Matrix info then it should be treated as it "Rec601" to maintain compatibility
- Parameter 'colorspace' default value is no longer "guess"
- Add more color options: PC.709, PC.601, TV.fcc, PC.fcc, TV.240m, PC.240m, none.
"none" and "guess" implies "guess-by-resolution".
- Fix: possible crash on initializing phase (buffer overread, linux crashed, Windows was just lucky)

2021-03-01 - pinterf
* Version 0.34:
- Fix the fix: revert matrix change made in 0.33
- Fix: Check matrix from .ASS file "YCbCr Matrix:" section besides "Video Colorspace:"
Recognized values are "tv.601" and "tv.709"

2021-02-28 - pinterf
* Version 0.33:
- Fix: wrong Bt.709 matrix (it wasn't :) )

2021-02-27 - pinterf
* Version 0.32:
- Fix: treat I420 variant as YV12 instead of unsupported color space

2021-02-18 - pinterf
* Version 0.31:
- Fix colors for planar RGB
- code: hidden ifdef FOR_AVISYNTH_26_ONLY for Avisynth 2.6-only build

2021-02-17 - pinterf
* Version 0.30:
- 10-16 bit support (including RGB48 and RGB64)
- YV411, Planar RGB support

2021-02-16 - pinterf
* Version 0.29:
- project moved to https://github.com/pinterf/assrender from https://github.com/vadosnaprimer/assrender
- Move to Visual Studio 2019 - v142 platform toolset
- Add .def module definition file for Avisynth 2.6 std compatibility (function name mangling)
- Update Avisynth C headers
- Check Linux and gcc-MinGW CMake build
- Add build instructions and change log to README

2019-01-14 - vadosnaprimer
- https://github.com/vadosnaprimer/assrender/
- add batch that lets not to change deps sdk and vs version copied from SMP libass
- update SMP submodules

2016-10-18 - Blitzker
- https://github.com/Blitzker/assrender
- Visual Studio 2015 support

2012-04-20 - lachs0r
* Version 0.25:
- code restructured
- added support for the BT.709 color space and the “Video Colorspace”
property that has been introduced with recent versions of Aegisub.
binary:
- updated everything, switched to MinGW-w64
(same toolchain as mplayer2 now)

2011-09-22 - lachs0r
* Version 0.24.1:
binary:
- updated libass to current git HEAD
- switched Harfbuzz to libass’ compatibility branch
- compiled Harfbuzz without Uniscribe backend
fixes lots of crashes and misbehavior

2011-07-29 - lachs0r
* Version 0.24:
binary:
- updated libass to current git HEAD:
- fixed performance regression

2011-07-29 - lachs0r
* Version 0.23:
- disabled font hinting by default
binary:
- updated libass to current git HEAD and included Harfbuzz:
- added support for bidirectional text, Arabic shaping etc.
- added proper support for @fonts (vertical writing)
- slight performance regression
(glyph cache not hooked up with Harfbuzz yet)
- updated FreeType to current git HEAD:
- fixed outline stroker for some broken fonts

2011-06-16 - lachs0r
* Version 0.22:
- fixed hang when a glyph with zero dimensions was encountered
(mostly vector clips)

2011-06-08 - lachs0r <lachs0r@srsfckn.biz>
* Version 0.21:
- finally implemented proper subsampling for YV12
- temporarily removed YV16 support
- renamed parameter verbosity → debuglevel
- code cleanups
binary:
- reverted to GCC 4.5.2 (4.6 miscompiles MinGW)

2011-06-01 - lachs0r
* Version 0.20:
- fixed the masksub stuff
- properly output debug messages to stderr instead of stdout
- reformatted source and corrected/removed some comments
- modified CMakeLists.txt to strip the binary by default
binary:
- now built with GCC 4.6 instead of 4.5.2
- included enca again
- patched fontconfig:
- prettier debug output
- use the correct location for its cache

2011-02-01 - lachs0r
* Version 0.19:
This is a bugfix/cleanup release.
- fixed possible buffer overflows in timecodesv1 and SRT parsing
- fixed random crashes on unloading
- probably fixed compilation with MSVC (patch by TheFluff)
- very slightly improved performance with GCC
- various code cleanups

2011-01-25 - lachs0r
* Version 0.18:
- improved YV12 support (should be somewhat usable now)
- added support for RGB24, YV24, YV16 and Y8 (YUY2 coming soon)
- added SRT subtitle format support
additional parameter: srt_font (font to use for srt subs)
- exposed some libass parameters:
line_spacing (line spacing)
dar, sar (aspect ratio)
top, bottom, left, right (margins)
fontdir (additional font directory)
- masksub equivalent if used on a blankclip
(still buggy - read source for details)
- no more global variables

2011-01-17 - lachs0r
* Version 0.17:
- added rudimentary YV12 support (chroma subsampling still needs work)
- binary: Previously, I linked against a very old avisynth_c.lib - now
you shouldn’t get any error messages about “avisynth_c.dll”
- tidied up the RGB32 blitter a bit

2011-01-16 - lachs0r
* Version 0.15:
- reimplemented as AviSynth C plugin - this fixed several crashes and
got rid of the major pain in the ass that is MSVC
- binary: built with patched Fontconfig (no longer needs fonts.conf)
* Version 0.16:
- implemented VFRaC support via timecodes files (v1 and v2 supported)
</pre>
<br>

== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v0.25
|[http://srsfckn.biz/assrender/assrender-0.25.7z assrender-0.25.7z]
|[https://web.archive.org/web/20180118024447if_/http://srsfckn.biz/assrender/assrender-0.25.7z assrender-0.25.7z]
|}

<br>

== External Links ==
*[http://github.com/pinterf/assrender GitHub] - Updated version (v0.30+)
*[http://github.com/pingplug/assrender GitHub] - Updated version (v0.28), only source code available.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Subtitling|External Filters]] ←'''

AssRender

2021-03-04T14:08:24Z

AmjadSONY:

{{FilterCat6|External_filters|Plugins|Plugins_x64|Adjustment_filters|Subtitling|Deep_color_tools}}
{{Filter3
|1=pinterf, vadosnaprimer, Blitzker, pingplug, lachs0r, TheFluff
|2=v0.30
|3=[https://github.com/pinterf/assrender/releases/ assrender-0.35.7z]
|4=Subtitling
|5=Source code is MIT license, binaries are GPL
|6=[https://forum.doom9.org/showthread.php?t=148926 Doom9 Thread]}}
<br>
== Description ==
AssRender is an AviSynth plugin that renders ASS/SSA and SRT (without the HTML-like markup) subtitles. It uses libass to render the subtitles.

This also means that it is much more picky about script syntax than VSFilter and friends, so keep that in mind before blaming the filter. Yes, people have reported a lot of errors that were actually the script author’s fault and libass vs VSFilter compatibility.
<br>
<br>
<span style="color:red">'''Note:'''</span> AssRender 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.6]
* [x64]: [[AviSynth+]]
* Supported color formats: [[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
** AviSynth+: all [[planar]] formats (8/10/12/14/16bit, Y/YUV/RGB with or without alpha) are supported. [[RGB48]] and [[RGB64]] are also supported.
<br>

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|assrender (clip, string file, string "vfr", int "hinting", float "scale", float "line_spacing", float "dar", float "sar", int "top", int "bottom", int "left", int "right", string "charset", int "debuglevel", string "fontdir", string "srt_font", string "colorspace") }}
<br>
::{{Par2||clip| }}
:::Input clip.
<br>
::{{Par2||string|}}
:::Your subtitle file. May be ASS, SSA or SRT.
<br>
::{{Par2|vfr|string| }}
:::Specify timecodes v1 or v2 file when working with VFRaC.
<br>
::{{Par2|hinting|int|0}}
:::Font hinting mode. Choose between:
:::*none (0, default), light (1), normal (2) and Freetype native (3) autohinting.
<br>
::{{Par2|scale|float|1.0}}
:::Font scale. Defaults to 1.0.
<br>
::{{Par2|line_spacing|float|1.0}}
:::Line spacing in pixels. Defaults to 1.0 and won’t be scaled with frame size.
<br>
::{{Par2|dar|float| }}
::{{Par2|sar|float| }}
:::Aspect ratio. Of course you need to set both parameters.
<br>
::{{Par2|top|int|0}}
::{{Par2|bottom|int|0}}
::{{Par2|left|int|0}}
::{{Par2|right|int|0}}
:::Margins. They will be added to the frame size and may be negative.
<br>
::{{Par2|charset|string|"UTF-8"}}
:::Character set to use, in GNU iconv or enca format. Defaults to UTF-8.
:::Example enca format: enca:pl:cp1250 (guess the encoding for Polish, fall back on cp1250)
<br>
::{{Par2|debuglevel|int|0}}
:::How much crap assrender is supposed to spam to stderr.
<br>
::{{Par2|fontdir|string|""}}
:::Additional font directory.
:::Useful if you are lazy but want to keep your system fonts clean.
<br>
::{{Par2|srt_font|string|"Sans"}}
:::Font to use for SRT subtitles. Defaults to whatever Fontconfig chooses for “Sans”.
<br>
::{{Par2|colorspace|string|""}}
:::The color space of your (YUV) video. Possible values:
:::* "Rec2020", "BT.2020"
:::* "Rec709", "BT.709"
:::* "Rec601", "BT.601"
:::* "PC.709"
:::* "PC.601"
:::* "TV.fcc", "PC.fcc"
:::* "TV.240m", "PC.240m"
:::* "none", "guess"
:::Default is to use the ASS script's "YCbCr Matrix" or "Video Colorspace" property.
:::Recognized .ASS properties: "TV.601" "TV.709", "PC.601" "PC.709" "TV.240m" "PC.240m" "TV.fcc" "PC.fcc" and "none".

:::"none" and "guess" decides upon on video resolution: width > 1280 or height > 576 → BT.709, else → BT.601. When no hint found in ASS script and 'colorspace' parameter is empty then the default is BT.601.
<br>

== Examples ==

[[AviSource]]("Blah.avi")
AssRender("subtitles.ass")

<br>

== Changelog ==
<pre>
2021-03-04 - pinterf
* Version 0.35:
- Windows MSVC: Update to libass v0.15 (git submodule update --init --recursive --remote) For changes since v0.14 see https://github.com/libass/libass/blob/master/Changelog
- don't guess base on video resolution (realfinder) if .ass file has no Matrix info then it should be treated as it "Rec601" to maintain compatibility
- Parameter 'colorspace' default value is no longer "guess"
- Add more color options: PC.709, PC.601, TV.fcc, PC.fcc, TV.240m, PC.240m, none. "none" and "guess" implies "guess-by-resolution".
- Fix: possible crash on initializing phase (buffer overread, linux crashed, Windows was just lucky)

2021-03-01 - pinterf
* Version 0.34:
- Fix the fix: revert matrix change made in 0.33
- Fix: Check matrix from .ASS file "YCbCr Matrix:" section besides "Video Colorspace:" Recognized values are "tv.601" and "tv.709"

2021-02-28 - pinterf
* Version 0.33:
- Fix: wrong Bt.709 matrix (it wasn't :) )

2021-02-27 - pinterf
* Version 0.32:
- Fix: treat I420 variant as YV12 instead of unsupported color space

2021-02-18 - pinterf
* Version 0.31:
- Fix colors for planar RGB
- code: hidden ifdef FOR_AVISYNTH_26_ONLY for Avisynth 2.6-only build

2021-02-17 - pinterf
* Version 0.30:
- 10-16 bit support (including RGB48 and RGB64)
- YV411, Planar RGB support

2021-02-16 - pinterf
* Version 0.29:
- project moved to https://github.com/pinterf/assrender from https://github.com/vadosnaprimer/assrender
- Move to Visual Studio 2019 - v142 platform toolset
- Add .def module definition file for Avisynth 2.6 std compatibility (function name mangling)
- Update Avisynth C headers
- Check Linux and gcc-MinGW CMake build
- Add build instructions and change log to README

2019-01-14 - vadosnaprimer
- https://github.com/vadosnaprimer/assrender/
- add batch that lets not to change deps sdk and vs version copied from SMP libass
- update SMP submodules

2016-10-18 - Blitzker
- https://github.com/Blitzker/assrender
- Visual Studio 2015 support

2012-04-20 - lachs0r
* Version 0.25:
- code restructured
- added support for the BT.709 color space and the “Video Colorspace”
property that has been introduced with recent versions of Aegisub.
binary:
- updated everything, switched to MinGW-w64
(same toolchain as mplayer2 now)

2011-09-22 - lachs0r
* Version 0.24.1:
binary:
- updated libass to current git HEAD
- switched Harfbuzz to libass’ compatibility branch
- compiled Harfbuzz without Uniscribe backend
fixes lots of crashes and misbehavior

2011-07-29 - lachs0r
* Version 0.24:
binary:
- updated libass to current git HEAD:
- fixed performance regression

2011-07-29 - lachs0r
* Version 0.23:
- disabled font hinting by default
binary:
- updated libass to current git HEAD and included Harfbuzz:
- added support for bidirectional text, Arabic shaping etc.
- added proper support for @fonts (vertical writing)
- slight performance regression
(glyph cache not hooked up with Harfbuzz yet)
- updated FreeType to current git HEAD:
- fixed outline stroker for some broken fonts

2011-06-16 - lachs0r
* Version 0.22:
- fixed hang when a glyph with zero dimensions was encountered
(mostly vector clips)

2011-06-08 - lachs0r <lachs0r@srsfckn.biz>
* Version 0.21:
- finally implemented proper subsampling for YV12
- temporarily removed YV16 support
- renamed parameter verbosity → debuglevel
- code cleanups
binary:
- reverted to GCC 4.5.2 (4.6 miscompiles MinGW)

2011-06-01 - lachs0r
* Version 0.20:
- fixed the masksub stuff
- properly output debug messages to stderr instead of stdout
- reformatted source and corrected/removed some comments
- modified CMakeLists.txt to strip the binary by default
binary:
- now built with GCC 4.6 instead of 4.5.2
- included enca again
- patched fontconfig:
- prettier debug output
- use the correct location for its cache

2011-02-01 - lachs0r
* Version 0.19:
This is a bugfix/cleanup release.
- fixed possible buffer overflows in timecodesv1 and SRT parsing
- fixed random crashes on unloading
- probably fixed compilation with MSVC (patch by TheFluff)
- very slightly improved performance with GCC
- various code cleanups

2011-01-25 - lachs0r
* Version 0.18:
- improved YV12 support (should be somewhat usable now)
- added support for RGB24, YV24, YV16 and Y8 (YUY2 coming soon)
- added SRT subtitle format support
additional parameter: srt_font (font to use for srt subs)
- exposed some libass parameters:
line_spacing (line spacing)
dar, sar (aspect ratio)
top, bottom, left, right (margins)
fontdir (additional font directory)
- masksub equivalent if used on a blankclip
(still buggy - read source for details)
- no more global variables

2011-01-17 - lachs0r
* Version 0.17:
- added rudimentary YV12 support (chroma subsampling still needs work)
- binary: Previously, I linked against a very old avisynth_c.lib - now
you shouldn’t get any error messages about “avisynth_c.dll”
- tidied up the RGB32 blitter a bit

2011-01-16 - lachs0r
* Version 0.15:
- reimplemented as AviSynth C plugin - this fixed several crashes and
got rid of the major pain in the ass that is MSVC
- binary: built with patched Fontconfig (no longer needs fonts.conf)
* Version 0.16:
- implemented VFRaC support via timecodes files (v1 and v2 supported)
</pre>
<br>

== Archived Downloads ==
{| class="wikitable" border="1"; width="600px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Mirror
|-
!v0.25
|[http://srsfckn.biz/assrender/assrender-0.25.7z assrender-0.25.7z]
|[https://web.archive.org/web/20180118024447if_/http://srsfckn.biz/assrender/assrender-0.25.7z assrender-0.25.7z]
|}

<br>

== External Links ==
*[http://github.com/pinterf/assrender GitHub] - Updated version (v0.30+)
*[http://github.com/pingplug/assrender GitHub] - Updated version (v0.28), only source code available.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Subtitling|External Filters]] ←'''

QTGMC

2020-06-26T03:41:17Z

AmjadSONY: update links

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, real.finder
| v3.364s
| 3=[https://raw.githubusercontent.com/realfinder/AVS-Stuff/master/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[https://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[https://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[https://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[https://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared.avsi]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi GitHub]
|This script is required from now on.
|}

====Optional Plugins====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/Asd-g/AviSynth-EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[https://github.com/pinterf/EEDI3/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[https://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[https://github.com/pinterf/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[https://github.com/chikuzen/PlanarTools/releases GitHub]
|<strike>Not necessarily required but may improve speed when working with a [[YUY2]] source.</strike> Don't use it in avs+ for now
|-
|[[TDeint]]
|[https://github.com/pinterf/TIVTC/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[https://github.com/Asd-g/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

MSharpen

2020-06-11T18:55:36Z

AmjadSONY: the real threshold is not 10 (from the Source code)

{{FilterCat4|External_filters|Plugins|Plugins_x64|Adjustment_filters|Sharpeners}}
{{Filter3
| {{Author/tp7}}
| v0.9
|[http://github.com/tp7/msharpen/releases/download/0.9/msharpen-x86.zip msharpen-x86.zip]
[http://github.com/tp7/msharpen/releases/download/0.9/msharpen-x64.zip msharpen-x64.zip]
| Sharpeners
| [http://opensource.org/licenses/MIT MIT] but binaries are [http://www.gnu.org/licenses/gpl-2.0.txt GPLv2]
|6=[http://forum.doom9.org/showthread.php?t=169832 Doom9 Thread]}}

== Description ==
<tt>MSharpen</tt> is a very simple masked sharpening plugin for AviSynth. This version is a reimplementation of neuron2's [http://rationalqm.us/msharpen/msharpen.html old <tt>MSharpen</tt>] plugin. It features better performance, x64 compatibility and less bugs.
<br>
<br>
== Requirements ==
* [http://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0] or greater
* x64 version requires [http://forum.doom9.org/showthread.php?t=168856 AviSynth+ r1576] or later
* Supported color formats: [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]
<br>
* [http://www.microsoft.com/en-us/download/details.aspx?id=30679 Microsoft Visual C++ 2012 Redistributable Package (x86 / x64)]
:<span style="color:red">***</span> <tt>vcredist_x86.exe</tt> is required for <tt>vinverse-x86</tt>
:<span style="color:red">***</span> <tt>vcredist_x64.exe</tt> is required for <tt>vinverse-x64</tt>
<br>

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|MSharpen (clip, int "threshold", int "strength", bool "highq", bool "mask")}}
<br>
::{{Par2| |clip| }}
:::Input clip
<br>
::{{Par2|threshold|int|15}}
:::Determines what is detected as edge detail and thus sharpened. To see what edge detail areas will be sharpened, use the 'mask' parameter.
:::Range: 0 to 255
<br>
::{{Par2|strength|int|100}}
:::Strength of the sharpening to be applied to the edge detail areas. It is applied only to the edge detail areas as determined by the threshold parameter. Strength 255 is the strongest sharpening.
:::Range: 0 to 255
<br>
::{{Par2|highq|bool|true}}
:::Lets you tradeoff speed for quality of detail detection. Set it to true for the best detail detection. Set it to false for maximum speed.
<br>
::{{Par2|mask|bool|false}}
:::When set to true, the areas to be sharpened are shown in white against a black background. Use this to set the level of detail to be sharpened. This function also makes a basic edge detection filter.
<br>

== Examples ==
<tt>MSharpen</tt> with default settings:
[[AviSource]]("blah.avi")
MSharpen(threshold=10, strength=100, highq=true, mask=false)
<br>
== Changelog ==
Version Date Changes<br>
v0.9 11/28/2013 - Initial release. Only Avisynth+ and Avisynth 2.6 are supported.
- YUY2 support and MMX code path removed.
- All code paths are faster than before, planar processing in SSE2-optimized.
<br>
== Archived Downloads ==
{| class="wikitable" border="1"; width="400px"
|-
!!width="100px"| Version
!!width="150px"| Download
!!width="150px"| Source Code
|-
!v0.9
|[http://github.com/tp7/msharpen/releases/download/0.9/msharpen-x86.zip msharpen-x86.zip]
[http://github.com/tp7/msharpen/releases/download/0.9/msharpen-x64.zip msharpen-x64.zip]
|[http://github.com/tp7/msharpen/archive/0.9.zip msharpen-0.9.zip]
|}
<br>

== External Links ==
*[http://github.com/tp7/msharpen GitHub] - Source code repository.
*[http://forum.doom9.org/showthread.php?t=42839 Doom9 Forum] - Original MSharpen discussion.
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Sharpeners|External Filters]] ←'''

QTGMC

2020-05-05T18:15:10Z

AmjadSONY:

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, real.finder
| v3.364s
| 3=[https://raw.githubusercontent.com/realfinder/AVS-Stuff/master/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[http://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[http://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[http://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[http://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared.avsi]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi github]
|This script is required from now on.
|}

====Optional Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/avisynth-repository/EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[http://github.com/Elegant996/EEDI3/releases/ GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[http://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[http://github.com/Khanattila/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[http://github.com/chikuzen/PlanarTools/releases GitHub]
|Not necessarily required but may improve speed when working with a [[YUY2]] source.
|-
|[[TDeint]]
|[http://avisynth.nl/index.php/TDeint 32-bit] /// [http://www.mediafire.com/download/kmcztm1xzjm/TDeinterlace_3-14-2010.rar 64-bit]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[http://github.com/chikuzen/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2020-05-05T18:12:51Z

AmjadSONY: /* Optional Plugins and Scripts */

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, real.finder
| v3.364s
| 3=[https://raw.githubusercontent.com/realfinder/AVS-Stuff/master/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[http://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[http://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[http://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[http://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared.avsi]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi github]
|This script is required from now on.
|}

SMDegrain Requirements Plugins not needed for QTGMC, only SMDegrain.avsi is needed since it has shared functions that used in QTGMC, same things for any Required Script for QTGMC

====Optional Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/avisynth-repository/EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[http://github.com/Elegant996/EEDI3/releases/ GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[http://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[http://github.com/Khanattila/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[http://github.com/chikuzen/PlanarTools/releases GitHub]
|Not necessarily required but may improve speed when working with a [[YUY2]] source.
|-
|[[TDeint]]
|[http://avisynth.nl/index.php/TDeint 32-bit] /// [http://www.mediafire.com/download/kmcztm1xzjm/TDeinterlace_3-14-2010.rar 64-bit]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[http://github.com/chikuzen/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

QTGMC

2020-05-05T18:11:56Z

AmjadSONY: /* Core Plugins and scripts */

{{FilterCat4|External_filters|Scripts|Restoration_filters|Deinterlacers}}

{{Filter3
| Vit, real.finder
| v3.364s
| 3=[https://raw.githubusercontent.com/realfinder/AVS-Stuff/master/avs%202.6%20and%20up/QTGMC.avsi QTGMC.avsi]
| 4=Deinterlacers
| 5=
| 6=[http://forum.doom9.org/showthread.php?t=156028 Doom9 Thread (original)]<br>[http://forum.doom9.org/showthread.php?t=174544 Update (real.finder mod)]
}}

A very high quality deinterlacer with a range of features for both quality and convenience. These include a simple presets system, extensive noise processing capabilities, support for repair of progressive material, precision source matching, shutter speed simulation, etc. Originally based on [[TempGaussMC]] by Didée.

==Requirements==
QTGMC requires the latest version of the following plugins:

====Core Plugins and scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[MaskTools2]]
|[http://github.com/pinterf/masktools/releases GitHub]
|
|-
|[[MVTools|MVTools2]]
|[http://github.com/pinterf/mvtools/releases GitHub]
|
|-
|[[nnedi3]]
|[http://github.com/jpsdr/NNEDI3/releases GitHub]
|
|-
|[[RgTools]]
|[http://github.com/pinterf/RgTools/releases GitHub]
|
|-
|[[Zs_RF_Shared.avsi]]
|[https://github.com/realfinder/AVS-Stuff/raw/master/avs%202.5%20and%20up/Zs_RF_Shared.avsi github]
|This script is required from now on.
|}

SMDegrain Requirements Plugins not needed for QTGMC, only SMDegrain.avsi is needed since it has shared functions that used in QTGMC, same things for any Required Script for QTGMC

====Optional Plugins and Scripts====
:{| class="wikitable"
|-
!! style="width: 113px" | Wiki page
!! style="width: 175px" | Download
!! style="width: 575px" | Comments
|-
|[[AddGrainC]]
|[https://github.com/pinterf/AddGrainC/releases GitHub]
|Only required if <code>NoiseDeint="Generate"</code> is selected for noise bypass.
|-
|[[dfttest]]
|[https://github.com/pinterf/dfttest/releases GitHub]
|Only required if selected for noise processing.
|-
|[[EEDI2]]
|[https://github.com/avisynth-repository/EEDI2/releases GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[eedi3|EEDI3]]
|[http://github.com/Elegant996/EEDI3/releases/ GitHub]
|Only required if selected directly or via a source-match preset.
|-
|[[FFT3DFilter]]
|[http://github.com/pinterf/fft3dfilter/releases GitHub]
|Only required if selected for noise processing.
|-
|[[KNLMeansCL]]
|[http://github.com/Khanattila/KNLMeansCL/releases GitHub]
|Only required if selected for noise processing.
|-
|[[PlanarTools]]
|[http://github.com/chikuzen/PlanarTools/releases GitHub]
|Not necessarily required but may improve speed when working with a [[YUY2]] source.
|-
|[[TDeint]]
|[http://avisynth.nl/index.php/TDeint 32-bit] /// [http://www.mediafire.com/download/kmcztm1xzjm/TDeinterlace_3-14-2010.rar 64-bit]
|Only required if selected directly or via a source-match preset.
|-
|[[yadifmod2]]
|[http://github.com/chikuzen/yadifmod2/releases GitHub]
|Only required for <code>Preset="Ultra Fast"</code> or if selected directly.
|-
|[[AnimeIVTC]]
|[http://pastebin.com/raw/z976zmzj pastebin] [https://forum.doom9.org/attachment.php?attachmentid=16317&d=1524003741 Doom9]
|Script is only required when working with a [[YUY2]] source.
|}

Dfttest, FFT3DFilter and MVTools2 need the [http://www.fftw.org/ FFTW3 library] ([http://www.fftw.org/install/windows.html windows builds]). On a 64-bit Windows OS, extract the 32-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''SysWow64'' folder.

If you want to use the 64-bit libfftw3f-3.dll versions then extract the 64-bit <code>libfftw3f-3.dll</code>. Make a copy of it and rename it as "FFTW3.dll". Place the files "libfftw3f-3.dll" and "FFTW3.dll" in the ''System32'' folder.

==Getting Started==

Install AviSynth and copy the plugins from the plugin package to the correct locations. Then to use QTGMC, write a script like this:

<pre>
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
QTGMC( Preset="Slow" )
SelectEven() # Add this line to keep original frame rate, leave it out for smoother doubled frame rate
</pre>

Save this script with an ".avs" extension. You can now use it as an AVI source for encoding.

''Most users should only use presets.'' The "Preset" used selects sensible settings for a given speed. Choose from:

* '''"Placebo" • "Very Slow" • "Slower" • "Slow" • "Medium" • "Fast" • "Faster" • "Very Fast" • "Super Fast" • "Ultra Fast" • "Draft"'''

The default preset is '''"Slower"'''. Don't be obsessed with using the slowest settings, the differences can be very small for a huge increase in time. In particular HD material benefits less from extreme settings. HD is 6-8 times as slow as SD.

There are many settings for tweaking this script, full details are provided in this documentation. The settings have been divided into categories, which each having key points, a detailed description, settings specifications/defaults, and several examples. The key points and examples should get you going. You can display settings currently being used with ''ShowSettings'':

QTGMC( Preset="Slow", ShowSettings=true )

===Multi-Threaded Usage===

QTGMC is very demanding on your system. For best performance try using it multi-threaded. You will need one of the "MT" versions of Avisynth from the [[Main Page]], only [http://forum.doom9.org/showthread.php?t=148782 2.6.0 MT by SEt] is supported. Use the multithreaded plugin pack in this case.

You need to tweak multi-threaded scripts to suit your system. Here is a basic template - read and follow the comments carefully and provide the values noted (you cannot use this code just as it is):

SetMTMode(5, ''X'') # See ''X'' below
SetMemoryMax(''M'') # Optional line. Leave it out at first. See ''M'' below
YourSource("yourfile") # DGDecode_mpeg2source, FFVideoSource, AviSource, whatever your source requires
SetMTMode(2)
QTGMC( Preset="Slow", EdiThreads=''Y'' ) # Choose preset based on overall speed/quality you want. See ''Y'' below
Distributor() # This line may or may not be necessary, try removing it and see if you get more speed

====SetMTMode ''X''====
* Start at the number of logical cores in your machine (note: with HyperThreading enabled, logical cores = 2x physical cores)
* If it crashes, decrease 1 at a time
* Otherwise increase 1 at a time until CPU usage just reaches 100%, don't go too far or it will slow down

====EdiThreads ''Y''====
* Start at about half number of cores and tweak upwards or downwards (but don't choose 0)
* Reducing this value may help stability, and might allow you to increase X for an overall speedup

====SetMemoryMax ''M''====
* First try without the SetMemoryMax line
* However, selecting a good SetMemoryMax value might better utilise memory and increase stability. Particularly important for slower settings
* Try values 400,600,800,1000 etc. Sometimes reducing this value can allow you to increase X for a speedup

====Notes====
* '''Do not use MT()'''.
* There are occasional instabilities with multi-threading, because AviSynth and plugins are not quite thread-safe. These instabilities affect different users in different ways: some report no issues, others can barely get multi-threading to work at all. But do try it as the speed increase can be considerable.

==Features / Settings==

'''Key Points''': For basic usage, ''select a preset and leave the core settings alone''.

===Core Settings===

'''Key Points''': Most useful setting is TR2, which controls smoothing of output.

{|
|-
| TR0
| (1,2)
| Temporal binomial smoothing radius used to create motion search clip. In general 2=quality, 1=speed
|-
| TR1
| (1,2)
| Temporal binomial smoothing radius used on interpolated clip for inital output. In general 2=quality, 1=speed
|-
| TR2
| (0,1,2,3)
| Temporal linear smoothing radius used for final stablization / denoising. Increase for smoother output
|-
| Rep0
| (int)
| Repair motion search clip (0 = off): repair unwanted blur after temporal smooth TR0
|-
| Rep1
| (int)
| Repair initial output clip (0 = off): repair unwanted blur after temporal smooth TR1
|-
| Rep2
| (int)
| Repair final output clip (0 = off): unwanted blur after temporal smooth TR2 (will also repair TR1 blur if Rep1 not used)
|-
| RepChroma
| (bool)
| Whether the repair modes affect chroma. Default: '''True'''
|}

RepX syntax: first digit (0-5): how wide thin shimmering lines can be and still get removed, from 1px to ~3px; second digit (0-3): to restore a bit beyond the detected lines. A single digit counts as the first digit.

====Examples====

QTGMC( Preset="Slow", TR2=3 ) # Strong final smooth (e.g. noisy / shimmery source)

====Algorithm Details====

The core algorithm is this:
<ol start="0">
<li> Bob the source clip. Temporally smooth the bob to remove shimmer then analyse its motion
<li> More accurately interpolate the source clip (e.g. NNEDI3). Use the motion analysis from previous step to temporally smooth this interpolate with motion compensation. This removes shimmer whilst retaining detail. Resharpen the result to counteract any blurring
<li> A final light temporal smooth to clean the result
</ol>

Stages 0 & 1 use a binomial smooth (similar to a Gaussian) to remove deinterlacing shimmer. Stage 2 uses a simple linear smoothing. Each stage's temporal radius (the number of frames out from the current) is given in the settings '''TR0''', '''TR1''' and '''TR2'''.

The shimmer reduction is critical for the algorithm so TR0 and TR1 should be at least 1. TR0 only affects the motion analysis and is only indirectly visible, increasing it to 2 will generally give a better motion match. Increasing TR1 and TR2 will create a smoother and more stable output and more strongly denoise; the downside is increased blurring and possibly lost detail, and potentially can cause stronger artifacts where motion analysis is inaccurate. The blur is partially counteracted by the sharpening settings.

The deinterlacer primarily tries to reduce "bob shimmer": horizontal lines of shimmer created when interpolating an interlaced stream. Consequently any changes made to the initial interpolation (e.g. NNEDI3) are expected to be horizontal lines of change only. The repair stages '''Rep0''', '''Rep1''' and '''Rep2''' occur after each temporal smooth. They only allow such horizontal lines of change - shimmer fixes, discarding other changes. This prevents the motion blur
that temporal smoothing could generate. The repX settings control the size of areas to allow through. (See the ''QTGMC_KeepOnlyBobShimmerFixes'' function comments for more detail.)

===Motion Analysis===

'''Key Points''': The presets make sensible choices for motion analysis. Some sources or requirements may require tweaks, but read these and MVTools2 docs first.

The bobbed source clip is sent to the MVTools2 plugin to perform motion analysis. Almost all these settings are used directly in MVTools2 functions. Read the MVTools2 documentation for more details on their purpose. Some settings can be altered for a speed / accuracy tradeoff. Less accurate motion search can result in blurring and/or oversharpening (in different circumstances) as well as slight distortions of visual elements. The faster presets gain speed by simplifying the motion search parameters, use the "ShowSettings" parameter or look at the table a short way into the script to see how.

{|
| SrchClipPP
| (0,1,2,3)
| Pre-filtering for motion search clip, 0 = none, 1 = simple blur, 2 = Gauss blur, 3 = Gauss blur + edge soften
|-
| SubPel
| (1,2,4)
| Sub-pixel accuracy for motion analysis (1 = 1 pixel, 2 = 1/2 pixel, 4 = 1/4 pixel)
|-
| SubPelInterp
| (0,1,2)
| Interpolation used for sub-pixel motion analysis: 0 = bilinear (soft), 1 = bicubic (sharper), 2 = Weiner (sharpest) Default: '''2'''
|-
| Blocksize
| (4,8,16,32)
| Size of blocks that are matched during motion analysis
|-
| Overlap
| (0-Blocksize/2)
| How much to overlap motion analysis blocks (requires more blocks, but essential to smooth block edges in motion compenstion)
|-
| Search
| (0...5)
| Search method used for matching motion blocks - see MVTools2 documentation for available algorithms
|-
| SearchParam
| (0...)
| Parameter for search method chosen. For default search method (hexagon search) it is the search range
|-
| PelSearch
| (0...)
| Search parameter (as above) for the finest sub-pixel level (see SubPel)
|-
| ChromaMotion
| (bool)
| Whether to consider chroma when analyzing motion. Setting to false gives good speed-up, but may very occasionally make incorrect motion decision.
|-
| TrueMotion
| (bool)
| Whether to use the 'truemotion' defaults from MAnalyse (see MVTools2 documentation) Default: '''False'''
|-
| Lambda
| (0...)
| Motion vector field coherence - how much the motion analysis favors similar motion vectors for neighboring blocks. Should be scaled by BlockSize*BlockSize/64
|-
| LSAD
| (0...)
| How much to reduce need for vector coherence (i.e. Lambda above) if prediction of motion vector from neighbors is poor, typically in areas of complex motion. This value is scaled in MVTools (unlike Lambda)
|-
| PNew
| (0...)
| Penalty for choosing a new motion vector for a block over an existing one - avoids chosing new vectors for minor gain
|-
| PLevel
| (0,1,2)
| Mode for scaling lambda across different sub-pixel levels - see MVTools2 documentation for choices
|-
| GlobalMotion
| (bool)
| Whether to estimate camera motion to assist in selecting block motion vectors. Default: '''True'''
|-
| DCT
| (0...10)
| Modes to use DCT (frequency analysis) or SATD as part of the block matching process - see MVTools2 documentation for choices. Default: '''0'''
|-
| ThSAD1
| (0...)
| SAD threshold for block match on shimmer-removing temporal smooth (''TR1''). Increase to reduce bob-shimmer more (may smear/blur) Default: '''640'''
|-
| ThSAD2
| (0...)
| SAD threshold for block match on final denoising temporal smooth (''TR2''). Increase to strengthen final smooth (may smear/blur) Default: '''256'''
|-
| ThSCD1
| (0...)
| Scene change detection parameter 1 - see MVTools documentation. Default: '''180'''
|-
| ThSCD2
| (0...)
| Scene change detection parameter 2 - see MVTools documentation. Default: '''98'''
|}

Defaults:

TrueMotion is false : Lambda = '''(1000 * BlockSize2)/64''', LSAD='''400''', PNew='''25''', PLevel='''0'''

TrueMotion is true : Lambda = '''(100 * BlockSize2)/64''', LSAD='''1200''', PNew='''50''', PLevel='''1'''

Other settings defaults are determined by preset.

===Interpolation===

'''Key Points''': Interpolation affects quality and speed. The presets can be relied on to provide sensible defaults mostly using NNEDI3.

The first step to create the deinterlaced output is to spatially interpolate a single half-height field into a full-height frame. A variety of interpolators are supported, with various settings to control the quality/speed of the output.

{|
|-
| EdiMode
| (string)
| Interpolation method, from "NNEDI3", "NNEDI2", "NNEDI", "EEDI3+NNEDI3" (EEDI3 with sclip from NNEDI3), "EEDI3", "EEDI2", "Yadif", "TDeint" or "RepYadif" ("repaired" Yadif), anything else uses "Bob"
|-
| ChromaEdi
| (string)
| Interpolation method used for chroma. Set to "" to use EdiMode above (default). Otherwise choose from "NNEDI3", "Yadif" or "Bob" - all high speed variants. This can give a minor speed-up if using a very slow EdiMode (i.e. one of the EEDIx modes) Default: '''""'''
|-
| NNSize
| (0...6)
| Area around each pixel used as predictor for NNEDI3. A larger area is slower with better quality, read the NNEDI3 docs to see the area choices. Note: area sizes are not in increasing order (i.e. increased value doesn't always mean increased quality)
|-
| NNeurons
| (0...4)
| Controls number of neurons in NNEDI2 (0-2) & NNEDI3 (0-4), larger = slower and better quality but improvements are small
|-
| EdiQual
| (1,2,3)
| Quality setting for NNEDI2 (1,2,3) & NNEDI3 (1,2 only). Higher values for better quality - but improvements are marginal
|-
| EdiMaxD
| (1...)
| Spatial search distance for finding connecting edges in EEDI2 and EEDI3
|-
| EdiThreads
| (0...)
| Number of threads to use in EEDI3 & NNEDI2/3, 0 = default = number of logical processors on system. Also affects source-match interpolations. Source-match can add 2 further interpolations per frame, adjusting this setting can help balance system load. Default: '''0'''
|-
| EdiExt
| (clip)
| Provide externally created interpolated clip rather than use one of the above modes. Default: '''undefined'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", EdiMode="EEDI3", EdiMaxD=16 ) # Use EEDI3 with an explicit search radius
QTGMC( Preset="Very Slow", EdiThreads=2 ) # Specify number of threads (with default NNEDI3) useful to tweak if using SetMTMode or source-match

===Sharpness===

Key Points: Always consider adjusting the Sharpness setting to taste. The default 1.0 is fairly sharp. If using source-match the default is 0.2

The core of the algorithm involves a binomial smooth to remove shimmer. So the result needs to be resharpened to counteract this blur. The main setting Sharpness defaults to 1.0, which is a level designed to retain the sharpness of stable areas. However, this level can cause moving areas to be oversharpened so you may wish to reduce the value depending on source. Sharpness when using source-match behaves differently, see that section. The sharpness processing for a given setting is tweaked to remain roughly similar regardless of other settings. However, there will be minor differences, so always consider adjusting sharpness if you tweak other major settings.

Oversharpening is limited either spatially (SLMode = 1,3) or temporally (SLMode = 2,4). Temporal limiting is more "correct" but also more aggressive in preventing sharpening. It's also slower. You can set a small value in the overshoot setting (SOvs) to give the temporal limiting a bit of "headroom". You can also perform sharpness limiting later in the algorithm (SLMode = 3,4) for more sharpness, but with the potential for minor artefacts.
Settings
{|
|-
| Sharpness
| (0.0...)
| How much to resharpen the temporally blurred clip (default is always 1.0 unlike original TGMC)
|-
| SMode
| (0,1,2)
| Resharpening mode: 0 = none, 1 = difference from 3x3 blur kernel, 2 = vertical max/min average + 3x3 kernel
|-
| SLMode
| (0,1,2,3,4)
| Sharpness limiting: 0 = off, [1 = spatial, 2 = temporal] : before final temporal smooth, [3 = spatial, 4 = temporal] : after final temporal smooth
|-
| SLRad
| (0...)
| Temporal or spatial radius used with sharpness limiting (depends on SLMode). Temporal radius can only be 0,1 or 3
|-
| SOvs
| (0...255)
| Amount of overshoot allowed with temporal sharpness limiting (SLMode = 2,4), i.e. allow some oversharpening. Default: '''0'''
|-
| SVThin
| (0.0...)
| How much to thin down 1-pixel wide lines that have been widened due to interpolation into neighboring field lines. Default: '''0.0'''
|-
| Sbb
| (0,1,2,3)
| Back blend (blurred) difference between pre & post sharpened clip (minor fidelity improvement): 0 = Off, 1 = before (1st) sharpness limiting, 2 = after (1st) sharpness limiting, 3 = both. Default: '''0'''
|}

Other settings defaults are determined by preset.

====Examples====

QTGMC( Preset="Slow", Sharpness=0.4 ) # Reduce oversharpening
QTGMC( Preset="Slow", Sharpness=1.2, SLMode=1 ) # Increase sharpness, use spatial sharpness limiting (which typically allows more sharpening)

===Source Match / Lossless===

Very detailed section for new feature [documentation likely to be thinned as feature matures]
Note: the effects of this feature are both subtle and precise, intended only for exacting detail. Make sure you can see exacting detail first.

Key Points: Source-match creates higher fidelity output with extra processing. Enable with SourceMatch = 1,2 or 3. Higher values are slower and more accurate. Can combine with Lossless setting (especially Lossless=2) for more detail again. Tweak speed with MatchPreset (like Preset). Will honor artefacts in source, so best used with quality sources. By default Sharpness becomes 0.2 & sharpness limiting (SLMode) is switched off, so adjust sharpness carefully.

Quickstart: The templates below increase in both quality and slowness. Choose a preset as required, the very fastest presets are not suitable though. The default Sharpness=0.2 but you may wish to increase it slightly. Set TR2=1 for clean source, set TR2=2 or TR2=3 (slower) if more denoising required or use noise processing

QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X ) # Basic mode, fastest
QTGMC( Preset=XXXX, SourceMatch=1, Sharpness=XXX, TR2=X, Lossless=2 ) # Good quality, efficient, minor residual combing
QTGMC( Preset=XXXX, SourceMatch=2, Sharpness=XXX, TR2=X ) # Good quality, slower, no combing
QTGMC( Preset=XXXX, SourceMatch=3, Sharpness=XXX, TR2=X, Lossless=2 ) # Best quality, slowest, very minor residual combing

Intuitively, a deinterlacer should just inject new fields into the source, leaving the original pixels untouched. The temporal blur/resharpen in this script means that doesn't happen - the source pixels are changed in the output. The (optional) source-match steps attempt to fix this and make the result closer to the source. They work by looking at the difference between output and source at different points in the algorithm and correcting for that difference.

Matching to the source will capture more source detail and reduce oversharpening / haloing. Caveat: the default algorithm temporally smooths but with source-matching much less so (by necessity / design). Source-matching may faithfully recreate artefacts in the source (e.g blocking, banding & some noise) so it's better for quality sources. The SourceMatch setting sets the mode: 0=off (standard [Q]TGMC algorithm), 1,2,3 for progressively more accurate but slower processing. Modes 2 & 3 restore almost exact source detail but are sensitive to noise & introduce occasional aliasing (mode 3 is less affected). Mode 1 is a more conservative halfway stage that rarely introduces artefacts.

Since source-matching recovers sharpness, the Sharpness default is reduced to 0.2. Source-matching may initially appear less sharp than standard processing because it will not oversharpen. However, be careful if raising the sharpness, because sharpness limiting is switched off by default. This is because sharpness limiting reduces the the accuracy of these modes. Use the MatchEnhance setting to exaggerate additional detail found by modes 2 & 3. This gives a sharpening / detail enhancing effect and works well at sensible levels - but it's a slight cheat that should be used with care as it can easily enhance noise. Since source-match is sensitive to source noise you may want to set TR2 to 2 or 3 and/or use some noise processing (see below).

The additional Lossless modes are designed to take source-match to its logical conclusion: Lossless mode 1 restores the *exact* pixels of the source into the output (provided NoiseRestore=0). This recovers a liitle more source detail but can introduce shimmering, minor combing, noise etc. Note the Sharpness and MatchEnhance settings have little effect in lossless mode 1. Lossless mode 2 makes the clip lossless before the sharpening & final temporal smooth. This removes most of the lossless artefacts and also allows sharpness control. This mode will not give an exactly lossless output but it will gain a little more detail.

The source-match settings introduce further processing. SourceMatch mode 1 requires a second interpolation (e.g. NNEDI3), but it can use a lower quality settings than the main stage. SourceMatch mode 2 requires yet another interpolation, but works effectively with just a bob (but using a better interpolator can reduce occasional aliasing). Mode 3 adds just a little more processing and is usually worth it as it reduces artefacts. There is no exact control over the interpolations used (too many settings required), instead there are MatchPresets that work in a similar way to the main Preset. The extra processing suggests much slower speeds, but actually using higher speed presets (both MatchPreset and Preset) with source-matching can give results comparable to slower presets without it. Having said that, the extra detail from source-matching is too subtle to significantly affect very high speed main presets.
{|
|-
| SourceMatch
| (0,1,2,3)
| 0 = Source-matching off (standard algorithm), 1 = basic source-match, 2 = refined match, 3 = twice refined match
|-
| Lossless
| (0,1,2)
| Puts exact source fields into result & cleans any artefacts. 0=off, 1=after final temporal smooth, 2=before resharpening. Adds some extra detail but: mode 1 gets shimmer / minor combing, mode 2 is more stable/tweakable but not exactly lossless. Default: '''0'''
|- align="center"
|colspan=2| <small>for SourceMatch=1,2,3</small>
|-
| MatchPreset
| (string)
| Speed/quality for basic source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Ideal choice is the same as main preset, but can choose a faster setting (but not slower). Default: '''3 steps faster than MatchPreset'''
|-
| MatchEdi
| (string)
| Override default interpolation method for basic source-match. Default method is same as main EdiMode setting (usually NNEDI3). Only need to override if using slow method for main interpolation (e.g. EEDI3) and want a faster method for source-match. Default: '''EdiMode'''
|- align="center"
|colspan=2| <small>for SourceMatch=2,3</small>
|-
| MatchPreset2
| (string)
| Speed/quality for refined source-match processing, select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" (no "Draft"). Faster settings are usually sufficient, but slower settings are useful if you get extra aliasing. Default: '''2 steps faster than MatchPreset'''
|-
| MatchEdi2
| (string)
| Override interpolation method for refined source-match. Can be a good idea to pick MatchEdi2="Bob" for speed. Default: '''NNEDI3'''
|-
| MatchTR2
| (0,1,2)
| Temporal radius for refined source-matching. 2=smoothness, 1=speed/sharper, 0=not recommended. Differences are very marginal. Basic source-match doesn't need this setting as its temporal radius must match TR1 core setting (i.e. there is no MatchTR1). Default: '''1'''
|-
| MatchEnhance
| (0.0...)
| Enhance the detail found by source-match modes 2 & 3. A slight cheat - will enhance noise if set too strong. Best set < 1.0. Default: '''0.5'''
|}

Defaults changes:
* MatchEdi is "Yadif" when MatchPreset="Ultra Fast"
* MatchEdi2 is "TDeint" when MatchPreset="Super Fast", or "Bob" when MatchPreset="Ultra Fast"

====Examples====

<pre>
QTGMC( Preset="Slow", SourceMatch=1 ) # Enable basic source-match. Result somewhat closer to source.
QTGMC( Preset="Slow", SourceMatch=1, Sharpness=0.4 ) # Basic source-match but sharper (up from 0.2). Be careful as sharpness limiting defaults to off
QTGMC( Preset="Slow", SourceMatch=1, Lossless=2 ) # Basic source-match with "fake" lossless. Efficient setting for quality, may bring minor combing

QTGMC( Preset="Medium", SourceMatch=2, TR2=2 ) # Refined source-match, closer to source with no combing, slower. Increased TR2 reduces noise

QTGMC( Preset="Slower", SourceMatch=3 ) # Twice refined source-match, higher quality than mode 2, but a little bit slower again
QTGMC( Preset="Slower", SourceMatch=3, Lossless=2 ) # Twice refined source-match with fake lossless. Almost perfect fidelity mode with few artefacts
QTGMC( Preset="Slower", SourceMatch=3, Lossless=1 ) # Twice refined source-match with true lossless. Exact detail, but likely combing and shimmer

QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75 ) # Further enhance detail found by refined match, a little sharper, may be noisier
QTGMC( Preset="Slow", SourceMatch=3, Lossless=2, MatchEnhance=0.75, NoiseProcess=1, NoiseRestore=0.7, Sigma=1.5 ) # As above, denoise a little to help

QTGMC( Preset="Slower", MatchPreset="Very Fast", SourceMatch=1 ) # Faster basic source-match preset (defaults to 3 steps faster than main Preset)
QTGMC( Preset="Slower", MatchPreset="Faster", MatchPreset2="Ultra Fast", SourceMatch=3 ) # Faster refined source-match preset as well
# (defaults to 2 steps faster than basic match Preset)
QTGMC( Preset="Slower", MatchPreset="Slow", MatchPreset2="Slow", SourceMatch=3 ) # Or use slower source-match presets (usually unnecessary)
</pre>

===Noise Bypass / Denoising===

Key Points: QTGMC can remove, retain or strengthen noise and very fine detail. Has automatic "EZ" settings for simple operation. Refer to examples below

The use of multiple temporal smooths means that this script denoises by default. QTGMC can extract some noise/grain from the source at the start, then optionally restore some of it back in again at the end. This allows either denoising, or for the grain/noise from the source to be retained. For simplest operation use one of the two automatic "EZ" modes, EZDenoise or EZKeepGrain (can only use one at once) and select a NoisePreset. For manual operation there are two modes: NoiseProcess=1 actually denoises at the start, whereas NoiseProcess=2 just identifies the noise in the source without removing it. NoiseProcess=1 is typically used for stronger denoising of the output, and NoiseProcess=2 is used to retain grain or for a very light denoise.

Manual operation: after selecting a mode, set a Sigma value to estimate the level of source noise. Use the ShowNoise setting to help in this choice. Then decide how much of that noise to restore after the deinterlace. There are two restore points called GrainRestore/NoiseRestore, the amount of noise restored depends on their sum. For full denoising set them both to 0. For grain retention, a good starting point is 0.7/0.3 for NoiseProcess=1, and 0.3/0.1 for NoiseProcess=2. GrainRestore restores more stable "grain-like" detail. NoiseRestore restores finer more fluctuating noise. Usually best if GrainRestore is greater than NoiseRestore unless you want a very noisy look. Too high restoral values will give grain exaggeration and even luma changes.

Important: You must use a non-zero value in one of EZDenoise, EZKeepGrain or NoiseProcess or no noise processing will occur
{|
|- align="center"
|colspan=2| <small>Quick Settings</small>
|-
| EZDenoise
| (0.0...)
| Automatic setting to denoise source. Set > 0.0 to enable. Higher values denoise more. Can use ShowNoise to help choose value. Default: '''0.0'''
|-
| EZKeepGrain
| (0.0...)
| Automatic setting to retain source grain/detail. Set > 0.0 to enable. Higher values retain more grain. A good starting point = 1.0. Default: '''0.0'''
|-
| NoisePreset
| (string)
| Automatic setting for quality of noise processing. Choices: "Slower", "Slow", "Medium", "Fast", and "Faster". Default: '''"Fast"'''
|- align="center"
|colspan=2| <small>Full Settings</small>
|-
| NoiseProcess
| (0,1,2)
| Bypass mode: 0 = disable, 1 = denoise source & optionally restore some noise back at end of script [use for stronger denoising], 2 = identify noise only & optionally restore some after QTGMC smoothing [for grain retention / light denoising]. Default: '''0''' (Very Slow: '''2''')
|-
| ChromaNoise
| (bool)
| When processing noise (NoiseProcess > 0), whether to process chroma noise or not (luma noise is always processed). Default: '''False'''
|- align="center"
|colspan=2| <small>Removing Noise</small>
|-
| Denoiser
| (string)
| Select denoiser to use for noise bypass / denoising. Select from "dfttest" or "fft3dfilter". dfttest is better, but slower. Unknown value selects "fft3dfilter". Default: '''fft3dfilter'''
|-
| DftThreads
| (0...)
| Number of threads to use if using "dfttest" for Denoiser, 0 = number of logical processors on system. Default: '''EdiThreads'''
|-
| DenoiseMC
| (bool)
| Whether to provide a motion-compensated clip to the denoiser for better noise vs detail detection (will be a little slower). Default: '''False'''
|-
| NoiseTR
| (0,1,2)
| Temporal radius used when analyzing clip for noise extraction. Higher values better identify noise vs detail but are slower. Default: '''1'''
|-
| Sigma
| (0.0...)
| Amount of noise known to be in the source, sensible values vary by source and denoiser, so experiment. Use ShowNoise to help. Default: '''2.0'''
|-
| ShowNoise
| (bool / 0.0...)
| Display extracted and "deinterlaced" noise rather than normal output. Set to true or false, or set a value (around 4 to 16) to specify contrast for displayed noise. Visualising noise helps to determine suitable value for Sigma or EZDenoise - want to see noise and noisy detail, but not too much clean structure or edges - fairly subjective. Pause the video when checking this. Default: '''False'''
|- align="center"
|colspan=2| <small>Restoring Noise</small>
|-
| GrainRestore
| (0.0...1.0...)
| How much removed noise/grain to restore before final temporal smooth. Retain "stable" grain and some detail (effect depends on TR2). Default: '''0.0''' (Very Slow: '''0.3''')
|-
| NoiseRestore
| (0.0...1.0...)
| How much removed noise/grain to restore after final temporal smooth. Retains any kind of noise. Default: '''0.0''' (Very Slow: '''0.1''')
|-
| NoiseDeint
| (string)
| When noise is taken from interlaced source, how to 'deinterlace' it before restoring. "Bob" & "DoubleWeave" are fast but with minor issues: "Bob" is coarse and "Doubleweave" lags by one frame. "Generate" is a high quality mode that generates fresh noise lines, but it is slower. Unknown value selects "DoubleWeave". Default: '''""'''
|-
| StabilizeNoise
| (bool)
| Use motion compensation to limit shimmering and strengthen detail within the restored noise. Recommended for "Generate" mode. Default: '''False'''
|}

* EZDenoise and EZKeepGrain set automatic values for NoiseProcess, NoiseRestore/GrainRestore and Sigma
* Denoiser, DenoiseMC, NoiseTR, NoiseDeint and StabilizeNoise settings are determined by NoisePreset
* If using manual settings be sure to override *all* the values you are interested in

====Examples====
<pre>
# Automatic Settings
QTGMC( Preset="Slower", EZDenoise=2.5, NoisePreset="Slow" ) # Automatic denoising, value is denoising strength, preset is quality/speed tradeoff
QTGMC( Preset="Slower", EZKeepGrain=1.0, NoisePreset="Faster" ) # Automatic grain retention - retain all source grain

# Denoising
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Sigma=4.0 ) # Fully denoise, strength of denoising depends on Sigma setting
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=0.0, Denoiser="dfttest", DenoiseMC=true, NoiseTR=2, Sigma=4.0 ) # More "accurate" denoising (slower)

# Retain Noise / Grain
QTGMC( Preset="Slower", NoiseProcess=1, NoiseRestore=1.0, Sigma=2.0 ) # Retain *all* the noise / fine detail of a less noisy source
QTGMC( Preset="Slower", NoiseProcess=1, GrainRestore=1.0, Sigma=2.0 ) # Similar to above but only keep the more "stable" noise elements (depends on TR2)

# Strong Detail / Grain
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.5, NoiseRestore=0.1, Sigma=2.5 ) # Using stronger mode 2, retains noise and sharpens slightly
QTGMC( Preset="Slower", NoiseProcess=2, GrainRestore=0.4, NoiseRestore=0.2, Sigma=1.8, \
NoiseDeint="Generate", StabilizeNoise=true ) # As above with better quality, more stable detail and grain
</pre>

===Progressive Input===

Key Points: Can remove horizontal shimmering effects from progressive sources. Experiment with InputType=1, 2 or 3 for best results. FPS will not be doubled

This script is designed for deinterlacing and so by default expects an interlaced clip. However, much of its operation concerns the reduction of horizontal shimmering. It is possible to use the script to remove similar shimmer from a progressive clip by using the InputType setting. InputType=1 is used for general progressive material that contains less severe problems. InputType=2,3 are designed for badly deinterlaced material with considerable horizontal artefacts. These modes drop half the fields and recreate an interlaced stream from the others, which is then treated in the normal way. Mode 3 differs from mode 2 only in that it complements field parity of the input. Generally mode 1 will retain more detail, but repair less artefacts than modes 2,3. You may consider setting TR2 to a higher value (e.g. 2 or 3) when repairing progressive material.

SourceMatch and Lossless modes are supported for progressive material. It works well for InputType=2,3, where the input is converted to an interlaced stream, and helps in detail retention. Source-match is much less useful for InputType=1

{|
|-
| InputType
| (0,1,2,3)
| Default = 0 for interlaced input. Settings 1,2 & 3 accept progressive input for deshimmer or repair. Frame rate of progressive source is not doubled. Mode 1 is for general progressive material. Modes 2 & 3 are designed for badly deinterlaced material. Default: '''0'''
|-
| ProgSADMask
| (0.0...)
| Only applies to InputType=2,3. If ProgSADMask > 0.0 then blend InputType modes 1 and 2/3 based on block motion SAD. Higher values help recover more detail, but repair less artefacts. Reasonable range about 2.0 to 20.0, or 0.0 for no blending. Default: '''10.0''' ('''0.0''' for "Fast" and faster.)
|}

====Examples====

QTGMC( Preset="Slower", InputType=1 ) # Process progressive source, it will be temporally smoothed / deshimmered
QTGMC( Preset="Slower", InputType=2, ProgSADMask=12.0 ) # Process progressive source with major artefacts, slightly favoring detail over repairs

===Shutter Speed Motion Blur / Frame Rate===

Key Points: Can output video at single or double-frame rate. For smoother playback of single-rate output there are settings to add light motion blur to simulate different shutter angles (shutter speeds)

By default QTGMC outputs video at "double-rate", twice the frame rate of the source. This is because there are two separate images (fields) in every frame, which the deinterlacing process restores in full. By setting FPSDivisor to 2, every second frame is dropped and the output frame rate is the same as the source ("single-rate")

Single-rate output may look a little stuttery, depending on how the source was filmed/created. Adding motion blur to each frame can help with this, smoothing the feel of the slower rate playback. This is done by setting ShutterBlur to 1,2 or 3, then specifying the shutter angle that you wish the output to simulate. However, as there may be some motion blur already in the source you also need to specify/estimate the shutter angle used in the source. Shutter angles range from 0 to 360, with 0 being perfectly sharp and 360 being fully blurred from one frame to next (artificial output shutter angles > 360 are supported to a very limited degree). Motion-blur can also be applied to double-rate output, but the effect is less noticable.

As motion analysis is block-based, motion blur of an object can "bleed" into surrounding, more static areas. This can be reduced using the slower ShutterBlur modes or by increasing the SBlurLimit setting (which is enabled and set to 4 by default). Both repair methods may reduce the level of motion blur a little though. In situations of complex motion the motion analysis can be incorrect, which can lead to inappropriate blurring.

{|
|-
| FPSDivisor
| (1,2...)
| 1 = Double-rate output, 2 = Single-rate output. Higher values can be used too (e.g. 60fps & FPSDivisor=3 gives 20fps output). '''Important:''' You do not need SelectEven() in the calling script if you use FPSDivisor=2. Default: '''1'''
|-
| ShutterBlur
| (0,1,2,3)
| 0 = Off, 1 = Enable, 2,3 = Higher precisions (slower). Higher precisions reduce blur "bleeding" into static areas a little. Default: '''0'''
|-
| ShutterAngleSrc
| (0...360)
| Shutter angle used in source. If necessary, estimate from motion blur seen in a single frame: 0=pin-sharp, 360=fully blurred from frame to frame. Default: '''180'''
|-
| ShutterAngleOut
| (0...360)
| Shutter angle to simulate in output. Extreme values may be rejected (depends on other settings). Cannot reduce motion blur already in the source. Default: '''180'''
|-
| SBlurLimit
| (0...)
| Limit motion blur where motion lower than given value. Increase to reduce blur "bleeding". 0=Off. Sensible range around 2-12. Default: '''4'''
|}

====Examples====

QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=30, ShutterAngleOut=180 ) # Smooth single-rate output, when input has little blur
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=1, ShutterAngleSrc=180, ShutterAngleOut=180 ) # Keep "film" look on single-rate output, "film" input
QTGMC( Preset="Slower", FPSDivisor=2, ShutterBlur=2, ShutterAngleSrc=180, ShutterAngleOut=180, SBlurLimit=8 ) # Same but srongly reduce blur "bleeding"
QTGMC( Preset="Slower", FPSDivisor=1, ShutterBlur=1, ShutterAngleSrc=0, ShutterAngleOut=720 ) # Blur some high shutter-speed footage, keep double rate
# [Use of artificially high shutter angles is limited]

===Miscellaneous Settings===

Settings not covered above. Note that Border is false by default, which differs from TempGaussMC

{|
|-
| Border
| (bool)
| Pad a little vertically while processing (doesn't affect output size) - set true you see flickering on the very top or bottom line of the output. If you have wider edge effects than that, you should crop afterwards instead. Be wary of this setting if reusing QTGMC motion vectors in the calling script. Default: '''False'''
|-
| Precise
| (bool)
| Set to false to use faster algorithms with *very* slight imprecision in places
|-
| Preset
| (string)
| Sets a range of defaults for different encoding speeds. Select from "Placebo", "Very Slow", "Slower", "Slow", "Medium", "Fast", "Faster", "Very Fast", "Super Fast", "Ultra Fast" & "Draft". Default: '''"Slower"'''
|-
| Tuning
| (string)
| Tweaks the defaults for different source types. Choose from "None", "DV-SD", "DV-HD". Default: '''"None"''' [An idea for development based on the x264 approach, but as I don't work with many source types it has seen little development]
|-
| ShowSettings
| (bool)
| Display all the current parameter values - useful to find preset defaults. Default: '''False'''
|-
| GlobalNames
| (string)
| The name used to expose intermediate clips to calling script. See External Linkage section. Default: '''QTGMC'''
|-
| PrevGlobals
| (string)
| What to do with global variables from earlier QTGMC call that match above name. Either "Replace", or "Reuse" (for a speed-up). Default: '''Undefined'''
|-
| ForceTR
| (0,1,2,3)
| Ensure globally exposed motion vectors are calculated to this radius even if not needed by QTGMC. 0 = disabled. Default: '''0'''
|}

Default for Precise depends on Preset.

==External Linkage==
===Accessing QTGMC Motion Vectors===
QTGMC now exposes its motion vectors and other intermediate clips to the calling script through global variables. These globals are uniquely named. By default they begin with the prefix "QTGMC_". The available clips are:

{|
|-
| Backward motion vectors
| bVec1, bVec2, bVec3 (temporal radius 1 to 3)
|-
| Forward motion vectors
| fVec1, fVec2, fVec3
|-
| Filtered clip used for motion analysis
| srchClip
|-
| MVTools "super" clip for filtered clip
| srchSuper
|}

Not all these clips are necessarily created - it depends on your QTGMC settings. To ensure motion vector creation to radius X, set ForceTR=X

====Example====

QTGMC( Preset="Medium", ForceTR=2, SubPel=2 ) # Ensure we get temporal radius of at least 2, read note below regarding SubPel
super = MSuper( pel=2, levels=1 ) # Faster to use levels=1, don't usually need more levels once you have the vectors
MDegrain2( super, QTGMC_bVec1,QTGMC_fVec1, QTGMC_bVec2,QTGMC_fVec2 ) # Use QTGMC-created motion vectors

====Important Notes====

* The SubPel setting to QTGMC must match the pel setting in MVTools or you will get visual errors or crashes. Default SubPel in QTGMC varies depending on Preset, "Medium" and quicker settings get SubPel=1, slower settings get SubPel=2. Default pel in MVTools is 2
* Do not use Border=true if using motion vectors in this way, or the clips exposed will have an 8 pixel border top and bottom (i.e. they won't match your source)

===Multiple QTGMC Calls===
The section above showed how global variables are used to expose the workings of QTGMC. However, if there are multiple calls to QTGMC in your script then you should consider whether they should work together with their exposed globals. By default the globals for each call to QTGMC will overwrite the globals from previous calls. However there are actually three options in this case:

* Use the setting GlobalNames to make unique global names for each call. E.g. if you set GlobalNames="TestA" you will receive a global called TestA_bVec1.
* Set PrevGlobals="Reuse" to reuse existing similar named globals for this run & not recalculate motion vectors etc. This will improve performance.
* Set PrevGlobals="Replace" to overwrite similar named globals from a previous run. This is the default and easiest option for most use cases.

Here's an artifical example of multiple calls in a script to show the options:

q1 = c.QTGMC( Preset="Medium" ) # QTGMC_bVec1 and similar variables are created
q2 = c.QTGMC( Preset="Medium" ) # Recalculates and replaces variables QTGMC_bVec1 and similar with new values (same as setting PrevGlobals="Replace")
q3 = c.QTGMC( Preset="Medium", PrevGlobals="Reuse" ) # Reuses QTGMC_bVec1 motion vectors from q2 above. Doesn't recalculate, improving performance
q4 = c.QTGMC( Preset="Medium", GlobalNames="TestA" ) # Creates new variables called TestA_bVec1...
q5 = c.QTGMC( Preset="Medium", GlobalNames="TestA", PrevGlobals="Reuse" ) # Reuses the TestA_bVec1 motion vectors

Here's a realistic example. This simple script repairs progressive material with very bad deinterlacing artefacts. It needs two calls to QTGMC:

t = QTGMC( Preset="Slower", InputType=2 )
b = QTGMC( Preset="Slower", InputType=3, PrevGlobals="Reuse" ) # Reuse motion vectors from first call for a good speed-up
Repair( t, b, 1 )

==TempGaussMC Notes==
In its default setup this script is very similar in operation to TempGaussMC_beta2. The call QTGMC() is very similar to:

TempGaussMC_beta2( 2,2,1, Border=false, SVthin=0.0 )

There are a few key differences:

* QTGMC typically uses "NNEDI3" for interpolation (TempGaussMC_beta2 uses "EEDI2" by default)
* Sharpness default in QTGMC is always 1.0 (or 0.2 if using source-match) - adjusted internally to give very roughly the same sharpness across settings / presets
* In QTGMC, SVThin defaults to 0, Border defaults to false
* Lossless and Draft modes are supported but in a different way
* The parameter order is the same up to EdiMode, a couple of 'lesser' parameters have had name changes for consistency

==Acknowledgements==
Thanks go to Didée for the script from where this began.

Also thanks to the plugin coders: Manao, Fizick, Tritical, Kassandro, Tsp, SEt, Tom Barry, Foxyshadis, TSchniede, Kurosu, mg262 and any others...

And to the many people who have given feedback, reported bugs and offered suggestions to help improve the script

==Changelog==
<pre>
# v3.357s
# - high bit depth now basically work in avs+
#
# v3.354s
# - added optional chikuzen PlanarTools for YUY2 using nonyuy2clipin/nonyuy2clipout in AnimeIVTC() v2.20
#
# v3.353s
# - added ndjamena suggestion for maximum temporal radius
# - added DftDither to controle dfttest dither Parameter
#
# v3.352s
# - added useEdiExt
# - added tr0=-1 to use the EdiExt clip (if there is no EdiExt clip then it will not work)
# - rep0 now will be 0 if tr0 < 1
#
# v3.347s
# - fix SourceMatch (bug after new YUY2 method, thanks to ndjamena for report it)
#
# v3.346s
# - EEDI3+NNEDI3 bug fix by ndjamena
# - Renamed DftThreads parameter to FftThreads, to set the ncpu argument of FFT3DFilter (from VS)
# - FFT3DFilter will work now in YUY2, use it with Denoiser="fft3df" (or use NoisePreset)
#
# v3.345s
# - work with SMDegrain_KNLMeansCL now to process chroma too
#
# v3.343s
# - edit in ChromaEdi
# - others
#
# v3.34s (mod) 2016 12 18 (ravewulf idea in another way)
# - Added yadifmod2 (if you need old one use it like this EdiMode="cYadif" or EdiMode="RepcYadif")
# - fast and clean up YUY2 (will work in x64 now, no need to SSETools)
#
# v3.33s (mod) 2016 12 06
# - Add TR2=4 and TR2=5
# - add TV_range bool and dither_luma_rebuild (from SMDegrain) Str and Amp
# - for avsplus now QTGMC_Bob is ready for any 420, not only yv12
#
# v3.33s (mod) 2016 04 11
# - Add KNLMeansCL as another Denoiser to NoiseProcess
# - others
#
# v3.33s (mod) 2016 01 19
# - make QTGMC_deflate/QTGMC_inflate work with YUY2 using masktool2 for avs 2.60
#
# v3.33s (mod) 2015 10 23
# - revert to QTGMC_deflate/QTGMC_inflate quoted from Dogway
#
# v3.33s (mod) 2015 9 10
# - fix Multiple QTGMC Calls
# - others fix
#
# v3.33s (mod) 2015 8 6
# - some changes in bob to speed up
#
# v3.33s (mod) 2015 8 4
# - fix bug in YUY2 with SourceMatch
# - add slice=false to ditherpost to avoid artefacts
#
# v3.33s (mod)
# - fix bob chroma
# - work with new masktool2 for avs 2.60 in YUY2
#
# v3.33d (mod)
# - Added 32 bit precision option through the lsbd (for dfttest and knlmeanscl) and lsb (mdegrain) options.
# - optimized some mask handling a bit as originally suggested by Vit
# - others
#
# v3.33
# - Increased maximum value for Rep0, Rep1 and Rep2 to 7 (from 5). Higher values help with flicker on static detail, potential for minor motion blur
# - Bug fix for the fact that Bob always outputs a BFF clip regardless of field order of input (thanks ajp_anton)
# - Improved generation of noise (NoiseDeint="Generate") for noise bypass / EZKeepGrain
# - Minor change to denoising
#
# v3.32
# - Bugfix with shutter blur and ChromaMotion (thanks Heaud)
# - Tweaked vector recalculation for shutter motion blur
# - Changed defaults for TR2 when using source-match
# - Minor bugfix with SLMode/SLRad on pass-through settings
</pre>

==External Links:==
*[http://www.spirton.com/uploads/QTGMC/QTGMC-3.32-Spanish.rar Spanish Instructions (3.32)] by Overdrive80
*[http://forum.doom9.org/showpost.php?p=1732845&postcount=2041 QTGMC-3.33s] by A.SONY

<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Deinterlacing|External Filters]] ←'''

Dither tools

2019-09-14T00:38:23Z

AmjadSONY:

[[Category:External_filters]]
[[Category:Deep_color_tools]]
'''Dither — high-bit-depth tools for AviSynth'''

This package offers a set of tools to manipulate Stacked Hacked [[High_bit-depth_Support_with_Avisynth|high-bit-depth]] (16 bits per plane) video clips. The most prominent features are color banding artifact removal, dithering to 8 bits, colorspace conversions and resizing.

Additionally, some existing filters ([[dfttest]], MDegrain from [[MVTools]], etc) have been modified to handle 16-bit clips. See [[High_bit-depth_Support_with_Avisynth|High bit-depth Support with Avisynth]] for more information.

{{Filter
|Firesledge (aka {{Author/cretindesalpes}})
|1.27.2
|[http://ldesoras.free.fr/prod.html#src_ditheravsi http://ldesoras.free.fr/prod.html]
|[[:Category:Deep_color_tools|Deep color tools]]
|[[Planar]] colorspace,
* [[MaskTools2|Masktools 2]] '''alpha 48''' or later ([https://github.com/tp7/masktools/releases tp7 version] strongly recommended),
* [[RemoveGrain]] 1.0b “beta” or later (same here, use the [[RgTools]] version),
* [[AddGrainC]] 1.5.1 or later
|[http://www.wtfpl.net/ WTFPL]
|7=[http://forum.doom9.org/showpost.php?p=1386559 doom9.org]
}}

=== Formats ===
As Avisynth (not AvisynthPlus) doesn't support natively high bit-depth, a specific format named [[Stack16]] aka lsb is introduced. The picture is made of two parts, one containing the highest 8 bits (MSB) stacked on top of another containing the lowest 8 bits (LSB) for each pixel. When previewing the video stored in stack16 format, the top part looks quite like the original picture and the bottom one generally looks like psychedelic garbage.

Some functions may also use an MSB/LSB decomposition as interleaved aka Double-Width pictures, but this format should be considered deprecated and is only supported for backward compatibility.

Finally, there are a few other formats made specifically for encoding, allowing Avisynth to send more than 8 bits per plane by faking raw data characteristics on the codec side.

When working with 16-bit clips, it’s important to know exactly which format a function takes as input and output. Specifically, you cannot process directly 16-bit clips with the usual 8-bit Avisynth filters, because they will interpret the LSB and MSB parts as regular data and mess everything. However there are various workarounds to mix 8- and 16-bit processing with minimal quality loss, please refer to the example section.

Outputting [[High_bit-depth_Support_with_Avisynth|high-bit-depth]] clips to encode in 10 bits or more has become possible and is now quite common and supported by various encoding tools. However there is no practical mean to load a high-bit-depth media into Avisynth at this time. Regardless, [http://github.com/SAPikachu/ SAPikachu] hacked [[FFmpegSource|FFmpegSource2]] to load 10-bit clips using a special parameter ''enable10bithack=true'', resulting in stack16 output. See the latest ffms2 release [http://www.sapikachu.net/%E8%BF%91%E6%9C%9Fep%E4%BD%9C%E5%93%81%E6%B1%87%E6%80%BB/ here]. Patch source code [https://github.com/SAPikachu/ffms2_hacks/ here].

=== Debanding and dithering ===
The main reason this package has been made is to address the color banding problem. Color banding generally occurs on low gradients or almost flat colors covering large areas, which is often the case in cartoons and animes. Because of the limited video bit-depth, the gradient color values show staircases in its curve, making apparent the discontinuity between two adjacent color steps.

These artifacts can appear at various stages:

* It can be already present in the source,
* created during a filtering pass
* or added by the final codec because of bitrate starvation or inappropriate encoding settings.

Debanding functions helps to remove the banding from a source. Using high-bit-depth processing prevents the banding from appearing during filtering. Finally, appropriate dithering helps to avoid banding during the conversion to 8 bits and the encoding stage.

Generally, film grain and video noise act as natural dithering. Filtering them out also removes this dithering and thus creates color banding. That’s why some denoising filters have been modified, in order to work as reversed dithering, outputting smooth 16-bit gradients from a noisy 8-bit source.

=== Colorspace conversions ===
Using 16-bit data helps working with curves without creating steps or holes in the histogram, which often are a sign of color banding. Colorspace conversion has the same kind of issues, and benefits from accurate 16-bit calculations too.

It makes possible to handle the picture information in “linear light” (without gamma correction), increasing the accuracy of some operations when processing pictures exhibiting high contrast.

=== Content ===
The functions are spread across dither.dll and dither.avsi. There are other files:

* mt_xxpand_multi.avsi, containing utility functions not specifically related to dithering (they rather are [[MaskTools2|Masktools]] extensions).
* [[AVSTP|avstp.dll]], to make dither.dll support native multi-threading. If this avstp is missing, the functions will still work but will be limited to single-threading only.

You may already have obtained them by other means. Put all these files in your AviSynth 2.5\plugins\ directory. The package also contains [[Modulo|“mod16”]]-modified denoising plug-ins to directly generate 16-bit data in a much more efficient way.

Functions implemented in dither.dll should be compatible with all the MT modes (including mode 1) and accept any planar colorspace. On this topic, scripted functions are limited by their external dependencies. YV12 colorspace and MT mode 2 should always work fine, anyway.

=== Considerations ===
If you’re going [http://forum.doom9.org/showthread.php?t=148782 multi-threaded using the MT command], make sure you have set ''splitvertical''=true for two reasons:

* The functions may have to change the clip height
* Stacked LSB and MSB of a given pixel must not be separated.

== Examples of use ==
=== Use of modified denoisers ===
There are specifically modified denoising plug-ins allowing 16-bit output (I called them [[Modulo|“mod16”]]), currently [[dfttest]], [[MVTools|MDegrain1, MDegrain2 and MDegrain3]]. They are included in the Dither package and can safely replace the regular versions, when up-to-date. Use the named parameter ''lsb=true'' to enable 16 bit output. Then, MSB is stacked on top of the LSB.

dfttest (lsb=true) # The output contains stacked MSB-LSB on the same frame.
DitherPost ()

=== Transdithering using a non-modified temporal denoiser ===
An effective but very slow way to remove low noise while avoiding the introduction of color banding artifacts and keeping an excellent compressability. Actually, better quality could be achieved with motion compensation but this is not the scope of this example. It shows how to use Dither2Pre to create a 16-bit clip with a 8-bit denoiser. Here, the default TTempSmooth parameters have been multiplied by 4 to adapt to the internal scale of pixel values.
<pre>o = last
Dither2Pre (
\ "TTempSmooth (lthresh=16, cthresh=20, lmdiff=8, cmdiff=12, scthresh=48)",
\ overlap=0, tvopt=true)
ref = last
mask = DitherPost (mode=-1).mt_edge (mode="min/max", thY1=0, thY2=255, thC1=0, thC2=255)
mask = mask.mt_binarize (1, u=3, v=3).mt_expand (u=3, v=3).mt_expand (u=3, v=3)
mask = mask.RemoveGrain (20).RemoveGrain (20)
Dither_bilateral16 (radius=16, thr=1.5, wmin=1, flat=0.75)
Dither_bilateral16 (radius=8, thr=2.5, wmin=1, flat=0.33, ref=ref)
Dither_limit_dif16 (ref, thr=0.3)
DitherPost ()
mt_merge (last, o, mask, u=3, v=3)
</pre>
=== Combining 8- and 16-bit processing ===
==== Generic method ====
There is often a need to mix 8- and 16-bit processing because only a few filters are available in 16 bits. Below is a little template to achieve this. This is not a perfect solution but work quite well. It’s possible to lower a bit the Dither_limit_dif16 ''thr'' parameter. You can repeat the steps as many times you need to alternate 8 and 16 bits.

<pre>dfttest (lsb=true) # or whatever generating stack16 data

# Insert 16-bit filters here

s16 = last
DitherPost (mode=-1)

# Insert 8-bit filters here

Dither_convert_8_to_16 ()
s16.Dither_limit_dif16 (last, thr=1.0, elast=2.0)

# Insert 16-bits filters again…

# Finally
DitherPost () # or Dither_out ()
</pre>
==== Filtering in 16 bits with basic sharpening ====
The example below shows how to use a 8-bit sharpener with a 16-bit clip. This method guarantees that the dithering pattern will not be sharpened. This is an alternative method to the proposed above. The rationale is: going back to 8-bit without dithering (mode = -1), doing stuff, compute the difference between processed and unprocessed clips, dither the 16-bit clip and add the previously computed difference to the result. This method can be applied to some other kinds of processing.

<pre>dfttest (lsb=true)
f = DitherPost (mode=-1)
s = f.Sharpen ()
d = mt_makediff (s, f)
DitherPost ()
mt_adddiff (last, d, u=2, v=2)
</pre>
=== Debanding a clip ===
Without filtering:

GradFun3 ()

Advanced multi-pass filtering for a source containing both noise and banding. This script requires the modified version of the MVTools2.

<pre># Your favourite 8-bit denoiser here, doing the main job
denoised = dfttest (sigma=16)

# Restores a bit of noise
mt_lutxy (last, denoised, expr="x y < y 1 - x y > y 1 + y ? ?", y=3, u=3, v=3)

super = last.MSuper ()
super_a = denoised.MSuper ()

# You could also reuse the vectors found in a previous processing stage
vf1 = super_a.MAnalyse (isb=false, delta=1, overlap=4, blksize=16)
vb1 = super_a.MAnalyse (isb=true, delta=1, overlap=4, blksize=16)

# Turns remaining noise into 16-bit gradients
cf1 = MCompensate (super, vf1, thSAD=200)
cb1 = MCompensate (super, vb1, thSAD=200)
Interleave (cf1, last, cb1)
dfttest (sigma=1.0, tbsize=3, lsb=true)
SelectEvery (3, 1)

# Additional smoothing pass and back to 8 bits
GradFun3 (thr=0.25, lsb_in=true)
</pre>
When a clip contains sharpening overshoots, the color banding may be resilient to [[GradFun3]], even with high thresholds (> 1.5). The following script helps to remove it without loosing too much details. You may have to adapt some values. Display mask_details.GreyScale() to check the mask. It shouldn’t show the color band boundaries (or just marginally).

<pre>lvl_overshoot = 3.5
lvl_details = 2

o = last
w = Width ()
h = Height ()

edges = mt_edge (mode="prewitt", thY1=0, thY2=255)
details = mt_edge (mode="min/max", thY1=0, thY2=255)

mask_lines = edges.mt_lut ("x 6 - 50 *")
mask_lines = mask_lines.mt_expand ().mt_expand ().mt_expand ().mt_expand ()
mask_overshoot = edges.mt_lut ("x "+String(lvl_overshoot)+" - 2 ^ 40 *")
mask_overshoot = mask_overshoot.mt_inpand ().RemoveGrain (12, -1)
mask_overshoot = mt_logic (mask_overshoot, mask_lines, mode="max")
mask_details = details.mt_binarize (lvl_details)
mask_details = mask_details.RemoveGrain (21 ,-1).mt_expand ()
mask_final = mt_logic (mask_overshoot, mask_details, mode="min")
mask_final = mask_final.RemoveGrain (20, -1).RemoveGrain (20, -1)

o
BicubicResize (w/16 * 4, h/16 * 4, 1, 0).BicubicResize (w, h, 1, 0)
GradFun3 (radius=4, thr=0.6, mask=0, mode=6) # Huge blur
mt_merge (last, o, mask_overshoot, luma=true) # W/o overshoot
GradFun3 (thr=0.6, mask=0) # W/o banding
mt_merge (last, o, mask_final, luma=true) # Details protected
</pre>
=== Working with curves ===
The following examples are designed for TV-range data (luma in 16–235).

Denoises very slightly, debands and protects the darkest shades by increasing the dynamic range for low luma values:

<pre>a = 0.5 # The smaller, the greater the protection
sa = String (a)
sd = String (Pow (219*256, 1 - 1.0/a))
dfttest (sigma=0.25, lsb=true)
Dither_lut16 ("x 4096 - 0 max "+sd+" / "+sa+" ^", y=3, u=2, v=2) # Direct
SmoothGrad ()
Dither_lut16 ("x 1 "+sa+" / ^ "+sd+" * 4096 +", y=3, u=2, v=2) # Inverse
DitherPost ()
</pre>
Blending 8-bit pictures in linear light:

<pre># Blending amount for the first clip
bl = 0.75
bls1 = String ( bl)
bls2 = String (1 - bl)

# 8-bit clips converted to linear 16-bit full range (gamma undone)
ug = " 16 - 0 max 1.41624 / 2.2 ^ "

# Redo the gamma, result in 16 bits YUV
rg = " 0.454545 ^ 362.5585 * 4096 +"

# Blend
Dither_lutxy8 (src1, src2,
\ expr ="x " + bls1 + " * y " + bls2 + " * + 256 *",
\ yexpr="x" + ug + bls1 + " * y" + ug + bls2 + " * +" + rg,
\ y=3, u=3, v=3)

# Back to 8 bits
DitherPost ()
</pre>
=== Resizing in 16 bits ===
Simple resize:

Dither_convert_8_to_16 ()
Dither_resize16 (1280, 720)
DitherPost ()

Sharpening the luma using the convolver of the resizer:

Dither_convert_8_to_16 ()
Dither_resize16 (Width (), Height () / 2, kernel="impulse -1 6 -1",
\ fh=-1, fv=-1, cnorm=true, center=false, y=3, u=2, v=2)
DitherPost ()

Restoring the original size of a picture using kernel inversion:

<pre># Input in 8 bits
w = Width () # Original size
h = Height () #
BilinearResize (w * 3 / 2, h * 3 / 2) # Upscale

Dither_convert_8_to_16 ()
Dither_resize16 (w, h, kernel="bilinear", invks=true)
DitherPost ()
</pre>
Resizing in linear light with protection against ringing:

<pre># Y'Cb'Cr' input in 16 bits
Dither_convert_yuv_to_rgb (matrix="709", output="rgb48y", lsb_in=true)
Dither_y_gamma_to_linear (tv_range_in=false, tv_range_out=false, curve="709", sigmoid=true)
Dither_resize16nr (1280, 720, kernel="spline36")
Dither_y_linear_to_gamma (tv_range_in=false, tv_range_out=false, curve="709", sigmoid=true)
r = SelectEvery (3, 0)
g = SelectEvery (3, 1)
b = SelectEvery (3, 2)
Dither_convert_rgb_to_yuv (r, g, b, matrix="709", lsb=true)
# Y'Cb'Cr' output in 16 bits
</pre>
=== Colorspace conversions ===
Color conversions of 8-bit clips:

BlankClip () # Assumes RGB
Dither_convert_rgb_to_yuv ()
Dither_convert_yuv_to_rgb ()

Upscaling in 16 bits a SD video to HD with correct color matrix conversion (slow way), output dithered to 8 bits ready for encoding:

MPEG2Source ("video_sd.d2v")
Dither_convert_8_to_16 ()
Dither_resize16 (1280, 720)
Dither_convert_yuv_to_rgb (matrix="601", output="rgb48y", lsb_in=true)
r = SelectEvery (3, 0)
g = SelectEvery (3, 1)
b = SelectEvery (3, 2)
Dither_convert_rgb_to_yuv (r, g, b, matrix="709", lsb=false, mode=0)

Another possibility, with the resizing function operating in RGB land:

MPEG2Source ("video_sd.d2v")
Dither_convert_yuv_to_rgb (matrix="601", output="rgb48y")
Dither_resize16 (1280, 720, y=3, u=1, v=1)
r = SelectEvery (3, 0)
g = SelectEvery (3, 1)
b = SelectEvery (3, 2)
Dither_convert_rgb_to_yuv (r, g, b, matrix="709", lsb=false, mode=0)

Displaying a preview of a YUV stream with automatic matrix detection, conversion to sRGB with correct transfer curve, non-ringing scaling to 1080 lines in RGB linear colorspace and anamorphic correction:

MPEG2Source ("anything.d2v")
Dither_srgb_display (h=1080, dar=1.778) # or 1.333 for 4:3 AR

=== Special output to high-bit-depth ===
Simple denoising, quick debanding and direct 16-bit output for x264-10bit. Make sure reading the important remarks in the Dither_out function description:

dfttest (lsb=true)
SmoothGrad ()
Dither_out ()

Same as above, but outputting 10-bit data aligned on 16-bit words (still needs --input-depth 16 in x264. Use ''reducerange=true'' for real 10-bit input):

dfttest (lsb=true)
SmoothGrad ()
Dither_quantize (10, mode=6)
Dither_out ()

Simple debanding with RGB48 output (needs specific encoding step):

Dither_convert_8_to_16 ()
SmoothGrad ()
Dither_convert_yuv_to_rgb (lsb_in=true, output="rgb48y")
r = SelectEvery (3, 0)
g = SelectEvery (3, 1)
b = SelectEvery (3, 2)
Dither_convey_rgb48_on_yv12 (r, g, b)

== Common parameters ==
Exactly like [[MaskTools2|Masktools 2]], Dither has functions sharing common parameters.

;int y (3), int u (3), int v (3)

: These three values describe the actual processing mode that is to be used on each plane / channel. Here is how the modes are coded:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''-255...0 or -65535...0'''
| style="border:none;padding:0.0194in;"| All the pixels of the plane will be set to -x. The range depends whether the output clip is a stack16 or a regular 8-bit clip.
|-
| style="border:none;padding:0.0194in;"| '''1'''
| style="border:none;padding:0.0194in;"| The plane will not be processed. That means the content of the plane after the filter is pure garbage.
|-
| style="border:none;padding:0.0194in;"| '''2'''
| style="border:none;padding:0.0194in;"| The plane of the first input clip will be copied.
|-
| style="border:none;padding:0.0194in;"| '''3'''
| style="border:none;padding:0.0194in;"| The plane will be processed with the processing the filter is designed to do.
|-
| style="border:none;padding:0.0194in;"| '''4'''
| style="border:none;padding:0.0194in;"| When applicable, the plane of the second input clip will be copied.
|-
| style="border:none;padding:0.0194in;"| '''5'''
| style="border:none;padding:0.0194in;"| When applicable, the plane of the third input clip will be copied.
|}
Unlike Masktools 2, all the planes are processed by default.

== Filters description ==
=== DitherPost ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">DitherPost (
clip m,
clip clsb (undefined),
int mode (0),
float ampo (1),
float ampn (0),
int pat (1),
bool dyn (false),
bool prot (false),
clip mask (undefined),
float thr (-1),
bool stacked (true),
bool interlaced (false),
int y (3),
int u (3),
int v (3),
bool staticnoise (false),
bool slice (true)
)
</pre>
Adds the dither, turning a 16-bit clip generated by Dither1Pre, Dither2Pre or a mod16 denoiser into a regular 8-bit clip.

Pure ordered dithering seems to be retained better than noise or error diffusion during video compression. Therefore this is the recommended method to avoid color banding, unless you encode at very high bitrates. If you don’t care about video compression, error diffusion gives the most accurate results. To avoid discontinuities between purely flat areas and dithered areas, you can add a bit of noise.

Important note: the colorbanding removal is not done by the dithering stage, but by the filtering stage. The latter rebuilds the fine gradients in the 16-bit land. The dithering helps converting the picture data to something watchable, in 8 bits, while preserving a preceptually high colordepth, thus preventing the colorbanding to appear.

;m
:If ''clsb'' is defined, contains the main picture data (MSB). If ''clsb'' is not defined, it contains both MSB and LSB clips as interleaved frames (same format as the first pass output), or as stacked frames, depending on the ''stacked'' value.

;clsb
:Contains the residual information (LSB) if defined.

;mode
:Dithering method:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''-1'''
| style="border:none;padding:0.0194in;"| no dither, round to the closest value
|-
| style="border:none;padding:0.0194in;"| '''0'''
| style="border:none;padding:0.0194in;"| 8-bit ordered dither + noise.
|-
| style="border:none;padding:0.0194in;"| '''1'''
| style="border:none;padding:0.0194in;"| 1-bit dither
|-
| style="border:none;padding:0.0194in;"| '''2'''
| style="border:none;padding:0.0194in;"| 2-bit dither, light
|-
| style="border:none;padding:0.0194in;"| '''3'''
| style="border:none;padding:0.0194in;"| 2-bit dither, medium
|-
| style="border:none;padding:0.0194in;"| '''4'''
| style="border:none;padding:0.0194in;"| 2-bit dither, strong
|-
| style="border:none;padding:0.0194in;"| '''5'''
| style="border:none;padding:0.0194in;"| 2-bit dither, stronger
|-
| style="border:none;padding:0.0194in;"| '''6'''
| style="border:none;padding:0.0194in;"| Serpentine Floyd-Steinberg error diffusion + noise. Well-balanced algorithm.
|-
| style="border:none;padding:0.0194in;"| '''7'''
| style="border:none;padding:0.0194in;"| Stucki error diffusion + noise. Looks “sharp” and preserve light edges and details well.
|-
| style="border:none;padding:0.0194in;"| '''8'''
| style="border:none;padding:0.0194in;"| Atkinson error diffusion + noise. Generates distinct patterns but keeps clean the flat areas.
|}
Modes 1 to 5 have no real interest over mode 0 and can be considered deprecated.

;ampo
:The ordered dither peak-to-peak amplitude, on an 8 bit scale. = 0. On error diffusion algorithms, it increases the collected error amount, helping to extend the range of the dithering while preserving its natural pattern (especially Atkinson’s). This gives a better looking result than just adding noise.

;ampn
:The noise peak-to-peak amplitude, on an 8 bit scale. = 0. Currently, the maximum value is 4.

;pat
:is the dither pattern type for 2-bit dither:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''0'''
| style="border:none;padding:0.0194in;"| Regular
|-
| style="border:none;padding:0.0194in;"| '''1'''
| style="border:none;padding:0.0194in;"| Alternate V
|-
| style="border:none;padding:0.0194in;"| '''2'''
| style="border:none;padding:0.0194in;"| Alternate H
|}

;dyn
:Indicates if the ordered dither pattern is dynamic. If so, the pattern is rotated each frame.

;prot
:Enables the protection against MSB-LSB inconsistencies, which can occur when the main picture (MSB only) is processed.

;mask
:If defined, dithering is applied where the pixel values are lower than 128. Must be defined for all the planes. You can build the mask with [[#DitherBuildMask|DitherBuildMask]].

;thr
:Threshold below which no dither occurs, in pixel value units on an 8 bit scale. It helps to keep calm flat areas where the LSB content is just low-level residual noise. Works only for dithering mode 0. Ranges from 0 to 0.5. -1 = disabled.

;stacked
:When ''clsb'' is undefined, true indicates that the clip is composed of the MSB part stacked on top of the LSB part. false indicates that MSB and LSB are interleaved.

;interlaced
:Indicates that the clip is interlaced and that the dither should be applied on each field separately.

;staticnoise
:If set to true, the noise generated with ''ampn'' is static.

;slice
:Set it to false to disable plane slicing. Slicing is used in multithreading and can create artifacts at slice boundaries with error-diffusion algorithms. Disabling slicing reduces the threading performances.

Category: dll.

=== DitherBuildMask ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">DitherBuildMask (
clip cnew,
clip cold (undefined),
int edgelvl (8),
int radius (2)
)
</pre>
This function builds a mask to use in [[#DitherPost|DitherPost]]. It helps avoiding artifacts during the dithering when the picture was processed between the [[Dither_tools#Dither1Pre.2C_Dither2Pre|DitherXPre]] and DitherPost operations. It also helps to preserve detailed areas from dithering. Call this function right before DitherPost and pass the result in the mask parameter.

;cnew
:The MSB part of the processed clip.

;cold
:The original MSB part of the clip. If this argument is specified, cold must be of the same size as cnew. Pixel which are different are set in the mask and are expanded like the edges.

;edgelvl
:Threshold for the edge detection (0–255). The lower, the more edges it detects.

;radius
:Minimum distance in pixels separating the dithered zones from the detected edges and potential artifacts (1–8).

Category: script.

=== SmoothGrad ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">SmoothGrad (
clip m,
clip clsb (undefined),
int radius (16),
float thr (0.25),
bool stacked (true),
clip ref (undefined),
float elast (3),
int y (3),
int u (3),
int v (3)
)
</pre>
SmoothGrad smooths the low gradients or flat areas of a 16-bit clip. It proceeds by applying a huge blur filter and comparing the result with the input data for each pixel. If the difference is below the specified threshold, the filtered version is taken into account, otherwise the input pixel remains unchanged.

;m
:If ''clsb'' is defined, contains the main picture data (MSB). If ''clsb'' is not defined, it contains both clips. In this case, its format depends on the ''stacked'' parameter.

;clsb
:Contains the residual information (LSB) if defined.

;radius
:Radius in pixels of the smoothing filter. > 0.

;thr
:Threshold between reference data and filtered data, on an 8-bit scale. > 0.

;stacked
:When ''clsb'' is undefined, true indicates that the clip is composed of the MSB part stacked on top of the LSB part. False indicates that MSB and LSB are interleaved.

;ref
:Reference clip for the filter output comparison. Specify here the input clip when you cascade several [[#SmoothGrad|SmoothGrad]] calls. It is always a stacked or interleaved LSB/MSB combination, depending on the ''stacked'' parameter. When undefined, the input clip is taken as reference.

;elast
:To avoid artifacts, the threshold has some kind of elasticity. Value differences falling over this threshold are gradually attenuated, up to ''thr'' * ''elast'' > 1.

Category: dll.

=== GradFun3 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">GradFun3 (
clip src,
float thr (0.35),
int radius (12),
float elast (3),
int mask (2),
int mode (undefined),
float ampo (undefined),
float ampn (undefined),
int pat (undefined),
bool dyn (undefined),
float dthr (undefined),
int smode (0),
float wmin (1.0),
float thr_det (2),
float thr_edg,
int debug (0),
float subspl (0),
bool lsb (false),
bool lsb_in (false),
bool staticnoise (undefined),
float thrc (thr),
int radiusc (radius),
float elastc (elast)
int y (3),
int u (3),
int v (3),
clip ref,
bool slice (true)
)
</pre>
This function is equivalent to GradFun2db and helps removing the existing color banding from a source, dithered or not. The default dithering pattern is ordered and should be more resilient to lossy codec quantification than the other patterns. But to keep all the advantages of the gradient smoothing and dithering, you should make GradFun3 the very last filter of your encoding chain, or use masking methods to safeguard the dither patterns.

;src
:The input clip.

;thr, thrc
:Filter threshold. Below this value, the changes made by the banding filter on pixel values are not attenuated. The higher, the more effective the filter will be, but details will be smoothed and artifacts will appear near the edges between two flat areas. ''thrc'' is the parameter for the chroma planes. Keep it below 1.0. Range: 0.1–10.0.

;radius, radiusc
:Filter radius, in pixels. Basically, this is the extent of artifical gradient introduced on the band edges. ''radiusc'' is the parameter for the chroma planes. The default value is tuned for SD video and 720p, but you might probably want to increase it to 16 for 1080p video. Range: 1–68 for ''smode=0'', 1–128 for ''smode=1'' and = 3 for ''smode=2''.

;elast, elastc
:Elasticity of the filter attenuation. It’s a multiplier on the threshold. A pixel difference above ''thr'' * ''elast'' won’t have any effect. ''elastc'' is the parameter for the chroma planes. Good values are in the range 1.25–4.

;mask
:Depth in pixels of the detail/edge masking. Set it to 0 to disable it.

;thr_det
:Local contrast threshold for detail detection and masking. The lower, the better the details will be protected, but the lower the smoothing efficiency. Must be > 0, and above the height of a color-banding step. When kept unspecified, it more or less follows the main debanding threshold ''thr''.

;thr_edg
:Unused. Kept for backward compatibility purpose.

;smode
:Indicates which filter to use for gradient smoothing.
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''0'''
| style="border:none;padding:0.0194in;"| Box filter. Very fast, whatever the radius. Drawback: can introduce slight but large halos, especially with high thresholds.

|-
| style="border:none;padding:0.0194in;"| '''1'''
| style="border:none;padding:0.0194in;"| <code>dfttest</code>. Much slower, but less prone to artefacts and halos than the box filter. This is the prefered mode for high quality results with acceptable processing time.

|-
| style="border:none;padding:0.0194in;"| '''2'''
| style="border:none;padding:0.0194in;"| Bilateral filter. Very slow, and slower for bigger radius, but much less prone to artefacts than the box filter. Almost haloless, even for high thresholds.

|-
| style="border:none;padding:0.0194in;"| '''3'''
| style="border:none;padding:0.0194in;"| Undocumented mode.

|}

;wmin
:For ''smode'' 2 (bilateral filter), this parameter prevents the filter to totally flatten the small areas of nearly uniform color. It ranges between 0.0 (normal bilateral filtering) and 1.0 (protection fully activated).

;debug
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''0'''
| style="border:none;padding:0.0194in;"| Normal output, without debugging information.

|-
| style="border:none;padding:0.0194in;"| '''1'''
| style="border:none;padding:0.0194in;"| Shows the detail/edge mask.

|}

;subspl
:Subsampling rate for the bilateral filter. Set it to 0 to adjust it automatically to the radius. Disable it with 1. Normal subsampling values should be greater or equal to 4. The maximum value depends on the radius.

;lsb
:When set to true, leaves the 16-bit data instead of dithering them to 8 bits.

;lsb_in
:When set to true, works on 16-bit input.

;ref
:Reference clip used to limit changes. Allows cascading multiple GradFun3 calls (for example by combining small and large radius settings) without going too far from the original picture. ''ref'' must have the same format as the input clip. When not specified, the reference clip is the input.

;other parameters
:The other parameters are directly transmitted to DitherPost. ''dthr'' is translated to ''thr''.

Here is a table showing the equivalent parameters in GradFun3 and GradFun2DBmod:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| <div align="right">'''GradFun3'''</div>
| style="border:none;padding:0.0194in;"| <center>'''Conversion'''</center>
| style="border:none;padding:0.0194in;"| <center>'''GradFun2DBmod'''</center>

|-
| style="border:none;padding:0.0194in;"| <div align="right">''thr''</div>
| style="border:none;padding:0.0194in;"| <nowiki>= 0.3 *</nowiki>
| style="border:none;padding:0.0194in;"| ''thr''

|-
| style="border:none;padding:0.0194in;"| <div align="right">''mask''</div>
| style="border:none;padding:0.0194in;"| <nowiki>=</nowiki>
| style="border:none;padding:0.0194in;"| ''radius''

|-
| style="border:none;padding:0.0194in;"| <div align="right">''thr_det''</div>
| style="border:none;padding:0.0194in;"| <nowiki>=</nowiki>
| style="border:none;padding:0.0194in;"| ''range''

|}
Category: script.

=== Dither_box_filter16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_box_filter16 (
clip src,
int radius (16),
int y (3),
int u (3),
int v (3)
)
</pre>
Performs a box filtering on the input clip. Box filtering consists in averaging all the pixels in a square area whose center is the output pixel. This filter is very fast to compute and its speed doesn’t depend on its radius. You can approximate a large gaussian filtering by cascading a few box filters.

Both input and output are vertically stacked 16-bit clips.

;src
:Input clip to be filtered.

;radius
:Size of the averaged square. Its width is radius*2-1. Range: 2–91.

Category: dll.

=== Dither_bilateral16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_bilateral16 (
clip src,
clip ref (undefined),
int radius (16),
float thr (2.5),
float flat (0.4),
float wmin (0.0),
float subspl (0),
int y (3),
int u (3),
int v (3)
)
</pre>
Performs a bilateral filtering on the input clip. A bilateral filter is like a gaussian filter, but values of the filtering window are weighted with a gaussian curve, depending of their proximity with the center pixel. The closer the values, the more weight has the value in the final sum. Bilateral filters are very efficient to remove noise on flat areas and smooth gradients without being disturbed by surrounding areas of different colors or high contrast lines. The result of a bilateral filtering is indeed cartoonish and waxy, therefore it does a very good job at gradient smoothing, without producing halos like the box filter. However, this is a very slow filter.

Actually, this implementation is an approximation of a bilateral filter, like many other image processing tools do. The spatial weighting is not a gaussian curve but a box, and the value weighting is a trapezoid. Cascading several function calls leads to a better approximation of the gaussian shape.

If you plan to use this filter for debanding, do not use it alone. It has no protection against oversmoothing. You should first apply [[#Dither_limit_dif16|Dither_limit_dif16]] on its result, exactly like with pp#Dither_box_filter16|Dither_box_filter16]], then use a mask to protect the finest details. The [[#GradFun3|GradFun3]] code is a good example to refer to.

This function works only on 16-bit stacked clips.

If you [http://forum.doom9.org/showthread.php?t=148782 MT()] the function, make sure to have an horizontal overlap greater or equal to twice the radius. Anyway, this is certainly not the most efficient way to get the processing multithreaded. Prefer using SetMTMode 1 or 2.

;src
:Clip to be filtered.

;ref
:When computing the value weighting, pixels of this clip are taken for reference. When cascading several calls to the function, set the original clip as reference to avoid the result drifting to something superflat.

;radius
:Size of the averaged square. Its width is radius*2-1. Must be = 2.

;thr
:Pixels whose difference of value with the center pixel is over ''thr'' will be discarded. The parameter ranges on an 8 bit scale. Must be stricly positive.

;flat
:Determines the shape of the trapezoid weighting of the value differences. Close to 0, the shape is triangular. Close to 1, the shape is a rectangle, like a box filter with a hard threshold. Range: 0.0–1.0

;wmin
:The partial or missing pixels are completed with the center pixel to match the ''wmin'' fraction of the filter window at full weight. At 0.0, it acts like a classic bilateral filter. Raising the total weight helps preventing the filter to completely flatten the small areas of close colors. Range: 0.0–1.0. Values over 1 are tolerated, they are equivalent to keep ''wmin'' to 1 while reducing the overall strength of the filter.

;subspl
:Subsampling rate. When this parameter is activated, only a few pixels randomly chosen from the search window are taken into account. This leads to significative speed improvment, with only a minor quality loss. A value equal to twice the radius looks like a good compromise. Normal subsampling values should be greater or equal to 4. Below, subsampling is disabled. Set ''subspl'' to 0 to let the filter adjust the subsampling rate automatically, depending on the radius. The number of subsampling points is limited to 4096. The random pattern is the same for all the frames and planes.

Category: dll.

=== Dither_limit_dif16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_limit_dif16 (
clip flt,
clip src,
clip ref (undefined),
float thr (0.25),
float elast (3.0),
int y (3),
int u (3),
int v (3)
)
</pre>
This function compare a filtered clip with its original version, and keeps the filtered pixels only if the difference between the filtered pixel and the reference pixel is below the given threshold. This is a building block of SmoothGrad and GradFun3.

This function works only on 16-bit stacked clips.

;flt
:Filtered clip.

;src
:Original clip.

;ref
:Reference clip for the filter output comparison. Specify here the first original clip when you cascade several limited filters. When undefined, the ''src'' clip is taken as reference.

;thr
:Thershold between reference data and filtered data, on an 8-bit scale. > 0.

;elast
:To avoid artifacts, the threshold has some kind of elasticity. Value differences falling over this thershold are gradually attenuated, up to ''thr'' * ''elast''. > 1.

Category: dll.

=== Dither_resize16, Dither_resize16nr ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_resize16 (
clip src,
int width,
int height,
float src_left (0),
float src_top (0),
float src_width (0),
float src_height (0),
string kernel ("spline36"),
float fh (1.0),
float fv (1.0),
int taps (4),
float a1 (undefined),
float a2 (undefined),
float a3 (undefined),
int kovrspl (1),
bool cnorm (true),
bool center (true),
string cplace ("MPEG2"),
int y (3),
int u (3),
int v (3),
string kernelh (""),
string kernelv (""),
float totalh (0),
float totalv (0),
bool invks (false),
bool invksh (invks),
bool invksv (invks),
int invkstaps (5),
string cplaces (cplace),
string cplaced (cplace),
string csp (undefined)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_resize16nr (
…
(same arguments as Dither_resize16)
…
bool noring (true)
)
</pre>
Resizes a 16-bit clip.

The function can resize interlaced content, but only if presented as separated, interleaved fields. It uses the Avisynth parity information to detect fields and maintain the correct chroma and luma positions. If this behaviour is not desired, add an AssumeFrameBased() before the resizing call.

The function can also be used to compute horizontal and vertical convolutions. If you do so, don’t forget to set:

:* ''fh'' or ''fv'' to -1 to make sure the clip is processed even if its size doesn’t change,
:* ''cnorm'' to false to avoid automatic kernel normalisation if your impulse is already normalised, or specify ''totalv'' or ''totalh'' if the normalisation factor is not the sum of the impulse
:* and ''center'' to false to keep the desired spacing between the sampling points.

This function works only on 16-bit stacked clips.

The Dither_resize16nr function is a wrapper over Dither_resize16, adding a ringing-cancellation algorithm.

;src
:Clip to be resized. Mandatory.

;width, height
:New picture width and height in pixels, > 0. Mandatory.

;src_left, src_top
:Coordinate of the top-left corner of the picture sub-area used as source for the resizing. They can be fractional. If negative, the picture is extended by replicating the left pixel column.

;src_width, src_height
:Size in pixels of the sub-area to resize. They can be fractional. If 0, the area has the same size as the source clip. If negative, they define coordinates relative to the bottom-right corner, in a [[Crop]]-like manner.

;kernel
:Kernel used by the resizer. Possible values are:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''"point"'''
| style="border:none;padding:0.0194in;"| Nearest neighbour interpolation. Same as [[PointResize]]().

|-
| style="border:none;padding:0.0194in;"| '''"rect" or "box"'''
| style="border:none;padding:0.0194in;"| Box filter.

|-
| style="border:none;padding:0.0194in;"| '''"linear" or"bilinear"'''
| style="border:none;padding:0.0194in;"| Bilinear interpolation. Same as [[BilinearResize]]().

|-
| style="border:none;padding:0.0194in;"| '''"cubic" or"bicubic"'''
| style="border:none;padding:0.0194in;"| Bicubic interpolation. Same as [[BicubicResize]](). The ''b'' and ''c'' variables are mapped on ''a1'' and ''a2'' and are both set to 1/3 by default.

|-
| style="border:none;padding:0.0194in;"| '''"lanczos"'''
| style="border:none;padding:0.0194in;"| [[Resampling#Sinc_resampler|Sinc]] function windowed by the central lobe of a sinc. Use ''taps'' to specify its impulse length. Same as [[LanczosResize]]().

|-
| style="border:none;padding:0.0194in;"| '''"blackman"'''
| style="border:none;padding:0.0194in;"| [[Resampling#Blackman_resampler|Blackman-Harris]] windowed sinc. Use ''taps'' to control its length. Same as [[BlackmanResize]]().

|-
| style="border:none;padding:0.0194in;"| '''"blackmanminlobe"'''
| style="border:none;padding:0.0194in;"| Another kind of Blackman windowed sinc, with a bit less ringing. Use ''taps'' for you know what.

|-
| style="border:none;padding:0.0194in;"| '''"spline16"'''
| style="border:none;padding:0.0194in;"| Cubic spline based kernel, 4 sample points. Same as [[Spline16Resize]]().

|-
| style="border:none;padding:0.0194in;"| '''"spline36"'''
| style="border:none;padding:0.0194in;"| Spline, 6 sample points. Same as [[Spline36Resize]]().

|-
| style="border:none;padding:0.0194in;"| '''"spline64"'''
| style="border:none;padding:0.0194in;"| Spline, 8 sample points. Same as [[Spline64Resize]]().

|-
| style="border:none;padding:0.0194in;"| '''"spline"'''
| style="border:none;padding:0.0194in;"| Generic splines, number of sample points is twice the ''taps'' parameter, so you can use ''taps = 6'' to get a [[SplineResize|Spline144Resize]]() equivalent.

|-
| style="border:none;padding:0.0194in;"| '''"gauss" or"gaussian"'''
| style="border:none;padding:0.0194in;"| [[Resampling#Gaussian_resampler|Gaussian]] kernel. The p parameter is mapped on ''a1'' and controls the curve width. The higher p, the sharper. It is set to 30 by default. This resizer is the same as [[GaussResize]](), but ''taps'' offers a control on the filter impulse length. For low p values (soft and blurry), it’s better to increase the number of taps to avoid truncating the gaussian curve too early and creating artifacts.

|-
| style="border:none;padding:0.0194in;"| '''"sinc"'''
| style="border:none;padding:0.0194in;"| Truncated sinc function. Use ''taps'' to control its length. Same as [[SincResize]]().

|-
| style="border:none;padding:0.0194in;"| '''"impulse"'''
| style="border:none;padding:0.0194in;"| Offers the possibility to create your own kernel (useful for convolutions). Add your coefficents in the string after “impulse”, separated with spaces (ex: "impulse 1 2 1"). The number of coefficients must be odd. The curve is linearly interpolated between the provided points. You can oversample the impulse by setting ''kovrspl'' to a value > 1.

|}

;fh, fv
:Horizontal and vertical frequency factors, also known as inverse kernel support. They are multipliers on the theoretical kernel cutoff frequency in both directions. Values below 1.0 spatially expand the kernel and blur the picture. Values over 1.0 shrink the kernel and let higher frequencies pass. The result will look sharper but more aliased. The multiplicator is applied after the kernel scaling in case of downsizing. Negative values force the processing, even if the horizontal size doesn’t change. The filter will use the absolute parameter value.

;taps
:Some kernels have a variable number of sample points, given by this parameter. Actually this counts half the number of lobes (or equivalent) ; in case of downscaling, the actual number of sample points may be greater than the specified value. Range: 1–128

;a1, a2, a3
:Specific parameters, depending on the selected kernel.

;kovrspl
:Specifies here how many times the kernel is oversampled when you provide a custom impluse response. = 1.

;cnorm
:If set to true, the impulse sum is normalised to 1 for each pixel. This is the normal behaviour when resizing, to make sure the energy is constant for all pixels. If you use the resizer as a convolution engine, it is advised to disable the normalisation.

;center
:Like the Avisynth resizers, this resizer preserves the position of the picture center. Disable this parameter if you may want to resize by preserving the top-left corner position. Similarly, if you are convolving without resizing, setting it to false ensures you that the same kernel will be applied to all pixels.

;cplace, cplaces, cplaced
:Placement of the chroma samples. ''cplaces'' and ''cplaced'' allow specifying different placements for source and destination clips and take precedence over ''cplace''. Can be one of these strings:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''"MPEG1"'''
| style="border:none;padding:0.0194in;"| 4:2:0 subsampling used in MPEG-1. Chroma samples are located on the center of each group of 4 pixels.

|-
| style="border:none;padding:0.0194in;"| '''"MPEG2"'''
| style="border:none;padding:0.0194in;"| Subsampling used in MPEG-2 4:2:x and most other formats. Chroma samples are located on the left pixel column of the group.

|-
| style="border:none;padding:0.0194in;"| '''"DV"'''
| style="border:none;padding:0.0194in;"| For 4:2:0 modes, it’s like MPEG-2 but U and V channels are “co-sited” vertically: V on the top row, and U on the bottom row. For 4:1:1, chroma is located on the leftmost column.

|}
The chroma placement is ignored when ''center'' is set to false or ''kernel'' to "point". You’ll find below an overview of common chroma placement and subsampling combinations:


<div id="chroma_placement">You’ll find below an overview of common chroma placement and subsampling combinations (click to enlarge)
::[[File:Colorspace-subsampling.png|171px]]
</div>

;kernelh, kernelv
:''kernel'' parameter specialisation for a given direction (horizontal or vertical). An empty string means that the ''kernel'' value is used.

;totalh, totalv
:When ''cnorm'' is activated, these parameters specify the normalisation value for the corresponding kernel. 0 means that the normalisation value is the sum of the coefficients. The [[MaskTools2|Masktools’]] mt_convolution function has a single parameter for this use: ''total'' = ''totalh'' × ''totalv''. Because the convolution is computed with floating point data, there is no saturation of intermediate results, therefore the balance between ''totalh'' and ''totalv'' is not important, only their product will be taken into account.

;invks, invksh, invksv
:Activates the kernel inversion mode for the specified direction (use ''invks'' for both). Inverting the kernel allows to “undo” a previous upsizing by compensating the loss in high frequencies, giving a sharper and more accurate output than classic kernels, closer to the original. This is particularly useful for clips upscaled with a bilinear kernel. All the kernel-related parameters specify the kernel to undo. The target resolution must be as close as possible to the initial resolution. The kernel inversion is mainly intended to downsize an upscaled picture. Using it for upsizing will not restore details but will give a sligthly sharper look, at the cost of a bit of aliasing and ringing. This mode is somewhat equivalent to the debilinear plug-in but works with a different principle.

;invkstaps
:In kernel inversion mode (''invks=true''), this parameter sets the number of taps for the inverted kernel. Use it as a tradeoff between softness and ringing. Range: 1–128

;csp
:Target colorspace. Can only change the chroma subsampling. You can convert only to a planar colorspace, keeping the same number of planes. Supporte values:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''"YV12"'''
| style="border:none;padding:0.0194in;"| 4:2:0

|-
| style="border:none;padding:0.0194in;"| '''"YV16"'''
| style="border:none;padding:0.0194in;"| 4:2:2

|-
| style="border:none;padding:0.0194in;"| '''"YV24"'''
| style="border:none;padding:0.0194in;"| 4:4:4

|-
| style="border:none;padding:0.0194in;"| '''"YV411"'''
| style="border:none;padding:0.0194in;"| 4:1:1

|-
| style="border:none;padding:0.0194in;"| '''"Y8"'''
| style="border:none;padding:0.0194in;"| No chroma

|}
Category: dll.

;noring
:A ringing cancellation algorithm is additionnaly used when set to true. Note: the ringing cancellation actually works only for low scaling ratios.

Category: script.

=== Dither_convert_yuv_to_rgb ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_convert_yuv_to_rgb (
clip src,
string matrix (undefined),
bool interlaced (false),
bool tv_range (true),
string cplace ("MPEG2"),
string chromak ("bicubic"),
float fh (undefined),
float fv (undefined),
int taps (undefined),
float a1 (undefined),
float a2 (undefined),
float a3 (undefined),
bool lsb_in (false),
int mode (undefined or 6),
float ampn (undefined or 0.5),
string output ("rgb32"),
int ampo (undefined),
bool staticnoise (undefined),
bool noring (false),
bool slice (undefined)
)
</pre>
Converts a YUV clip to RGB using high-bit-depth calculations. By default, 8 bit RGB output is dithered using error diffusion + noise to get the maximum visual quality.

;src
: An 8 or 16-bit YUV clip to be converted to RGB. If the clip is 16-bit stacked, set the ''lsb_in'' parameter to <tt>true</tt>.

;matrix
: The matrix used to convert the Y’CbCr pixels to computer RGB. Possible values are:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| <tt>'''"601"'''</tt>
| style="border:none;padding:0.0194in;"| ITU-R BT.601 / ITU-R BT.470-2 / SMPTE 170M. For Standard Definition content.
|-
| style="border:none;padding:0.0194in;"| <tt>'''"709"'''</tt>
| style="border:none;padding:0.0194in;"| ITU-R BT.709. For High Definition content.
|-
| style="border:none;padding:0.0194in;"| <tt>'''"2020"'''</tt>
| style="border:none;padding:0.0194in;"| ITU-R BT.2020, non constant luminance mode. For UHDTV content.
|-
| style="border:none;padding:0.0194in;"| <tt>'''"240"'''</tt>
| style="border:none;padding:0.0194in;"| SMPTE 240M
|-
| style="border:none;padding:0.0194in;"| <tt>'''"FCC"'''</tt>
| style="border:none;padding:0.0194in;"| FCC (where does that come from?)
|-
| style="border:none;padding:0.0194in;"| <tt>'''"YCgCo"'''</tt>
| style="border:none;padding:0.0194in;"| YCgCo
|}
When the parameter is not defined, ITU-R BT.601 and ITU-R BT.709 are automatically selected depending on the clip definition (considered as HD if ≥ 600 lines).

;interlaced
: Indicates that the input clip is interlaced.

;tv_range
: <tt>true</tt> if input clip has TV range pixel values, <tt>false</tt> if it uses the full range (PC scale).

;cplace
: Placement of the chroma samples. Can be one of these strings:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| <tt>'''"MPEG1"'''</tt>
| style="border:none;padding:0.0194in;"| 4:2:0 subsampling used in MPEG-1. Chroma samples are located on the center of each group of 4 pixels.
|-
| style="border:none;padding:0.0194in;"| <tt>'''"MPEG2"'''</tt>
| style="border:none;padding:0.0194in;"| Subsampling used in MPEG-2 4:2:x and most other formats. Chroma samples are located on the left pixel column of the group.
|-
| style="border:none;padding:0.0194in;"| <tt>'''"DV"'''</tt>
| style="border:none;padding:0.0194in;"| For 4:2:0 modes, it’s like MPEG-2 but U and V channels are "co-sited" vertically: V on the top row, and U on the bottom row. For 4:1:1, chroma is located on the leftmost column.
|}
;chromak
: Kernel used to shift and resize the chroma plane to full resolution before conversion.

;fh, fv, taps, a1, a2, a3
: Chroma resampling parameters. See [[#dither_resize16|Dither_resize16()]] for more information.

;lsb_in
: Indicates that the input clip is stack16.

;mode, ampo, ampn, staticnoise
: Dithering parameters, for 8 bit output. See [[#ditherpost|DitherPost()]]. When ''and ampn are not defined, they are set to the specified default value.''

;output
: Output format. Possible values are:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| <tt>'''"rgb32"'''</tt>
| style="border:none;padding:0.0194in;"| Regular RGB32 colorspace.
|-
| style="border:none;padding:0.0194in;"| <tt>'''"rgb24"'''</tt>
| style="border:none;padding:0.0194in;"| Regular RGB24 colorspace.
|-
| style="border:none;padding:0.0194in;"| <tt>'''"rgb48yv12"'''</tt>
| style="border:none;padding:0.0194in;"| 48-bit RGB [[#dither_convey_rgb48_on_yv12|conveyed on YV12]]. Use it for rawvideo export only. Not suitable for display or further processing (it will look like garbage).
|-
| style="border:none;padding:0.0194in;"| <tt>'''"rgb48y"'''</tt>
| style="border:none;padding:0.0194in;"| 48-bit RGB. The components R, G and B are conveyed on three YV12 or Y8 (if supported) stack16 clips interleaved on a frame basis.
|}
;noring
: A ringing cancellation algorithm is used to upscale the chroma when this parameter set to true.

;slice
: TODO

Category: script.

=== Dither_convert_rgb_to_yuv ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_convert_rgb_to_yuv (
clip src,
clip g (undefined),
clip b (undefined),
string matrix (undefined),
bool interlaced (false),
bool tv_range (true),
string cplace ("MPEG2"),
string chromak ("bicubic"),
float fh (undefined),
float fv (undefined),
int taps (undefined),
float a1 (undefined),
float a2 (undefined),
float a3 (undefined),
bool lsb (undefined),
int mode (undefined),
float ampn (undefined),
string output ("yv12"),
int ampo (undefined),
bool staticnoise (undefined),
bool noring (false),
bool slice (undefined)
)
</pre>
Converts an RGB clip to YUV using high-bit-depth calculations.

;src
:An 8 or 16-bit RGB clip to be converted to RGB. if only ''src'' is defined, the clip is considered as 8-bit RGB. If ''g'' and ''b'' are defined too, the three are assumed as 16-bit stacked clips containing the red, green and blue channels. They might be the deinterleaved result of [[#dither_convert_yuv_to_rgb|Dither_convert_yuv_to_rgb()]] with "rgb48y" as ''output'' string.

;matrix
:The matrix used to convert the R’G’B’ pixels to Y’CbCr. Possible values are:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''"601"'''
| style="border:none;padding:0.0194in;"| ITU-R BT.601 / ITU-R BT.470-2 / SMPTE 170M. For Standard Definition content.

|-
| style="border:none;padding:0.0194in;"| '''"709"'''
| style="border:none;padding:0.0194in;"| ITU-R BT.709. For High Definition content.

|-
| style="border:none;padding:0.0194in;"| '''"2020"'''
| style="border:none;padding:0.0194in;"| ITU-R BT.2020, non constant luminance mode. For UHDTV content.

|-
| style="border:none;padding:0.0194in;"| '''"240"'''
| style="border:none;padding:0.0194in;"| SMPTE 240M

|-
| style="border:none;padding:0.0194in;"| '''"FCC"'''
| style="border:none;padding:0.0194in;"| FCC (where does that come from?)

|-
| style="border:none;padding:0.0194in;"| '''"YCgCo"'''
| style="border:none;padding:0.0194in;"| YCgCo

|}

When the parameter is not defined, ITU-R BT.601 and ITU-R BT.709 are automatically selected depending on the clip definition (considered as HD if = 600 lines).

;interlaced
:Indicates that the input clip is interlaced.

;tv_range
:true if output clip has TV range pixel values, false if it uses the full range (PC scale).

;cplace
:Placement of the chroma samples. Can be one of these strings:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''"MPEG1"'''
| style="border:none;padding:0.0194in;"| 4:2:0 subsampling used in MPEG-1. Chroma samples are located on the center of each group of 4 pixels.

|-
| style="border:none;padding:0.0194in;"| '''"MPEG2"'''
| style="border:none;padding:0.0194in;"| Subsampling used in MPEG-2 4:2:x and most other formats. Chroma samples are located on the left pixel column of the group.

|-
| style="border:none;padding:0.0194in;"| '''"DV"'''
| style="border:none;padding:0.0194in;"| For 4:2:0 modes, it’s like MPEG-2 but U and V channels are "co-sited" vertically: V on the top row, and U on the bottom row. For 4:1:1, chroma is located on the leftmost column.

|}

;chromak
:Kernel used to shift and resize the chroma plane to full resolution before conversion.

;fh, fv, taps, a1, a2, a3
:Chroma resampling parameters. See [[#dither_resize16|Dither_resize16]] for more information.

;lsb
:Indicates if the output clip is stack16 (true) or 8 bits. If not defined, it depends on the input bit-depth.

;mode, ampo, ampn, staticnoise, slice
:Dithering parameters, for 8 bit output. See [[#ditherpost|DitherPost]].

;output
:Output format, 8 or 16-bit stacked. Possible values are:
:* "YV12"
:* "YV16"
:* "YV24"
:* "YV411"
:* "Y8"

;noring
:A ringing cancellation algorithm is used to downscale the chroma when this parameter set to true.

Category: script.

=== Dither_srgb_display ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_srgb_display (
clip src,
int debug (0),
bool lsb_in (false),
string matrix (undefined),
bool tv_range (undefined),
string chromak (undefined),
int w (undefined),
int h (undefined),
string kernel ("spline36" or "spline64"),
int taps (undefined),
bool noring (true),
bool precrop (depends),
bool autopar (true),
float par (undefined),
int parnum (undefined),
int parden (undefined),
float dar (undefined),
int darnum (undefined),
int darden (undefined),
float src_left (0),
float src_top (0),
float src_width (0),
float src_height (0),
float gamma (2.2)
bool center (true),
bool lsb (false),
string cplace (undefined),
int bkgcolor (undefined),
bool sigmoid (undefined),
bool slice (undefined),
int dispm (-1)
)
</pre>
Converts a Y’CbCr or Y clip to sRGB for display on a computer. The purpose of this function is to be as simple as possible. Some clip characteristics are automatically detected but may be overriden if necessary.

The function first performs a conversion to gamma-corrected R’G’B’, then reverts the original transfer curve to get linear RGB values, scales the clip to its final resolution possibly using a non-ringing resize, and finally applies the sRGB transfer curve.

The function is well suited for screen captures. Similarly, this is recommended for enlarging SD pictures for previewing instead of the built-in pointresize-style zoom in video applications.

;src
:The clip to display.

;debug
:Overlays debug information if set to 1.

;lsb_in, matrix, tv_range, chromak
:These parameters are passed to the Dither_convert_yuv_to_rgb function called internally.

;w, h
:Display size of the clip. It’s possible to specify only one dimension. In this case, DAR and PAR information are used to compute the other dimension. If both dimensions are specified and if the PAR is available, pillarboxing or letterboxing may be used to satisfy the requirements.

;kernel, taps, src_left, src_top, src_width, src_height, cplace
:These parameters are passed to the Dither_resize16 function called internally.

;noring
:In case of resizing, indicates that a non-ringing algorithm must be used. Default kernel is set to "spline64" for non-ringing algorithms and "spline36" for normal resizing.

;precrop
:When this flag is set, if 1. the clip is detected as SD (Standard Definition) and 2. PAR or display height only is specified, the source is automatically cropped to the active zone (704 pixels)

;autopar
:Allows the function to automatically select a PAR, referring to standardized picture sizes and other information like the DAR.

;par
:Decimal value for PAR (Pixel Aspect Ratio, a.k.a. Sample Aspect Ratio). Depending on the other parameters, the clip may be resized for square pixel display.

;parnum, parden
:Numerator and denominator for PAR specification in form of a fraction. You cannot set both the PAR as a fraction and as decimal.

;dar
:Decimal value for DAR (Display Aspect Ratio). Depending on other parameters, this allows the function to display the clip in square pixels in case of anamorphic storage. 1.778 and 1.333 are fine for 16:9 and 4:3 DAR.

;darnum, darden
:Numerator and denominator for DAR specification in form of a fraction. You cannot set both the DAR as a fraction and as decimal.

;gamma
:Sets the gamma for target display. A gamma of 2.1 is recommended for common practical viewing conditions in an office (200–300 lx ambiant light) and 2.2 (default) for viewing conditions specified by the sRGB standard (64 lx ambiant light). Changing the default value forces linear processing.

;center
:Indicates that clipping, pillarboxing or letterboxing should be centered. Otherwise, the top-left corner of the picture is preserved.

;lsb
:When true, the output is in the stack16 RGB32 format.

;bkgcolor
:Color value for the added borders, black is the default. It works like the color parameter in AddBorders(). It depends on the colorspace and possibly the value range (TV or full).

;sigmoid
:When set, use the sigmoidal curve to convert to and from linear light for the resizing.

;slice
:Parameter for DitherPost.

;dispm
:Sets the transfer curve to use for gamma to linear conversions. 0 and 1 set the regular BT.1886 transfer curve, and 2 sets the alternative BT.1886 tranfer curve. The latter is a closer emulation of a reference CRT display, using a gamma between 2.6 and 3. -1 activates the old conversion method, using BT.709 transfer curve for both directions. Non-zero values force linear processing.

Category: script.

=== Dither_quantize ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_quantize (
clip src,
int bitdepth,
bool reducerange (false),
int mode,
float ampo,
float ampn,
int pat,
bool dyn,
bool prot,
clip mask,
float thr,
bool interlaced,
int y,
int u,
int v,
bool staticnoise
)
</pre>
Dither a clip to a given bit-depth. It’s possible to keep the resulting clip at the initial bit-depth of 16 or to reduce it to the specified depth.

To encode a clip in 10 bits using x264, set ''bitdepth=10'' and ''reducerange=true'', followed by Dither_out and set --input-depth 10 in the x264 parameters.

'''NB:''' Dither_quantize is known to be slightly buggy when the dither amplitude is greater than unity (ampo + ampn > 1). In this case, there is a risk of getting some artefacts in the result. When reducing to 10 bits, it affects a small range of pixel values below any multiple of 16 (on an 8-bit scale). Keeping ampo + ampn = 1 shouldn’t create any noticeable artefact.

;src
:Clip to dither. Must be in stack16 format.

;bitdepth
:Desired bit depth, in range 8–14.

;reducerange
:Indicates if the output value range must be reduced. Even if reduced, the output clip is still in the regular stack16 format.

;mode, ampo, ampn…
:The other parameters are the same as in DitherPost.

Category: script.

=== Dither_out ===

<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_out (
clip src,
bool bigendian (false)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_convey_yuv4xxp16_on_yvxx (
clip src,
bool bigendian (false)
)
</pre>
This function allows Avisynth to output 16-bit YUV pixel components. This is achieved by sending fake YV12 data, containing actually yuv420p16 data. Frame serving should be done via a rawvideo pipe, so the encoding application relies on information provided by the user, not Avisynth directly.

Dither_convey_yuv4xxp16_on_yvxx is the same as Dither_out and remains for compatibility purpose.

This function works only on 16-bit stacked clips.

;src
:Stack-16 YUV data to encode.

;bigendian
:Indicates that the output stream is big endian (MSB-LSB order, yuv4xxp16be instead of yuv4xxp16le).

Category: plugin.

==== Notes ====
This can be done this way with avs2yuv and 10-bit x264:

<pre>avs2yuv -raw "script.avs" -o - | x264-10bit --demuxer raw --input-depth 16
--input-res 1280x720 --fps 24 --output "out.mp4" -
</pre>
This is actually a single line which has been split for convenient display. Note the minus sign at the end of the line. Of course, you’ll have to change and specify FPS, video resolution and interlacing information. Don’t do any further pixel processing after having called this function. Be sure to use the raw video trick for encoding, otherwise you’ll only get garbage.

To encode 4:4:4 10-bit video, you’ll need to add both --input-csp i444 and --output-csp i444 to the x264-10bit command line.

It’s also possible to dither to the exact target bit-depth, while keeping data in the 16-bit range for piping. You can use this little code snippet, here for a bit-depth of 10:

Dither_quantize (bitdepth=10)
Dither_out ()

However it is not necessary. Just go with Dither_out() in 16 bits and let x264 do the conversion.

=== Dither_convey_rgb48_on_yv12 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_convey_rgb48_on_yv12 (
clip r,
clip g,
clip b,
bool bigendian (false)
)
</pre>
This function provides the same kind of functionality as [[#Dither_out|Dither_out]], but spits RGB48 pixels instead of YUV.

This function works only on 16-bit stacked clips.

;r, g, b
:Three YUV stack16 clips containing the red, green and blue channels in their luma plane.

;bigendian
:Indicates that MSB must be stored before the LSB (rgb48be instead of rgb48le).

==== Notes ====
Here is a command line to pipe the result to ImageMagick:

avs2yuv -raw "script.avs" -o - | convert -depth 16 -size 1280x720 rgb:- "out-%06d.png"

The same with FFmpeg, although current releases don’t support completely the RGB48 reading and round the data to 8 bits:

<pre>avs2yuv -raw "script.avs" -o - | ffmpeg -f rawvideo -vcodec rawvideo -pix_fmt rgb48le
-s 1280x720 -aspect 1:1 -y -i - -f image2 "out-%06d.png"
</pre>
This is actually a single line which has been split for convenient display.

Category: script.

=== Dither_removegrain16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_removegrain16 (
clip src,
int mode (2),
int modeU (mode),
int modeV (modeU)
)
</pre>
This is the 16-bit equivalent of the RemoveGrain plug-in. It applies various kinds of smoothing to the input clip by combining each pixel with its 8 neighbours. As in the original RemoveGrain, the borders rows and columns (1-pixel thick) are not processed.

;mode
:The smoothing mode. It can apply to all the planes or to the Y plane only, depending on the values of ''modeU'' and ''modeV''. Some of the RemoveGrain modes have not been ported yet (25 and above). The available ones are listed below.
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| <div align="right">-'''1'''</div>
| style="border:none;padding:0.0194in;"| The plane is not touched at all and may contain garbage on output.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''0'''</div>
| style="border:none;padding:0.0194in;"| The plane is copied without being processed.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''1'''</div>
| style="border:none;padding:0.0194in;"| Clips the pixel with the minimum and maximum of the 8 neighbour pixels.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''2'''</div>
| style="border:none;padding:0.0194in;"| Clips the pixel with the second minimum and maximum of the 8 neighbour pixels.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''3'''</div>
| style="border:none;padding:0.0194in;"| Clips the pixel with the third minimum and maximum of the 8 neighbour pixels.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''4'''</div>
| style="border:none;padding:0.0194in;"| Clips the pixel with the fourth minimum and maximum of the 8 neighbour pixels, which is equivalent to a median filter.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''5'''</div>
| style="border:none;padding:0.0194in;"| Line-sensitive clipping giving the minimal change.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''6–8'''</div>
| style="border:none;padding:0.0194in;"| Line-sensitive clipping, intermediate.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''9'''</div>
| style="border:none;padding:0.0194in;"| Line-sensitive clipping on a line where the neighbours pixels are the closest.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''10'''</div>
| style="border:none;padding:0.0194in;"| Replaces the target pixel with the closest neighbour.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''11'''</div>
| style="border:none;padding:0.0194in;"| [1 2 1] horizontal and vertical kernel blur. Similar to Blur(1).

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''12'''</div>
| style="border:none;padding:0.0194in;"| Same as mode 11.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''13'''</div>
| style="border:none;padding:0.0194in;"| Bob mode, interpolates top field from the line where the neighbours pixels are the closest.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''14'''</div>
| style="border:none;padding:0.0194in;"| Bob mode, interpolates bottom field from the line where the neighbours pixels are the closest.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''15'''</div>
| style="border:none;padding:0.0194in;"| Bob mode, interpolates top field. Same as 13 but with a more complicated interpolation formula.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''16'''</div>
| style="border:none;padding:0.0194in;"| Bob mode, interpolates bottom field. Same as 14 but with a more complicated interpolation formula.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''17'''</div>
| style="border:none;padding:0.0194in;"| Clips the pixel with the minimum and maximum of respectively the maximum and minimum of each pair of opposite neighbour pixels.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''18'''</div>
| style="border:none;padding:0.0194in;"| Line-sensitive clipping using opposite neighbours whose greatest distance from the current pixel is minimal.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''19'''</div>
| style="border:none;padding:0.0194in;"| Replaces the pixel with the average of its 8 neighbours.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''20'''</div>
| style="border:none;padding:0.0194in;"| Averages the 9 pixels ([1 1 1] horizontal and vertical blur). Similar to Blur(1.58).

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''21'''</div>
| style="border:none;padding:0.0194in;"| Clips pixels using the averages of opposite neighbour

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''22'''</div>
| style="border:none;padding:0.0194in;"| Same as mode 21 but simpler and faster.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''23'''</div>
| style="border:none;padding:0.0194in;"| Small edge and halo removal, but reputed useless.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''24'''</div>
| style="border:none;padding:0.0194in;"| Small edge and halo removal, but reputed useless.

|}

;modeU, modeV
:Same as ''mode'' but for U and V planes. If not defined, they use the same value as ''mode''.

Category: plug-in.

=== Dither_repair16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_repair16 (
clip src1,
clip src2,
int mode (2),
int modeU (mode),
int modeV (modeU)
)
</pre>
This is the 16-bit equivalent of the Repair plug-in. It can repair the artifacts generated by a processing by applying a RemoveGrain-like treatment on the input clip to fix the ouput clip.

;src1
:The clip to repair.

;src2
:The reference clip. Must have the same format as ''src1''.

;mode
:The repairing mode. It can apply to all the planes or to the Y plane only, depending on the values of ''modeU'' and ''modeV''. The available ones are listed below. These modes are similar to the RemoveGrain modes but include the center pixel of the reference clip for min/max calculation.
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| <div align="right">-'''1'''</div>
| style="border:none;padding:0.0194in;"| The plane is not touched at all and may contain garbage on output.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''0'''</div>
| style="border:none;padding:0.0194in;"| The plane is copied without being processed.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''1–4'''</div>
| style="border:none;padding:0.0194in;"| Clips the source pixel with the Nth minimum and maximum found on the 3×3-pixel square from the reference clip.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''5'''</div>
| style="border:none;padding:0.0194in;"| Line-sensitive clipping giving the minimal change.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''6–8'''</div>
| style="border:none;padding:0.0194in;"| Line-sensitive clipping, intermediate.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''9'''</div>
| style="border:none;padding:0.0194in;"| Line-sensitive clipping on a line where the neighbours pixels are the closest.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''10'''</div>
| style="border:none;padding:0.0194in;"| Replaces the target pixel with the closest pixel from the 3×3-pixel reference square.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''11–14'''</div>
| style="border:none;padding:0.0194in;"| Same as modes 1–4 but uses min(Nth_min, c) and max(Nth_max, c) for the clipping, where c is the value of the center pixel of the reference clip.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''15, 16'''</div>
| style="border:none;padding:0.0194in;"| Clips the source pixels using a clipping pair from the RemoveGrain modes 5 and 6.

|-
| style="border:none;padding:0.0194in;"| <div align="right">'''17, 18'''</div>
| style="border:none;padding:0.0194in;"| Clips the source pixels using a clipping pair from the RemoveGrain modes 17 and 18.

|}

;modeU, modeV
:Same as ''mode'' but for U and V planes. If not defined, they use the same value as ''mode''.

Category: plug-in.

=== Dither_median16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_median16 (
clip src,
int rx (1),
int ry (1),
int rt (0),
int ql (undefined),
int qh (undefined),
int y,
int u,
int v
)
</pre>
This filter performs quantile clipping, and more specifically can work as a median filter. It is quite slow, not optimised at all.

;rx, ry
:Horizontal and vertical radius of the workarea. Positive values. The middle pixel value is clipped by the lower and higher quantiles found in the defined group of pixels. With ''rx = 2'' and ''ry = 3'', the input area is 5×7 pixels.

;rt
:Temporal radius. Positive value. If set to 0, the filter is spatial only.

;ql, qh
:Low and high clipping quantiles. The filter chooses two pixels defined by their rank in the group of neighbours. Let’s call vl and vh the values corresponding to the ''ql''-th and ''qh''-th ranks. Pixel values outside the vl to vh range are clipped. ''ql'' and ''qh'' must be positive or null and less than (''rx''×2 + 1) × (''ry''×2 + 1) × (''rt''×2 + 1). Also, ''ql'' = ''qh''. If these parameters are set to a negative value or undefined, they are internally set to the middle of the range, performing a median filtering.

Category: plug-in.

=== DitherTestPatterns ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">DitherTestPatterns (
int size (192),
int mag (1),
int amp (1),
int len (24),
int luma (128)
)
</pre>
Shows all the dithering patterns in the same picture.

;size
:Width in pixels of a single test pattern.

;mag
:Magnification factor, > 0. Global picture size is unchanged. Recommended value: 3.

;amp
:Amplification factor, > 0. Useful to actually see the patterns without hurting your eyes. Recommended value: 32.

;len
:Number of frames to generate, > 0.

;luma
:Average luma value used for the tests (0–255).

Category: script.

=== Dither1Pre, Dither2Pre ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither1Pre (
clip m,
string flt ("dfttest (sigma=64)"),
bool stacked (true),
float overlap (0.5),
bool tvopt (false)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither2Pre (
clip m,
string flt ("dfttest (sigma=256)"),
bool stacked (true),
float overlap (0.5),
bool tvopt (false)
)
</pre>
Filters a 8-bit clip and outputs the result with 1 or 2 extra bits of accuracy. This function allows using 8-bit denoisers which have not been modified to support stack16 format.

The MSB part is stacked onto the LSB part. They can be separated later into two clips using the utility functions. You can also choose to interleave the MSB and the LSB data instead of stacking them on the same frame.

This function works by splitting the picture histogram in slices of equal width, stretching the slices to the full range, filtering them and recombining them all into a higher bit-depth clip. The stretch scale is x2 for Dither1Pre and x4 for Dither2Pre. In order to ensure the continuity, the slices are overlapped. 3 slices are used for 1 extra bit, and 7 slices for 2 extra bits (50 % overlap). Compared to the normal CPU load of the provided filter, computation times are multiplied respectively by 3 and 5. It is possible to change the overlap amount to save CPU.

Because of this histogram split, keep any motion compensation code out of the function. Just provide a raw filter here. As another consequence of the split, only filters processing the luma and chroma planes independently will work correctly. Fortunately, most of them do. Filters internally converting pixels to RGB or doing similar things will likely fail.

Note that these functions are dirty hacks. First, they are not efficient, because they have to run multiple times the specified noise filter. Also, the slicing may introduce artifacts, depending on the behavious of the specified filter. It is strongly recommended to use a modified denoiser to generate the 16-bit data instead of DitherNPre. Use these functions only when there is no other way to achieve the desired filtering.

If you are using MT, additionnaly to the splitvertical=true requirement, you must be aware that stacked=false in this case may lead to temporal artifacts for some unknown reason (thanks to Dogway on the Doom9 forum for investigating all these issues). Correct example:

MT ("""Dither1Pre (flt="tnlmeans()")""", 2, 2, true)

;m
:The original, noisy clip.

;flt
:An optional string containing the filter command. You can insert double quotes (") in the parameters with Chr(34) sequences. Beware: filter parameters must be set according to their new input range. In Dither1Pre, all amplitude-relative parameters must be doubled, and powers quadrupled. In Dither2Pre, all amplitudes are quadrupled and powers multiplied by 16. Spatial and temporal values can be left unchanged.

;stacked
:Indicates that the MSB and LSB data must be vertically stacked instead of being interleaved.

;overlap
:The slice overlap rate. The greater, the lower the risk of artifacts. The required number of slices is deduced from the overlap rate parameter. Overlap ranges from 0 (no additional slice) to 0.5 (50 % overlap, number of slices almost doubled). When ''tvopt'' is false, the minimum number of additional slices is restricted to one instead of zero.

;tvopt
:Can increase the actual overlap for a fixed number of slices in presence of TV-scale values (luma in the 16–235 range, and chroma in 16–240) by reducing the slice covering to the visible range. This means super blacks and super whites are clipped. The option is useful with small overlap rates.

Category: script.

== Utility functions ==
=== Dither_get_msb, Dither_get_lsb ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_get_msb (clip src)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_get_lsb (clip src)
</pre>
Extracts the MSB or the LSB from the stacked 16-bit frame ''src''.

Category: script.

=== Dither_gen_null_lsb ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_gen_null_lsb (clip src)
</pre>
Generates a LSB clip set to 0 for the non-stacked ''src'' clip, which can be a MSB or a standard 8-bit clip.

Category: script.

=== Dither_convert_8_to_16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_convert_8_to_16 (clip src)
</pre>
Converts the 8-bit ''src'' clip into a 16-bit stacked clip. For the inverse operation, just call DitherPost (mode=-1).

Category: script.

=== Dither_crop16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_crop16 (
clip src,
int left,
int top,
int width,
int height,
bool align
)
</pre>
Crops a 16-bit stacked clip. Coordinates are related to the real picture (half-height). Parameters are the same as the Avisynth Crop function.

Category: script.

=== Dither_addborders16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_addborders16 (
clip src,
int left,
int top,
int right,
int bottom,
int color_yuv (undefined)
int color (undefined)
)
</pre>
Add borders to a 16-bit stacked clip. Coordinates are related to the real picture (half-height).

;left, top, right, bottom
:Border sizes, same as the Avisynth AddBorders function.

;color_yuv, color
:Filling color. Default is black, in TV-range. Actually you can use both value whatever the colorspace (color_yuv is left only for backward compatibility).

Category: script.

=== Dither_lut8, Dither_lutxy8, Dither_lutxyz8 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_lut8 (
clip src,
string expr ("x"),
string yexpr (undefined),
string uexpr (undefined),
string vexpr (undefined),
int y (3),
int u (1),
int v (1)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_lutxy8 (
clip src1,
clip src2,
string expr ("x"),
string yexpr (undefined),
string uexpr (undefined),
string vexpr (undefined),
int y (3),
int u (1),
int v (1)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_lutxyz8 (
clip src,
clip src2,
clip src3,
string expr ("x"),
string yexpr (undefined),
string uexpr (undefined),
string vexpr (undefined),
int y (3),
int u (1),
int v (1)
)
</pre>
These functions are the equivalent of the [[MaskTools2|Masktools]] mt_lut, mt_lutxy and mt_lutxyz functions. Here, they generate 16-bit data from 8-bit clips. The output of the final function is rounded to the nearest integer and clipped into the [0; 65535] range. The result is stored into a 16-bit stacked clip.

If ''y'', ''u'' or ''v'' are defined to 2, 4 or 5 (copy plane from the Nth clip), the plane is converted to 16-bit with a null LSB.

Please refer to the Masktools documentation for more information about these functions.

Category: script.

=== Dither_lut16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_lut16 (
clip src,
string expr ("x"),
string yexpr (undefined),
string uexpr (undefined),
string vexpr (undefined),
int y (3),
int u (1),
int v (1)
)
</pre>
This works like the [[MaskTools2|Masktools]] mt_lut, except that both input and output are 16-bit values.

Category: script.

=== Dither_add16, Dither_sub16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_add16 (
clip src1,
clip src2,
bool wrap (false),
int y (3),
int u (3),
int v (3),
bool dif (false)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_sub16 (
clip src1,
clip src2,
bool wrap (false),
int y (3),
int u (3),
int v (3),
bool dif (false)
)
</pre>
Adds or subtract two 16-bit clips, pixel per pixel, plane per plane.

Dither_sub16(dif=true) is the 16-bit equivalent to mt_makediff().Dither_add16(dif=true) is the 16-bit equivalent to mt_adddiff().

;wrap
:Indicates if the value should wrap in case of overflow instead of being clipped in 0–65535.

;dif
:Indicates that ''src2'' is considered as a "difference" clip, 32768 (128 * 256) being the neutral value. The actual operation is src1 + src2 - 32768 (add) or src1 - src2 + 32768 (sub).

Category: dll.

=== Dither_max_dif16, Dither_min_dif16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_max_dif16 (
clip src1,
clip src2,
clip ref,
int y (3),
int u (3),
int v (3)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_min_dif16 (
clip src1,
clip src2,
clip ref,
int y (3),
int u (3),
int v (3)
)
</pre>
Compares pixel per pixel ''src1'' and ''src2'' to ''ref'' and takes the pixel with the greatest amplitude difference (or the smallest for Dither_min_dif16).

Category: dll.

=== Dither_merge16, Dither_merge16_8 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_merge16 (
clip src1,
clip src2,
clip mask,
bool luma (false),
int y (3),
int u (2 or 3),
int v (2 or 3)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_merge16_8 (
clip src1,
clip src2,
clip mask,
bool luma (false),
int y (3),
int u (2 or 3),
int v (2 or 3)
)
</pre>
These functions work like the [[MaskTools2|Masktools’]] mt_merge. The output is a blend between src1 and src2, depending on each ''mask'' pixel values. The bigger the mask value, the more the second clip will be taken into account.

All clips are 16-bit stacked. With Dither_merge16_8, ''mask'' is a regular 8-bit clip.

The default value for ''u'' and ''v'' are 2 (copy plane from ''src1'') excepted when ''luma = true''. In this case, chroma is always processed.

Category: Dither_merge16: dll, Dither_merge16_8: script.

=== Dither_y_gamma_to_linear, Dither_y_linear_to_gamma ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_y_gamma_to_linear (
clip src,
bool tv_range_in (true),
bool tv_range_out (true),
string curve ("srgb"),
int y (3),
int u (2),
int v (2),
float gcor (1.0),
bool sigmoid (false),
float thr (depends),
float cont (depends)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_y_linear_to_gamma (
clip src,
bool tv_range_in (true),
bool tv_range_out (true),
string curve ("srgb"),
int y (3),
int u (2),
int v (2),
float gcor (1.0),
bool sigmoid (false),
float thr (depends),
float cont (depends)
)
</pre>
Dither_y_gamma_to_linear converts the luma channel to linear light, and Dither_y_linear_to_gamma converts back a clip to gamma-corrected luma. The chroma channels remain untouched.

This function works only on 16-bit stacked clips.

Note: usually gamma compression applies to RGB channels, not Y’CbCr. Therefore this function should be used with RGB48Y clips, obtained from Dither_convert_yuv_to_rgb for example.

;clip
:The clip to be converted.

;tv_range_in
:Specifies if the luma range is 16-bit TV (16*256 to 235*256 inclusive) or full range (false)

;tv_range_out
:Same, but for output.

;curve
:Type of gamma mapping. Possible values:
:{| style="border-spacing:0;"
| style="border:none;padding:0.0194in;"| '''"709"'''
| style="border:none;padding:0.0194in;"| ITU-R BT.709 transfer curve for digital video

|-
| style="border:none;padding:0.0194in;"| '''"601"'''
| style="border:none;padding:0.0194in;"| ITU-R BT.601 transfer curve, same as "709"

|-
| style="border:none;padding:0.0194in;"| '''"170"'''
| style="border:none;padding:0.0194in;"| SMPTE 170M, same as "709"

|-
| style="border:none;padding:0.0194in;"| '''"240"'''
| style="border:none;padding:0.0194in;"| SMPTE 240M (1987)

|-
| style="border:none;padding:0.0194in;"| '''"srgb"'''
| style="border:none;padding:0.0194in;"| sRGB curve

|-
| style="border:none;padding:0.0194in;"| '''"2020"'''
| style="border:none;padding:0.0194in;"| ITU-R BT.2020 transfer curve, for 12-bit content. For sources of lower bit-depth, use the "709" curve.

|-
| style="border:none;padding:0.0194in;"| '''"1886"'''
| style="border:none;padding:0.0194in;"| ITU-R BT.1886 transfer curve, for flat panel display used in HDTV production, approximating a CRT characteristic.

|-
| style="border:none;padding:0.0194in;"| '''"1886a"'''
| style="border:none;padding:0.0194in;"| Curve given as example of better match to a CRT in recommendation ITU-R BT.1886

|}

::[[File:Transfer.png|280px]]

;gcor
:Gamma correction, applied on the linear part.

;sigmoid
:When set, applies a sigmoidal curve after the power-like curve (or before when converting from linear to gamma-corrected). This helps reducing the dark halo artefacts around sharp edges caused by resizing in linear luminance.

;thr
:Mid-point position of the sigmoid curve. Between 0 and 1, usually close to 0.5. The default value depends on the selected curve so the sigmoid tries to match the lower half of the standard curve with the contrast doubled.

;cont
:Contrast of the sigmoid curve. Must be > 0, and is usually set between 5 and 8. The default value depends on the selected curve so the sigmoid tries to match the lower half of the standard curve with the contrast doubled.

Category: script.

=== Dither_sigmoid_direct, Dither_sigmoid_inverse ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_sigmoid_direct (
clip src,
float thr (0.5),
float cont (6.5),
int u (2),
int v (2)
)
</pre>
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_sigmoid_inverse (
clip src,
float thr (0.5),
float cont (6.5),
int u (2),
int v (2)
)
</pre>

Dither_sigmoid_inverse applies the inverse sigmoid curve to a clip in linear luminance in order to lessen the ringing when resizing it. Dither_sigmoid_direct converts back a clip to linear luminance. The chroma channels remain untouched.

;thr
:Mid-point position of the sigmoid curve. Between 0 and 1, usually close to 0.5. The default value depends on the selected curve so the sigmoid tries to match the lower half of the standard curve with the contrast doubled.

;cont
:Contrast of the sigmoid curve. Must be > 0, and is usually set between 5 and 8. The default value depends on the selected curve so the sigmoid tries to match the lower half of the standard curve with the contrast doubled.

Category: script.

=== Dither_add_grain16 ===
<pre style="max-width:33em;border:1px solid blue;background-color:#F8F8FF;">Dither_add_grain16 (
clip src,
float var (1),
float uvar (0),
float soft (1),
int maxts (5),
bool replace (false),
bool lsb_in (true),
int seed (undefined)
)
</pre>
Generates and adds 16-bit grain to a clip, with optional temporal stabilization. The output is always a stack16 clip.

;var
:Standard deviation of the luma noise. = 0.

;uvar
:Standard deviation of the chroma noise. = 0.

;soft
:Noise temporal stability. This is actually the regeneration period of the noise, in frames. Set to 100 or above, the grain becomes static.

;maxts
:Maximum radius for the temporal softening of the noise, in frames. Larger radii smooth very slow grain with a higher quality, but they are more resource-demanding.

;replace
:Set to true, the noise is generated on a mid-grey clip instead of being added to the ''src'' clip. The new clip has the same properties as the source clip.

;lsb_in
:Indicates that the input clip is stack16.

;seed
:If defined and not negative, forces a seed for the random number generator used in grain generation. This ensures that the produced grain remains the same each time the script is executed.

Category: script.

== Troubleshooting ==
'''The resulting picture appears to be cut at half height.'''

You surely applied DitherPost twice, or use it on a regular 8-bit clip. Please check your script. Apply DitherPost only on 16-bit clips generated by the modified plug-ins with ''lsb=true'' or by the other dedicated functions outputing 16-bit stacked data.

'''[[GradFun3]] and some other functions always output a green screen.'''

You surely have an old [[MaskTools2|Masktools 2]] version installed somewhere and autoloaded by Avisynth. Search on your disks the filenames mt_masktools.dll, mt_masktools-25.dll and mt_masktools-26.dll. Remove the culprits and install the latest Masktools version from [https://github.com/tp7/masktools/releases there].

Still not working? Remove all the mt_masktools dll you can found. If you did it well, running your script must make Avisynth complain about missing masktools function. If this is not the case, search again, there is a masktool file hidden somewhere in your filesystem.

'''Error message — Script error: [[dfttest]] does not have a named argument "lsb"'''

Remove your dfttest.dll and install the modified one, contained in this package.

'''Error message — [[Removegrain|RemoveGrain]]: invalid mode ##'''

Your RemoveGrain version is too old. Remove RemoveGrain*.dll, Repair*.dll and SSE?Tools.dll and install [[RgTools]].

== Changelog ==
'''v1.27.2, 2015.12.30'''

* Fixed Dither_crop16 which wasn’t passing the align parameter if there was no horizontal cropping. Thanks to Reel.Deel for making me check.
* Fixed Dither_srgb_display with autopar=false and 1440×1080 input.
* Fixed Dither_quantize with reducerange=true, some rare pixel values were wrongly quantized. Thanks to _08 for reporting this bug.
* Fixed a picture corruption in Dither_bilateral16. Thanks to _08 for reporting what was actually a combination of two different bugs.

'''v1.27.1, 2015.07.16'''

* Fixed a wrong code path in Dither_limit_dif16 causing a crash on CPU without AVX2 instruction set. Thanks to real.finder and Groucho2004 for their report.
* Documentation typos fixed thanks to Colours.

'''v1.27.0, 2015.07.12'''

* Added ''cplaces'', ''cplaced'' and ''csp'' to Dither_resize16.
* Backported some code from [http://forum.doom9.org/showthread.php?t=166504 fmtconv] to Dither_resize16.
* Added the ''slice'' parameter to disable multi-threaded slicing for error-diffusion dithering (DitherPost and related functions).
* Added Dither_min_dif16.
* AVX2 optimisations for Dither_resize16, Dither_add16, Dither_sub16, Dither_median16, Dither_max_dif16, Dither_min_dif16 and Dither_limit_dif16.
* Added the BT.1886 transfer cruve to the gamma conversion functions.
* Added the ''dispm'' parameter to change the conversion mode in Dither_srgb_display.
* Improved the quality of the subsampling in Dither_bilateral16.
* Radius is no longer limited in Dither_bilateral16 as well as in GradFun3 in ''smode'' 2.
* Fixed a bug in the chroma filling (''u'' or ''v'' < 0) with non-YV12 colorspaces.

'''v1.26.5, 2014.09.23'''

* Fixed Dither_resize16 to make pure vertical resizing multi-threaded.

'''v1.26.4, 2014.09.22'''

* Fixed bug in Dither_limit_dif16 and SmoothGrad when ''thr'' and ''elast'' are both too low or too high. Thanks to mirkosp for reporting it.
* The ''radius'' value is more thoroughly checked in GradFun3 in order to make related error messages more explicit.

'''v1.26.3, 2014.09.05'''

* Fixed bug in Dither_box_filter16 shifting the frame to the right from the 2049th pixel column. Thanks to Motenai Yoda for reporting it.

'''v1.26.2, 2014.08.29'''

* Fixed an SSE2 bug in Dither_median16 for 3×3 spatial median. Thanks to TheProfileth for reporting it.

'''v1.26.1, 2014.06.05'''

* Fixed a wrong saturation in Dither_sub16 on the last pixels of a clip whose width is not mod-8.

'''v1.26.0, 2014.06.03'''

* Modded versions of dfttest and MVTools2 aren’t bundled with Dither anymore. Get them separately.
* Added sigmoid curves to Dither_y_gamma_to_linear and Dither_y_linear_to_gamma.
* Added Dither_sigmoid_direct and Dither_sigmoid_inverse functions.
* Added the ''sigmoid'' parameter to Dither_srgb_display.
* Dither_y_gamma_to_linear and Dither_y_linear_to_gamma now process data contained in the chroma planes when ''u'' or ''v'' are set to 3, instead of just copying them.

'''v1.25.1, 2014.03.03'''

* Fixed a regression introduced in Dither_merge16.

'''v1.25.0, 2014.03.02'''

* 64-bit version. Source code projects ported to M$VC 2012.
* Added modes 5–10 to Dither_repair16.
* Added ''ref'' clip to GradFun3.
* The order of the ''luma'', ''y'', ''u'' and ''v'' parameters in Dither_merge16 is now the same as in Dither_merge16_8. The documentation has been fixed accordingly.
* Slight speed improvement in Dither_srgb_display when there is no resizing nor gamma correction.
* Fixed a problem in Dither_lut16 with expressions containing two consecutive “x” arguments.
* Fixed artefacts (overflow occuring when input pixels are close to 0) and inaccuracy in mode 20 of Dither_removegrain16.

'''v1.24.0, 2013.10.27'''

* Added all modes up to 24 to Dither_removegrain16, thanks to tp7. Most of them are SSE2-optimised.
* Added modes 15–18 to Dither_repair16 (not optimised for SSE2).

'''v1.23.0, 2013.08.04'''

* Partial implementation of the BT.2020 color conversions. Only the non-constant luminance matrix is implemented.
* Optimized Dither_merge16 for SSE2.
* Fixed the ''radiusc'' type in GradFun3 (int), so it now should work correctly in Avisynth 2.6 alpha 4.
* Fixed a bug in Dither_merge16 affecting the chroma of YV12 clips with ''luma=true''. Thanks to tp7 for reporting these issues.

'''v1.22.1, 2013.01.09'''

* Fixed green frame output in Dither_resize16nr for some combination of the ''y'', ''u'' and ''v'' parameters.
* Fixed Dither_quantize for 14-bit output. It is not perfect but much better than before.
* Made the ''bitdepth'' parameter in Dither_quantize a named argument.
* Fixed ''var'' and ''uvar'' scaling in Dither_add_grain16 to match better AddGrainC.

'''v1.22.0, 2012.12.31'''

* Added temporal processing to Dither_median16.
* Added Dither_resize16nr, a simple ringing-cancellation wrapper around Dither_resize16.
* Added a ''noring'' parameter to conversion functions between YUV and RGB.
* Added ''lsb'', ''center'' and ''bkgcolor'' to Dither_srgb_display.
* Replaced Dither_convey_yuv4xxp16_on_yvxx with Dither_out, which also works correctly with YV16 input. The old function is still there for compatibility, mapped on the new one.
* Dither_addborders16 now works with RGB clips.
* Badly designed and buggy resizing functionalities in Dither_srgb_display were rewritten.

'''v1.21.0, 2012.09.07'''

* Added the ''seed'' parameter to Dither_add_grain16.
* Reworked Dither_srgb_display for mor accurate aspect ratios and transfer characteristics, added ''gamma'' parameter.
* Gamma transfer functions have now an optional gamma correction parameter.
* Added Dither_median16, but slow and without temporal component at the moment.

'''v1.20.0, 2012.08.12'''

* Added Dither_removegrain16 (modes 1–4, 11, 12, 19 and 20 only) and Dither_repair16 (modes 1–4 and 11–14 only).
* Added threshold, radius and elasticity settings for chroma to GradFun3, as well as the usual plane filters. Better compatibility with the 4:1:1 colorspace.
* Added Dither_sub16 and optimised Dither_add16 for SSE2.
* Fixed a regression for 4:2:0 DV-PAL chroma placement in Dither_resize16.
* Colorspace conversions using point-sampling for chroma are now more consistent regarding chroma placement.

'''v1.19.0, 2012.07.18'''

* Added kernel inversion to Dither_resize16.
* Added cropping parameters to Dither_srgb_display.
* Fixed a bug preventing to use the 4:1:1 colorspace in some scripted functions.
* Bug fixed in [[MVTools]] (v2.6.0.5).

'''v1.18.1, 2012.06.15'''

* Forgot to include AVSTP 1.0.1 in the previous release.
* The ''mode'' parameter in Dither_quantize was forgotten too…
* Detailed a few things in the documentations.

'''v1.18.0, 2012.06.14'''

* Added Dither_quantize to dither to bit-depths higher than 8.
* Added Dither_srgb_display for Y’CbCr preview and accurate screen captures.
* More meaningful error messages about wrong clip formats.
* SmoothGrad and Dither_box_filter16 now work correctly on picture of width > 2048
* Fixed a bug in multithreaded Dither_resize16.
* Bug fixed in MVTools (v2.6.0.4).

'''v1.17.0, 2012.05.13'''

* Added the YCgCo matrix in RGB conversions.
* More dithering settings exposed in RGB conversions.
* Fixed BT.709 coefficients.
* Bug fixed in MVTools (v2.6.0.3).

'''v1.16.0, 2012.05.01'''

* Added generic spline kernel to Dither_resize16.
* Added the SMPTE 240M gamma curve and aliases for BT.601 and SMPTE 170M.
* Fixed a bug related to chroma subsampling and multi-threading in Dither_merge16.
* Bug fixed in MVTools (v2.6.0.2).

'''v1.15.0, 2012.03.23'''

* Added the ''luma'' parameter to Dither_merge16 and defaulted ''u'' and ''v'' to 2 (copy) excepted when ''luma = true'' (process). This behaviour is now identical to mt_merge.
* Added plane filtering in Dither_merge16_8. The function now internaly uses Dither_merge16 and is much faster (×20 on a 4-core CPU).
* Added support for negative plane filter values in Dither_lut16. Thanks to 06_taro for the suggestion.
* Set ''quiet = true'' as default in dfttest 1.9.2.
* Fixed a bug in Dither_resize16 making it crash for some combinations of source and destination sizes.

'''v1.14.1, 2012.03.12'''

* Bugs fixed in MVTools (v2.6.0.1).

'''v1.14.0, 2012.03.11'''

* Multi-threading: most dither.dll functions are now multi-threaded, excepted Dither_box_filter16 and SmoothGrad (later, maybe). Some MVTools v2.6.0.0 functions support multi-threading too.
* Fixed a bug in dfttest v1.9.1
* Added ''staticnoise'' parameter to GradFun3.
* Documentation revisited.

'''v1.13.2, 2011.12.13'''

* Updated MVTools to v2.5.14.1 (bugfix)

'''v1.13.1, 2011.11.28'''

* Updated dfttest to v1.9 and MVTools to v2.5.14.0
* Fixed height checks in DitherPost with interlaced content.

'''v1.13.0, 2011.11.09'''

* Added ''kernelh'', ''kernelv'', ''totalh'' and ''totalv'' to Dither_resize16. Please note that the custom convolution coefficients are now read in the correct order.
* Fixed an error with the plane selectors in the Dither_lut*8 functions.
* Updated MVTools to v2.5.13.1.

'''v1.12.1, 2011.10.27'''

* Fixed a bug with Dither_resize16, occuring with positive values for ''src_left'' or ''src_top''.
* Fixed other issues in Dither_resize16, related to huge differences between vertical and horizontal resizing ratios. It’s not perfect yet, but still much better than before.
* Dither_convert_yuv_to_rgb now supports RGB24 output colorspace.
* Simplified Dither_crop16 for pure horizontal cropping.

'''v1.12.0, 2011.09.10'''

* MVTools update again.

'''v1.11.1, 2011.09.10'''

* Fixed a bug in the MVTools.

'''v1.11.0, 2011.09.10'''

* Updated MVTools to v2.5.12.0. See the MVTools documentation for details.

'''v1.10.0, 2011.08.24'''

* Added Dither_addborders16.
* Added the BT 709 curve to Dither_y_gamma_to_linear and Dither_y_linear_to_gamma, as well as the plane selectors.
* Added the possibility to have static noise in DitherPost.
* Added Dither_add_grain16.
* Added a ''dif'' parameter to Dither_add16.
* Added the ''lsb'' and ''lsb_in'' parameters to GradFun3 to deal with 16-bit data. The function also accepts smaller radii than before.

'''v1.9.5, 2011.07.21'''

* Bug fixed in Dither_resize16(), displaying green bars when SSE2 optimisations are disabled.
* Better check of stack16 clip dimensions.

'''v1.9.4, 2011.07.17'''

* Bug fix again in Dither_resize16().

'''v1.9.3, 2011.07.13'''

* Fixed crashes in Dither_bilateral16() occuring with subsampling using more than 32 reference pixels. This affected GradFun3(smode=2) with radii greater than 13.
* Fixed a mod4 check in Dither_convert_yuv_to_rgb().

'''v1.9.2, 2011.07.09'''

* Fixed crashes and bugs in Dither_resize16().

'''v1.9.1, 2011.07.06'''

* Improved memory usage and CPU load for the functions based on the 16-bit resizer.
* Simplified a bit the GradFun3() detail masking.
* Fixed a few glitches.

'''v1.9, 2011.06.11'''

* The threshold of the detail mask in GradFun3() now automatically adjusts to the debanding threshold. This helps removing serious color banding, when band boundaries are masked because they are detected as details. Also, the ''radius'' for ''smode'' 0 has been internally reduced to make the value reflect more accurately the actual range in pixels.
* Added an interlaced mode for DitherPost().
* Added Dither_resize16(), a 16-bit resizer which can also work as a chained horizontal and vertical convolution engine.
* Added ''y'', ''u'' and ''v'' parameters to almost all the dither.dll functions. Their behaviour is the same as in masktools2.
* Added Dither_y_gamma_to_linear() and Dither_y_linear_to_gamma(), for gamma ? linear conversions in 16 bits.
* Added Dither_convey_yuv4xxp16_on_yvxx() and Dither_convey_rgb48_on_yv12(), functions to export clips with 16 bits per component when Avisynth’s output is read as rawvideo via a pipe.
* Added Dither_convert_yuv_to_rgb() and Dither_convert_rgb_to_yuv() to convert 8 or 16 bits YUV to RGB and back with dithering. It’s also possible to output RGB48 conveyed on YV12 via a rawvideo pipe.
* Added Dither_max_dif16() to get from two clips the pixels having the maximum difference with a third reference clip.
* Fixed an error message about wrong colorspace.
* Bugfix: removed artifacts on flat pure white areas (luma == 255) when using error diffusion dithering (modes 6–8).
* Non-YV12 planar Y(UV) colorspaces should now work correctly on Avisynth 2.6.0.

'''v1.8.1, 2011.05.28'''

* Optimised Dither_bilateral16 with SSE and by introducing a subsampling parameter. Also, fixed a bug related to the use of a ''ref'' clip.
* Added a troubleshooting section to the documentation.

'''v1.8, 2011.05.15'''

* Dfttest has been modified to make it accept 16-bit input clips (v1.8 mod16b). It’s now possible to apply a curve on the input and the inverse curve to the output to protect dark shades for example, without resolution loss or risk of color banding.
* Made available the two internal components of the SmoothGrad function: Dither_box_filter16 and Dither_limit_dif16.
* Added Dither_bilateral16, a bilateral filter giving cleaner results than the box filter for gradient smoothing.
* Improved GradFun3:
** Better detail/edge masking with adjustable thresholds and optional mask display for debugging purpose.
** Added two smoothing modes using the modified dfttest and the new bilateral filter. The latter is slow as hell and should be considered as experimental.
* Added a Dither_crop16 function to properly crop stacked 16-bit clips.
* Added a ''luma'' parameter to Dither_merge16_8 and fixed a slight chroma bug.

'''v1.7.1, 2011.05.11'''

* Dither.avsi doesn’t use Max anymore, so it can now run on Avisynth 2.5.7 or earlier.
* Bugfix in the modified MVTools2: the ''thSADC'' argument was ignored in MDegrain1/2/3.

'''v1.7, 2011.04.27'''

* Slightly improved Dither1Pre and Dither2Pre functions, added the ''overlap'' and ''tvopt'' parameters.
* People complained about GradFun3 being too strong and washing fine shades away, so I changed the default parameter values for a better match with the gradfun2db default settings. ''thr'' is set to 0.35 and ''radius'' to 12.

'''v1.6, 2011.04.10'''

* Masktools 2 a48 is now the minimum requirement because some Dither functions use the new bitwise operators. I don’t know how to automatically detect the Masktools version, so be sure to update your Masktools before installing this Dither version.
* The modified MVTools2 has been synchronised with the latest official release (2.5.11.2 beta)
* Renamed the ''rem'' parameters into ''clsb'' in DitherPost and SmoothGrad functions
* Changed the default for the ''stacked'' (now true) and ''prot'' (now false) parameters.
* Added various utility functions, mainly Dither_lut8, Dither_lut16, Dither_add16 and Dither_merge16.

'''v1.5, 2010.11.07'''

* Added error diffusion algorithms (Floyd-Steinberg, Stucki and Atkinson).
* Fixed the internal noise generator, now with a better randomness.

'''v1.4, 2010.09.24'''

* Added SmoothGrad as pre-processor to smooth the gradients before dithering.
* Added GradFun3, a tool derived from SmoothGrad for color-banding removal.
* Added the ''stacked'' parameter to DitherPost, for an easier use with the other functions.
* Changed the documentation.
* Fixed wrong output FPS in DitherPost when the input is submitted as an interleaved MSB-LSB clip.

'''v1.3, 2010.07.16'''

* DitherPost is now a plug-in instead of a script function. Doesn’t require NoiseGenerator anymore.
* Synchronised modified plug-ins: mvtools 2.5.10.1 and dfttest 1.8

'''v1.2, 2010.06.20'''

* Synchronised the modified mvtools2 with the latest official release.

'''v1.1, 2010.05.06'''

* Merged the DitherPost functions into a single one.
* Fixed the static pattern for chroma in 1-bit dithering.
* Strengthened the protection method and made it optional
* Added new dithering patterns and a test function.
* Added a masking function

'''v1.0, 2009.12.25'''

* Initial release

High bit-depth Support with Avisynth

2019-09-14T00:29:18Z

AmjadSONY: /* Introduction */

== Introduction ==
<div style="max-width:62em" >
Currently, Avisynth (not AvisynthPlus) only supports 8-bit video. Nevertheless, through various utilities, plugins, and scripts, Avisynth can be used to import, process, and export high bit-depth video. There has been some effort to update Avisynth itself to support high bit-depth, but there has been no progress as of 2012 (http://forum.doom9.org/showthread.php?t=162436).
</div>

== What is Deep Color? ==
<div style="max-width:62em" >
Deep Color refers to using more than 8 bits of data to represent each color channel. It is also referred to as high bit-depth color. Basically, deep color allows finer graduations of color, smoother gradients and more detail. Please refer to this short, easy to understand article: [http://www.pcworld.com/article/171223/what_is_10bit_color.html PCWorld: What is 10-bit Color?]
</div>

== Why Use Deep Color? ==
<div style="max-width:62em" >
*Higher internal precision, using high-bit depth color, when processing an image in a filter, gives a higher quality (8-bit) output.
*If a video filter uses linear gamma internally, there can be noticeable differences in the image. A linear gamma representation is best supported with a high bit-depth. See the illustration for [http://int64.org/projects/resamplehq/ ResampleHQ].
*If you encode high-bit depth video, you can get better compression (reportedly up to 30%) and less banding.
*Banding is one of the most serious liabilities of 8-bit depth. Refer to the following references for an explanation of why 10-bit encodes compress better:
**[http://x264.nl/x264/10bit_02-ateme-why_does_10bit_save_bandwidth.pdf Why does 10-bit save bandwidth (even when content is 8-bit)?.pdf]
**[http://x264.nl/x264/10bit_01-ateme_pierre_larbier_422_10-bit.pdf Using 10-bit AVC/H.264 Encoding with 4:2:2 for Broadcast Contribution.pdf]
**[http://x264.nl/x264/10bit_03-422_10_bit_pristine_video_quality.pdf Keeping Video Quality Pristine throughout the Production Process: 4:2:2 10-bit AVC/H.264 encoding.pdf]
</div>

== AviSynth+ Native Deep Color Support ==
<div style="max-width:62em" >
Since [https://github.com/pinterf/AviSynthPlus/releases/tag/r2290-MT r2290] (October 2016), {{AvsPluscon}} supports deep color – 10, 12, 14, 16 and 32-bit (floating point) RGB & YUV color spaces. All AVS+ color spaces are listed [[Avisynthplus_color_formats|here]]. Support functions include [[ConvertBits]], [[ConvertStacked]], [[Extract]] and [[CombinePlanes]]. Deep color support has also been added to all [[Internal_filters|internal filters]] and many [[AviSynth%2B_x64_plugins|external plugins]].

'''''This feature greatly simplifies use of deep color and could make much of the information below obsolete.'''''

See the [[AviSynth%2B|AviSynth+ main page]] for more information.
</div>

== Importing High Bit-depth Video into AviSynth ==
<div style="max-width:62em" >
For importing high bit depth video [http://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0] or greater is strongly recommended. AviSynth 2.6 adds the additional [[planar]] color spaces ([[Y8]],[[YV16]],[[YV24]], [[YV411]]) which makes it that much more compatible with all of the existing formats.

=== [[FFmpegSource|FFMS2]] ===
'''Patched FFMS2''' - import DNxHD, ProRes, and other 10-bit videos in their native format (4:2:2 and 4:4:4 are also supported), output greater than 8-bits will always be in the [[Stack16]] format.

*Source code: [http://github.com/SAPikachu/ffms2_hacks GitHub repository]
*Discussion: [http://forum.doom9.org/showthread.php?t=164841 Doom9 thread] - Importing DNxHD to Avisynth (some of the links may be outdated; see downloads below or [http://forum.doom9.org/member.php?u=135430 SAPikachu's signature] for latest versions)

==== Download ====
Updated binaries: March 15, 2015 | [http://www.mediafire.com/folder/2izh9abzep52o/Video_works older versions]
* [http://www.nmm-hd.org/upload/get~t6gq8DWihBs/ffms2-6e0d654+a9fe004-ffmbc-FFmbc-0.7.1.7z ffms2-6e0d654+a9fe004-ffmbc-FFmbc-0.7.1.7z] | [http://web.archive.org/web/20150321005059/https://www.nmm-hd.org/upload/get~t6gq8DWihBs/ffms2-6e0d654+a9fe004-ffmbc-FFmbc-0.7.1.7z mirror] - This version uses [http://code.google.com/p/ffmbc/ FFmbc] as a decoder; may have better support for professional video formats like ProRes, DNxHD, etc.
* [http://www.nmm-hd.org/upload/get~BLsLZwgj5ps/ffms2-6e0d654+a9fe004-ffmpeg-1e4d049.7z ffms2-6e0d654+a9fe004-ffmpeg-1e4d049.7z] | [http://web.archive.org/web/20150321005255/https://www.nmm-hd.org/upload/get~BLsLZwgj5ps/ffms2-6e0d654+a9fe004-ffmpeg-1e4d049.7z mirror] - This version uses [http://en.wikipedia.org/wiki/FFmpeg FFmpeg] as a decoder; may be better for general (more common) formats.
* [http://www.nmm-hd.org/upload/get~Q4mZfV9y0Og/ffms2-6e0d654+a9fe004-libav-9a60b1f.7z ffms2-6e0d654+a9fe004-libav-9a60b1f.7z] | [http://web.archive.org/web/20150321005339/https://www.nmm-hd.org/upload/get~Q4mZfV9y0Og/ffms2-6e0d654+a9fe004-libav-9a60b1f.7z mirror] - This version uses [http://en.wikipedia.org/wiki/Libav Libav] as a decoder; may be better for general (more common) formats.

These versions work just like the official [[FFmpegSource|FFMS2]], but includes the additional {{FuncDef3|enable10bithack}} parameter and support for the additional [[planar]] colorspaces available is AviSynth 2.6.
By default {{FuncDef3|enable10bithack}} is set to false so it will work just like the official FFMS2; to import high bit depth video set {{FuncDef3|enable10bithack}}<code>=true</code>, output will be in the [[Stack16]] format.
See [http://github.com/mpv-player/mpv/wiki/FFmpeg-versus-Libav FFmpeg versus Libav] for information on pros and cons and differences between the FFmpeg and Libav.<br/>


=== [[LSMASHSource]] ===
Another source filter to import regular 8-bit and high bit depth video. LSMASHSource includes these 2 fuctions to import video:
*[[LSMASHSource/LSMASHVideoSource|LSMASHVideoSource]] - This function uses [http://en.wikipedia.org/wiki/Libavcodec#Implemented_video_codecs libavcodec] as a video decoder and [http://github.com/l-smash/l-smash L-SMASH] as a demuxer. Recommended for MP4, MOV, [http://en.wikipedia.org/wiki/ISO_base_media_file_format ISO Base Media] and its derived file formats.<br/>
*[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]] - This function uses [http://en.wikipedia.org/wiki/Libavcodec#Implemented_video_codecs libavcodec] as a video decoder and [http://www.ffmpeg.org/libavformat.html libavformat] as a demuxer.<br/>

=== [[VapourSource]] ===
Can be used to import [http://www.vapoursynth.com/ VapourSynth] scripts into AviSynth. Video can be 8-bit or greater.

=== ImageMagick ===
You can also import video or still via 16-bit PNG format pictures with the following [http://www.imagemagick.org/ ImageMagick] command lines.

Examples shown are for Windows. Requires the 16-bit version of ImageMagick; get it [http://www.imagemagick.org/script/binary-releases.php#windows here] (look for downloads with ''Q16'' in the file name)

*Convert 16-bit to [[Stack16]] (high/low or stack16 format):<div {{BoxWidthIndent|60|1}} >
convert 16bit.png -depth 16 ( +clone -evaluate and 255 -evaluate multiply 256 )
-append stacked.png
</div><div style="max-width:62em" >

*Convert Stack16 (high/low) to 16bit:<div {{BoxWidthIndent|60|1}} >
convert stacked.png -depth 16 -crop 100%x50% ( +clone -evaluate divide 256 )
-delete 1 -compose Add -composite -define png:bit-depth=16 16bit1.png
</div>

For further explanation of these command lines, please see the thread [http://forum.doom9.org/showthread.php?t=172846 ''Image Magick and stacked high bit-depth''] (doom9.org)

=== Obsolete ===
'''The following methods are obsolete! If you must, only use as a verification or as workaround:'''<br>

*[http://forum.doom9.org/showthread.php?p=1526131#post1526131 Readv210mod] - Can read uncompressed v210 in .mov container as color. Needs a manual setting skip the file header.

*[http://sites.google.com/site/ourenthusiasmsasham/soft Sashimi] - Sashimi 0.85 has different bit-depth support. Please see OtherFormats/Read_v210.avs included in the package.

*[http://forum.doom9.org/showthread.php?t=158985 ReadV210] - Can read uncompressed v210 in .mov container as greyscale.
<br>
Alternative builds and methods of importing '''(also obsolete)''':

*[http://forum.doom9.org/showthread.php?p=1528494 ffms2mod] - Can return most 10bit video in the Avisynth high bit-depth convention.

*[http://forum.doom9.org/showthread.php?t=162598&page=2 RawSource with ffmpeg] - shows an example of using ffmpeg to convert to a 16bit format which can be read by RawSource in Avisynth 2.6.
</div>

== Processing High Bit-depth Video with AviSynth ==
<div style="max-width:62em" >
Some plugins support processing internally in a higher bit-depth for better quality and return an 8-bit video. Others support full high-bit processing and can retun a special format 16 bit video.

Most developers have adopted a vertically stacked format known as [[Stack16]], where the high bits (MSB) are stored in the upper half of a video, and the lower bits (LSB) in the lower half of the video.<br>
This special format must be processed only with high-bit aware scripts and plugins.<br>
* Multipurpose
**'''[[Dither_tools|Dither]]''' - A set of scripts, original and modified plugins to process 16-bit clips. Some of the functions include 16-bit color space conversion, debanding, denoising, resizing, and dithering 16-bit to lower bit depths.
**'''[http://github.com/tp7/CLExpr/releases CLExpr]''' - OpenCl plugin for runtime calculation of expressions on 8 and 16-bit depths clips. Makes mt_lutxy and mt_lutxyz possible on 16-bit. More information [http://forum.doom9.org/showpost.php?p=1672638 here].
**'''[http://forum.doom9.org/showthread.php?t=154971 SmoothAdjust]''' - High quality YUV color adjustment plugin. SmoothAdjust can input and output 16-bits; all calculations are internally done in 32-bit float to avoid rounding errors and artifacts.

* Antialiasing
**'''[[Xaa]]''' - anti-aliasing and resizing script.

* Color Correction
** '''[http://forum.doom9.org/showthread.php?t=167573 AutoAdjust]''' - Automatic color adjustment plugin.
** '''[http://www.snovidenie.com/plugins/hdr/ HDRMatrix]''' - Bt.601-Bt.709 conversion and RGB color correction filter, see [http://forum.doom9.org/showthread.php?t=172189&page=2#post1756038 discussion].

* Debanding
**'''[http://forum.doom9.org/showthread.php?t=161411 flash3kyuu_deband]''' - Debanding filter with 8/16 bit input/output. In addition flash3kyuu_deband can be used to dither 16-bit to lower bit depths.

* Degraining
**'''[[SMDegrain]]''' - mvtools+mdegrain denoising with 16-bit input and output.

* Denoising
**'''[http://forum.doom9.org/showthread.php?t=162342 DenoiseMD]''' - 8/16-bit denoise.
**'''[[Dfttest]]''' - 8/16-bit 2D/3D frequency domain denoiser.
**'''[http://forum.doom9.org/showthread.php?t=171379 KNLMeansCL]''' - OpenCL based Non Local Means denoising with support for 16-bit input and output.
**'''[http://forum.videohelp.com/threads/369142-Simple-MDegrain-Mod-v2-2d-A-Quality-Denoising-Solution SMDegrainMod]''' - 8/16 bit denoising with additional features like sharpening. [http://web.archive.org/web/20131210170708/http://doom10.org/index.php?topic=2178.0 Original Doom10 archived page.]
**'''[http://forum.doom9.org/showthread.php?t=167032 TempLinearApproximate]''' - 8/16 bit filter for temporal linear approximation between pixels . Meant mainly for denoising aid in motion compensated clips.
**'''[http://forum.doom9.org/showthread.php?t=172966 xNLMeans]''' - Implementation of the Non Local Means denoising algorithm, as described by Buades et al. Includes support for 16-bit input and output.

* Deringing
**[[HQDering_mod|'''HQDeringMod''']] - Deringing script with 16-bit input and output.

* Effects
**'''[[f3kgrain]]''' - Luma adaptive grain generator with 8/16-bit input and output.
**[http://www.snovidenie.com/plugins/hdr/ HDRNoise] - Random noise and film grain library, see [http://forum.doom9.org/showthread.php?t=172189&page=2#post1756038 discussion.]

* Frame Averaging
**'''[http://forum.doom9.org/showpost.php?p=1579509 AvgAll_16]''' - Average all frames in a clip with 16-bit accuracy.
**'''[http://forum.doom9.org/showthread.php?t=168048 ClipBlend16]''' - Blend an specified amount of frames into a single frame with 16-bit accuracy.
**'''[http://forum.doom9.org/showthread.php?t=163018 RedAverage]''' - 16-bit capable average with masking. Download latest version [http://chaosking.de/wp-content/uploads/avsfilters/Unclassified/RedAverage___(1.4.3_-_2011-12-02).7z here]

* Resizing
**'''[[Debicubic]]''' - This filter is designed to reverse the effects of bicubic upsampling. 8/16-bit input and output.
**'''[[Debilinear]]''' - This filter is designed to reverse the effects of bilinear upsampling. 8/16-bit input and output.
**'''[[nnedi3_resize16]]''' - An advanced script for high quality image resizing and colorspace conversion. It supports 16-bit input and output.
**'''[http://svn.int64.org/viewvc/int64/resamplehq/doc/index.html ResampleHQ]''' - Provides gamma-aware resizing and color space conversion. Uses 32-bit linear color internally but input and output is limited to 8-bit.
**'''[http://forum.videohelp.com/threads/369143-ResizersPack-MasksPack-PlaygroundPack-SmoothContrast-Logo-mod-functions?p=2364056 Resizers Functions Pack]''' - Includes LinearResize(), a function to resize in linear space. 8/16-bit input/output. [http://web.archive.org/web/20141105135234/http://doom10.org/index.php?topic=2182.0 Original Doom10 archived page.]

* Support
**'''[http://www.snovidenie.com/plugins/hdr/ HDRCore]''' - Basic YUV bitdepth and range conversion filters, see [http://forum.doom9.org/showthread.php?t=172189 discussion].

* Deprecated
**'''[http://forum.doom9.org/showthread.php?p=1467907#post1467907 Deep Color Tools]''' - This Script provides basic functions to import 10bit video, do color adjustments, and export to 8bit. (NOT RECOMMENDED, THERE ARE BETTER ALTERNATIVES)

You can also check the [[External_filters#Deepcolor_Filters|External Filters: DeepColor]] section, and the [[:Category:Deep_color_tools|Deep Color Tools]] category for possibly more listings.
</div>

== Codecs which support high bit-depth ==
<div style="max-width:62em" >
*[http://en.wikipedia.org/wiki/Animation_codec Apple Animation]

*[http://en.wikipedia.org/wiki/DNxHD DNxHD] also supported by [http://code.google.com/p/ffmbc/ ffmbc]

*[http://en.wikipedia.org/wiki/H.264 H.264] - 10-bit YUV 4:2:0/4:2:2/4:4:4 available via x264 (lossy/lossless compression supported).

*[http://en.wikipedia.org/wiki/High_Efficiency_Video_Coding HEVC] - 10-bit YUV 4:2:0/4:2:2/4:4:4 available via x265 (lossy/lossless compression supported).

*[http://en.wikipedia.org/wiki/ProRes ProRes 422]

*[http://www.videohelp.com/tools/Ut-Video-Codec-Suite Ut Video Codec Suite] - YUV 4:2:2 10bit (lossless compression).

*[http://en.wikipedia.org/wiki/VP9 VP9] - support for YUV 4:2:0/4:2:2/4:4:4 10-12bit encoding via [http://en.wikipedia.org/wiki/VP9#Profiles profiles 2 and 3.]

*[http://azfcpug.org/wp-content/uploads/2011/02/Digital%20Video%20Acquisition%20Codecs.pdf Digital Video Acquisition Codecs.pdf] [http://web.archive.org/web/20141021023458/http://azfcpug.org/wp-content/uploads/2011/02/Digital%20Video%20Acquisition%20Codecs.pdf mirror]
</div>

== Exporting High Bit-depth Video ==
<div style="max-width:62em" >
You can encode out of AviSynth to 10bit x264 via

*[http://tmod.nmm-hd.org/x264/ x264-tMod] - A modification to the x264 encoder to enable various enhancements, especially for the use of high-bit depth input. Supports the AviSynth high bit-depth convention, quality enhancements, bit-depth conversion, filters such as denoising and deinterlacing.

10bit x264 command-line example:<div {{BoxWidthIndent|60|1}} >
avs2yuv -raw "script.avs" -o - | x264-10bit --demuxer raw --input-depth 10
--input-res 1280x720 --fps 24 --output "out.mp4" -
</div>

*[[Avs2YUV]]

*[[avs2pipemod]]

*[[avs4x264mod]] - This command-line tool will directly convert from a high bit-depth convention Avisynth script to H.264 with x264, including the 10bit profile. Please check the [http://astrataro.wordpress.com/category/encode/x264/avs4x26x/ blog] for updated versions.

Example:<div {{BoxWidthIndent|60|1}} >
avs4x264mod.exe --x264-binary “C:\x264_64-abc.exe” -o out.264 in.avs
</div>

Some tutorials on exporting high bit depth image sequences:
*[http://web.archive.org/web/20130914191039/http://blendervse.wordpress.com/2011/09/16/8bit-video-to-16bit-scene-referred-linear-exrs/ 8-bit video to 16-bit Scene Referred Linear .EXR’s]
*[http://web.archive.org/web/20131112191047/http://blendervse.wordpress.com/2013/03/23/pipe-to-rgb-quick-how-to/ Pipe To RGB – Quick How To]
*[http://web.archive.org/web/20131009105710/http://blendervse.wordpress.com/2013/03/12/pipe-to-rgb-avspmod-to-imagemagick/ Pipe To RGB – AvsPmod To ImageMagick]
</div>

== Playback of High Bit-depth Videos ==
<div style="max-width:62em" >
*Most of the time you will only get to see dithered 8-bit video, as equipment to truly display high bit-depths is not as common at the consumer level in 2014 ([http://4ktvblog.com/10-bit-monitor list of 10-bit monitors]).

*The Blu-ray standard does not support high bit-depth video nor [http://en.wikipedia.org/wiki/XvYCC xvYCC] color space (full-range 8 bit video). On September 2014 it was announced that the up-and-coming [http://en.wikipedia.org/wiki/Blu-ray_Disc#4K_Blu-ray_Disc 4k Blu-ray] standard will support 10-bit video and a greater color gamut by using the [http://en.wikipedia.org/wiki/Rec._2020 Rec. 2020] color space.

*Digital theaters project up to 12-bit video; for more information read the wiki article: [http://en.wikipedia.org/wiki/Digital_Cinema_Initiatives#Image_and_audio_capability_overview Digital Cinema Initiatives]

=====Playback Software=====

*[http://forum.doom9.org/showthread.php?t=146228 MadVR]

*[http://mpc-hc.org/ MPC-HC]

*[http://forum.doom9.org/showthread.php?t=171120 MPDN]

*[http://www.videolan.org VLC]

=====Other Software and Information=====

*[http://forum.doom9.org/showthread.php?t=161548 Further information on high-bit playback]

*[http://haruhichan.com/wpblog/?p=205 An excellent guide on 10-bit playback]

*[http://forum.doom9.org/showthread.php?t=161915 FFdshow builds with 10-bit support] (deprecated)
</div>

== Sample High Bit-Depth Videos ==
<div style="max-width:62em" >
See this thread for links to examples. There are also deepcolor versions of standard test clips (used in image processing research). http://forum.doom9.org/showthread.php?t=158836&highlight=v210

todo add: piping RGB48 data from avs2yuv and export 16bit image sequences in either .tif or .exr preferably using ImageMagick: http://www.imagemagick.org/discourse-server/viewtopic.php?f=1&t=18943 or .jp2 image sequences http://www.imagemagick.org/discourse-server/viewtopic.php?f=3&t=24718
</div>

[[Category:Advanced topics]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-14T00:23:09Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st examples of both Stacked and DoubleWidth below.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::1st example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|56|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16bit clip with truerange=false
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2, Input_Depth=10, Output_Mode=2, Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

::2nd example,
<div {{BoxWidthIndent|56|4}} >
## 16bit clip here
'''ConvertToDoubleWidth'''()
[[Hqdn3d16Y]]()
'''ConvertFromDoubleWidth'''()
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:40:29Z

AmjadSONY: /* Examples */

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd examples below.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|56|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16bit clip with truerange=false
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2, Input_Depth=10, Output_Mode=2, Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:38:51Z

AmjadSONY: /* Examples */

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd examples below.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|56|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16bit clip with truerange=false
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2, Input_Depth=10, Output_Mode=2, Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:35:07Z

AmjadSONY: /* Double-Width / interleaved format */

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd examples below.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|56|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16bit clip with truerange=false
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2, Input_Depth=10, Output_Mode=2, Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:34:30Z

AmjadSONY: /* Double-Width / interleaved format */

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd examples below.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|56|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16bit clip with truerange=false
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:33:20Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd examples below.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|56|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16 bit clip with truerange=false
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:31:20Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd example.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for examples below.
## 10bit clip here
[[ConvertBits]](16, truerange=false) #convey 10bit clip on 16 bit clip by set truerange=false
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:15:07Z

AmjadSONY: /* Double-Width/interleaved format */

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd example.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width / interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false)
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:14:56Z

AmjadSONY: /* Stacked/lsb */

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd example.

== Examples ==

=== Stacked / lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width/interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false)
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:14:32Z

AmjadSONY: /* Stack16/lsb */

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd example.

== Examples ==

=== Stacked/lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width/interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false)
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T22:12:42Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

== Syntax and Parameters ==

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. see the 1st and 3rd example.

== Examples ==

=== Stack16/lsb ===
<div style="max-width:62em" >

::1st example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::2nd example,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

=== Double-Width/interleaved format ===
<div style="max-width:62em" >

::3rd example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false)
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

== Changes ==
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T21:57:09Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

==== Syntax and Parameters ====
<div style="max-width:62em" >

{{FuncDef|ConvertToStacked(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}} Accepts a 16-bit (HBD) clip and returns a Double-Width 8-bit clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}} Accepts a stacked clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}} Accepts a Double-Width clip and returns a HBD clip.<br>

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. For example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::another example of Stack16/lsb,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

::Double-Width example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false)
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

==== Changes ====
<div style="max-width:62em" >
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T21:50:28Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

==== Syntax and Parameters ====
<div style="max-width:62em" >

Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToStacked(clip ''clip'' ] )}}<br>

same as above but returns a Double-Width 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}}

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

Accepts a stacked/Double-Width clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}}<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}}

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. For example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::another example of Stack16/lsb,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

::Double-Width example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false)
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

==== Changes ====
<div style="max-width:62em" >
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T20:25:22Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] aka stacked (or lsb) and interleaved format to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]] aka HBD. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.

*the '''Double-Width''' aka interleaved 16-bit is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].

*both can be between 9-16 bits not only 16bit
</div>

==== Syntax and Parameters ====
<div style="max-width:62em" >

Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToStacked(clip ''clip'' ] )}}<br>
same as above but returns a Double-Width 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}}

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

Accepts a stacked/Double-Width clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}}<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}}

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. For example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::another example of Stack16/lsb,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

::Double-Width example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false)
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

==== Changes ====
<div style="max-width:62em" >
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T06:32:34Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]]. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''' aka lsb, the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.
*the '''Double-Width''' is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].
</div>

==== Syntax and Parameters ====
<div style="max-width:62em" >

Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToStacked(clip ''clip'' ] )}}<br>
same as above but returns a Double-Width 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}}

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

Accepts a stacked/Double-Width clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}}<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}}

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. For example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::another example of Stack16/lsb,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

::Double-Width example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false)
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

==== Changes ====
<div style="max-width:62em" >
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]

ConvertStacked

2019-09-13T06:24:54Z

AmjadSONY:

<div style="max-width:82em; min-width:42em;" >
{{AvsPlusFilter}}
__TOC__
</div>

<div style="max-width:42em" >
These conversion filters are to allow filters that [[High_bit-depth_Support_with_Avisynth#Processing_High_Bit-depth_Video_with_AviSynth|use 16-bit video in a pseudo-8-bit colorspace]] to interact with [[Avisynthplus_color_formats|AviSyth+ high bit depth formats]]. They are intended to serve as a stopgap until more plugins appear supporting true high bit depth.
</div>

==== Notes ====
<div style="max-width:42em" >
*In '''[[Stack16]]''', the picture is made of two parts: one containing the highest 8 bits (MSB) for each pixel, stacked on top of another containing the lowest 8 bits (LSB). it's used in [[Dither tools]] and many others.
*the '''Double-Width''' is similar to Stack16, but the MSBs and LSBs are horizontally ''interleaved'' which is like Native HBD, and it's faster than lsb. the known examples of it existing in [[flash3kyuu_deband]]\F3kdb\f3kdb_dither with input/output_Mode=2, [[LSMASHSource]] (not in the last updates since it support HBD) and some dither package functions like [[Dither_out()]], [[TODO|TODO: verify]].
</div>

==== Syntax and Parameters ====
<div style="max-width:62em" >

Accepts a 16-bit (HBD) clip and returns a stacked 8-bit clip.<br>
{{FuncDef|ConvertToStacked(clip ''clip'' ] )}}<br>
same as above but returns a Double-Width 8-bit clip.<br>
{{FuncDef|ConvertToDoubleWidth(clip ''clip'' ] )}}

:{{Par2|clip|clip|}}
::Source clip. Must be native 16 bit: YUV420P16, YUV422P16, YUV444P16, Y16.

Accepts a stacked/Double-Width clip and returns a HBD clip.<br>
{{FuncDef|ConvertFromStacked(clip ''clip'', int ''bits'' ] )}}<br>
{{FuncDef|ConvertFromDoubleWidth(clip ''clip'', int ''bits'' ] )}}

:{{Par2|clip|clip|}}
::Source clip. Must be YV12, YV16, YV24 or Y8.

:{{Par2|bits|int|16}}
::Bit depth of returned clip. Must match the original bit depth. For example,
<div {{BoxWidthIndent|46|4}} >
## Decoding 10bit, YUV 4:2:0 source
## this is not needed nowadays since LSMASHSource added HBD support
## so nowadays only [[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>) will did the job
## but just for example, keep in mind that lsb is the slowest
[[LSMASHSource/LWLibavVideoSource|LWLibavVideoSource]](<''path''>, stacked=true, format="YUV420P10")
'''ConvertFromStacked'''(bits=10)
## the line below is only if you need to down to 8bit
[[ConvertBits]](8, dither=0) # '0' means on, '-1' means off
</div>

::another example of Stack16/lsb,
<div {{BoxWidthIndent|46|4}} >
## some 16bit HBD clip here
'''ConvertToStacked'''()
[[Dfttest]](lsb_in=true, lsb=true)
'''ConvertFromStacked'''()
## Continue filtering with 16bit HBD
</div>

::Double-Width example (F3KDB can work with lsb but Double-Width is faster than lsb),
<div {{BoxWidthIndent|46|4}} >
## this not needed since neo_f3kdb support HBD, but just for example
## 10bit clip here
[[ConvertBits]](16, truerange=false)
'''ConvertToDoubleWidth'''()
[[F3KDB]](Input_Mode=2,Input_Depth=10,Output_Mode=2,Output_Depth=10)
'''ConvertFromDoubleWidth'''(bits=10)
</div>

==== Changes ====
<div style="max-width:62em" >
{|border=1 cellspacing=1 cellpadding=4
|-
| 20170310 r2440
| first added
|}
</div>

[[Category:Internal_filters]]
[[Category:Colourspace_Conversion]]
[[Category:Avisynthplus]]
[[Category:Deep_color_tools]]