Avisynth wiki - User contributions [en]

Plugins

2014-11-20T03:07:30Z

AlanHK: /* Plugin autoload and name precedence v2 */

== Commands for loading plugins ==

With these functions you can add external functions to AviSynth.

LoadPlugin ("filename" [, ...])

Loads one or more external avisynth plugins (DLLs).

LoadVirtualDubPlugin ("filename", "filtername", preroll)

This loads a plugin written for [[VirtualDub]]. "filename" is the name of the .vdf file. After calling this function, the filter will be known as "filtername" in AviSynth. VirtualDub filters only supports [[RGB32]]. If the video happens to be in RGB24-format, then you must use [[ConvertToRGB32]] ([[ConvertToRGB]] won't suffice).

Some filters output depends on previous frames; for those preroll should be set to at least the number of frames the filter needs to pre-process to fill its buffers and/or updates its internal variables.

LoadVFAPIPlugin ("filename", "filtername")

This allows you to use VFAPI plugins (TMPGEnc import plugins).

LoadCPlugin ("filename" [, ...])
Load_Stdcall_Plugin ("filename" [, ...])

Loads so called Avisynth C-plugins (DLLs).
Load_Stdcall_Plugin() is an alias for LoadCPlugin().
C-plugins are created on pure C language and use special "AviSynth C API" (unlike ordinary Avisynth plugins which are created with MS C++). C-plugins must be loaded with LoadCPlugin() or Load_Stdcall_Plugin().

Kevin provides a LoadCPlugin.dll that overloads the LoadCPlugin() verb to support plugins compiled using the C subroutine calling sequence, use Load_Stdcall_Plugin() to load stdcall calling sequence plugins when using Kevins version. Advice: keep these plugins outside your auto plugin loading directory to prevent crashes. ([http://forum.doom9.org/showthread.php?s=&threadid=58840 discussion]), ([http://kevin.atkinson.dhs.org/avisynth_c/ AVISynth C API (by kevina20723)]).

== Plugin autoload and name precedence v2 ==

It is possible to put all plugins and script files with [[User_defined_script_functions|user-defined functions]] or (global) [[Script_variables|variables]] in a directory from where all files with the extension .AVSI (v2.08, v2.5, the type was .AVS in v2.05-2.07) and .DLL are loaded at startup, unloaded and then loaded dynamically as the script needs them.

.AVSI scripts in this directory should only contain function definitions and global variables, no main processing section (else strange errors may occur), it also is not recommended to put other files in that directory.

The directory is stored in the registry (the registry key has changed for v2.5). You can use double-clicking a .REG-file with the following lines to set the path (of course inserting your actual path):

REGEDIT4

[HKEY_LOCAL_MACHINE\SOFTWARE\Avisynth]
"plugindir2_5"="c:\\program files\\avisynth 2.5\\plugins"

The order in which function names take precedence is as follows:

* user-defined function (always have the highest priority)
** plugin-function (higher priority than built-in, will override a built-in function)
*** built-in function

Inside those groups the function loaded at last takes precedence, there is no error in a namespace conflict.

== Plugin autoload and conflicting function names v2.55 ==

Starting from v2.55 there is DLLName_function() support. The problem is that two plugins can have different functions which are named the same. To call the needed one, DLLName_function() support is added. It auto-generates the additional names both for auto-loaded plugins and for plugins loaded with LoadPlugin.

'''Some examples:'''

# using fielddeinterlace from decomb510.dll
AviSource("D:\captures\jewel.avi")
decomb510_fielddeinterlace(blend=false)

Suppose you have the plugins mpeg2dec.dll and mpeg2dec3.dll in your auto plugin dir, and you want to load a d2v file with mpeg2dec.dll (which outputs YUY2):

# using mpeg2source from mpeg2dec.dll
mpeg2dec_mpeg2source("F:\From_hell\from_hell.d2v")

or with mpeg2dec3.dll (which outputs YV12):

# using mpeg2source from mpeg2dec3.dll
mpeg2dec3_mpeg2source("F:\From_hell\from_hell.d2v")

----
Back to [[AviSynth Syntax]].

[[Category:AviSynth_Syntax]]
[[Category:Scripting_Basics]]

EditingFunctions

2012-01-21T07:32:22Z

AlanHK: missing++

Here are some functions I made and added to my plugins directory because I was sick of typing them so much. Hope you find them useful.

# inserts the clip 'inclip' into 'old' at index 'frame'
function Insert (clip old, clip inclip, int frame)
{
return old.[[Trim]](0, frame - 1) + inclip + old.Trim(frame, 0)
}

# as above, using aligned splices
function AlignedInsert (clip old, clip inclip, int frame)
{
return old.Trim(0, frame - 1) ++ inclip ++ old.Trim(frame, 0)
}

# replace 'numframes' frames of 'old' with 'inclip', starting at 'frame'
function Replace (clip old, clip inclip, int frame, int numframes)
{
numframes = ((numframes == 0) || (numframes > inclip.[[Clip_properties|framecount]])) ? inclip.framecount : numframes
return old.Trim(0, frame - 1) + inclip.Trim(0, numframes) + old.Trim(frame + numframes, 0)
}

# as above, using aligned splices
function AlignedReplace (clip old, clip inclip, int frame, int numframes)
{
numframes = (numframes == 0 || numframes > inclip.framecount) ? inclip.framecount : numframes
return old.Trim(0, frame - 1) ++ inclip.Trim(0, numframes) ++ old.Trim(frame + numframes, 0)
}

[[Category:Shared functions]]

Subtitle

2011-09-07T06:56:12Z

AlanHK: multi-line is allowed

{{Template:FuncDef|Subtitle(clip ''clip'', string ''text'', float ''x'', float ''y'', int ''first_frame'', int ''last_frame'', string ''font'', int ''size'', int ''text_color'', int ''halo_color'', int ''align'', int ''spc'', int ''lsp'', float ''font_width'', float ''font_angle'', bool ''interlaced'')|Subtitle(clip ''clip'', string ''text'')}}

The Subtitle filter adds anti-aliased text to a range of frames. All parameters after ''text'' are optional and can be omitted or specified out of order using the ''name=value'' syntax.

===Parameters===

''text'' is the text which will be overlayed on the clip starting from frame ''first_frame'' and ending with frame ''last_frame''.

(''x'',''y'') is the position of the text. The parameters ''x'' and ''y'' can be set to -1 to automatically calculate and use the horizontal or vertical center coordinate. Other negative values of ''x'' and ''y'' can be used to give subtitles partially off the screen. '''Caution:''' If your script uses Subtitle with [[Animate]] and negative ''x'' or ''y'' values, ''x'' or ''y'' might momentarily become -1, causing a glitch in the video. Starting from v2.60 they can be float.

''font'' is the font of the text (all installed fonts on the current machine are available, they are located in your 'windows\fonts' folder).

''size'' is the height of the text in pixels, and is rounded to the nearest 0.125 pixel.

The ''text_color'' and ''halo_color'' should be given as hexadecimal $aarrggbb values, similar to HTML--except that they start with $ instead of # and the 4th octet specifies the alpha transparency. $00rrggbb is completely opaque, $FF000000 is fully transparent. You can disable the halo by selecting this color. See [[Colors]] for more information on specifying colors.

The ''align'' parameter allows you to set where the text is placed relative to the (x,y) location and is based on the numeric keypad as follows:

{| border="1"
|-
| <left> 7 <top>
| <nowiki><center></nowiki> 8 <top>
| <right> 9 <top>
| top of text aligned to y-location for align=7,8,9
|-
| <left> 4 <baseline>
| <nowiki><center></nowiki> 5 <baseline>
| <right> 6 <baseline>
| baseline of text aligned to y-location for align=4,5,6
|-
| <left> 1 <bottom>
| <nowiki><center></nowiki> 2 <bottom>
| <right> 3 <bottom>
| bottom of text aligned to y-location for align=1,2,3
|-
| start at x for align=1,4,7
| center on x for align=2,5,8
| end at x for align=3,6,9
|
|}

Note: There is no Y-center alignment setting.

The ''spc'' parameter allows you to modify the character spacing (0=unchanged). The value can be positive or negative to widen or narrow the text. Per the Visual C++ documentation of the function SetTextCharacterExtra(), that performs this task, this value is in logical units and rounded to the nearest 0.125 pixel. This is helpful for trying to match typical fonts on the PC to fonts used in film and television credits which are usually wider for the same height or to just fit or fill in a space with a fixed per-character adjustment.

Multi-line text using "\n" is added in v2.57 and it is used if the lsp (line spacing) parameter is set. It sets the additional line space between two lines in 0.125 pixel units. (In the unlikely event that you want to output the characters "\n" literally in a multi-line text, you can do this by using "\\n".)

The ''font_width'' parameter allows you to modify, in 0.125 units, the aspect ratio of character glyphs per the Visual C++ documentation of the function CreateFont(). It is related to the size parameter by the default GDI aspect ratio and the natural aspect ratio of the chosen font.

The ''font_angle'' parameter allows you to modify the baseline angle of text in 0.1 degree increments anti-clockwise.

The ''interlaced'' parameter when enabled reduces flicker from sharp fine vertical transitions on interlaced displays. It applies a mild vertical blur by increasing the window for the anti-aliaser to include 0.5 of the pixel weight from the lines above and below.

The short form (with all default parameters) is useful when you don't really care what the subtitle looks like as long as you can see it--for example, when you're using [[StackVertical]] and its ilk to display several versions of a frame at once, and you want to label them to remember which is which.

This filter is used internally by AviSynth for the [[Version]] command and for reporting error messages, and the subtitling apparatus is also used by [[ShowFrameNumber]].

===Default values===

:''clip''
::: last

:''text''
::: no default, must be specified

:''x''
::: 8 if align=1,4,7 or none; -1 if align=2,5,8; or width-8 if align=3,6,9

:''y''
::: ''size'' if align=4,5,6 or none; 0 if align=7,8,9; or height-1 if align=1,2,3

:''first_frame''
::: 0

:''last_frame''
::: framecount(''clip'')-1

:''font''
::: "Arial"

:''size''
::: 18.0

:''text_color''
::: $00FFFF00 <full opaque yellow>

:''halo_color''
::: 0 <full opaque black>

:''align''
::: Normally 4 <left and baseline>; if x=-1, then 5 <horizontal center and baseline>

:''spc''
::: 0 <font spacing unchanged>

:''lsp''
::: <multiline is not enabled>

:''font_width''
::: 0 <system default>

:''font_angle''
::: 0.0 degrees

:''interlaced''
::: false

===Examples===

# Some text in the center of the clip:
AviSource("D:\clip.avi")
Subtitle("Hello world!", align=5)

# Some text in the upper right corner of the clip with specified font, size and color:
AviSource("D:\clip.avi")
Subtitle("Hello world!", font="georgia", size=24, text_color=$ff0000, align=9)

# Prints text on multiple lines
# without any text halo border.
BlankClip()
Subtitle( \
"Some text on line 1\\nMore text on line 1\n" + \
"Some text on line 2", \
lsp=10, halo_color=$ff000000)

# It results in:
Some text on line 1\nMore text on line 1
Some text on line 2

# Use String() to display values of functions.
AviSource("D:\clip.avi")
Subtitle("Width=" + String(Width()))

===Changes===

{| border="1"
|-
| v2.60
| position (x,y) can be float (previously int) (with 0.125 pixel granularity).
|-
| v2.58
| Added font_width, font_angle, interlaced and alpha color blending.
|-
| v2.57
| Added multi-line text and line spacing parameter.
|-
| v2.07
| Added ''align'' and ''spc'' parameters. Setting y=-1 calculates vertical center (alignment unaffected). Default ''x'' and ''y'' values dependent on alignment (previously x=8, y=''size'').
|-
| v1.00
| Setting x=-1 uses horizontal center and center alignment (undocumented prior to v2.07).
|}

===See also===

There are [[External_filters#Subtitling|external subtitling filters]] that display SRT, SSA, and other format subtitle files or offer more elaborate formatting.

[[Category:Internal filters]]

SmoothDeinterlaceFunctions

2010-08-23T14:27:59Z

AlanHK: specific link

SmoothDeinterlace is Xesdeeni2001's port of Gunnar Thalin's 'Smooth' deinterlacer for VirtualDub.

It is hosted on [http://www.guthspot.se/video/AVSPorts/SmoothDeinterlacer/ Gunnar Thalin's webpage].

One of the many cool things you can do with this filter is convert between broadcast formats with much less quality loss than would be possible using standard AviSynth filters alone. Here are some functions suggested in the documentation; feel free to use them.

function PAL2NTSC_DV(clip c)
{
c.SmoothDeinterlace(tff=false, doublerate=true)
BilinearResize(720, 480)
[[ChangeFPS]](59.94)
SeparateFields()
SelectEvery(4, 0, 3)
}

function NTSC2PAL_DV(clip c)
{
c.SmoothDeinterlace(tff=false, doublerate=true)
[[BilinearResize]](720, 576)
[[ConvertFPS]](50)
SeparateFields()
SelectEvery(4, 0, 3)
}

function PAL2NTSC_DVD(clip c)
{
c.SmoothDeinterlace(tff=true, doublerate=true)
BilinearResize(720, 480)
ChangeFPS(59.94)
[[SeparateFields]]()
SelectEvery(4, 1, 2)
}

function NTSC2PAL_DVD(clip c)
{
c.SmoothDeinterlace(tff=true, doublerate=true)
BilinearResize(720, 576)
ConvertFPS(50)
SeparateFields()
[[SelectEvery]](4, 1, 2)
}

Like what you see? Just copy the above into a script, put it in your plugins directory and start using them immediately!

[[Category:Shared functions]]

UnFilter

2010-04-14T07:50:35Z

AlanHK: add abstract

{{FilterCat|External_filters|Adjustment_filters|Sharpeners}}
{{Template:FuncDef|UnFilter(clip source, int ''HSharp'', int ''VSharp'') }}
{{Filter
|[http://www.trbarry.com Tom Barry]
|0.0.1.5
|[http://www.trbarry.com/UnFilter.zip UnFilter.zip]
|Adjustment filters
|[[YV12]]
|GPL
}}
== Abstract ==
UnFilter is a simple and reasonably fast Avisynth Soften/Sharpen filter.

It implements 5-tap user adjustable horizontal and vertical filters designed to
(slightly) reverse previous efforts at softening or edge enhancement that are
common (but ugly) in DVD mastering. Since DVDs were intended originally
for interlaced displays this has caused content providers to vertically filter
them even a bit more to hide interlacing artifacts. They sometimes overdo
the edge enhancement.

When softening it will attempt to approximate the inverse of a simple 3-tap edge
enhancement filter. When sharpening it will attempt to approximate the inverse
of a simple 3-tap softening filter. For the math and logic involved see
the comments in the UnFilterALL.inc member included in zip file.

The effects are fairly mild but be aware that excessive sharpening makes things
harder to compress and may bring about the dreaded "edge enhancement artifacts"
the people complain about in DVDs from some studios. And while excessive
softness may hide noise it loses detail and generally just looks ugly. So it is
probably best to just try to reverse whatever has already been done to your source.

UnFilter should run on all MMX machines or higher. It has also has some added code
for 3DNOW instructions for when it is running on a K6-II or higher and some SSEMMX
for P3 & Athlon.

==Known issues and limitations==

Assumes YUV (YUY2) or YV12 Frame Based input. Use an AVIsynth function to convert first if needed.

Currently still requires the pixel width to be a multiple of 2.

YV12 support for Avisynth 2.5 alpha release only.

== Requires Filters ==

[http://www.trbarry.com/UnFilter.zip Unfilter.dll]

==Parameters==

{{ParR|HSharp|int|0|-100-100}}
Horizontal sharpness. Valid values are from -100 (max softness) through zero (neutral) through +100 (max sharpness).

{{ParR|VSharp|int|0|-100-100}}
Vertical sharpness. Valid values are from -100 (max softness) through zero (neutral) through +100 (max sharpness).

== Examples==

Extreme sharpening
LoadPlugin("F:\UnFilter\UnFilter.dll")
Avisource("D:\wherever\myfile.avi")
UnFilter(100,100)

==External Links==
*[http://www.trbarry.com Tom Barry's Avisynth filters]
*[http://forum.doom9.org/showthread.php?s=&threadid=28197&pagenumber=3 Doom9 discussion]

YAHR

2010-04-14T06:38:32Z

AlanHK: /* Abstract */

{{FilterCat|External_filters|Restoration_filters|Dehaloers}}
{{Filter
|Didée
|1.0
|[http://avisynth.org/mediawiki/upload/f/f9/YAHR.avsi YAHR.avsi]
|Dehaloers
|
* YV12
|}}

{{Template:FuncDef|YAHR( )}}

== Abstract ==

'''Y'''et '''A'''nother '''H'''alo '''R'''educing script

=== Requires Filters ===
*[[aWarpSharp]]
*[[MaskTools]]
*[[MedianBlur]]
*[[MinBlur]]
*[[RemoveGrain]]
*[http://avisynth.org/mediawiki/RemoveGrain Repair.dll] part of the RemoveGrain package

== Description ==

Removes halos from overenhanced edges.

== Examples ==

[[AviSource]]("Blah.avi")
YAHR()

== Links ==
Post by Didée : [http://forum.doom9.org/showthread.php?p=1205653#post1205653 link]

Follow the discussion in its [http://forum.doom9.org/showthread.php?p=1205653 Doom9 thread].

AddAudio

2010-02-22T00:03:36Z

AlanHK:

Since [[ResampleAudio]] no longer adds empty sound to a clip when used, this workaround can no longer be used for avoiding crashes in CCE 2.50. Therefore a function has been made to add audio to a clip.

Save the following text in a file called "addaudio.avsi" and place it in the AviSynth plugin directory:

function AddAudio(clip v1)
{
v2 = Blankclip(audio_rate=44100,sixteen_bit=true,stereo=true,length=v1.FrameCount,fps=v1.FrameRate)
v1 = AudioDub(v1,v2)
return v1
}

To use the script, use:

AddAudio()

at the end of the script instead of the earlier ResampleAudio(44100).

[[Category:Shared functions]]

Srestore

2010-01-20T05:09:45Z

AlanHK: formatting

{{FilterCat|External_filters|Restoration_filters|Deblenders}}
{{Filter|MOmonster|2.7e|[[Media:srestore.avsi|srestore.avsi]]|Deblenders|
* YV12
|}}
{{Template:FuncDef| srestore(clip source, float ''frate'', int ''dmode'', ''omode'', float ''blocks'', int ''mthresh'', int ''bthresh'', bool ''chroma'', int ''cache'', float ''rr'', clip ''dclip'') }}

== Abstract ==
[[Srestore]] is the replacement function for [[mrestore]], Cdeblend, FixBlendIVTC and DupHq from the [[R_pack]]. It is an AviSynth script function that uses conditional frame evaluation for the output calculation. Generally it was written to undo norm-conversions with blends, but the last version can be useful for decimation ratios between 5 and 1 using the ''frate'' parameter.

Important note: Srestore can only be called one time in any script due to its use of global variables.

== Requires Filters ==
*[[MaskTools2]]
*[[TIVTC]] Version 1.04 or higher (only for cache>0, not default)
*[[RemoveGrain]] (only for double-blend-removal, not default)
*[http://forum.doom9.org/showthread.php?p=1129919#post1129919 Average] (only for double-blend-removal, not default)

==Parameters==
{{Par|frate|float|optional}}
You don't need to set the decimation parameters for the norm conversions restoring Pal_to_NTSC (50->23.976 or 25->11.988) and NTSC_to_Pal (59.94->25 or 29.97->12.5), but for some seldom other blend conversion (for example 29.97 back to 23.976 or 50 to 25 - DEFT). Use frate to set the wanted output-framerate. If source-framerate/frate >5 or <1 the output-framerate will be the same as the input-framerate. This can be useful if you want to have only the dup functionality of srestore.

{{ParR|omode|string|6|0-6 or mode}}
Srestore can be used as blend-decimation-function, as simple deblend-function and for double-blend-removal
: 1 - deblend-mode 1 -> detected blends will be replaced with the previous frame
: 2 - deblend-mode 2 -> next frame is used instead of the detected blend
: 3 - deblend-mode 3 -> detected blends will be replaced with the neighbour that has the smaller difference
: 4 - deblend-mode 4 -> use the neighbour with the smaller blend-possibility
: 5 - deblend-special -> outputs the one of four frames with the smallest blend-possibility
: >5 - blend-decimation -> for all decimation operations

The output-modes 1-5 are simple deblending modes, so the framerate will not change.

To enable the double-blend-removal you have to set a string for omode. This string decides about the postprocessing mode that is used on the restored frames:
: pp0 -> the fastest mode, no postprocessing
: pp1 -> use difference masking, higher quality and still good speed
: pp2 -> use a special blurring mask on luma and chroma that reduces artefacts
: pp3 -> combines postprocessing 1 and 2 -> slowest

You can add also your own postprocessing to these modes. Just add your function like this:

omode="pp3.blur(1)" -> pp3 + blurring
If you want to add a function with its own inputstrings use three quotation marks:
omode="""pp2.deen("a2d")"""

Important Note: Also the double-blend-removal does no decimation. It's created only for double-blends caused by blend deinterlacing of telecined sources. You have to add an decimation function for full restoring:

source #progressive
srestore(dmode=-4,omode="pp0")
decimate(cycle=5,quality=0) #recommed decimating

{{ParR|speed|int|9|-25-25}}
With the speed parameter you can set a speed-vs-detail-detection value. If you set speed=25, only one of 25 pixels (5*5) is used for the detection. Higher values result in a lower possibility of low-detail detection. Set a negative speed value for high quality and hd sources. This can improve the detection of small details.

{{ParR|mode|int|2|1-3}}
With the mode parameter you can decide if chroma should be used for detection and if srestore have to merge neighboured frames or look for dups to improve output quality:
: 1 - simple output mode, decimation is not touched
: 2 - duping feature, if a frame has a dup-neighbour, that seems to have a higher quality, this one will be outputed
: 3 - like 2 but the duplicates will be merged
: >3 - mode 2 and 3 combined
By setting the compatible negative values, the chroma values will be also used for the detection.
Note: The double-blend-removal does not use this parameter (-> only mode 1 or -1).

{{ParR|thresh|int|22|12-44}}
The detection of srestore is pretty stable, but the threshold is still important to weight the detection influence. Use small values for sources with little temporal artefacts (bobbing effect, aliasing, blocks, noise, ...) and higher values for the opposite case.

{{ParR|cache|int|-1|-1-10}}
With cache>=0 srestore use the RequestLinear function (TIVTC) to be more compatible with non-linear requesting (codec or other functions). Best way to use srestore is to do a lossless first pass right after calling srestore and do all other filtering and the final encoding in a second pass. If you do not have enough space to do a lossless pass and you cannot avoid non-linear frame requesting and the pattern of the source is pretty unstable set cache around 5-10, but keep in mind that this can increase memory usage.

{{Par|dclip|clip|input}}
The '''d'''etection '''clip''' can be used to improve (deblock, smooth, ...) and speed-up blend and motion detection. The selected clip is only used for detection and not for output, so it does not affect the output quality.
If you use a high quality deinterlacing on the source you can speed up the detection by using a faster deinterlacing function (third code example) for the detection clip.
It's recommended to crop the bobbed source (deinterlace BEFORE cropping!) to avoid the detection influence of the bobbing borders (second code example).

== Examples==

bobbed (or progressive) source
srestore()

or:
ord = last.getparity() ? 1 : 0
leakkernelbob(ord,4,true,true)
srestore(dclip=last.crop(8,16,-8,-24))

or:
d = last.bob(-0.2,0.6).reduceflicker(strength=1)
tdeint(mode=1) #or for example yadif(mode=1)
srestore(mode=4,dclip=d)

==External Links==
*[http://forum.doom9.org/showthread.php?t=95924 Discussion thread] at [http://forum.doom9.org/ Doom9's Forum]

C deblend

2010-01-20T04:27:20Z

AlanHK: /* Parameters */

{{FilterCat|External_filters|Restoration_filters|Deblenders}}
{{Filter|MOmonster|1.1b|[[Media:Cdeblend.avs|Cdeblend.avs]]|Deblenders|
* YV12
|}}
{{Template:FuncDef|Cdeblend(clip input, int ''omode'', float ''bthresh'', ''mthresh'', ''xr'', ''yr'', bool ''fnr'', clip ''dclip'') }}

== Abstract ==
Cdeblend is a simple blend replacing function like unblend or removeblend.
Now superseded by [[Srestore]].

=== Requires Filters ===
*[[Removegrain|RemoveGrain]] 1.x, for fnr=true.
*[[MaskTools2]]

== Parameters ==
{{ParR|omode|int|0|0-4}}
Stands for the output mode. There are five different omodes:
*omode 0 -> The previous frame will be duplicated to avoid a blend. (Default.)
*omode 1 -> The next frame is used instead of a blend.
*omode 2 -> Like omode 0 but with some double-blend detection (only without missing fields)
*omode 3 -> A special mode for 12fps sources.
*omode 4 -> Does nothing with the source. It just subtitles the blend factor.

{{ParR|bthresh|float|0.1|0-2.0}}
For omode 0 and 1 bthresh will be just compared with the calculated blend factor. If the blend factor is higher a blend is detected. Omode 3 uses this threshold to detect clears. If blendfactor<-bthresh the frame will be output also if there is another frame with a smaller blendfactor. This can give a better motion.

{{ParR|mthresh|float|0.6|0.3-1.6}}
Used for (m)otion (thresh)olding. It regulates the blend detection of frames with small pixel value differences. A better quality of the source allows lower values and a more accurate detection.

{{ParR|xr,yr|float|1,5,2.0|1.0-4.0}}
The scaled detection radius (xr & yr) blurs the internal detection clip and can speed up the function a little bit.

{{Par|fnr|bool|false}}
With fnr=true you enable a (f)ast (n)oise (r)eduction. It's sometimes useful for noisy sources and typical area motion (anime). Don't use a too big radius if you enable this feature and don't use it on very clean sources (speed decreasing is not the only negative effect).

{{Par|dclip|clip|input}}
The '''d'''etection'''clip''' can be set to improve the blend detection (cleaning the clip before).
This clip is only used for the blend detection and not for output.

==Examples==
<pre>
Avisource("blah.avi")
Cdeblend()
</pre>

<pre>
Avisource("blah.avi")
tdeint(mode=1)
c = last.crop(8,16,-8,-8)
Cdeblend(omode=1,dclip=c)
</pre>

==Links==
Download [[Media:Cdeblend.avs|Cdeblend.avs]]<br/>
Follow the discussion here [http://forum.doom9.org/showthread.php?t=95924 Doom9 forum]

SuperEQ

2008-08-13T07:47:25Z

AlanHK:

{{Template:Func2Def|SuperEq(clip, string filename)|SuperEq(clip, float ''band1'' [, float ''band2'', ..., float ''band18''])}}

Shibatch Super Equalizer is a graphic and parametric equalizer plugin for winamp. This plugin uses 16383th order FIR filter with FFT algorithm. Its equalization is very precise. Equalization setting can be done for each channel separately. SuperEQ is originally written by [http://shibatch.sourceforge.net/ Naoki Shibata].

SuperEQ requires a [http://www.foobar2000.org foobar2k] equalizer setting (.feq) file. The equalizer can be found in foobar's DSPManager, and settings are adjusted and saved from there as well.

A .feq file is a text file with a number on each line.
Each value controls the amplification in decibels of each of 18 frequency bands.
The boundaries between bands lie on the following frequencies:

# 65 Hz
# 92 Hz
# 131 Hz
# 185 Hz
# 262 Hz
# 370 Hz
# 523 Hz
# 740 Hz
# 1046 Hz
# 1480 Hz
# 2093 Hz
# 2960 Hz
# 4186 Hz
# 5920 Hz
# 8372 Hz
# 11839 Hz
# 16744 Hz
(adapted from avisynth/src/audio/supereq.h)

For example, the first line of the file controls 0 to 65 Hz, and the sixth controls 262 to 370 Hz.

These frequencies are the frequencies of C and F# in the modern equal tempered scales.
The lowest is the C two octaves below middle C.

Some preset settings (Equalizer Presets.zip) can be found in your \AviSynth25\Examples folder.

In v2.60, a custom band setting (band1, band2, ...) is added to allow all 18 bands to be set within your script (instead of within your preset file). The values should be specified in decibels (float).

This plugin is optimized for processors which have cache equal to or greater than 128k bytes (16383*2*sizeof(float) = 128k). This plugin won't work efficiently with K6 series processors (buy Athlon!!!).

'''Parameter:'''
{| border="1"
|-
| filename
| The foobar2k equalizer preset file to apply.
|-
| band1-band18
| Allows to set all bands within your script (in dB).
|}

'''Example:'''

# Apply "Loudness" filter from the Equalizer Presets above:
SuperEq("C:\Equalizer Presets\Loudness.feq")

'''Changes:'''
{| border="1"
|-
| v2.60
| Added custom band setting to allow all 16 bands to be set from script.
|-
| v2.54
| Initial Release.
|}

Some parts of SuperEQ are: <br>
Copyright © Naoki Shibata.

Other parts are: <br>
Copyright © 2001-2003, Peter Pawlowski
All rights reserved.

[[Category:Internal filters]]