View source for Xaa

{{FilterCat5|External_filters|Scripts|Restoration_filters|Anti-aliasing|Deep_color_tools}}
{{Filter3
| Desbreko
| v1.2.1
| [http://www.mediafire.com/download/sygi04y47eknvc2/xaa_v1.2.1.avsi xaa_v1.2.1.avsi]
| Anti-aliasing 
| 
| 
}}
== Description ==
A highly versatile [[anti aliasing|anti-aliasing]] function.<br>
<br>
== Requirements ==
* [x86]: [[AviSynth+]] or [https://sourceforge.net/projects/avisynth2/ AviSynth 2.6.0]
* [x64]: [[AviSynth+]]
* [[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: [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]

==== Required Plugins ====
Latest version of the following plugins are recommended unless stated otherwise.<br>
*[[Dither]]
*[[EEDI2]]
*[[eedi3|EEDI3]]
*[[FTurn]]
*[[MaskTools2]]
*[[nnedi3|NNEDI3]]
*[[nnedi3ocl]]
*[[RgTools]]
*[[SangNom2]]
*[[TCannyMod]]
*[[TEMmod]]

==== Required Scripts ====
*[[edi_rpow2]] | [http://www.mediafire.com/view/pcmkxaauku375xd/edi_rpow2_v1.0.avsi edi_rpow2_v1.0.avsi]
* [[ResizeX]] | [http://www.mediafire.com/download/lcbtb7uta4ta5pc/ResizeX_v1.0.avsi ResizeX_v1.0.avsi]
<br>

== [[Script variables|Syntax and Parameters]] ==
:{{Template:FuncDef|xaa (clip input, int "ow", int "oh", float "ss", val "ssw", val "ssh", string "mode", string "uscl", string "dscl", int "csharp", float "cstr", int "mask", string "mtype", float "mthr", int "chroma", string "cplace", int "nns", float "eedimthr", float "eediA", float "eediB", float "eediG", bool "lsb_in", bool "lsb", int "threads")}}
<br>
::{{Par2|input|clip| }}
:::Input clip to be processed.
<br>
::{{Par2|ow|int|input.width()}}
::{{Par2|oh|int|input.height()}}
:::The output width and height. Useful for when the video is going to be resized after antialising.
:::Use a negative value for either to disable resizing after supersampling. If not defined it defaults to the dimensions of the input clip.
<br>
::{{Par2|ss|float|2.0}}
:::The multiplier for determining the supersampled resolution which is then rounded to mod4.
:::Defaults to 1.0 (no supersampling) for double rate and double image antialiasing modes
<br>
::{{Par2|ssw|val|ss}}
::{{Par2|ssh|val|ss}}
:::Allows separate control of the supersampled width and height. Overrides the ss value.
:::When specified as a float, they act as a multiplier like the ss parameter.
:::When specified as an int, the given value is used for the supersampled width or height without rounding to mod4.
<br>
::{{Par2|mode|string|"sr SangNom2"}}
:::Specifies how to perform antialiasing in the format <tt>"[aa mode][direction][passes] [type] [sclip]"</tt> with the settings below available for each option. Antialiasing can also be disabled with <tt>"null"</tt>

:::{|
|-
|AA mode: 
|<code>sr, dr, di</code>
|-
|Direction: 
|<code>h, v, b</code>
|-
|Passes:
|<code>1 to 9</code>
|-
|Type: 
|<code>SangNom2, nnedi3, nnedi3ocl, eedi3, eedi2</code>
|-
|Sclip: 
|<code>SangNom2, nnedi3, nnedi3ocl, eedi2, or any resize kernel</code>
|}

:::'''AA Mode'''
:::The antialiasing mode determines what method of antialiasing is used.
:::*<tt>'''sr'''</tt> uses single rate deinterlacing, discarding one field of the frame and interpolating it from the remaining field.
:::*<tt>'''dr'''</tt> uses double rate deinterlacing, interpolating full-height frames from both fields and then blending the two together.
:::*<tt>'''di'''</tt> doubles the image height by interpolating every other line for the first pass, uses single rate deinterlacing for subsequent passes, and then downscales back to the original resolution.

:::'''Direction'''
:::By setting the direction to h or v, antialiasing can be applied only horizontally or vertically. If the direction is set to b or omitted, antialiasing will be applied in both directions.

:::'''Passes'''
:::The more passes used, the stronger the antialiasing will be. If the number of passes is omitted, it will default to 1.

:::'''Type'''
:::The type determines which deinterlacing plugin is used for antialiasing.

:::'''Sclip'''
:::The sclip option only applies when the type is set to eedi3 and will be undefined if omitted. If specified, the given deinterlacer or resize kernel will be used to generate the sclip for eedi3. See eedi3's documentation for more details.

:::'''Preset Modes'''
:::Preset modes which change the default settings to mimic other antialiasing functions are also available: <code>"maa2, "daa", "Mrdaa" or "MrdaaLame", "santiag"</code>

:::Equivalent settings:
:::{|
|-
|maa2: 
|<code>xaa(mtype="sobel", mthr=7)</code>
|-
|daa: 
|<code>xaa(mode="drv nnedi3", csharp=1, mask=0, chroma=1)</code>
|-
|Mrdaa:
|<code>xaa(mode="null", uscl="nnedi3", csharp=2, cstr=1.0, mask=0, chroma=1)</code>
|-
|santiag: 
|<code>xaa(mode="di2 nnedi3", mask=0, chroma=1)</code>
|}
<br>
::{{Par2|uscl|string|"Spline36"}}
::{{Par2|dscl|string|"Spline36"}}
:::The resize kernels used when upscaling, such as when supersampling, and when downscaling, such as when scaling back to the input resolution after supersampling.
:::Supports all of AviSynth's internal resizers and ResizeX's bicubic presets, and for upscaling, <code>"nnedi3", "nnedi3ocl", "eedi3",</code> and <code>"eedi2"</code> can also be used for their rpow2 image enlargement.

:::*For the <tt>Lanczos, Blackman,</tt> and <tt>Sinc</tt> kernels, the number of taps can be set with a number after the kernel name. E.g. <code>"Blackman3"</code> for <tt>BlackmanResize(taps=3)</tt>.

:::*For <tt>eedi3</tt> upscaling, the {{Template:FuncDef3|sclip}} setting can be specified with a resize kernel name or edi method on the end of the string. E.g. <code>"eedi3 nnedi3"</code> to upscale with <tt>eedi3</tt> using <tt>nnedi3</tt> as the {{Template:FuncDef3|sclip}}.
<br>
::{{Par2|csharp|int|0}}
:::*0 : No contra-sharpening.
:::*1 : Applies contra-sharpening before scaling to output resolution.
:::*2 : Applies contra-sharpening after scaling to output resolution.
<br>
::{{Par2|cstr|float|-1.0}}
:::Controls the strength of the contra-sharpening.
:::Any negative value uses RemoveGrain(11) as in daa.
:::A positive value uses Blur as in Mrdaa, up to a max of 7.9.
:::A value of 0 disables contra-sharpening and overrides the csharp setting.
<br>
::{{Par2|mask|int|1}}
:::* 0 : Processes the entire frame
:::* 1 : Processes edges only
:::* 2 : Processes everything except edges

:::A negative value will show an overlay of the mask.
<br>
::{{Par2|mtype|string|"TEMmod"}}
:::The type of edge mask to use. Options are: <code>"TEMmod", "TCannyMod"</code>, and mt_edge's <code>"sobel", "roberts", "laplace", "prewitt", "cartoon",</code> and <code>"min/max"</code>. A custom kernel for mt_edge may also be used. See its documentation for more info.
:::TEMmod's type parameter can be set with a number on the end of the string. E.g. "TEMmod5" for type=5. If no number is given, the default of 4 is used. See TEMmod's documentation for explanations of the different types.
:::This setting also determines the mask type for the eedimthr parameter.
<br>
::{{Par2|mthr|float|8.0}}
:::The threshold of the edge mask. Rounded to the nearest integer for mt_edge types.
:::*When mask=1, lower values result in more edges getting antialiased.
:::*When mask=2, lower values result in fewer edges getting excluded.
<br>
::{{Par2|chroma|int|0}}
:::* 0 : Processes the luma plane only
:::* 1 : Processes both the luma and chroma planes
:::* 2 : Processes the chroma planes only
<br>
::{{Par2|cplace|string|"MPEG2"}}
:::Specifies the input's chroma placement. Options are <code>"MPEG1"</code> and <code>"MPEG2"</code>.
:::Only applies to formats with subsampled chroma. Note that only [[YV12]] should be able to have MPEG1 chroma placement.
<br>
::{{Par2|nns|int|1}}
:::nnedi3's <tt>nns</tt> parameter for <tt>nnedi3</tt> and <tt>nnedi3ocl</tt> antialiasing. Ranges from 0 to 4. Higher values will provide better quality but will be slower.
:::This setting doesn't affect upscaling with <tt>nnedi3</tt> or <tt>nnedi3ocl</tt>.
<br>
::{{Par2|eedimthr|float|0.0}}
:::A value greater than 0 creates an edge mask with the given value's threshold to be used with <tt>eedi3</tt> antialiasing and upscaling.
:::Edge-directed interpolation will be used only on masked edges, increasing eedi3's speed as the threshold is raised, but at the risk of excluding edges that need antialiasing.
<br>
::{{Par2|eediA|float|0.2}}
::{{Par2|eediB|float|0.25}}
::{{Par2|eediG|float|20.0}}
:::eedi3's <tt>alpha, beta,</tt> and <tt>gamma</tt> parameters for <tt>eedi3</tt> antialiasing and upscaling. They adjust the balance between connecting lines and creating artifacts.
:::{{Template:FuncDef3|eediA}} and {{Template:FuncDef3|eediB}} must be in the range 0 to 1 and their sum can't exceed 1. See eedi3's documentation for more info.
<br>
::{{Par2|lsb_in|bool|false}}
:::Set to true if the input is a stacked 16-bit clip.
:::Because none of the plugins used for antialiasing support 16-bit, the input will almost always need to be dithered to 8-bit at some point, but it will be processed in 16-bit where possible.
<br>
::{{Par2|lsb|bool|false}}
:::Set to true to output a stacked 16-bit clip.
:::Because some functions don't support 16-bit, a few combinations of settings will result in the lsb being empty.
<br>
::{{Par2|threads|int|Undefined}}
:::The number of threads to use for each instance of SangNom2, nnedi3, and eedi3.
:::Leave this undefined to let the plugins choose automatically.
<br>

== Examples ==
xaa with default settings:
 [[AviSource]]("Blah.avi")
 xaa()

Downscaling an 8-bit source with 16-bit processing
[http://forum.doom9.org/showthread.php?p=1724750#post1724750 (source)]
 # 8-bit 1080p source 
 xaa(ow=1280, oh=720, mode="nnedi3", lsb=true)
 [[Dither_tools#GradFun3|GradFun3]](thr=0.2, lsb=true, lsb_in=true)
 [[Dither_tools#Dither_out|Dither_out]]()
<br>

== Changelog ==
 Version      Date            Changes<br>
 v1.2.1       09/13/2015      - Fixed a bug in eedi3 upscaling with an sclip setting.<br>
 v1.2         09/11/2015      - Added nnedi3ocl antialiasing and upscaling
                              - FTurn is now optional
                              - Resize8 is no longer required
                              - ResizeX is now required
                              - edi_rpow2 is now required
                              - Added support for YV16 and YUY2
                              - Removed dithermode parameter
                              - Added cplace parameter
                              - Changed the syntax of the mode parameter string (old settings still work)
                              - Added "santiag" preset mode
                              - Added double image antialiasing mode
                              - Added multipass antialiasing
                              - Added horizontal-only and vertical-only antialiasing
                              - All deinterlacing plugins can now be used for all antialiasing modes
                              - The eedimthr parameter now also applies to upscaling with eedi3
                              - Expanded support for eedi3's sclip parameter for both antialiasing and upscaling
                              - Added eedi2 upscaling<br>
 v1.1.2       08/14/2015      - Fixed center shift and csharp=1 for mode="eedi2". Border fix now used for all modes but eedi2.<br>
 v1.1.1       04/09/2015      - Added option to set TEMmod's type that I forgot
                              - Improved handling of borders with merged modes<br>
 v1.1         02/28/2015      - Supports TEMmod and TCannyMod masks, more eedi3 options, MrdaaLame preset as fast as the original.<br>
 v1.0.3       11/06/2014      - Fixed a bug with csharp=2. It wasn't actually being applied when lsb=true<br>
 v1.0.2       11/02/2014      - Now preserves the lsb in masked areas when using csharp=2, cstr>0, mask>0<br>
<br>
== External Links ==
<br>
<br>
-----------------------------------------------
'''Back to [[External_filters#Anti-aliasing|External Filters]] &larr;'''