http://avisynth.nl/api.php?action=feedcontributions&feedformat=atom&user=Martin53Avisynth wiki - User contributions [en]2026-04-08T00:46:20ZUser contributionsMediaWiki 1.19.24http://avisynth.nl/index.php/Filter_SDK/Cplusplus_APIFilter SDK/Cplusplus API2017-03-11T20:43:35Z<p>Martin53: /* GetVar */</p>
<hr />
<div>The header, avisynth.h, declares all the classes, structures and miscellaneous constants of the C++ API that you might need when writing a plugin. All external plugins should #include it:<br />
<br />
#include "avisynth.h"<br />
<br />
Note, sometimes there is a reference to a version number of the plugin api (for example v3, v5 or v6). This refers to the value of [[Filter_SDK/AVISYNTH_INTERFACE_VERSION|AVISYNTH_INTERFACE_VERSION]]. The classes and miscellaneous constants are described below.<br />
<br />
= CreateScriptEnvironment =<br />
<br />
IScriptEnvironment* __stdcall CreateScriptEnvironment(int version = AVISYNTH_INTERFACE_VERSION);<br />
<br />
AviSynth exports this. It enables you to use AviSynth as a library, without writing an AviSynth script or without going through AVIFile. [todo add link]<br />
<br />
= Classes =<br />
<br />
== AvisynthError ==<br />
<br />
AvisynthError(const char* _msg)<br />
<br />
Wrap your code in try/catch statements to enable exception handling. AvisynthError will tell you what's wrong.<br />
<br />
try <br />
{ <br />
Val = Env->Invoke("Import", Args, 0);<br />
Clip = Val.AsClip();<br />
VidInfo = Clip->GetVideoInfo();<br />
Frame = Clip->GetFrame( 1, Env);<br />
}<br />
catch (AvisynthError err) <br />
{<br />
printf("%s\n", err.msg);<br />
return 1;<br />
}<br />
<br />
== VideoFrameBuffer ==<br />
<br />
VideoFrameBuffer (VFB) holds information about a memory block which is used for video data. For efficiency, instances of this class are not deleted when the refcount reaches zero; instead they are stored in a linked list to be reused. The instances are deleted when the corresponding AVS file is closed. Or more accurately, a VideoFrameBuffer once new'd generally is not released until the IScriptEnvironment is deleted, except if SetMemoryMax is exceeded by too much then not in use VideoFrameBuffer's are forcible deleted until SetMemoryMax is satisfied.<br />
<br />
== VideoFrame ==<br />
<br />
VideoFrame holds a "window" into a VideoFrameBuffer. Operator new is overloaded to recycle class instances. Its members can be called by:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
src->GetReadPtr(..)<br />
<br />
VideoFrame has the following members: GetPitch, GetRowSize, GetHeight, GetReadPtr, GetWritePtr and IsWritable.<br />
<br />
All those filters (except IsWritable) will give you a property (pitch, rowsize, etc ...) of a plane (of the frame it points to). The interleaved formats (BGR(A) or YUY2) consist of one plane, and the planar formats consists of one (Y) or three (YUV) planes. The default plane is just the first plane (which is plane Y for the planar formats).<br />
<br />
=== GetPitch ===<br />
<br />
int GetPitch(int plane=0) const;<br />
<br />
The "pitch" (also called stride) of a frame buffer is the offset (in bytes) from the beginning of one scan line to the beginning of the next. The source and destination buffers won't necessarily have the same pitch. The pitch can vary among frames in a clip, and it can differ from the width of the clip. [todo add link]<br />
<br />
The scan line will be padded to a multiple of 8 (if necessary) due to speed reasons, so the pitch will always be a multiple of 8. Image processing is expensive, so SIMD instructions are used to speed tasks up: <br><br />
SSE uses 128 bit = 16 byte registers, so 8 YUY2 pixels can be processed the same time. <br><br />
AVX uses 256 bit = 32 byte registers, so 16 YUY2 pixels can be processed the same time.<br />
<br />
NOTE that the pitch can change anytime, so in most use cases you must request the pitch dynamically.<br />
<br />
Usage:<br />
<br />
GetPitch must be used on every plane (interleaved like YUY2 means 1 plane...) of every PVideoFrame that you want to read or write to. It is the only way to get the size of the Video Buffer (e.g. get the size of PVideoFrame):<br />
<br />
int buffer_size = src->GetPitch() * src->GetHeight(); //YUY2, interleaved<br />
<br />
This will give you the pitch of the U-plane (it will be zero if the plane doesn't exist):<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const int src_pitchUV = src->GetPitch(PLANAR_U);<br />
<br />
=== GetRowSize ===<br />
<br />
int GetRowSize(int plane=0) const;<br />
<br />
GetRowSize gives the length of each row in bytes (thus not in pixels). It's usually equal to the pitch or slightly less, but it may be significantly less if the frame in question has been through [[Crop]]. <br />
This will give you the rowsize of a frame for the interleaved formats, or the rowsize of the Y-plane for the planar formats (being the default plane).<br />
<br />
const int src_width = src->GetRowSize();<br />
<br />
=== GetHeight ===<br />
<br />
int GetHeight(int plane=0) const;<br />
<br />
GetHeight gives the height of the plane in pixels.<br />
<br />
=== GetReadPtr ===<br />
<br />
const BYTE* GetReadPtr(int plane=0) const;<br />
<br />
GetReadPtr gives you a read pointer to a plane. This will give a read pointer to the default plane:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const unsigned char* srcp = src->GetReadPtr()<br />
<br />
=== GetWritePtr ===<br />
<br />
BYTE* GetWritePtr(int plane=0) const;<br />
<br />
GetWritePtr gives you a write pointer to a plane.<br />
<br />
Any buffer you get from NewVideoFrame is guaranteed to be writable (as long as you only assign it to one PVideoFrame). Our filter's dst came from NewVideoFrame, so we can safely call dst->GetWritePtr(). However, frames you get from other clips via GetFrame may not be writable, in which case GetWritePtr() will return a null pointer.<br />
<br />
PVideoFrame dst = env->NewVideoFrame(vi); <br />
unsigned char* dstp = dst->GetWritePtr();<br />
<br />
If you want to write a frame which is not new (the source frame for example), you will have to call MakeWritable first:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
unsigned char* srcp = src->GetWritePtr(PLANAR_Y);<br />
<br />
See IsWritable for more details.<br />
<br />
=== IsWritable ===<br />
<br />
bool IsWritable() const;<br />
<br />
All frame buffers are readable, but not all are writable. This method can be used to find out if a buffer is writable or not, and there's a MakeWritable callback (described below) to ensure that it is.<br />
<br />
The rule about writability is this: A buffer is writable if and only if there is exactly one PVideoFrame pointing to it. In other words, you can only write to a buffer if no one else might be reading it. This rule guarantees that as long as you hold on to a PVideoFrame and don't write to it yourself, that frame will remain unchanged. The only drawback is that you can't have two PVideoFrames pointing to a writable buffer.<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
if (src->IsWritetable()) {...}<br />
<br />
== AlignPlanar ==<br />
<br />
AlignPlanar(PClip _clip);<br />
<br />
AlignPlanar does nothing, if the pitch of a frame is at least mod16 (16 bytes, being the default frame alignment for luma and chroma). Otherwise it realigns the image, by blitting it to a larger buffer.<br />
<br />
Filters can enforce a lower pitch, but they must always apply the AlignPlanar filter after itself, if they intend to return a frame with a lower pitch. VFW delivers a 4 byte alignment for example, so the AlignPlanar filters needs to be applied on all frames when using AviSource.<br />
<br />
== FillBorder ==<br />
<br />
FillBorder(PClip _clip);<br />
<br />
This function fills up the right side of the picture on planar images with duplicates of the rightmost pixel if the planes are not aligned. That is, if src->GetRowSize(PLANAR_Y) != src->GetRowSize(PLANAR_Y_ALIGNED).<br />
<br />
== ConvertAudio ==<br />
<br />
ConvertAudio(PClip _clip, int prefered_format);<br />
<br />
ConvertAudio converts the sample type of the audio to one of the following sample types: SAMPLE_INT8 (8 bits), SAMPLE_INT16 (16 bits), SAMPLE_INT24 (24 bits), SAMPLE_INT32 (32 bits) or SAMPLE_FLOAT (float).<br />
<br />
The following example converts the sample type of the clip child to SAMPLE_INT16 (16 bit) if the input isn’t 16 bit.<br />
<br />
ConvertAudio(child, SAMPLE_INT16);<br />
<br />
== IScriptEnvironment ==<br />
<br />
AviSynth exports an IScriptEnvironment interface. It enables you to use AviSynth as a library, without writing an AVS script or without going through AVIFile. Its members can be called by:<br />
<br />
IScriptEnvironment* env<br />
env->Invoke(..)<br />
<br />
IScriptEnvironment has the following members: ThrowError, GetCPUFlags, SaveString, Sprintf, VSprintf, Invoke, BitBlt, AtExit, AddFunction, MakeWritable, FunctionExists, GetVar, GetVarDef, SetVar, SetGlobalVar, PushContext, PopContext, NewVideoFrame, CheckVersion, Subframe, SubframePlanar, SetMemoryMax, SetWorkingDir, DeleteScriptEnvironment and ApplyMessage. They are described in the following subsections.<br />
<br />
=== ThrowError ===<br />
<br />
__declspec(noreturn) virtual void __stdcall ThrowError(const char* fmt, ...) = 0;<br />
<br />
ThrowError throws an exception (of type AvisynthError). Usually, your error message will end up being displayed on the user's screen in lieu of the video clip they were expecting:<br />
<br />
if (!vi.IsRGB()) {<br />
env->ThrowError("RGBAdjust requires RGB input");<br />
}<br />
<br />
You can use [http://www.cplusplus.com/reference/cstdio/printf/ format specifiers] to print variables. The additional arguments following fmt are formatted and inserted in the resulting string replacing their respective specifiers:<br />
<br />
if (w[j] < 0.01) {<br />
env->ThrowError("%s Resizer: [Internal Error] Got Zero Coefficient; j: %d; w[j]: %f", "Spline", j, w[j]);<br />
}<br />
<br />
=== GetCPUFlags ===<br />
<br />
virtual long GetCPUFlags();<br />
<br />
GetCPUFlags returns the instruction set of your CPU. To find out if you're running for example on a CPU that supports MMX, test:<br />
<br />
env->GetCPUFlags() & CPUF_MMX<br />
<br />
There's a complete list of flags in avisynth.h.<br />
<br />
=== SaveString ===<br />
<br />
virtual char* SaveString(const char* s, int length = -1);<br />
<br />
This function copies its argument to a safe "permanent" location and returns a pointer to the new location. <br />
Each ScriptEnvironment instance has a buffer set aside for storing strings, which is expanded as needed. The strings are not deleted until the ScriptEnvironment instance goes away (when the script file is closed, usually). This is usually all the permanence that is needed, since all related filter instances will already be gone by then. <br />
The returned pointer is not const-qualified, and you're welcome to write to it, as long as you don't stray beyond the bounds of the string.<br />
<br />
Example usage (converting a string to upper case):<br />
<br />
AVSValue UCase(AVSValue args, void*, IScriptEnvironment* env) {<br />
return _strupr(env->SaveString(args[0].AsString()));<br />
}<br />
<br />
=== Sprintf and VSprintf ===<br />
<br />
virtual char* Sprintf(const char* fmt, ...);<br />
virtual char* VSprintf(const char* fmt, char* val);<br />
<br />
These store strings away in the same way as SaveString, but they treat their arguments like printf and vprintf. <br />
Currently there's a size limit of 4096 characters on strings created this way. (The implementation uses _vsnprintf, so you don't need to worry about buffer overrun.) <br />
<br />
=== Invoke ===<br />
<br />
virtual AVSValue Invoke(const char* name, const AVSValue args, const char** arg_names=0);<br />
<br />
You can use this to call a script function. There are many script functions which can be useful from other filters; for example, the Bob filter uses SeparateFields, and several source filters use UnalignedSplice. Some functions, like Weave, are implemented entirely in terms of other functions. <br />
If you're calling a function taking exactly one argument, you can simply pass it in the args parameter; Invoke will convert it into an array for you. In order to call a function taking multiple arguments, you will need to create the array yourself; it can be done like this: <br />
<br />
AVSValue up_args[3] = {child, 384, 288}; <br />
PClip resized = env->Invoke("LanczosResize", AVSValue(up_args,3)).AsClip();<br />
<br />
In this case LanczosResize would need to have a parameter-type string like "cii". <br />
<br />
Invoking a filter without arguments (for example catching the path of the loaded script with [[Internal_functions/ScriptDir#ScriptDir|ScriptDir]]):<br />
<br />
const char* V = env->Invoke("ScriptDir", AVSValue(0,0)).AsString();<br />
<br />
The arg_names parameter can be used to specify named arguments. Named arguments can also be given positionally, if you prefer. For example:<br />
<br />
int size_text = 24;<br />
int align = 8;<br />
const char *names[] = {NULL, NULL, "align", "size", "text_color"};<br />
AVSValue avsv[5] = {clip, "text", align, size_text, 0xFFFF00};<br />
clip = env->Invoke("Subtitle", AVSValue(avsv, 5), names).AsClip();<br />
<br />
Invoke throws IScriptEnvironment::NotFound if it can't find a matching function prototype. You should be prepared to catch this unless you know that the function exists and will accept the given arguments.<br />
<br />
=== BitBlt ===<br />
<br />
virtual void BitBlt(unsigned char* dstp, int dst_pitch, const unsigned char* srcp, int src_pitch, int row_size, int height);<br />
<br />
This brilliantly-named function does a line-by-line copy from the source to the destination. It's useful for quite a number of things; the built-in filters DoubleWeave, FlipVertical, AddBorders, PeculiarBlend, StackVertical, StackHorizontal, and ShowFiveVersions all use it to do their dirty work.<br />
<br />
In AddBorders it’s to copy the Y-plane from the source to the destination frame (for planar formats):<br />
<br />
const int initial_black = top*dst_pitch + vi.BytesFromPixels(left);<br />
if (vi.IsPlanar()) {<br />
env->BitBlt(dstp+initial_black, dst_pitch, srcp, src_pitch, src_row_size, src_height);<br />
...<br />
}<br />
<br />
left is the number of pixels which is added to the left, top the number which is added to the top. So the first source pixel, srcp[0], is copied to its new location dstp[x], and so on. The remaining bytes are zeroed and can be refilled later on.<br />
<br />
=== AtExit ===<br />
<br />
virtual void AtExit(ShutdownFunc function, void* user_data);<br />
<br />
When IScriptEnvironment is deleted on script close the AtExit functions get run. When you register the function you can optionally provide some user data. When the function is finally called this data will be provided as the argument to the procedure.<br />
<br />
The example below (thanks to tsp) loads a library and automatically unloads it (by using AtExit) after the script is closed. It can be useful when your plugin depends on a library and you want to load the library in your script (the plugin fft3dfilter.dll depends on the library fftw3.dll for example):<br />
<br />
void __cdecl UnloadDll(void* hinst, IScriptEnvironment* env) {<br />
if (hinst)<br />
FreeLibrary(static_cast<HMODULE>(hinst)); <br />
}<br />
<br />
AVSValue __cdecl LoadDll(AVSValue args, void* user_data, IScriptEnvironment* env){<br />
HMODULE hinst = 0;<br />
hinst = LoadLibrary(args[0].AsString()); // loads a library<br />
env->AtExit(UnloadDll, hinst); // calls UnloadDll to unload the library upon script exit<br />
return hinst!=NULL;<br />
}<br />
<br />
=== AddFunction ===<br />
<br />
virtual void __stdcall AddFunction(const char* name, const char* params, ApplyFunc apply, void* user_data) = 0; <br />
<br />
The main purpose of the AvisynthPluginInit2 (or AvisynthPluginInit3) function is to call env->AddFunction.<br />
<br />
env->AddFunction("Sepia", "c[color]i[mode]s", Create_Sepia, 0);<br />
<br />
AddFunction is called to let Avisynth know of the existence of our filter. It just registers a function with Avisynth's internal function table. This function takes four arguments: the name of the new script function; the parameter-type string; the C++ function implementing the script function; and the user_data cookie.<br />
<br />
The added function is of type AVSValue and can therefore return any AVSValue. Here are a few options how to return from the "added" function:<br />
<br />
AVSValue __cdecl returnSomething(AVSValue args, void* user_data, IScriptEnvironment* env){<br />
<br />
char *strlit = "AnyOldName";<br />
int len = strlen(strlit);<br />
char *s = new char[len+1];<br />
if (s==NULL)<br />
env->ThrowError("Cannot allocate string mem");<br />
strcpy(s, strlit); // duplicate<br />
char *e = s+len; // point at null<br />
// make safe copy of string (memory is freed on Avisynth closure)<br />
AVSValue ret = env->SaveString(s,e-s); // e-s is text len only (excl null) {SaveString uses memcpy)<br />
// AVSValue ret = env->SaveString(s); // alternative, Avisynth uses strlen to ascertain length<br />
delete []s; // delete our temp s buffer<br />
return ret; // return saved string as AVSValue<br />
// return strlit; // alternative to MOST of above code char* converted to AVSValue.<br />
// return "AnyOldName"; // alternative to ALL of above code char* converted to AVSValue.<br />
// String literals are read only and at constant address and so need not be saved.<br />
}<br />
<br />
=== MakeWritable ===<br />
<br />
virtual bool __stdcall MakeWritable(PVideoFrame* pvf) = 0;<br />
<br />
MakeWritable only copies the active part of the frame to a completely new frame with a default pitch. You need this to recieve a valid write pointer to an existing frame. <br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
<br />
=== FunctionExists ===<br />
<br />
virtual bool __stdcall FunctionExists(const char* name) = 0;<br />
<br />
FunctionExists returns true if the specified filter exists, otherwise returns false: <br />
<br />
if (env->FunctionExists("Import")) {<br />
env->ThrowError("Yes, the IMPORT function exist.");<br />
} else {<br />
env->ThrowError("No, the IMPORT function don't exist.");<br />
}<br />
<br />
=== GetVar ===<br />
<br />
virtual AVSValue __stdcall GetVar(const char* name) = 0;<br />
<br />
GetVar can be used to access AviSynth variables. It will throw an error if the variable doesn't exist.<br />
<br />
Internal and external (plugin) functions are, for example, exported as AviSynth variables:<br />
<br />
* $InternalFunctions$ Should contain a string consisting of function names of all internal functions.<br />
* $InternalFunctions!Functionname!Param$ Should contain all parameters for each internal function.<br />
* $PluginFunctions$ Should contain a string of all plugins in your autoloading plugin folder.<br />
* $Plugin!Functionname!Param$ Should contain all parameters.<br />
<br />
Use env->GetVar() to access them. This example returns a string consisting of all parameters of ConvertToYV12:<br />
<br />
const char* plugin_dir;<br />
plugin_dir = env->GetVar("$Plugin!ConverttoYV12!Param$").AsString();<br />
<br />
This example returns the plugin folder which is used to autoload your plugins (and returns an error if it’s not set):<br />
<br />
try {<br />
const char* plugin_dir;<br />
plugin_dir = env->GetVar("$PluginDir$").AsString();<br />
env->ThrowError(plugin_dir);<br />
} catch(...) {<br />
env->ThrowError("Plugin directory not set.");<br />
}<br />
<br />
If you are making a conditional filter you can use it to get the current framenumber:<br />
<br />
// Get current frame number<br />
AVSValue cf = env->GetVar("current_frame");<br />
if (!cf.IsInt())<br />
env->ThrowError("MinMaxAudio: This filter can only be used within ConditionalFilter");<br />
int n = cf.AsInt();<br />
PVideoFrame src = child->GetFrame(n, env);<br />
<br />
NEVER catch an AviSynth exception inside a plugin and continue normal execution afterwards, see [[AviSynth%2B#AviSynth_Plugin_Writing_Tips]]<br />
<br />
=== GetVarDef, v6 ===<br />
<br />
virtual AVSValue __stdcall GetVarDef(const char* name, const AVSValue& def=AVSValue()) = 0;<br />
<br />
GetVarDef can be used to access AviSynth variables. It will return 'def' if the variable doesn't exist (instead of throwing an error):<br />
<br />
int error;<br />
AVSValue ret1 = env->GetVarDef("VarUnknown", AVSValue(-1)); // returns -1 when 'VarUnknown' doesn't exist<br />
AVSValue ret2 = env->GetVarDef("VarUnknown", AVSValue(-2)); // returns -2 when 'VarUnknown' doesn't exist<br />
if (ret1 != ret2)<br />
env->ThrowError("Plugin: The variable 'VarUnknown' doesn't exist!");<br />
<br />
Note: One call with a proper default setting is sufficient when either a variable's content or else a default value is needed.<br />
<br />
=== SetVar ===<br />
<br />
virtual bool __stdcall SetVar(const char* name, const AVSValue& val) = 0;<br />
<br />
WARNING: memory used by ''name'' and ''val.AsString()'' parameters must be allocated till IScriptEnvironment is destroyed.<br />
<br />
It will return true if the variable was created and filled with the given value. It will return false in case the variable was already there and we just updated its value.<br />
<br />
SetVar can be used to set or create AviSynth variables. The created variables are only visible in the local scope, e.g. script functions have a new scope.<br />
<br />
This example sets the autoloading plugin folder to "C:\\"<br />
<br />
if (env->SetVar("$PluginDir$", AVSValue("C:\\"))) {<br />
//variable was created<br />
} else {<br />
//variable was already existing and updated<br />
}<br />
<br />
This example sets variables in GetFrame which can be accessed later on in a script within the conditional environment:<br />
<br />
// saves the blue value of a pixel<br />
int BlueValue;<br />
BlueValue = srcp[x];<br />
env->SetVar("BlueValue", AVSValue(BlueValue));<br />
<br />
=== SetGlobalVar ===<br />
<br />
virtual bool __stdcall SetGlobalVar(const char* name, const AVSValue& val) = 0;<br />
<br />
WARNING: memory used by ''name'' and ''val.AsString()'' parameters must be allocated till IScriptEnvironment is destroyed.<br />
<br />
Usage:<br />
<br />
SetGlobalVar can be used to create or set AviSynth variables that are visible within global scope. It is possible that a single filter may want to use SetVar in order to exchange signals to possible other instances of itself.<br />
<br />
There are at least 4 different components that make use of Set(Global)Var functions:<br />
* the core itself<br />
* the user within the avs script<br />
* filters/plugins<br />
* a custom application that invoked the environment<br />
<br />
All of above may have their own requirements for the SetVar function. Some may want to be visible globally, others may not.<br />
<br />
=== PushContext ===<br />
<br />
virtual void __stdcall PushContext(int level=0) = 0;<br />
<br />
// TODO - see (also similar functions) http://forum.doom9.org/showthread.php?p=1595750#post1595750<br />
<br />
=== PopContext ===<br />
<br />
virtual void __stdcall PopContext() = 0;<br />
<br />
?<br />
<br />
=== PopContextGlobal ===<br />
<br />
virtual void __stdcall PopContextGlobal() = 0;<br />
<br />
?<br />
<br />
=== NewVideoFrame ===<br />
<br />
virtual PVideoFrame __stdcall NewVideoFrame(const VideoInfo& vi, int align=FRAME_ALIGN) = 0; // default align is 16<br />
<br />
The NewVideoFrame callback allocates space for a video frame of the supplied size. (In this case it will hold our filter's output.) The frame buffer is uninitialized raw memory (except that in the debug build it gets filled with the repeating byte pattern 0A 11 0C A7 ED, which is easy to recognize because it looks like "ALLOCATED"). <br><br />
"vi" is a protected member of GenericVideoFilter. It is a structure of type VideoInfo, which contains information about the clip (like frame size, frame rate, pixel format, audio sample rate, etc.). NewVideoFrame uses the information in this structure to return a frame buffer of the appropriate size.<br />
<br />
The following example creates a new VideoInfo structure and creates a new video frame from it:<br />
<br />
VideoInfo vi;<br />
PVideoFrame frame;<br />
memset(&vi, 0, sizeof(VideoInfo));<br />
vi.width = 640;<br />
vi.height = 480;<br />
vi.fps_numerator = 30000;<br />
vi.fps_denominator = 1001;<br />
vi.num_frames = 107892; // 1 hour<br />
vi.pixel_type = VideoInfo::CS_BGR32;<br />
vi.sample_type = SAMPLE_FLOAT;<br />
vi.nchannels = 2;<br />
vi.audio_samples_per_second = 48000;<br />
vi.num_audio_samples = vi.AudioSamplesFromFrames(vi.num_frames);<br />
frame = env->NewVideoFrame(vi);<br />
<br />
=== CheckVersion ===<br />
<br />
virtual void __stdcall CheckVersion(int version = AVISYNTH_INTERFACE_VERSION) = 0;<br />
<br />
CheckVersion checks the interface version (avisynth.h). It throws an error if ‘version’ is bigger than the used interface version. The following interface versions are in use:<br />
<br />
AVISYNTH_INTERFACE_VERSION = 1 (v1.0-v2.0.8), 2 (v2.5.0-v2.5.5), 3 (v2.5.6-v2.5.8), 5 (v2.6.0a1-v2.6.0a5), or 6 (v2.6.0) [version 4 doesn’t exist].<br />
<br />
This example will throw an error if v2.5x or an older AviSynth version is being used:<br />
<br />
env->CheckVersion(5)<br />
<br />
This can be used in a plugin, for example, if it needs at least a certain interface version for it to work.<br />
<br />
=== Subframe ===<br />
<br />
virtual PVideoFrame __stdcall Subframe(PVideoFrame src, int rel_offset, int new_pitch, int new_row_size, int new_height) = 0;<br />
<br />
Subframe (for interleaved formats) extracts a part of a video frame. For planar formats use SubframePlanar. For examples see SubframePlanar.<br />
<br />
=== SubframePlanar ===<br />
<br />
virtual PVideoFrame __stdcall SubframePlanar(PVideoFrame src, int rel_offset, int new_pitch, int new_row_size, int new_height, int rel_offsetU, int rel_offsetV, int new_pitchUV) = 0;<br />
<br />
SubframePlanar (for planar formats) extracts a part of a video frame. The example below returns the first field of a frame:<br />
<br />
vi.height >>= 1; // sets new height in the constructor<br />
<br />
PVideoFrame frame = child->GetFrame(n, env);<br />
if (vi.IsPlanar()) { // SubframePlanar works on planar formats only<br />
const int frame_pitch = frame->GetPitch(PLANAR_Y);<br />
const int frame_width = frame->GetRowSize(PLANAR_Y);<br />
const int frame_height = frame->GetHeight(PLANAR_Y);<br />
const int frame_pitchUV = frame->GetPitch(PLANAR_U);<br />
return env->SubframePlanar(frame, 0, 2*frame_pitch, frame_width, frame_height>>1, 0, 0, 2*frame_pitchUV);<br />
}<br />
<br />
Note that it copies the first row of pixels and moves on to the third row (by moving the offset by ‘2*frame_pitch’). After frame_height/2 it stops reading.<br />
<br />
The following example keeps the left 100 pixels of a clip (it leaves the height unaltered) and throws away the rest:<br />
<br />
vi.width = 100; // sets new width in the constructor<br />
<br />
PVideoFrame frame = child->GetFrame(n, env);<br />
if (vi.IsPlanar()) { // SubframePlanar works on planar formats only<br />
const int frame_pitch = frame->GetPitch(PLANAR_Y);<br />
const int frame_height = frame->GetHeight(PLANAR_Y);<br />
const int frame_pitchUV = frame->GetPitch(PLANAR_U);<br />
return env->SubframePlanar(frame, 0, frame_pitch, 100, frame_height, 0, 0, frame_pitchUV);<br />
}<br />
<br />
Note that it copies 100 pixels and moves on to the next row (by moving the offset by ‘frame_pitch’).<br />
<br />
You need to check somewhere that the source frames is more than 100 pixels wide, otherwise throw an error.<br />
<br />
=== SetMemoryMax ===<br />
<br />
virtual int __stdcall SetMemoryMax(int mem) = 0;<br />
<br />
There is a builtin cache automatically inserted in between all filters. You can use SetmemoryMax to increase the size.<br />
<br />
SetMemoryMax only sets the size of the frame buffer cache. It is independent of any other memory allocation. Memory usage due to the frame cache should ramp up pretty quickly to the limited value and stay there. Setting a lower SetMemoryMax value will make more memory available for other purposes and provide less cache buffer frames. It is pointless having more buffers available than are needed by the scripts temporal requirements. If each and every frame generated at each and every stage of a script is only ever used once then the cache is entirely useless. By definition a cache is only useful if a generated element is needed a second or subsequent time.<br />
<br />
=== SetWorkingDir ===<br />
<br />
virtual int __stdcall SetWorkingDir(const char * newdir) = 0;<br />
<br />
Sets the default directory for AviSynth.<br />
<br />
=== DeleteScriptEnvironment, v5 ===<br />
<br />
virtual void __stdcall DeleteScriptEnvironment() = 0;<br />
<br />
Provides a method to delete the ScriptEnvironment which is created with CreateScriptEnvironment.<br />
<br />
=== ApplyMessage, v5 ===<br />
<br />
virtual void _stdcall ApplyMessage(PVideoFrame* frame, const VideoInfo& vi, const char* message, int size, int textcolor, int halocolor, int bgcolor) = 0;<br />
<br />
ApplyMessage writes text on a frame. For example:<br />
<br />
char BUF[256];<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
sprintf(BUF, "Filter: Frame %d is processed.", n);<br />
env->ApplyMessage(&src, vi, BUF, vi.width/4, 0xf0f080, 0, 0);<br />
<br />
=== GetAVSLinkage , v5 ===<br />
<br />
virtual const AVS_Linkage* const __stdcall GetAVSLinkage() = 0;<br />
<br />
Returns the [[Filter_SDK/AVS_Linkage|AVSLinkage]].<br />
<br />
todo: how and when to use that ...<br />
<br />
== PVideoFrame ==<br />
<br />
PVideoFrame is a smart pointer to VideoFrame.<br />
<br />
In this example it gives a pointer to frame ‘n’ from child:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
<br />
"child" is a protected member of GenericVideoFilter, of type PClip. It contains the clip that was passed to the constructor. For our filter to produce frame n we need the corresponding frame of the input. If you need a different frame from the input, all you have to do is pass a different frame number to child->GetFrame.<br />
<br />
In this example it gives a pointer to a new created VideoFrame from vi (which is a VideoInfo structure):<br />
<br />
PVideoFrame dst = env->NewVideoFrame(vi);<br />
<br />
"vi" is another protected member of GenericVideoFilter (the only other member, actually). It is a structure of type VideoInfo, which contains information about the clip (like frame size, frame rate, pixel format, audio sample rate, etc.). NewVideoFrame uses the information in this struct to return a frame buffer of the appropriate size.<br />
<br />
== IClip ==<br />
<br />
An Avisynth filter is simply a C++ class implementing the IClip interface. IClip has four pure virtual methods: GetVideoInfo, GetFrame, GetParity, and GetAudio. <br />
The class GenericVideoFilter is a simple do-nothing filter defined in avisynth.h. It derives from IClip and implements all four methods. Most filters can inherit from GenericVideoFilter rather than directly from IClip; this saves you from having to implement methods that you don't care about, like GetAudio. <br />
<br />
IClip has the following members: GetVersion, GetFrame, GetParity, GetAudio, SetCacheHints and GetVideoInfo. They are described in the following subsections.<br />
<br />
=== GetVersion ===<br />
<br />
virtual int __stdcall GetVersion() { return AVISYNTH_INTERFACE_VERSION; }<br />
<br />
GetVersion returns the interface version of the loaded avisynth.dll:<br />
<br />
AVISYNTH_INTERFACE_VERSION = 1 (v1.0-v2.0.8), 2 (v2.5.0-v2.5.5), 3 (v2.5.6-v2.5.8), or 6 (v2.6.0) [version 4 doesn’t exist, version 5 refers to the alpha versions of v2.6.0 so you won't need that one].<br />
<br />
=== GetFrame ===<br />
<br />
virtual PVideoFrame __stdcall GetFrame(int n, IScriptEnvironment* env) = 0;<br />
<br />
GetFrame returns a video frame. In this example, the even frames (0, 2, 4, ...) of ‘child’ are returned:<br />
<br />
PVideoFrame src = child->GetFrame(2*n, env);<br />
<br />
You should do all the GetFrame() calls BEFORE you get any pointers and start manipulating any data.<br />
<br />
=== GetParity ===<br />
<br />
virtual bool __stdcall GetParity(int n) = 0;<br />
<br />
GetParity returns the field parity if the clip is field-based, otherwise it returns the parity of first field of a frame. In other words, it distinguishes between top field first (TFF) and bottom field first (BFF). When it returns true, it means that this frame should be considered TFF, otherwise it should be considered BFF.<br />
<br />
=== GetAudio ===<br />
<br />
virtual void __stdcall GetAudio(void* buf, __int64 start, __int64 count, IScriptEnvironment* env) = 0;<br />
<br />
Audio processing is handled through the GetAudio method. You must fill in the buffer with count samples beginning at the sample start. A sample may vary from one to four bytes, depending on whether the audio is 8, 16, 24 or 32-bit (float is also 32-bit). The flag vi.SampleType() will tell you this. <br />
<br />
If you cannot do your audio processing in-place, you must allocate your own buffer for the source audio using new or malloc.<br />
<br />
In this example, the audio of frame ‘n’ is returned (in the buffer ‘samples’):<br />
<br />
VideoInfo vi = child->GetVideoInfo();<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const __int64 start = vi.AudioSamplesFromFrames(n);<br />
const __int64 count = vi.AudioSamplesFromFrames(1);<br />
SFLOAT* samples = new SFLOAT[count*vi.AudioChannels()];<br />
child->GetAudio(samples, max(0,start), count, env);<br />
<br />
=== SetCacheHints ===<br />
<br />
void __stdcall SetCacheHints(int cachehints, int frame_range) = 0 ; // We do not pass cache requests upwards, only to the next filter.<br />
// int __stdcall SetCacheHints(int cachehints, int frame_range) = 0 ; // We do not pass cache requests upwards, only to the next filter.<br />
<br />
SetCacheHints should be used in filters that request multiple frames from any single PClip source per input GetFrame call. frame_range is maximal 21.<br />
<br />
The possible values of cachehints are:<br />
<br />
CACHE_NOTHING=0 // Filter requested no caching.<br />
CACHE_RANGE=1 // An explicit cache of "frame_range" frames around the current frame.<br />
CACHE_ALL=2 // This is default operation, a simple LRU cache.<br />
CACHE_AUDIO=3 // Audio caching.<br />
CACHE_AUDIO_NONE=4 // Filter requested no audio caching.<br />
CACHE_AUDIO_AUTO=5 // Audio caching (difference with CACHE_AUDIO?).<br />
<br />
When caching video frames (cachehints=0, 1, 2), frame_range is the radius around the current frame. When caching audio samples (cachehints=3, 4, 5), the value 0 creates a default buffer of 64kb and positive values allocate frame_range bytes for the cache.<br />
<br />
E.g. If you have a single PClip source, i.e. child and you get asked for frame 100 and you in turn then ask for frames 98, 99, 100, 101 and 102 then you need to call CACHE_RANGE with frame_range set to 3:<br />
<br />
child->SetCacheHints(CACHE_RANGE, 3);<br />
<br />
Frames outside the specified radius are candidate for normal LRU caching.<br />
<br />
// TODO - describe input and output for v5<br />
// http://forum.doom9.org/showthread.php?p=1595750#post1595750<br />
<br />
=== GetVideoInfo ===<br />
<br />
virtual const VideoInfo& __stdcall GetVideoInfo() = 0;<br />
<br />
GetVideoInfo returns a [[Filter_SDK/Cplusplus_API/VideoInfo|VideoInfo]] structure.<br />
<br />
== PClip ==<br />
<br />
PClip is a smart pointer to an IClip, and IClip is a generic abstract class.. It maintains a reference count on the IClip object and automagically deletes it when the last PClip referencing it goes away. For obvious reasons, you should always use PClip rather than IClip* to refer to clips. <br />
<br />
Like a genuine pointer, a PClip is only four bytes long, so you can pass it around by value. Also like a pointer, a PClip can be assigned a null value (0), which is often useful as a sentinel. Unlike a pointer, <br />
<br />
PClip is initialized to 0 by default. <br />
<br />
You'll need to make sure your class doesn't contain any circular PClip references, or any PClips sitting in dynamically allocated memory that you forget to delete. Other than that, you don't have to worry about the reference-counting machinery. <br />
<br />
AviSynth filters have a standardized output channel via IClip, but (unlike VirtualDub filters) no standardized input channel. Each filter is responsible for obtaining its own source material -- usually (as in this case) from another clip, but sometimes from several different clips, or from a file. <br />
<br />
The clip functionality must be provided by some concrete subclass of IClip which implements the functions GetFrame(), etc. So you cannot create a PClip without having an appropriate IClip subclass. For most filters, the GenericVideoFilter class provides the basis for this, but 'source' filters (which is basically what you have) do not have a parent clip and so GenericVideoFilter is not appropriate.<br />
<br />
== AVSValue ==<br />
<br />
Inside Avisynth, the value of a (script) variable is represented by an instance of the class AVSValue. Such objects have a one-character type field which denotes the script language type of the value:<br />
* 'a' for an array of AVSValues<br />
* 'b' for boolean<br />
* 'c' for clip<br />
* 'f' for float (IEEE single precision (32-bit) floating point)<br />
* 'i' for int (32-bit signed integer)<br />
* 's' for string<br />
* 'v' for void<br />
<br />
A variable of type AVSValue, if simply declared and not initialised, will have its type set to 'v' by the AVSValue constructor, meaning void (or 'undefined'), and not just left as random garbage.<br />
<br />
A numeric script variable is either an integer or an float. The latter will be the case if the value of the numeric variable contains a dot (so for example the variable x = '10.' will be parsed as float since its value contains a dot).<br />
<br />
You can test which type a variable is with the methods (return true or false):<br />
<br />
{| border="1"<br />
|- <br />
| '''Method'''<br />
| '''true condition'''<br />
| '''false condition'''<br />
|-<br />
| IsArray()<br />
| variable is an array<br />
| anything else<br />
|-<br />
| IsBool()<br />
| variable is true or false<br />
| anything else<br />
|-<br />
| IsClip()<br />
| variable is a clip<br />
| anything else<br />
|-<br />
| IsFloat()<br />
| variable is float or int<br />
| anything else<br />
|-<br />
| IsInt()<br />
| variable is int<br />
| anything else<br />
|-<br />
| IsString()<br />
| variable is float or string<br />
| anything else<br />
|-<br />
| Defined()<br />
| anything else<br />
| variable is "undefined"<br />
|}<br />
<br />
You can get the value of a variable with the methods:<br />
<br />
{| border="1"<br />
|- <br />
| '''Method'''<br />
| '''return type'''<br />
|-<br />
| AsBool(), AsBool(bool def)<br />
| bool<br />
|-<br />
| AsClip()<br />
| PClip<br />
|-<br />
| AsDblDef(double def)<br />
| double<br />
|-<br />
| AsFloat(), AsFloat(float def)<br />
| double<br />
|-<br />
| AsFloatf(), AsFloatf(float def)<br />
| float<br />
|-<br />
| AsInt(), AsInt(int def)<br />
| int<br />
|-<br />
| AsString(), AsString(const char* def)<br />
| const char*<br />
|}<br />
<br />
Boolean values are not treated as numeric (unlike C).<br />
<br />
Note that not all 32-bit integers can be represented as IEEE 32-bit floating point numbers. 16777216 and 16777217 have the same IEEE 32-bit floating point representation. Namely [0|10010111|00000000000000000000000]. See [[Float|IEEE-754]] for more information.<br />
<br />
For arrays, you can use the ArraySize() method to get the number of elements, and [] indexing to get the elements themselves.<br />
<br />
AVSValue holds an array of AVSValues in the following way:<br />
<br />
AVSValue(const AVSValue* a, int size) { type = 'a'; array = a; array_size = size; }<br />
<br />
'''Examples'''<br />
<br />
'''Arrays'''<br />
<br />
Using Invoke to apply a filter:<br />
<br />
AVSValue up_args[3] = {child, 384, 288}; <br />
PClip resized = env->Invoke("LanczosResize", AVSValue(up_args, 3)).AsClip();<br />
<br />
Note that<br />
<br />
AVSValue(up_args, 3)<br />
<br />
returns the following: {'a'; {child, 384, 288}; 3}.<br />
<br />
Also [[#Invoke|Invoke]] returns an AVSValue (see its declaration) which in that case is a PClip.<br />
<br />
You can get the number of elements of up_args and its elements in the following way:<br />
<br />
int num_args, width, height;<br />
PClip clip;<br />
if (up_args.IsArray()) {<br />
num_args = up_args.ArraySize();<br />
clip = up_args[1].AsClip();<br />
width = up_args[2].AsInt();<br />
height = up_args[3].AsInt();<br />
}<br />
<br />
'''Integers and floats'''<br />
<br />
Note that 123.0 can be accurately represented as an int, float or double. So for getting the exact value of x=123.0 you can use either AsInt(123), AsFloat(x), AsFloatf(x) or AsDblDef(x). All of them will return the same value with the same accuracy.<br />
<br />
As noted above, 16777217 can't be accurately represented as a float. So for getting the exact value of x=16777217.0 you need to use either AsInt(16777217) or AsDblDef(x). Both will return the same value with the same accuracy. Note that AsFloat() will return a double, but it is cast to a float first (losing accuracy).<br />
<br />
= Structures =<br />
<br />
The following structure is available: VideoInfo structure. It holds global information about a clip (i.e. information that does not depend on the framenumber). The GetVideoInfo method in IClip returns this structure. A description (for AVISYNTH_INTERFACE_VERSION=6) of it can be found [[Filter_SDK/Cplusplus_API/VideoInfo|here]].<br />
<br />
= Constants =<br />
<br />
The following constants are defined in avisynth.h:<br />
<br />
// Audio Sample information<br />
typedef float SFLOAT;<br />
<br />
enum { // sample types<br />
SAMPLE_INT8 = 1<<0,<br />
SAMPLE_INT16 = 1<<1,<br />
SAMPLE_INT24 = 1<<2,<br />
SAMPLE_INT32 = 1<<3,<br />
SAMPLE_FLOAT = 1<<4<br />
};<br />
<br />
enum { // plane types<br />
PLANAR_Y = 1<<0,<br />
PLANAR_U = 1<<1,<br />
PLANAR_V = 1<<2,<br />
PLANAR_ALIGNED = 1<<3,<br />
PLANAR_Y_ALIGNED = PLANAR_Y | PLANAR_ALIGNED,<br />
PLANAR_U_ALIGNED = PLANAR_U | PLANAR_ALIGNED,<br />
PLANAR_V_ALIGNED = PLANAR_V | PLANAR_ALIGNED,<br />
PLANAR_A = 1<<4, // v5<br />
PLANAR_R = 1<<5, // v5<br />
PLANAR_G = 1<<6, // v5<br />
PLANAR_B = 1<<7, // v5<br />
PLANAR_A_ALIGNED = PLANAR_A | PLANAR_ALIGNED, // v5<br />
PLANAR_R_ALIGNED = PLANAR_R | PLANAR_ALIGNED, // v5<br />
PLANAR_G_ALIGNED = PLANAR_G | PLANAR_ALIGNED, // v5<br />
PLANAR_B_ALIGNED = PLANAR_B | PLANAR_ALIGNED, // v5<br />
};<br />
<br />
enum { // cache types<br />
// Old 2.5 poorly defined cache hints (v3).<br />
// Reserve values used by 2.5 API<br />
// Do not use in new filters<br />
CACHE_25_NOTHING = 0, // Filter requested no caching.<br />
CACHE_25_RANGE = 1, // An explicit cache of "frame_range" frames around the current frame.<br />
CACHE_25_ALL = 2, // This is default operation, a simple LRU cache.<br />
CACHE_25_AUDIO = 3, // Audio caching.<br />
CACHE_25_AUDIO_NONE = 4, // Filter requested no audio caching.<br />
CACHE_25_AUDIO_AUTO = 5, // Audio caching (difference with CACHE_AUDIO?).<br />
<br />
// New 2.6 explicitly defined cache hints (v5).<br />
CACHE_NOTHING = 10, // Do not cache video.<br />
CACHE_WINDOW = 11, // Hard protect upto X frames within a range of X from the current frame N.<br />
CACHE_GENERIC = 12, // LRU cache upto X frames.<br />
CACHE_FORCE_GENERIC = 13, // LRU cache upto X frames, override any previous CACHE_WINDOW.<br />
<br />
CACHE_GET_POLICY = 30, // Get the current policy.<br />
CACHE_GET_WINDOW = 31, // Get the current window h_span.<br />
CACHE_GET_RANGE = 32, // Get the current generic frame range.<br />
<br />
CACHE_AUDIO = 50, // Explicitly do cache audio, X byte cache.<br />
CACHE_AUDIO_NOTHING = 51, // Explicitly do not cache audio.<br />
CACHE_AUDIO_NONE = 52, // Audio cache off (auto mode), X byte intial cache.<br />
CACHE_AUDIO_AUTO = 53, // Audio cache on (auto mode), X byte intial cache.<br />
<br />
CACHE_GET_AUDIO_POLICY = 70, // Get the current audio policy.<br />
CACHE_GET_AUDIO_SIZE = 71, // Get the current audio cache size.<br />
<br />
CACHE_PREFETCH_FRAME = 100, // Queue request to prefetch frame N.<br />
CACHE_PREFETCH_GO = 101, // Action video prefetches.<br />
<br />
CACHE_PREFETCH_AUDIO_BEGIN = 120, // Begin queue request transaction to prefetch audio (take critical section).<br />
CACHE_PREFETCH_AUDIO_STARTLO = 121, // Set low 32 bits of start.<br />
CACHE_PREFETCH_AUDIO_STARTHI = 122, // Set high 32 bits of start.<br />
CACHE_PREFETCH_AUDIO_COUNT = 123, // Set low 32 bits of length.<br />
CACHE_PREFETCH_AUDIO_COMMIT = 124, // Enqueue request transaction to prefetch audio (release critical section).<br />
CACHE_PREFETCH_AUDIO_GO = 125, // Action audio prefetches.<br />
<br />
CACHE_GETCHILD_CACHE_MODE = 200, // Cache ask Child for desired video cache mode.<br />
CACHE_GETCHILD_CACHE_SIZE = 201, // Cache ask Child for desired video cache size.<br />
CACHE_GETCHILD_AUDIO_MODE = 202, // Cache ask Child for desired audio cache mode.<br />
CACHE_GETCHILD_AUDIO_SIZE = 203, // Cache ask Child for desired audio cache size.<br />
<br />
CACHE_GETCHILD_COST = 220, // Cache ask Child for estimated processing cost.<br />
CACHE_COST_ZERO = 221, // Child response of zero cost (ptr arithmetic only).<br />
CACHE_COST_UNIT = 222, // Child response of unit cost (less than or equal 1 full frame blit).<br />
CACHE_COST_LOW = 223, // Child response of light cost. (Fast)<br />
CACHE_COST_MED = 224, // Child response of medium cost. (Real time)<br />
CACHE_COST_HI = 225, // Child response of heavy cost. (Slow)<br />
<br />
CACHE_GETCHILD_THREAD_MODE = 240, // Cache ask Child for thread safetyness.<br />
CACHE_THREAD_UNSAFE = 241, // Only 1 thread allowed for all instances. 2.5 filters default!<br />
CACHE_THREAD_CLASS = 242, // Only 1 thread allowed for each instance. 2.6 filters default!<br />
CACHE_THREAD_SAFE = 243, // Allow all threads in any instance.<br />
CACHE_THREAD_OWN = 244, // Safe but limit to 1 thread, internally threaded.<br />
<br />
CACHE_GETCHILD_ACCESS_COST = 260, // Cache ask Child for preferred access pattern.<br />
CACHE_ACCESS_RAND = 261, // Filter is access order agnostic.<br />
CACHE_ACCESS_SEQ0 = 262, // Filter prefers sequential access (low cost)<br />
CACHE_ACCESS_SEQ1 = 263, // Filter needs sequential access (high cost)<br />
};<br />
<br />
enum { // For GetCPUFlags. These are backwards-compatible with those in VirtualDub.<br />
/* oldest CPU to support extension */<br />
CPUF_FORCE = 0x01, // N/A<br />
CPUF_FPU = 0x02, // 386/486DX<br />
CPUF_MMX = 0x04, // P55C, K6, PII<br />
CPUF_INTEGER_SSE = 0x08, // PIII, Athlon<br />
CPUF_SSE = 0x10, // PIII, Athlon XP/MP<br />
CPUF_SSE2 = 0x20, // PIV, K8<br />
CPUF_3DNOW = 0x40, // K6-2<br />
CPUF_3DNOW_EXT = 0x80, // Athlon<br />
CPUF_X86_64 = 0xA0, // Hammer (note: equiv. to 3DNow + SSE2, which only Hammer will have anyway)<br />
CPUF_SSE3 = 0x100, // PIV+, K8 Venice<br />
<br />
// Additional CPU flags in 2.6 (v5-v6).<br />
CPUF_SSSE3 = 0x200, // Core 2<br />
CPUF_SSE4 = 0x400, // Penryn, Wolfdale, Yorkfield<br />
CPUF_SSE4_1 = 0x400,<br />
CPUF_SSE4_2 = 0x1000, // Nehalem (note this was 0x800 in v5)<br />
};<br />
<br />
[[Category:AviSynth_Development]]<br />
[[Category:FilterSDK]]</div>Martin53http://avisynth.nl/index.php/Filter_SDK/Cplusplus_APIFilter SDK/Cplusplus API2017-03-11T20:38:03Z<p>Martin53: /* GetVar */</p>
<hr />
<div>The header, avisynth.h, declares all the classes, structures and miscellaneous constants of the C++ API that you might need when writing a plugin. All external plugins should #include it:<br />
<br />
#include "avisynth.h"<br />
<br />
Note, sometimes there is a reference to a version number of the plugin api (for example v3, v5 or v6). This refers to the value of [[Filter_SDK/AVISYNTH_INTERFACE_VERSION|AVISYNTH_INTERFACE_VERSION]]. The classes and miscellaneous constants are described below.<br />
<br />
= CreateScriptEnvironment =<br />
<br />
IScriptEnvironment* __stdcall CreateScriptEnvironment(int version = AVISYNTH_INTERFACE_VERSION);<br />
<br />
AviSynth exports this. It enables you to use AviSynth as a library, without writing an AviSynth script or without going through AVIFile. [todo add link]<br />
<br />
= Classes =<br />
<br />
== AvisynthError ==<br />
<br />
AvisynthError(const char* _msg)<br />
<br />
Wrap your code in try/catch statements to enable exception handling. AvisynthError will tell you what's wrong.<br />
<br />
try <br />
{ <br />
Val = Env->Invoke("Import", Args, 0);<br />
Clip = Val.AsClip();<br />
VidInfo = Clip->GetVideoInfo();<br />
Frame = Clip->GetFrame( 1, Env);<br />
}<br />
catch (AvisynthError err) <br />
{<br />
printf("%s\n", err.msg);<br />
return 1;<br />
}<br />
<br />
== VideoFrameBuffer ==<br />
<br />
VideoFrameBuffer (VFB) holds information about a memory block which is used for video data. For efficiency, instances of this class are not deleted when the refcount reaches zero; instead they are stored in a linked list to be reused. The instances are deleted when the corresponding AVS file is closed. Or more accurately, a VideoFrameBuffer once new'd generally is not released until the IScriptEnvironment is deleted, except if SetMemoryMax is exceeded by too much then not in use VideoFrameBuffer's are forcible deleted until SetMemoryMax is satisfied.<br />
<br />
== VideoFrame ==<br />
<br />
VideoFrame holds a "window" into a VideoFrameBuffer. Operator new is overloaded to recycle class instances. Its members can be called by:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
src->GetReadPtr(..)<br />
<br />
VideoFrame has the following members: GetPitch, GetRowSize, GetHeight, GetReadPtr, GetWritePtr and IsWritable.<br />
<br />
All those filters (except IsWritable) will give you a property (pitch, rowsize, etc ...) of a plane (of the frame it points to). The interleaved formats (BGR(A) or YUY2) consist of one plane, and the planar formats consists of one (Y) or three (YUV) planes. The default plane is just the first plane (which is plane Y for the planar formats).<br />
<br />
=== GetPitch ===<br />
<br />
int GetPitch(int plane=0) const;<br />
<br />
The "pitch" (also called stride) of a frame buffer is the offset (in bytes) from the beginning of one scan line to the beginning of the next. The source and destination buffers won't necessarily have the same pitch. The pitch can vary among frames in a clip, and it can differ from the width of the clip. [todo add link]<br />
<br />
The scan line will be padded to a multiple of 8 (if necessary) due to speed reasons, so the pitch will always be a multiple of 8. Image processing is expensive, so SIMD instructions are used to speed tasks up: <br><br />
SSE uses 128 bit = 16 byte registers, so 8 YUY2 pixels can be processed the same time. <br><br />
AVX uses 256 bit = 32 byte registers, so 16 YUY2 pixels can be processed the same time.<br />
<br />
NOTE that the pitch can change anytime, so in most use cases you must request the pitch dynamically.<br />
<br />
Usage:<br />
<br />
GetPitch must be used on every plane (interleaved like YUY2 means 1 plane...) of every PVideoFrame that you want to read or write to. It is the only way to get the size of the Video Buffer (e.g. get the size of PVideoFrame):<br />
<br />
int buffer_size = src->GetPitch() * src->GetHeight(); //YUY2, interleaved<br />
<br />
This will give you the pitch of the U-plane (it will be zero if the plane doesn't exist):<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const int src_pitchUV = src->GetPitch(PLANAR_U);<br />
<br />
=== GetRowSize ===<br />
<br />
int GetRowSize(int plane=0) const;<br />
<br />
GetRowSize gives the length of each row in bytes (thus not in pixels). It's usually equal to the pitch or slightly less, but it may be significantly less if the frame in question has been through [[Crop]]. <br />
This will give you the rowsize of a frame for the interleaved formats, or the rowsize of the Y-plane for the planar formats (being the default plane).<br />
<br />
const int src_width = src->GetRowSize();<br />
<br />
=== GetHeight ===<br />
<br />
int GetHeight(int plane=0) const;<br />
<br />
GetHeight gives the height of the plane in pixels.<br />
<br />
=== GetReadPtr ===<br />
<br />
const BYTE* GetReadPtr(int plane=0) const;<br />
<br />
GetReadPtr gives you a read pointer to a plane. This will give a read pointer to the default plane:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const unsigned char* srcp = src->GetReadPtr()<br />
<br />
=== GetWritePtr ===<br />
<br />
BYTE* GetWritePtr(int plane=0) const;<br />
<br />
GetWritePtr gives you a write pointer to a plane.<br />
<br />
Any buffer you get from NewVideoFrame is guaranteed to be writable (as long as you only assign it to one PVideoFrame). Our filter's dst came from NewVideoFrame, so we can safely call dst->GetWritePtr(). However, frames you get from other clips via GetFrame may not be writable, in which case GetWritePtr() will return a null pointer.<br />
<br />
PVideoFrame dst = env->NewVideoFrame(vi); <br />
unsigned char* dstp = dst->GetWritePtr();<br />
<br />
If you want to write a frame which is not new (the source frame for example), you will have to call MakeWritable first:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
unsigned char* srcp = src->GetWritePtr(PLANAR_Y);<br />
<br />
See IsWritable for more details.<br />
<br />
=== IsWritable ===<br />
<br />
bool IsWritable() const;<br />
<br />
All frame buffers are readable, but not all are writable. This method can be used to find out if a buffer is writable or not, and there's a MakeWritable callback (described below) to ensure that it is.<br />
<br />
The rule about writability is this: A buffer is writable if and only if there is exactly one PVideoFrame pointing to it. In other words, you can only write to a buffer if no one else might be reading it. This rule guarantees that as long as you hold on to a PVideoFrame and don't write to it yourself, that frame will remain unchanged. The only drawback is that you can't have two PVideoFrames pointing to a writable buffer.<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
if (src->IsWritetable()) {...}<br />
<br />
== AlignPlanar ==<br />
<br />
AlignPlanar(PClip _clip);<br />
<br />
AlignPlanar does nothing, if the pitch of a frame is at least mod16 (16 bytes, being the default frame alignment for luma and chroma). Otherwise it realigns the image, by blitting it to a larger buffer.<br />
<br />
Filters can enforce a lower pitch, but they must always apply the AlignPlanar filter after itself, if they intend to return a frame with a lower pitch. VFW delivers a 4 byte alignment for example, so the AlignPlanar filters needs to be applied on all frames when using AviSource.<br />
<br />
== FillBorder ==<br />
<br />
FillBorder(PClip _clip);<br />
<br />
This function fills up the right side of the picture on planar images with duplicates of the rightmost pixel if the planes are not aligned. That is, if src->GetRowSize(PLANAR_Y) != src->GetRowSize(PLANAR_Y_ALIGNED).<br />
<br />
== ConvertAudio ==<br />
<br />
ConvertAudio(PClip _clip, int prefered_format);<br />
<br />
ConvertAudio converts the sample type of the audio to one of the following sample types: SAMPLE_INT8 (8 bits), SAMPLE_INT16 (16 bits), SAMPLE_INT24 (24 bits), SAMPLE_INT32 (32 bits) or SAMPLE_FLOAT (float).<br />
<br />
The following example converts the sample type of the clip child to SAMPLE_INT16 (16 bit) if the input isn’t 16 bit.<br />
<br />
ConvertAudio(child, SAMPLE_INT16);<br />
<br />
== IScriptEnvironment ==<br />
<br />
AviSynth exports an IScriptEnvironment interface. It enables you to use AviSynth as a library, without writing an AVS script or without going through AVIFile. Its members can be called by:<br />
<br />
IScriptEnvironment* env<br />
env->Invoke(..)<br />
<br />
IScriptEnvironment has the following members: ThrowError, GetCPUFlags, SaveString, Sprintf, VSprintf, Invoke, BitBlt, AtExit, AddFunction, MakeWritable, FunctionExists, GetVar, GetVarDef, SetVar, SetGlobalVar, PushContext, PopContext, NewVideoFrame, CheckVersion, Subframe, SubframePlanar, SetMemoryMax, SetWorkingDir, DeleteScriptEnvironment and ApplyMessage. They are described in the following subsections.<br />
<br />
=== ThrowError ===<br />
<br />
__declspec(noreturn) virtual void __stdcall ThrowError(const char* fmt, ...) = 0;<br />
<br />
ThrowError throws an exception (of type AvisynthError). Usually, your error message will end up being displayed on the user's screen in lieu of the video clip they were expecting:<br />
<br />
if (!vi.IsRGB()) {<br />
env->ThrowError("RGBAdjust requires RGB input");<br />
}<br />
<br />
You can use [http://www.cplusplus.com/reference/cstdio/printf/ format specifiers] to print variables. The additional arguments following fmt are formatted and inserted in the resulting string replacing their respective specifiers:<br />
<br />
if (w[j] < 0.01) {<br />
env->ThrowError("%s Resizer: [Internal Error] Got Zero Coefficient; j: %d; w[j]: %f", "Spline", j, w[j]);<br />
}<br />
<br />
=== GetCPUFlags ===<br />
<br />
virtual long GetCPUFlags();<br />
<br />
GetCPUFlags returns the instruction set of your CPU. To find out if you're running for example on a CPU that supports MMX, test:<br />
<br />
env->GetCPUFlags() & CPUF_MMX<br />
<br />
There's a complete list of flags in avisynth.h.<br />
<br />
=== SaveString ===<br />
<br />
virtual char* SaveString(const char* s, int length = -1);<br />
<br />
This function copies its argument to a safe "permanent" location and returns a pointer to the new location. <br />
Each ScriptEnvironment instance has a buffer set aside for storing strings, which is expanded as needed. The strings are not deleted until the ScriptEnvironment instance goes away (when the script file is closed, usually). This is usually all the permanence that is needed, since all related filter instances will already be gone by then. <br />
The returned pointer is not const-qualified, and you're welcome to write to it, as long as you don't stray beyond the bounds of the string.<br />
<br />
Example usage (converting a string to upper case):<br />
<br />
AVSValue UCase(AVSValue args, void*, IScriptEnvironment* env) {<br />
return _strupr(env->SaveString(args[0].AsString()));<br />
}<br />
<br />
=== Sprintf and VSprintf ===<br />
<br />
virtual char* Sprintf(const char* fmt, ...);<br />
virtual char* VSprintf(const char* fmt, char* val);<br />
<br />
These store strings away in the same way as SaveString, but they treat their arguments like printf and vprintf. <br />
Currently there's a size limit of 4096 characters on strings created this way. (The implementation uses _vsnprintf, so you don't need to worry about buffer overrun.) <br />
<br />
=== Invoke ===<br />
<br />
virtual AVSValue Invoke(const char* name, const AVSValue args, const char** arg_names=0);<br />
<br />
You can use this to call a script function. There are many script functions which can be useful from other filters; for example, the Bob filter uses SeparateFields, and several source filters use UnalignedSplice. Some functions, like Weave, are implemented entirely in terms of other functions. <br />
If you're calling a function taking exactly one argument, you can simply pass it in the args parameter; Invoke will convert it into an array for you. In order to call a function taking multiple arguments, you will need to create the array yourself; it can be done like this: <br />
<br />
AVSValue up_args[3] = {child, 384, 288}; <br />
PClip resized = env->Invoke("LanczosResize", AVSValue(up_args,3)).AsClip();<br />
<br />
In this case LanczosResize would need to have a parameter-type string like "cii". <br />
<br />
Invoking a filter without arguments (for example catching the path of the loaded script with [[Internal_functions/ScriptDir#ScriptDir|ScriptDir]]):<br />
<br />
const char* V = env->Invoke("ScriptDir", AVSValue(0,0)).AsString();<br />
<br />
The arg_names parameter can be used to specify named arguments. Named arguments can also be given positionally, if you prefer. For example:<br />
<br />
int size_text = 24;<br />
int align = 8;<br />
const char *names[] = {NULL, NULL, "align", "size", "text_color"};<br />
AVSValue avsv[5] = {clip, "text", align, size_text, 0xFFFF00};<br />
clip = env->Invoke("Subtitle", AVSValue(avsv, 5), names).AsClip();<br />
<br />
Invoke throws IScriptEnvironment::NotFound if it can't find a matching function prototype. You should be prepared to catch this unless you know that the function exists and will accept the given arguments.<br />
<br />
=== BitBlt ===<br />
<br />
virtual void BitBlt(unsigned char* dstp, int dst_pitch, const unsigned char* srcp, int src_pitch, int row_size, int height);<br />
<br />
This brilliantly-named function does a line-by-line copy from the source to the destination. It's useful for quite a number of things; the built-in filters DoubleWeave, FlipVertical, AddBorders, PeculiarBlend, StackVertical, StackHorizontal, and ShowFiveVersions all use it to do their dirty work.<br />
<br />
In AddBorders it’s to copy the Y-plane from the source to the destination frame (for planar formats):<br />
<br />
const int initial_black = top*dst_pitch + vi.BytesFromPixels(left);<br />
if (vi.IsPlanar()) {<br />
env->BitBlt(dstp+initial_black, dst_pitch, srcp, src_pitch, src_row_size, src_height);<br />
...<br />
}<br />
<br />
left is the number of pixels which is added to the left, top the number which is added to the top. So the first source pixel, srcp[0], is copied to its new location dstp[x], and so on. The remaining bytes are zeroed and can be refilled later on.<br />
<br />
=== AtExit ===<br />
<br />
virtual void AtExit(ShutdownFunc function, void* user_data);<br />
<br />
When IScriptEnvironment is deleted on script close the AtExit functions get run. When you register the function you can optionally provide some user data. When the function is finally called this data will be provided as the argument to the procedure.<br />
<br />
The example below (thanks to tsp) loads a library and automatically unloads it (by using AtExit) after the script is closed. It can be useful when your plugin depends on a library and you want to load the library in your script (the plugin fft3dfilter.dll depends on the library fftw3.dll for example):<br />
<br />
void __cdecl UnloadDll(void* hinst, IScriptEnvironment* env) {<br />
if (hinst)<br />
FreeLibrary(static_cast<HMODULE>(hinst)); <br />
}<br />
<br />
AVSValue __cdecl LoadDll(AVSValue args, void* user_data, IScriptEnvironment* env){<br />
HMODULE hinst = 0;<br />
hinst = LoadLibrary(args[0].AsString()); // loads a library<br />
env->AtExit(UnloadDll, hinst); // calls UnloadDll to unload the library upon script exit<br />
return hinst!=NULL;<br />
}<br />
<br />
=== AddFunction ===<br />
<br />
virtual void __stdcall AddFunction(const char* name, const char* params, ApplyFunc apply, void* user_data) = 0; <br />
<br />
The main purpose of the AvisynthPluginInit2 (or AvisynthPluginInit3) function is to call env->AddFunction.<br />
<br />
env->AddFunction("Sepia", "c[color]i[mode]s", Create_Sepia, 0);<br />
<br />
AddFunction is called to let Avisynth know of the existence of our filter. It just registers a function with Avisynth's internal function table. This function takes four arguments: the name of the new script function; the parameter-type string; the C++ function implementing the script function; and the user_data cookie.<br />
<br />
The added function is of type AVSValue and can therefore return any AVSValue. Here are a few options how to return from the "added" function:<br />
<br />
AVSValue __cdecl returnSomething(AVSValue args, void* user_data, IScriptEnvironment* env){<br />
<br />
char *strlit = "AnyOldName";<br />
int len = strlen(strlit);<br />
char *s = new char[len+1];<br />
if (s==NULL)<br />
env->ThrowError("Cannot allocate string mem");<br />
strcpy(s, strlit); // duplicate<br />
char *e = s+len; // point at null<br />
// make safe copy of string (memory is freed on Avisynth closure)<br />
AVSValue ret = env->SaveString(s,e-s); // e-s is text len only (excl null) {SaveString uses memcpy)<br />
// AVSValue ret = env->SaveString(s); // alternative, Avisynth uses strlen to ascertain length<br />
delete []s; // delete our temp s buffer<br />
return ret; // return saved string as AVSValue<br />
// return strlit; // alternative to MOST of above code char* converted to AVSValue.<br />
// return "AnyOldName"; // alternative to ALL of above code char* converted to AVSValue.<br />
// String literals are read only and at constant address and so need not be saved.<br />
}<br />
<br />
=== MakeWritable ===<br />
<br />
virtual bool __stdcall MakeWritable(PVideoFrame* pvf) = 0;<br />
<br />
MakeWritable only copies the active part of the frame to a completely new frame with a default pitch. You need this to recieve a valid write pointer to an existing frame. <br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
<br />
=== FunctionExists ===<br />
<br />
virtual bool __stdcall FunctionExists(const char* name) = 0;<br />
<br />
FunctionExists returns true if the specified filter exists, otherwise returns false: <br />
<br />
if (env->FunctionExists("Import")) {<br />
env->ThrowError("Yes, the IMPORT function exist.");<br />
} else {<br />
env->ThrowError("No, the IMPORT function don't exist.");<br />
}<br />
<br />
=== GetVar ===<br />
<br />
virtual AVSValue __stdcall GetVar(const char* name) = 0;<br />
<br />
GetVar can be used to access AviSynth variables. It will throw an error if the variable doesn't exist.<br />
<br />
Internal and external (plugin) functions are, for example, exported as AviSynth variables:<br />
<br />
* $InternalFunctions$ Should contain a string consisting of function names of all internal functions.<br />
* $InternalFunctions!Functionname!Param$ Should contain all parameters for each internal function.<br />
* $PluginFunctions$ Should contain a string of all plugins in your autoloading plugin folder.<br />
* $Plugin!Functionname!Param$ Should contain all parameters.<br />
<br />
Use env->GetVar() to access them. This example returns a string consisting of all parameters of ConvertToYV12:<br />
<br />
const char* plugin_dir;<br />
plugin_dir = env->GetVar("$Plugin!ConverttoYV12!Param$").AsString();<br />
<br />
This example returns the plugin folder which is used to autoload your plugins (and returns an error if it’s not set):<br />
<br />
try {<br />
const char* plugin_dir;<br />
plugin_dir = env->GetVar("$PluginDir$").AsString();<br />
env->ThrowError(plugin_dir);<br />
} catch(...) {<br />
env->ThrowError("Plugin directory not set.");<br />
}<br />
<br />
If you are making a conditional filter you can use it to get the current framenumber:<br />
<br />
// Get current frame number<br />
AVSValue cf = env->GetVar("current_frame");<br />
if (!cf.IsInt())<br />
env->ThrowError("MinMaxAudio: This filter can only be used within ConditionalFilter");<br />
int n = cf.AsInt();<br />
PVideoFrame src = child->GetFrame(n, env);<br />
<br />
NEVER catch an AviSynth exception inside a plugin and continue normal execution afterwards, see [[AviSynth_Plugin_Writing_Tips]]<br />
<br />
=== GetVarDef, v6 ===<br />
<br />
virtual AVSValue __stdcall GetVarDef(const char* name, const AVSValue& def=AVSValue()) = 0;<br />
<br />
GetVarDef can be used to access AviSynth variables. It will return 'def' if the variable doesn't exist (instead of throwing an error):<br />
<br />
int error;<br />
AVSValue ret1 = env->GetVarDef("VarUnknown", AVSValue(-1)); // returns -1 when 'VarUnknown' doesn't exist<br />
AVSValue ret2 = env->GetVarDef("VarUnknown", AVSValue(-2)); // returns -2 when 'VarUnknown' doesn't exist<br />
if (ret1 != ret2)<br />
env->ThrowError("Plugin: The variable 'VarUnknown' doesn't exist!");<br />
<br />
Note: One call with a proper default setting is sufficient when either a variable's content or else a default value is needed.<br />
<br />
=== SetVar ===<br />
<br />
virtual bool __stdcall SetVar(const char* name, const AVSValue& val) = 0;<br />
<br />
WARNING: memory used by ''name'' and ''val.AsString()'' parameters must be allocated till IScriptEnvironment is destroyed.<br />
<br />
It will return true if the variable was created and filled with the given value. It will return false in case the variable was already there and we just updated its value.<br />
<br />
SetVar can be used to set or create AviSynth variables. The created variables are only visible in the local scope, e.g. script functions have a new scope.<br />
<br />
This example sets the autoloading plugin folder to "C:\\"<br />
<br />
if (env->SetVar("$PluginDir$", AVSValue("C:\\"))) {<br />
//variable was created<br />
} else {<br />
//variable was already existing and updated<br />
}<br />
<br />
This example sets variables in GetFrame which can be accessed later on in a script within the conditional environment:<br />
<br />
// saves the blue value of a pixel<br />
int BlueValue;<br />
BlueValue = srcp[x];<br />
env->SetVar("BlueValue", AVSValue(BlueValue));<br />
<br />
=== SetGlobalVar ===<br />
<br />
virtual bool __stdcall SetGlobalVar(const char* name, const AVSValue& val) = 0;<br />
<br />
WARNING: memory used by ''name'' and ''val.AsString()'' parameters must be allocated till IScriptEnvironment is destroyed.<br />
<br />
Usage:<br />
<br />
SetGlobalVar can be used to create or set AviSynth variables that are visible within global scope. It is possible that a single filter may want to use SetVar in order to exchange signals to possible other instances of itself.<br />
<br />
There are at least 4 different components that make use of Set(Global)Var functions:<br />
* the core itself<br />
* the user within the avs script<br />
* filters/plugins<br />
* a custom application that invoked the environment<br />
<br />
All of above may have their own requirements for the SetVar function. Some may want to be visible globally, others may not.<br />
<br />
=== PushContext ===<br />
<br />
virtual void __stdcall PushContext(int level=0) = 0;<br />
<br />
// TODO - see (also similar functions) http://forum.doom9.org/showthread.php?p=1595750#post1595750<br />
<br />
=== PopContext ===<br />
<br />
virtual void __stdcall PopContext() = 0;<br />
<br />
?<br />
<br />
=== PopContextGlobal ===<br />
<br />
virtual void __stdcall PopContextGlobal() = 0;<br />
<br />
?<br />
<br />
=== NewVideoFrame ===<br />
<br />
virtual PVideoFrame __stdcall NewVideoFrame(const VideoInfo& vi, int align=FRAME_ALIGN) = 0; // default align is 16<br />
<br />
The NewVideoFrame callback allocates space for a video frame of the supplied size. (In this case it will hold our filter's output.) The frame buffer is uninitialized raw memory (except that in the debug build it gets filled with the repeating byte pattern 0A 11 0C A7 ED, which is easy to recognize because it looks like "ALLOCATED"). <br><br />
"vi" is a protected member of GenericVideoFilter. It is a structure of type VideoInfo, which contains information about the clip (like frame size, frame rate, pixel format, audio sample rate, etc.). NewVideoFrame uses the information in this structure to return a frame buffer of the appropriate size.<br />
<br />
The following example creates a new VideoInfo structure and creates a new video frame from it:<br />
<br />
VideoInfo vi;<br />
PVideoFrame frame;<br />
memset(&vi, 0, sizeof(VideoInfo));<br />
vi.width = 640;<br />
vi.height = 480;<br />
vi.fps_numerator = 30000;<br />
vi.fps_denominator = 1001;<br />
vi.num_frames = 107892; // 1 hour<br />
vi.pixel_type = VideoInfo::CS_BGR32;<br />
vi.sample_type = SAMPLE_FLOAT;<br />
vi.nchannels = 2;<br />
vi.audio_samples_per_second = 48000;<br />
vi.num_audio_samples = vi.AudioSamplesFromFrames(vi.num_frames);<br />
frame = env->NewVideoFrame(vi);<br />
<br />
=== CheckVersion ===<br />
<br />
virtual void __stdcall CheckVersion(int version = AVISYNTH_INTERFACE_VERSION) = 0;<br />
<br />
CheckVersion checks the interface version (avisynth.h). It throws an error if ‘version’ is bigger than the used interface version. The following interface versions are in use:<br />
<br />
AVISYNTH_INTERFACE_VERSION = 1 (v1.0-v2.0.8), 2 (v2.5.0-v2.5.5), 3 (v2.5.6-v2.5.8), 5 (v2.6.0a1-v2.6.0a5), or 6 (v2.6.0) [version 4 doesn’t exist].<br />
<br />
This example will throw an error if v2.5x or an older AviSynth version is being used:<br />
<br />
env->CheckVersion(5)<br />
<br />
This can be used in a plugin, for example, if it needs at least a certain interface version for it to work.<br />
<br />
=== Subframe ===<br />
<br />
virtual PVideoFrame __stdcall Subframe(PVideoFrame src, int rel_offset, int new_pitch, int new_row_size, int new_height) = 0;<br />
<br />
Subframe (for interleaved formats) extracts a part of a video frame. For planar formats use SubframePlanar. For examples see SubframePlanar.<br />
<br />
=== SubframePlanar ===<br />
<br />
virtual PVideoFrame __stdcall SubframePlanar(PVideoFrame src, int rel_offset, int new_pitch, int new_row_size, int new_height, int rel_offsetU, int rel_offsetV, int new_pitchUV) = 0;<br />
<br />
SubframePlanar (for planar formats) extracts a part of a video frame. The example below returns the first field of a frame:<br />
<br />
vi.height >>= 1; // sets new height in the constructor<br />
<br />
PVideoFrame frame = child->GetFrame(n, env);<br />
if (vi.IsPlanar()) { // SubframePlanar works on planar formats only<br />
const int frame_pitch = frame->GetPitch(PLANAR_Y);<br />
const int frame_width = frame->GetRowSize(PLANAR_Y);<br />
const int frame_height = frame->GetHeight(PLANAR_Y);<br />
const int frame_pitchUV = frame->GetPitch(PLANAR_U);<br />
return env->SubframePlanar(frame, 0, 2*frame_pitch, frame_width, frame_height>>1, 0, 0, 2*frame_pitchUV);<br />
}<br />
<br />
Note that it copies the first row of pixels and moves on to the third row (by moving the offset by ‘2*frame_pitch’). After frame_height/2 it stops reading.<br />
<br />
The following example keeps the left 100 pixels of a clip (it leaves the height unaltered) and throws away the rest:<br />
<br />
vi.width = 100; // sets new width in the constructor<br />
<br />
PVideoFrame frame = child->GetFrame(n, env);<br />
if (vi.IsPlanar()) { // SubframePlanar works on planar formats only<br />
const int frame_pitch = frame->GetPitch(PLANAR_Y);<br />
const int frame_height = frame->GetHeight(PLANAR_Y);<br />
const int frame_pitchUV = frame->GetPitch(PLANAR_U);<br />
return env->SubframePlanar(frame, 0, frame_pitch, 100, frame_height, 0, 0, frame_pitchUV);<br />
}<br />
<br />
Note that it copies 100 pixels and moves on to the next row (by moving the offset by ‘frame_pitch’).<br />
<br />
You need to check somewhere that the source frames is more than 100 pixels wide, otherwise throw an error.<br />
<br />
=== SetMemoryMax ===<br />
<br />
virtual int __stdcall SetMemoryMax(int mem) = 0;<br />
<br />
There is a builtin cache automatically inserted in between all filters. You can use SetmemoryMax to increase the size.<br />
<br />
SetMemoryMax only sets the size of the frame buffer cache. It is independent of any other memory allocation. Memory usage due to the frame cache should ramp up pretty quickly to the limited value and stay there. Setting a lower SetMemoryMax value will make more memory available for other purposes and provide less cache buffer frames. It is pointless having more buffers available than are needed by the scripts temporal requirements. If each and every frame generated at each and every stage of a script is only ever used once then the cache is entirely useless. By definition a cache is only useful if a generated element is needed a second or subsequent time.<br />
<br />
=== SetWorkingDir ===<br />
<br />
virtual int __stdcall SetWorkingDir(const char * newdir) = 0;<br />
<br />
Sets the default directory for AviSynth.<br />
<br />
=== DeleteScriptEnvironment, v5 ===<br />
<br />
virtual void __stdcall DeleteScriptEnvironment() = 0;<br />
<br />
Provides a method to delete the ScriptEnvironment which is created with CreateScriptEnvironment.<br />
<br />
=== ApplyMessage, v5 ===<br />
<br />
virtual void _stdcall ApplyMessage(PVideoFrame* frame, const VideoInfo& vi, const char* message, int size, int textcolor, int halocolor, int bgcolor) = 0;<br />
<br />
ApplyMessage writes text on a frame. For example:<br />
<br />
char BUF[256];<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
sprintf(BUF, "Filter: Frame %d is processed.", n);<br />
env->ApplyMessage(&src, vi, BUF, vi.width/4, 0xf0f080, 0, 0);<br />
<br />
=== GetAVSLinkage , v5 ===<br />
<br />
virtual const AVS_Linkage* const __stdcall GetAVSLinkage() = 0;<br />
<br />
Returns the [[Filter_SDK/AVS_Linkage|AVSLinkage]].<br />
<br />
todo: how and when to use that ...<br />
<br />
== PVideoFrame ==<br />
<br />
PVideoFrame is a smart pointer to VideoFrame.<br />
<br />
In this example it gives a pointer to frame ‘n’ from child:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
<br />
"child" is a protected member of GenericVideoFilter, of type PClip. It contains the clip that was passed to the constructor. For our filter to produce frame n we need the corresponding frame of the input. If you need a different frame from the input, all you have to do is pass a different frame number to child->GetFrame.<br />
<br />
In this example it gives a pointer to a new created VideoFrame from vi (which is a VideoInfo structure):<br />
<br />
PVideoFrame dst = env->NewVideoFrame(vi);<br />
<br />
"vi" is another protected member of GenericVideoFilter (the only other member, actually). It is a structure of type VideoInfo, which contains information about the clip (like frame size, frame rate, pixel format, audio sample rate, etc.). NewVideoFrame uses the information in this struct to return a frame buffer of the appropriate size.<br />
<br />
== IClip ==<br />
<br />
An Avisynth filter is simply a C++ class implementing the IClip interface. IClip has four pure virtual methods: GetVideoInfo, GetFrame, GetParity, and GetAudio. <br />
The class GenericVideoFilter is a simple do-nothing filter defined in avisynth.h. It derives from IClip and implements all four methods. Most filters can inherit from GenericVideoFilter rather than directly from IClip; this saves you from having to implement methods that you don't care about, like GetAudio. <br />
<br />
IClip has the following members: GetVersion, GetFrame, GetParity, GetAudio, SetCacheHints and GetVideoInfo. They are described in the following subsections.<br />
<br />
=== GetVersion ===<br />
<br />
virtual int __stdcall GetVersion() { return AVISYNTH_INTERFACE_VERSION; }<br />
<br />
GetVersion returns the interface version of the loaded avisynth.dll:<br />
<br />
AVISYNTH_INTERFACE_VERSION = 1 (v1.0-v2.0.8), 2 (v2.5.0-v2.5.5), 3 (v2.5.6-v2.5.8), or 6 (v2.6.0) [version 4 doesn’t exist, version 5 refers to the alpha versions of v2.6.0 so you won't need that one].<br />
<br />
=== GetFrame ===<br />
<br />
virtual PVideoFrame __stdcall GetFrame(int n, IScriptEnvironment* env) = 0;<br />
<br />
GetFrame returns a video frame. In this example, the even frames (0, 2, 4, ...) of ‘child’ are returned:<br />
<br />
PVideoFrame src = child->GetFrame(2*n, env);<br />
<br />
You should do all the GetFrame() calls BEFORE you get any pointers and start manipulating any data.<br />
<br />
=== GetParity ===<br />
<br />
virtual bool __stdcall GetParity(int n) = 0;<br />
<br />
GetParity returns the field parity if the clip is field-based, otherwise it returns the parity of first field of a frame. In other words, it distinguishes between top field first (TFF) and bottom field first (BFF). When it returns true, it means that this frame should be considered TFF, otherwise it should be considered BFF.<br />
<br />
=== GetAudio ===<br />
<br />
virtual void __stdcall GetAudio(void* buf, __int64 start, __int64 count, IScriptEnvironment* env) = 0;<br />
<br />
Audio processing is handled through the GetAudio method. You must fill in the buffer with count samples beginning at the sample start. A sample may vary from one to four bytes, depending on whether the audio is 8, 16, 24 or 32-bit (float is also 32-bit). The flag vi.SampleType() will tell you this. <br />
<br />
If you cannot do your audio processing in-place, you must allocate your own buffer for the source audio using new or malloc.<br />
<br />
In this example, the audio of frame ‘n’ is returned (in the buffer ‘samples’):<br />
<br />
VideoInfo vi = child->GetVideoInfo();<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const __int64 start = vi.AudioSamplesFromFrames(n);<br />
const __int64 count = vi.AudioSamplesFromFrames(1);<br />
SFLOAT* samples = new SFLOAT[count*vi.AudioChannels()];<br />
child->GetAudio(samples, max(0,start), count, env);<br />
<br />
=== SetCacheHints ===<br />
<br />
void __stdcall SetCacheHints(int cachehints, int frame_range) = 0 ; // We do not pass cache requests upwards, only to the next filter.<br />
// int __stdcall SetCacheHints(int cachehints, int frame_range) = 0 ; // We do not pass cache requests upwards, only to the next filter.<br />
<br />
SetCacheHints should be used in filters that request multiple frames from any single PClip source per input GetFrame call. frame_range is maximal 21.<br />
<br />
The possible values of cachehints are:<br />
<br />
CACHE_NOTHING=0 // Filter requested no caching.<br />
CACHE_RANGE=1 // An explicit cache of "frame_range" frames around the current frame.<br />
CACHE_ALL=2 // This is default operation, a simple LRU cache.<br />
CACHE_AUDIO=3 // Audio caching.<br />
CACHE_AUDIO_NONE=4 // Filter requested no audio caching.<br />
CACHE_AUDIO_AUTO=5 // Audio caching (difference with CACHE_AUDIO?).<br />
<br />
When caching video frames (cachehints=0, 1, 2), frame_range is the radius around the current frame. When caching audio samples (cachehints=3, 4, 5), the value 0 creates a default buffer of 64kb and positive values allocate frame_range bytes for the cache.<br />
<br />
E.g. If you have a single PClip source, i.e. child and you get asked for frame 100 and you in turn then ask for frames 98, 99, 100, 101 and 102 then you need to call CACHE_RANGE with frame_range set to 3:<br />
<br />
child->SetCacheHints(CACHE_RANGE, 3);<br />
<br />
Frames outside the specified radius are candidate for normal LRU caching.<br />
<br />
// TODO - describe input and output for v5<br />
// http://forum.doom9.org/showthread.php?p=1595750#post1595750<br />
<br />
=== GetVideoInfo ===<br />
<br />
virtual const VideoInfo& __stdcall GetVideoInfo() = 0;<br />
<br />
GetVideoInfo returns a [[Filter_SDK/Cplusplus_API/VideoInfo|VideoInfo]] structure.<br />
<br />
== PClip ==<br />
<br />
PClip is a smart pointer to an IClip, and IClip is a generic abstract class.. It maintains a reference count on the IClip object and automagically deletes it when the last PClip referencing it goes away. For obvious reasons, you should always use PClip rather than IClip* to refer to clips. <br />
<br />
Like a genuine pointer, a PClip is only four bytes long, so you can pass it around by value. Also like a pointer, a PClip can be assigned a null value (0), which is often useful as a sentinel. Unlike a pointer, <br />
<br />
PClip is initialized to 0 by default. <br />
<br />
You'll need to make sure your class doesn't contain any circular PClip references, or any PClips sitting in dynamically allocated memory that you forget to delete. Other than that, you don't have to worry about the reference-counting machinery. <br />
<br />
AviSynth filters have a standardized output channel via IClip, but (unlike VirtualDub filters) no standardized input channel. Each filter is responsible for obtaining its own source material -- usually (as in this case) from another clip, but sometimes from several different clips, or from a file. <br />
<br />
The clip functionality must be provided by some concrete subclass of IClip which implements the functions GetFrame(), etc. So you cannot create a PClip without having an appropriate IClip subclass. For most filters, the GenericVideoFilter class provides the basis for this, but 'source' filters (which is basically what you have) do not have a parent clip and so GenericVideoFilter is not appropriate.<br />
<br />
== AVSValue ==<br />
<br />
Inside Avisynth, the value of a (script) variable is represented by an instance of the class AVSValue. Such objects have a one-character type field which denotes the script language type of the value:<br />
* 'a' for an array of AVSValues<br />
* 'b' for boolean<br />
* 'c' for clip<br />
* 'f' for float (IEEE single precision (32-bit) floating point)<br />
* 'i' for int (32-bit signed integer)<br />
* 's' for string<br />
* 'v' for void<br />
<br />
A variable of type AVSValue, if simply declared and not initialised, will have its type set to 'v' by the AVSValue constructor, meaning void (or 'undefined'), and not just left as random garbage.<br />
<br />
A numeric script variable is either an integer or an float. The latter will be the case if the value of the numeric variable contains a dot (so for example the variable x = '10.' will be parsed as float since its value contains a dot).<br />
<br />
You can test which type a variable is with the methods (return true or false):<br />
<br />
{| border="1"<br />
|- <br />
| '''Method'''<br />
| '''true condition'''<br />
| '''false condition'''<br />
|-<br />
| IsArray()<br />
| variable is an array<br />
| anything else<br />
|-<br />
| IsBool()<br />
| variable is true or false<br />
| anything else<br />
|-<br />
| IsClip()<br />
| variable is a clip<br />
| anything else<br />
|-<br />
| IsFloat()<br />
| variable is float or int<br />
| anything else<br />
|-<br />
| IsInt()<br />
| variable is int<br />
| anything else<br />
|-<br />
| IsString()<br />
| variable is float or string<br />
| anything else<br />
|-<br />
| Defined()<br />
| anything else<br />
| variable is "undefined"<br />
|}<br />
<br />
You can get the value of a variable with the methods:<br />
<br />
{| border="1"<br />
|- <br />
| '''Method'''<br />
| '''return type'''<br />
|-<br />
| AsBool(), AsBool(bool def)<br />
| bool<br />
|-<br />
| AsClip()<br />
| PClip<br />
|-<br />
| AsDblDef(double def)<br />
| double<br />
|-<br />
| AsFloat(), AsFloat(float def)<br />
| double<br />
|-<br />
| AsFloatf(), AsFloatf(float def)<br />
| float<br />
|-<br />
| AsInt(), AsInt(int def)<br />
| int<br />
|-<br />
| AsString(), AsString(const char* def)<br />
| const char*<br />
|}<br />
<br />
Boolean values are not treated as numeric (unlike C).<br />
<br />
Note that not all 32-bit integers can be represented as IEEE 32-bit floating point numbers. 16777216 and 16777217 have the same IEEE 32-bit floating point representation. Namely [0|10010111|00000000000000000000000]. See [[Float|IEEE-754]] for more information.<br />
<br />
For arrays, you can use the ArraySize() method to get the number of elements, and [] indexing to get the elements themselves.<br />
<br />
AVSValue holds an array of AVSValues in the following way:<br />
<br />
AVSValue(const AVSValue* a, int size) { type = 'a'; array = a; array_size = size; }<br />
<br />
'''Examples'''<br />
<br />
'''Arrays'''<br />
<br />
Using Invoke to apply a filter:<br />
<br />
AVSValue up_args[3] = {child, 384, 288}; <br />
PClip resized = env->Invoke("LanczosResize", AVSValue(up_args, 3)).AsClip();<br />
<br />
Note that<br />
<br />
AVSValue(up_args, 3)<br />
<br />
returns the following: {'a'; {child, 384, 288}; 3}.<br />
<br />
Also [[#Invoke|Invoke]] returns an AVSValue (see its declaration) which in that case is a PClip.<br />
<br />
You can get the number of elements of up_args and its elements in the following way:<br />
<br />
int num_args, width, height;<br />
PClip clip;<br />
if (up_args.IsArray()) {<br />
num_args = up_args.ArraySize();<br />
clip = up_args[1].AsClip();<br />
width = up_args[2].AsInt();<br />
height = up_args[3].AsInt();<br />
}<br />
<br />
'''Integers and floats'''<br />
<br />
Note that 123.0 can be accurately represented as an int, float or double. So for getting the exact value of x=123.0 you can use either AsInt(123), AsFloat(x), AsFloatf(x) or AsDblDef(x). All of them will return the same value with the same accuracy.<br />
<br />
As noted above, 16777217 can't be accurately represented as a float. So for getting the exact value of x=16777217.0 you need to use either AsInt(16777217) or AsDblDef(x). Both will return the same value with the same accuracy. Note that AsFloat() will return a double, but it is cast to a float first (losing accuracy).<br />
<br />
= Structures =<br />
<br />
The following structure is available: VideoInfo structure. It holds global information about a clip (i.e. information that does not depend on the framenumber). The GetVideoInfo method in IClip returns this structure. A description (for AVISYNTH_INTERFACE_VERSION=6) of it can be found [[Filter_SDK/Cplusplus_API/VideoInfo|here]].<br />
<br />
= Constants =<br />
<br />
The following constants are defined in avisynth.h:<br />
<br />
// Audio Sample information<br />
typedef float SFLOAT;<br />
<br />
enum { // sample types<br />
SAMPLE_INT8 = 1<<0,<br />
SAMPLE_INT16 = 1<<1,<br />
SAMPLE_INT24 = 1<<2,<br />
SAMPLE_INT32 = 1<<3,<br />
SAMPLE_FLOAT = 1<<4<br />
};<br />
<br />
enum { // plane types<br />
PLANAR_Y = 1<<0,<br />
PLANAR_U = 1<<1,<br />
PLANAR_V = 1<<2,<br />
PLANAR_ALIGNED = 1<<3,<br />
PLANAR_Y_ALIGNED = PLANAR_Y | PLANAR_ALIGNED,<br />
PLANAR_U_ALIGNED = PLANAR_U | PLANAR_ALIGNED,<br />
PLANAR_V_ALIGNED = PLANAR_V | PLANAR_ALIGNED,<br />
PLANAR_A = 1<<4, // v5<br />
PLANAR_R = 1<<5, // v5<br />
PLANAR_G = 1<<6, // v5<br />
PLANAR_B = 1<<7, // v5<br />
PLANAR_A_ALIGNED = PLANAR_A | PLANAR_ALIGNED, // v5<br />
PLANAR_R_ALIGNED = PLANAR_R | PLANAR_ALIGNED, // v5<br />
PLANAR_G_ALIGNED = PLANAR_G | PLANAR_ALIGNED, // v5<br />
PLANAR_B_ALIGNED = PLANAR_B | PLANAR_ALIGNED, // v5<br />
};<br />
<br />
enum { // cache types<br />
// Old 2.5 poorly defined cache hints (v3).<br />
// Reserve values used by 2.5 API<br />
// Do not use in new filters<br />
CACHE_25_NOTHING = 0, // Filter requested no caching.<br />
CACHE_25_RANGE = 1, // An explicit cache of "frame_range" frames around the current frame.<br />
CACHE_25_ALL = 2, // This is default operation, a simple LRU cache.<br />
CACHE_25_AUDIO = 3, // Audio caching.<br />
CACHE_25_AUDIO_NONE = 4, // Filter requested no audio caching.<br />
CACHE_25_AUDIO_AUTO = 5, // Audio caching (difference with CACHE_AUDIO?).<br />
<br />
// New 2.6 explicitly defined cache hints (v5).<br />
CACHE_NOTHING = 10, // Do not cache video.<br />
CACHE_WINDOW = 11, // Hard protect upto X frames within a range of X from the current frame N.<br />
CACHE_GENERIC = 12, // LRU cache upto X frames.<br />
CACHE_FORCE_GENERIC = 13, // LRU cache upto X frames, override any previous CACHE_WINDOW.<br />
<br />
CACHE_GET_POLICY = 30, // Get the current policy.<br />
CACHE_GET_WINDOW = 31, // Get the current window h_span.<br />
CACHE_GET_RANGE = 32, // Get the current generic frame range.<br />
<br />
CACHE_AUDIO = 50, // Explicitly do cache audio, X byte cache.<br />
CACHE_AUDIO_NOTHING = 51, // Explicitly do not cache audio.<br />
CACHE_AUDIO_NONE = 52, // Audio cache off (auto mode), X byte intial cache.<br />
CACHE_AUDIO_AUTO = 53, // Audio cache on (auto mode), X byte intial cache.<br />
<br />
CACHE_GET_AUDIO_POLICY = 70, // Get the current audio policy.<br />
CACHE_GET_AUDIO_SIZE = 71, // Get the current audio cache size.<br />
<br />
CACHE_PREFETCH_FRAME = 100, // Queue request to prefetch frame N.<br />
CACHE_PREFETCH_GO = 101, // Action video prefetches.<br />
<br />
CACHE_PREFETCH_AUDIO_BEGIN = 120, // Begin queue request transaction to prefetch audio (take critical section).<br />
CACHE_PREFETCH_AUDIO_STARTLO = 121, // Set low 32 bits of start.<br />
CACHE_PREFETCH_AUDIO_STARTHI = 122, // Set high 32 bits of start.<br />
CACHE_PREFETCH_AUDIO_COUNT = 123, // Set low 32 bits of length.<br />
CACHE_PREFETCH_AUDIO_COMMIT = 124, // Enqueue request transaction to prefetch audio (release critical section).<br />
CACHE_PREFETCH_AUDIO_GO = 125, // Action audio prefetches.<br />
<br />
CACHE_GETCHILD_CACHE_MODE = 200, // Cache ask Child for desired video cache mode.<br />
CACHE_GETCHILD_CACHE_SIZE = 201, // Cache ask Child for desired video cache size.<br />
CACHE_GETCHILD_AUDIO_MODE = 202, // Cache ask Child for desired audio cache mode.<br />
CACHE_GETCHILD_AUDIO_SIZE = 203, // Cache ask Child for desired audio cache size.<br />
<br />
CACHE_GETCHILD_COST = 220, // Cache ask Child for estimated processing cost.<br />
CACHE_COST_ZERO = 221, // Child response of zero cost (ptr arithmetic only).<br />
CACHE_COST_UNIT = 222, // Child response of unit cost (less than or equal 1 full frame blit).<br />
CACHE_COST_LOW = 223, // Child response of light cost. (Fast)<br />
CACHE_COST_MED = 224, // Child response of medium cost. (Real time)<br />
CACHE_COST_HI = 225, // Child response of heavy cost. (Slow)<br />
<br />
CACHE_GETCHILD_THREAD_MODE = 240, // Cache ask Child for thread safetyness.<br />
CACHE_THREAD_UNSAFE = 241, // Only 1 thread allowed for all instances. 2.5 filters default!<br />
CACHE_THREAD_CLASS = 242, // Only 1 thread allowed for each instance. 2.6 filters default!<br />
CACHE_THREAD_SAFE = 243, // Allow all threads in any instance.<br />
CACHE_THREAD_OWN = 244, // Safe but limit to 1 thread, internally threaded.<br />
<br />
CACHE_GETCHILD_ACCESS_COST = 260, // Cache ask Child for preferred access pattern.<br />
CACHE_ACCESS_RAND = 261, // Filter is access order agnostic.<br />
CACHE_ACCESS_SEQ0 = 262, // Filter prefers sequential access (low cost)<br />
CACHE_ACCESS_SEQ1 = 263, // Filter needs sequential access (high cost)<br />
};<br />
<br />
enum { // For GetCPUFlags. These are backwards-compatible with those in VirtualDub.<br />
/* oldest CPU to support extension */<br />
CPUF_FORCE = 0x01, // N/A<br />
CPUF_FPU = 0x02, // 386/486DX<br />
CPUF_MMX = 0x04, // P55C, K6, PII<br />
CPUF_INTEGER_SSE = 0x08, // PIII, Athlon<br />
CPUF_SSE = 0x10, // PIII, Athlon XP/MP<br />
CPUF_SSE2 = 0x20, // PIV, K8<br />
CPUF_3DNOW = 0x40, // K6-2<br />
CPUF_3DNOW_EXT = 0x80, // Athlon<br />
CPUF_X86_64 = 0xA0, // Hammer (note: equiv. to 3DNow + SSE2, which only Hammer will have anyway)<br />
CPUF_SSE3 = 0x100, // PIV+, K8 Venice<br />
<br />
// Additional CPU flags in 2.6 (v5-v6).<br />
CPUF_SSSE3 = 0x200, // Core 2<br />
CPUF_SSE4 = 0x400, // Penryn, Wolfdale, Yorkfield<br />
CPUF_SSE4_1 = 0x400,<br />
CPUF_SSE4_2 = 0x1000, // Nehalem (note this was 0x800 in v5)<br />
};<br />
<br />
[[Category:AviSynth_Development]]<br />
[[Category:FilterSDK]]</div>Martin53http://avisynth.nl/index.php/Filter_SDK/Cplusplus_APIFilter SDK/Cplusplus API2017-03-11T20:30:15Z<p>Martin53: /* GetVarDef, v6 */</p>
<hr />
<div>The header, avisynth.h, declares all the classes, structures and miscellaneous constants of the C++ API that you might need when writing a plugin. All external plugins should #include it:<br />
<br />
#include "avisynth.h"<br />
<br />
Note, sometimes there is a reference to a version number of the plugin api (for example v3, v5 or v6). This refers to the value of [[Filter_SDK/AVISYNTH_INTERFACE_VERSION|AVISYNTH_INTERFACE_VERSION]]. The classes and miscellaneous constants are described below.<br />
<br />
= CreateScriptEnvironment =<br />
<br />
IScriptEnvironment* __stdcall CreateScriptEnvironment(int version = AVISYNTH_INTERFACE_VERSION);<br />
<br />
AviSynth exports this. It enables you to use AviSynth as a library, without writing an AviSynth script or without going through AVIFile. [todo add link]<br />
<br />
= Classes =<br />
<br />
== AvisynthError ==<br />
<br />
AvisynthError(const char* _msg)<br />
<br />
Wrap your code in try/catch statements to enable exception handling. AvisynthError will tell you what's wrong.<br />
<br />
try <br />
{ <br />
Val = Env->Invoke("Import", Args, 0);<br />
Clip = Val.AsClip();<br />
VidInfo = Clip->GetVideoInfo();<br />
Frame = Clip->GetFrame( 1, Env);<br />
}<br />
catch (AvisynthError err) <br />
{<br />
printf("%s\n", err.msg);<br />
return 1;<br />
}<br />
<br />
== VideoFrameBuffer ==<br />
<br />
VideoFrameBuffer (VFB) holds information about a memory block which is used for video data. For efficiency, instances of this class are not deleted when the refcount reaches zero; instead they are stored in a linked list to be reused. The instances are deleted when the corresponding AVS file is closed. Or more accurately, a VideoFrameBuffer once new'd generally is not released until the IScriptEnvironment is deleted, except if SetMemoryMax is exceeded by too much then not in use VideoFrameBuffer's are forcible deleted until SetMemoryMax is satisfied.<br />
<br />
== VideoFrame ==<br />
<br />
VideoFrame holds a "window" into a VideoFrameBuffer. Operator new is overloaded to recycle class instances. Its members can be called by:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
src->GetReadPtr(..)<br />
<br />
VideoFrame has the following members: GetPitch, GetRowSize, GetHeight, GetReadPtr, GetWritePtr and IsWritable.<br />
<br />
All those filters (except IsWritable) will give you a property (pitch, rowsize, etc ...) of a plane (of the frame it points to). The interleaved formats (BGR(A) or YUY2) consist of one plane, and the planar formats consists of one (Y) or three (YUV) planes. The default plane is just the first plane (which is plane Y for the planar formats).<br />
<br />
=== GetPitch ===<br />
<br />
int GetPitch(int plane=0) const;<br />
<br />
The "pitch" (also called stride) of a frame buffer is the offset (in bytes) from the beginning of one scan line to the beginning of the next. The source and destination buffers won't necessarily have the same pitch. The pitch can vary among frames in a clip, and it can differ from the width of the clip. [todo add link]<br />
<br />
The scan line will be padded to a multiple of 8 (if necessary) due to speed reasons, so the pitch will always be a multiple of 8. Image processing is expensive, so SIMD instructions are used to speed tasks up: <br><br />
SSE uses 128 bit = 16 byte registers, so 8 YUY2 pixels can be processed the same time. <br><br />
AVX uses 256 bit = 32 byte registers, so 16 YUY2 pixels can be processed the same time.<br />
<br />
NOTE that the pitch can change anytime, so in most use cases you must request the pitch dynamically.<br />
<br />
Usage:<br />
<br />
GetPitch must be used on every plane (interleaved like YUY2 means 1 plane...) of every PVideoFrame that you want to read or write to. It is the only way to get the size of the Video Buffer (e.g. get the size of PVideoFrame):<br />
<br />
int buffer_size = src->GetPitch() * src->GetHeight(); //YUY2, interleaved<br />
<br />
This will give you the pitch of the U-plane (it will be zero if the plane doesn't exist):<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const int src_pitchUV = src->GetPitch(PLANAR_U);<br />
<br />
=== GetRowSize ===<br />
<br />
int GetRowSize(int plane=0) const;<br />
<br />
GetRowSize gives the length of each row in bytes (thus not in pixels). It's usually equal to the pitch or slightly less, but it may be significantly less if the frame in question has been through [[Crop]]. <br />
This will give you the rowsize of a frame for the interleaved formats, or the rowsize of the Y-plane for the planar formats (being the default plane).<br />
<br />
const int src_width = src->GetRowSize();<br />
<br />
=== GetHeight ===<br />
<br />
int GetHeight(int plane=0) const;<br />
<br />
GetHeight gives the height of the plane in pixels.<br />
<br />
=== GetReadPtr ===<br />
<br />
const BYTE* GetReadPtr(int plane=0) const;<br />
<br />
GetReadPtr gives you a read pointer to a plane. This will give a read pointer to the default plane:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const unsigned char* srcp = src->GetReadPtr()<br />
<br />
=== GetWritePtr ===<br />
<br />
BYTE* GetWritePtr(int plane=0) const;<br />
<br />
GetWritePtr gives you a write pointer to a plane.<br />
<br />
Any buffer you get from NewVideoFrame is guaranteed to be writable (as long as you only assign it to one PVideoFrame). Our filter's dst came from NewVideoFrame, so we can safely call dst->GetWritePtr(). However, frames you get from other clips via GetFrame may not be writable, in which case GetWritePtr() will return a null pointer.<br />
<br />
PVideoFrame dst = env->NewVideoFrame(vi); <br />
unsigned char* dstp = dst->GetWritePtr();<br />
<br />
If you want to write a frame which is not new (the source frame for example), you will have to call MakeWritable first:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
unsigned char* srcp = src->GetWritePtr(PLANAR_Y);<br />
<br />
See IsWritable for more details.<br />
<br />
=== IsWritable ===<br />
<br />
bool IsWritable() const;<br />
<br />
All frame buffers are readable, but not all are writable. This method can be used to find out if a buffer is writable or not, and there's a MakeWritable callback (described below) to ensure that it is.<br />
<br />
The rule about writability is this: A buffer is writable if and only if there is exactly one PVideoFrame pointing to it. In other words, you can only write to a buffer if no one else might be reading it. This rule guarantees that as long as you hold on to a PVideoFrame and don't write to it yourself, that frame will remain unchanged. The only drawback is that you can't have two PVideoFrames pointing to a writable buffer.<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
if (src->IsWritetable()) {...}<br />
<br />
== AlignPlanar ==<br />
<br />
AlignPlanar(PClip _clip);<br />
<br />
AlignPlanar does nothing, if the pitch of a frame is at least mod16 (16 bytes, being the default frame alignment for luma and chroma). Otherwise it realigns the image, by blitting it to a larger buffer.<br />
<br />
Filters can enforce a lower pitch, but they must always apply the AlignPlanar filter after itself, if they intend to return a frame with a lower pitch. VFW delivers a 4 byte alignment for example, so the AlignPlanar filters needs to be applied on all frames when using AviSource.<br />
<br />
== FillBorder ==<br />
<br />
FillBorder(PClip _clip);<br />
<br />
This function fills up the right side of the picture on planar images with duplicates of the rightmost pixel if the planes are not aligned. That is, if src->GetRowSize(PLANAR_Y) != src->GetRowSize(PLANAR_Y_ALIGNED).<br />
<br />
== ConvertAudio ==<br />
<br />
ConvertAudio(PClip _clip, int prefered_format);<br />
<br />
ConvertAudio converts the sample type of the audio to one of the following sample types: SAMPLE_INT8 (8 bits), SAMPLE_INT16 (16 bits), SAMPLE_INT24 (24 bits), SAMPLE_INT32 (32 bits) or SAMPLE_FLOAT (float).<br />
<br />
The following example converts the sample type of the clip child to SAMPLE_INT16 (16 bit) if the input isn’t 16 bit.<br />
<br />
ConvertAudio(child, SAMPLE_INT16);<br />
<br />
== IScriptEnvironment ==<br />
<br />
AviSynth exports an IScriptEnvironment interface. It enables you to use AviSynth as a library, without writing an AVS script or without going through AVIFile. Its members can be called by:<br />
<br />
IScriptEnvironment* env<br />
env->Invoke(..)<br />
<br />
IScriptEnvironment has the following members: ThrowError, GetCPUFlags, SaveString, Sprintf, VSprintf, Invoke, BitBlt, AtExit, AddFunction, MakeWritable, FunctionExists, GetVar, GetVarDef, SetVar, SetGlobalVar, PushContext, PopContext, NewVideoFrame, CheckVersion, Subframe, SubframePlanar, SetMemoryMax, SetWorkingDir, DeleteScriptEnvironment and ApplyMessage. They are described in the following subsections.<br />
<br />
=== ThrowError ===<br />
<br />
__declspec(noreturn) virtual void __stdcall ThrowError(const char* fmt, ...) = 0;<br />
<br />
ThrowError throws an exception (of type AvisynthError). Usually, your error message will end up being displayed on the user's screen in lieu of the video clip they were expecting:<br />
<br />
if (!vi.IsRGB()) {<br />
env->ThrowError("RGBAdjust requires RGB input");<br />
}<br />
<br />
You can use [http://www.cplusplus.com/reference/cstdio/printf/ format specifiers] to print variables. The additional arguments following fmt are formatted and inserted in the resulting string replacing their respective specifiers:<br />
<br />
if (w[j] < 0.01) {<br />
env->ThrowError("%s Resizer: [Internal Error] Got Zero Coefficient; j: %d; w[j]: %f", "Spline", j, w[j]);<br />
}<br />
<br />
=== GetCPUFlags ===<br />
<br />
virtual long GetCPUFlags();<br />
<br />
GetCPUFlags returns the instruction set of your CPU. To find out if you're running for example on a CPU that supports MMX, test:<br />
<br />
env->GetCPUFlags() & CPUF_MMX<br />
<br />
There's a complete list of flags in avisynth.h.<br />
<br />
=== SaveString ===<br />
<br />
virtual char* SaveString(const char* s, int length = -1);<br />
<br />
This function copies its argument to a safe "permanent" location and returns a pointer to the new location. <br />
Each ScriptEnvironment instance has a buffer set aside for storing strings, which is expanded as needed. The strings are not deleted until the ScriptEnvironment instance goes away (when the script file is closed, usually). This is usually all the permanence that is needed, since all related filter instances will already be gone by then. <br />
The returned pointer is not const-qualified, and you're welcome to write to it, as long as you don't stray beyond the bounds of the string.<br />
<br />
Example usage (converting a string to upper case):<br />
<br />
AVSValue UCase(AVSValue args, void*, IScriptEnvironment* env) {<br />
return _strupr(env->SaveString(args[0].AsString()));<br />
}<br />
<br />
=== Sprintf and VSprintf ===<br />
<br />
virtual char* Sprintf(const char* fmt, ...);<br />
virtual char* VSprintf(const char* fmt, char* val);<br />
<br />
These store strings away in the same way as SaveString, but they treat their arguments like printf and vprintf. <br />
Currently there's a size limit of 4096 characters on strings created this way. (The implementation uses _vsnprintf, so you don't need to worry about buffer overrun.) <br />
<br />
=== Invoke ===<br />
<br />
virtual AVSValue Invoke(const char* name, const AVSValue args, const char** arg_names=0);<br />
<br />
You can use this to call a script function. There are many script functions which can be useful from other filters; for example, the Bob filter uses SeparateFields, and several source filters use UnalignedSplice. Some functions, like Weave, are implemented entirely in terms of other functions. <br />
If you're calling a function taking exactly one argument, you can simply pass it in the args parameter; Invoke will convert it into an array for you. In order to call a function taking multiple arguments, you will need to create the array yourself; it can be done like this: <br />
<br />
AVSValue up_args[3] = {child, 384, 288}; <br />
PClip resized = env->Invoke("LanczosResize", AVSValue(up_args,3)).AsClip();<br />
<br />
In this case LanczosResize would need to have a parameter-type string like "cii". <br />
<br />
Invoking a filter without arguments (for example catching the path of the loaded script with [[Internal_functions/ScriptDir#ScriptDir|ScriptDir]]):<br />
<br />
const char* V = env->Invoke("ScriptDir", AVSValue(0,0)).AsString();<br />
<br />
The arg_names parameter can be used to specify named arguments. Named arguments can also be given positionally, if you prefer. For example:<br />
<br />
int size_text = 24;<br />
int align = 8;<br />
const char *names[] = {NULL, NULL, "align", "size", "text_color"};<br />
AVSValue avsv[5] = {clip, "text", align, size_text, 0xFFFF00};<br />
clip = env->Invoke("Subtitle", AVSValue(avsv, 5), names).AsClip();<br />
<br />
Invoke throws IScriptEnvironment::NotFound if it can't find a matching function prototype. You should be prepared to catch this unless you know that the function exists and will accept the given arguments.<br />
<br />
=== BitBlt ===<br />
<br />
virtual void BitBlt(unsigned char* dstp, int dst_pitch, const unsigned char* srcp, int src_pitch, int row_size, int height);<br />
<br />
This brilliantly-named function does a line-by-line copy from the source to the destination. It's useful for quite a number of things; the built-in filters DoubleWeave, FlipVertical, AddBorders, PeculiarBlend, StackVertical, StackHorizontal, and ShowFiveVersions all use it to do their dirty work.<br />
<br />
In AddBorders it’s to copy the Y-plane from the source to the destination frame (for planar formats):<br />
<br />
const int initial_black = top*dst_pitch + vi.BytesFromPixels(left);<br />
if (vi.IsPlanar()) {<br />
env->BitBlt(dstp+initial_black, dst_pitch, srcp, src_pitch, src_row_size, src_height);<br />
...<br />
}<br />
<br />
left is the number of pixels which is added to the left, top the number which is added to the top. So the first source pixel, srcp[0], is copied to its new location dstp[x], and so on. The remaining bytes are zeroed and can be refilled later on.<br />
<br />
=== AtExit ===<br />
<br />
virtual void AtExit(ShutdownFunc function, void* user_data);<br />
<br />
When IScriptEnvironment is deleted on script close the AtExit functions get run. When you register the function you can optionally provide some user data. When the function is finally called this data will be provided as the argument to the procedure.<br />
<br />
The example below (thanks to tsp) loads a library and automatically unloads it (by using AtExit) after the script is closed. It can be useful when your plugin depends on a library and you want to load the library in your script (the plugin fft3dfilter.dll depends on the library fftw3.dll for example):<br />
<br />
void __cdecl UnloadDll(void* hinst, IScriptEnvironment* env) {<br />
if (hinst)<br />
FreeLibrary(static_cast<HMODULE>(hinst)); <br />
}<br />
<br />
AVSValue __cdecl LoadDll(AVSValue args, void* user_data, IScriptEnvironment* env){<br />
HMODULE hinst = 0;<br />
hinst = LoadLibrary(args[0].AsString()); // loads a library<br />
env->AtExit(UnloadDll, hinst); // calls UnloadDll to unload the library upon script exit<br />
return hinst!=NULL;<br />
}<br />
<br />
=== AddFunction ===<br />
<br />
virtual void __stdcall AddFunction(const char* name, const char* params, ApplyFunc apply, void* user_data) = 0; <br />
<br />
The main purpose of the AvisynthPluginInit2 (or AvisynthPluginInit3) function is to call env->AddFunction.<br />
<br />
env->AddFunction("Sepia", "c[color]i[mode]s", Create_Sepia, 0);<br />
<br />
AddFunction is called to let Avisynth know of the existence of our filter. It just registers a function with Avisynth's internal function table. This function takes four arguments: the name of the new script function; the parameter-type string; the C++ function implementing the script function; and the user_data cookie.<br />
<br />
The added function is of type AVSValue and can therefore return any AVSValue. Here are a few options how to return from the "added" function:<br />
<br />
AVSValue __cdecl returnSomething(AVSValue args, void* user_data, IScriptEnvironment* env){<br />
<br />
char *strlit = "AnyOldName";<br />
int len = strlen(strlit);<br />
char *s = new char[len+1];<br />
if (s==NULL)<br />
env->ThrowError("Cannot allocate string mem");<br />
strcpy(s, strlit); // duplicate<br />
char *e = s+len; // point at null<br />
// make safe copy of string (memory is freed on Avisynth closure)<br />
AVSValue ret = env->SaveString(s,e-s); // e-s is text len only (excl null) {SaveString uses memcpy)<br />
// AVSValue ret = env->SaveString(s); // alternative, Avisynth uses strlen to ascertain length<br />
delete []s; // delete our temp s buffer<br />
return ret; // return saved string as AVSValue<br />
// return strlit; // alternative to MOST of above code char* converted to AVSValue.<br />
// return "AnyOldName"; // alternative to ALL of above code char* converted to AVSValue.<br />
// String literals are read only and at constant address and so need not be saved.<br />
}<br />
<br />
=== MakeWritable ===<br />
<br />
virtual bool __stdcall MakeWritable(PVideoFrame* pvf) = 0;<br />
<br />
MakeWritable only copies the active part of the frame to a completely new frame with a default pitch. You need this to recieve a valid write pointer to an existing frame. <br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
<br />
=== FunctionExists ===<br />
<br />
virtual bool __stdcall FunctionExists(const char* name) = 0;<br />
<br />
FunctionExists returns true if the specified filter exists, otherwise returns false: <br />
<br />
if (env->FunctionExists("Import")) {<br />
env->ThrowError("Yes, the IMPORT function exist.");<br />
} else {<br />
env->ThrowError("No, the IMPORT function don't exist.");<br />
}<br />
<br />
=== GetVar ===<br />
<br />
virtual AVSValue __stdcall GetVar(const char* name) = 0;<br />
<br />
GetVar can be used to access AviSynth variables. It will throw an error if the variable doesn't exist.<br />
<br />
Internal and external (plugin) functions are, for example, exported as AviSynth variables:<br />
<br />
* $InternalFunctions$ Should contain a string consisting of function names of all internal functions.<br />
* $InternalFunctions!Functionname!Param$ Should contain all parameters for each internal function.<br />
* $PluginFunctions$ Should contain a string of all plugins in your autoloading plugin folder.<br />
* $Plugin!Functionname!Param$ Should contain all parameters.<br />
<br />
Use env->GetVar() to access them. This example returns a string consisting of all parameters of ConvertToYV12:<br />
<br />
const char* plugin_dir;<br />
plugin_dir = env->GetVar("$Plugin!ConverttoYV12!Param$").AsString();<br />
<br />
This example returns the plugin folder which is used to autoload your plugins (and returns an error if it’s not set):<br />
<br />
try {<br />
const char* plugin_dir;<br />
plugin_dir = env->GetVar("$PluginDir$").AsString();<br />
env->ThrowError(plugin_dir);<br />
} catch(...) {<br />
env->ThrowError("Plugin directory not set.");<br />
}<br />
<br />
If you are making a conditional filter you can use it to get the current framenumber:<br />
<br />
// Get current frame number<br />
AVSValue cf = env->GetVar("current_frame");<br />
if (!cf.IsInt())<br />
env->ThrowError("MinMaxAudio: This filter can only be used within ConditionalFilter");<br />
int n = cf.AsInt();<br />
PVideoFrame src = child->GetFrame(n, env);<br />
<br />
=== GetVarDef, v6 ===<br />
<br />
virtual AVSValue __stdcall GetVarDef(const char* name, const AVSValue& def=AVSValue()) = 0;<br />
<br />
GetVarDef can be used to access AviSynth variables. It will return 'def' if the variable doesn't exist (instead of throwing an error):<br />
<br />
int error;<br />
AVSValue ret1 = env->GetVarDef("VarUnknown", AVSValue(-1)); // returns -1 when 'VarUnknown' doesn't exist<br />
AVSValue ret2 = env->GetVarDef("VarUnknown", AVSValue(-2)); // returns -2 when 'VarUnknown' doesn't exist<br />
if (ret1 != ret2)<br />
env->ThrowError("Plugin: The variable 'VarUnknown' doesn't exist!");<br />
<br />
Note: One call with a proper default setting is sufficient when either a variable's content or else a default value is needed.<br />
<br />
=== SetVar ===<br />
<br />
virtual bool __stdcall SetVar(const char* name, const AVSValue& val) = 0;<br />
<br />
WARNING: memory used by ''name'' and ''val.AsString()'' parameters must be allocated till IScriptEnvironment is destroyed.<br />
<br />
It will return true if the variable was created and filled with the given value. It will return false in case the variable was already there and we just updated its value.<br />
<br />
SetVar can be used to set or create AviSynth variables. The created variables are only visible in the local scope, e.g. script functions have a new scope.<br />
<br />
This example sets the autoloading plugin folder to "C:\\"<br />
<br />
if (env->SetVar("$PluginDir$", AVSValue("C:\\"))) {<br />
//variable was created<br />
} else {<br />
//variable was already existing and updated<br />
}<br />
<br />
This example sets variables in GetFrame which can be accessed later on in a script within the conditional environment:<br />
<br />
// saves the blue value of a pixel<br />
int BlueValue;<br />
BlueValue = srcp[x];<br />
env->SetVar("BlueValue", AVSValue(BlueValue));<br />
<br />
=== SetGlobalVar ===<br />
<br />
virtual bool __stdcall SetGlobalVar(const char* name, const AVSValue& val) = 0;<br />
<br />
WARNING: memory used by ''name'' and ''val.AsString()'' parameters must be allocated till IScriptEnvironment is destroyed.<br />
<br />
Usage:<br />
<br />
SetGlobalVar can be used to create or set AviSynth variables that are visible within global scope. It is possible that a single filter may want to use SetVar in order to exchange signals to possible other instances of itself.<br />
<br />
There are at least 4 different components that make use of Set(Global)Var functions:<br />
* the core itself<br />
* the user within the avs script<br />
* filters/plugins<br />
* a custom application that invoked the environment<br />
<br />
All of above may have their own requirements for the SetVar function. Some may want to be visible globally, others may not.<br />
<br />
=== PushContext ===<br />
<br />
virtual void __stdcall PushContext(int level=0) = 0;<br />
<br />
// TODO - see (also similar functions) http://forum.doom9.org/showthread.php?p=1595750#post1595750<br />
<br />
=== PopContext ===<br />
<br />
virtual void __stdcall PopContext() = 0;<br />
<br />
?<br />
<br />
=== PopContextGlobal ===<br />
<br />
virtual void __stdcall PopContextGlobal() = 0;<br />
<br />
?<br />
<br />
=== NewVideoFrame ===<br />
<br />
virtual PVideoFrame __stdcall NewVideoFrame(const VideoInfo& vi, int align=FRAME_ALIGN) = 0; // default align is 16<br />
<br />
The NewVideoFrame callback allocates space for a video frame of the supplied size. (In this case it will hold our filter's output.) The frame buffer is uninitialized raw memory (except that in the debug build it gets filled with the repeating byte pattern 0A 11 0C A7 ED, which is easy to recognize because it looks like "ALLOCATED"). <br><br />
"vi" is a protected member of GenericVideoFilter. It is a structure of type VideoInfo, which contains information about the clip (like frame size, frame rate, pixel format, audio sample rate, etc.). NewVideoFrame uses the information in this structure to return a frame buffer of the appropriate size.<br />
<br />
The following example creates a new VideoInfo structure and creates a new video frame from it:<br />
<br />
VideoInfo vi;<br />
PVideoFrame frame;<br />
memset(&vi, 0, sizeof(VideoInfo));<br />
vi.width = 640;<br />
vi.height = 480;<br />
vi.fps_numerator = 30000;<br />
vi.fps_denominator = 1001;<br />
vi.num_frames = 107892; // 1 hour<br />
vi.pixel_type = VideoInfo::CS_BGR32;<br />
vi.sample_type = SAMPLE_FLOAT;<br />
vi.nchannels = 2;<br />
vi.audio_samples_per_second = 48000;<br />
vi.num_audio_samples = vi.AudioSamplesFromFrames(vi.num_frames);<br />
frame = env->NewVideoFrame(vi);<br />
<br />
=== CheckVersion ===<br />
<br />
virtual void __stdcall CheckVersion(int version = AVISYNTH_INTERFACE_VERSION) = 0;<br />
<br />
CheckVersion checks the interface version (avisynth.h). It throws an error if ‘version’ is bigger than the used interface version. The following interface versions are in use:<br />
<br />
AVISYNTH_INTERFACE_VERSION = 1 (v1.0-v2.0.8), 2 (v2.5.0-v2.5.5), 3 (v2.5.6-v2.5.8), 5 (v2.6.0a1-v2.6.0a5), or 6 (v2.6.0) [version 4 doesn’t exist].<br />
<br />
This example will throw an error if v2.5x or an older AviSynth version is being used:<br />
<br />
env->CheckVersion(5)<br />
<br />
This can be used in a plugin, for example, if it needs at least a certain interface version for it to work.<br />
<br />
=== Subframe ===<br />
<br />
virtual PVideoFrame __stdcall Subframe(PVideoFrame src, int rel_offset, int new_pitch, int new_row_size, int new_height) = 0;<br />
<br />
Subframe (for interleaved formats) extracts a part of a video frame. For planar formats use SubframePlanar. For examples see SubframePlanar.<br />
<br />
=== SubframePlanar ===<br />
<br />
virtual PVideoFrame __stdcall SubframePlanar(PVideoFrame src, int rel_offset, int new_pitch, int new_row_size, int new_height, int rel_offsetU, int rel_offsetV, int new_pitchUV) = 0;<br />
<br />
SubframePlanar (for planar formats) extracts a part of a video frame. The example below returns the first field of a frame:<br />
<br />
vi.height >>= 1; // sets new height in the constructor<br />
<br />
PVideoFrame frame = child->GetFrame(n, env);<br />
if (vi.IsPlanar()) { // SubframePlanar works on planar formats only<br />
const int frame_pitch = frame->GetPitch(PLANAR_Y);<br />
const int frame_width = frame->GetRowSize(PLANAR_Y);<br />
const int frame_height = frame->GetHeight(PLANAR_Y);<br />
const int frame_pitchUV = frame->GetPitch(PLANAR_U);<br />
return env->SubframePlanar(frame, 0, 2*frame_pitch, frame_width, frame_height>>1, 0, 0, 2*frame_pitchUV);<br />
}<br />
<br />
Note that it copies the first row of pixels and moves on to the third row (by moving the offset by ‘2*frame_pitch’). After frame_height/2 it stops reading.<br />
<br />
The following example keeps the left 100 pixels of a clip (it leaves the height unaltered) and throws away the rest:<br />
<br />
vi.width = 100; // sets new width in the constructor<br />
<br />
PVideoFrame frame = child->GetFrame(n, env);<br />
if (vi.IsPlanar()) { // SubframePlanar works on planar formats only<br />
const int frame_pitch = frame->GetPitch(PLANAR_Y);<br />
const int frame_height = frame->GetHeight(PLANAR_Y);<br />
const int frame_pitchUV = frame->GetPitch(PLANAR_U);<br />
return env->SubframePlanar(frame, 0, frame_pitch, 100, frame_height, 0, 0, frame_pitchUV);<br />
}<br />
<br />
Note that it copies 100 pixels and moves on to the next row (by moving the offset by ‘frame_pitch’).<br />
<br />
You need to check somewhere that the source frames is more than 100 pixels wide, otherwise throw an error.<br />
<br />
=== SetMemoryMax ===<br />
<br />
virtual int __stdcall SetMemoryMax(int mem) = 0;<br />
<br />
There is a builtin cache automatically inserted in between all filters. You can use SetmemoryMax to increase the size.<br />
<br />
SetMemoryMax only sets the size of the frame buffer cache. It is independent of any other memory allocation. Memory usage due to the frame cache should ramp up pretty quickly to the limited value and stay there. Setting a lower SetMemoryMax value will make more memory available for other purposes and provide less cache buffer frames. It is pointless having more buffers available than are needed by the scripts temporal requirements. If each and every frame generated at each and every stage of a script is only ever used once then the cache is entirely useless. By definition a cache is only useful if a generated element is needed a second or subsequent time.<br />
<br />
=== SetWorkingDir ===<br />
<br />
virtual int __stdcall SetWorkingDir(const char * newdir) = 0;<br />
<br />
Sets the default directory for AviSynth.<br />
<br />
=== DeleteScriptEnvironment, v5 ===<br />
<br />
virtual void __stdcall DeleteScriptEnvironment() = 0;<br />
<br />
Provides a method to delete the ScriptEnvironment which is created with CreateScriptEnvironment.<br />
<br />
=== ApplyMessage, v5 ===<br />
<br />
virtual void _stdcall ApplyMessage(PVideoFrame* frame, const VideoInfo& vi, const char* message, int size, int textcolor, int halocolor, int bgcolor) = 0;<br />
<br />
ApplyMessage writes text on a frame. For example:<br />
<br />
char BUF[256];<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
sprintf(BUF, "Filter: Frame %d is processed.", n);<br />
env->ApplyMessage(&src, vi, BUF, vi.width/4, 0xf0f080, 0, 0);<br />
<br />
=== GetAVSLinkage , v5 ===<br />
<br />
virtual const AVS_Linkage* const __stdcall GetAVSLinkage() = 0;<br />
<br />
Returns the [[Filter_SDK/AVS_Linkage|AVSLinkage]].<br />
<br />
todo: how and when to use that ...<br />
<br />
== PVideoFrame ==<br />
<br />
PVideoFrame is a smart pointer to VideoFrame.<br />
<br />
In this example it gives a pointer to frame ‘n’ from child:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
<br />
"child" is a protected member of GenericVideoFilter, of type PClip. It contains the clip that was passed to the constructor. For our filter to produce frame n we need the corresponding frame of the input. If you need a different frame from the input, all you have to do is pass a different frame number to child->GetFrame.<br />
<br />
In this example it gives a pointer to a new created VideoFrame from vi (which is a VideoInfo structure):<br />
<br />
PVideoFrame dst = env->NewVideoFrame(vi);<br />
<br />
"vi" is another protected member of GenericVideoFilter (the only other member, actually). It is a structure of type VideoInfo, which contains information about the clip (like frame size, frame rate, pixel format, audio sample rate, etc.). NewVideoFrame uses the information in this struct to return a frame buffer of the appropriate size.<br />
<br />
== IClip ==<br />
<br />
An Avisynth filter is simply a C++ class implementing the IClip interface. IClip has four pure virtual methods: GetVideoInfo, GetFrame, GetParity, and GetAudio. <br />
The class GenericVideoFilter is a simple do-nothing filter defined in avisynth.h. It derives from IClip and implements all four methods. Most filters can inherit from GenericVideoFilter rather than directly from IClip; this saves you from having to implement methods that you don't care about, like GetAudio. <br />
<br />
IClip has the following members: GetVersion, GetFrame, GetParity, GetAudio, SetCacheHints and GetVideoInfo. They are described in the following subsections.<br />
<br />
=== GetVersion ===<br />
<br />
virtual int __stdcall GetVersion() { return AVISYNTH_INTERFACE_VERSION; }<br />
<br />
GetVersion returns the interface version of the loaded avisynth.dll:<br />
<br />
AVISYNTH_INTERFACE_VERSION = 1 (v1.0-v2.0.8), 2 (v2.5.0-v2.5.5), 3 (v2.5.6-v2.5.8), or 6 (v2.6.0) [version 4 doesn’t exist, version 5 refers to the alpha versions of v2.6.0 so you won't need that one].<br />
<br />
=== GetFrame ===<br />
<br />
virtual PVideoFrame __stdcall GetFrame(int n, IScriptEnvironment* env) = 0;<br />
<br />
GetFrame returns a video frame. In this example, the even frames (0, 2, 4, ...) of ‘child’ are returned:<br />
<br />
PVideoFrame src = child->GetFrame(2*n, env);<br />
<br />
You should do all the GetFrame() calls BEFORE you get any pointers and start manipulating any data.<br />
<br />
=== GetParity ===<br />
<br />
virtual bool __stdcall GetParity(int n) = 0;<br />
<br />
GetParity returns the field parity if the clip is field-based, otherwise it returns the parity of first field of a frame. In other words, it distinguishes between top field first (TFF) and bottom field first (BFF). When it returns true, it means that this frame should be considered TFF, otherwise it should be considered BFF.<br />
<br />
=== GetAudio ===<br />
<br />
virtual void __stdcall GetAudio(void* buf, __int64 start, __int64 count, IScriptEnvironment* env) = 0;<br />
<br />
Audio processing is handled through the GetAudio method. You must fill in the buffer with count samples beginning at the sample start. A sample may vary from one to four bytes, depending on whether the audio is 8, 16, 24 or 32-bit (float is also 32-bit). The flag vi.SampleType() will tell you this. <br />
<br />
If you cannot do your audio processing in-place, you must allocate your own buffer for the source audio using new or malloc.<br />
<br />
In this example, the audio of frame ‘n’ is returned (in the buffer ‘samples’):<br />
<br />
VideoInfo vi = child->GetVideoInfo();<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const __int64 start = vi.AudioSamplesFromFrames(n);<br />
const __int64 count = vi.AudioSamplesFromFrames(1);<br />
SFLOAT* samples = new SFLOAT[count*vi.AudioChannels()];<br />
child->GetAudio(samples, max(0,start), count, env);<br />
<br />
=== SetCacheHints ===<br />
<br />
void __stdcall SetCacheHints(int cachehints, int frame_range) = 0 ; // We do not pass cache requests upwards, only to the next filter.<br />
// int __stdcall SetCacheHints(int cachehints, int frame_range) = 0 ; // We do not pass cache requests upwards, only to the next filter.<br />
<br />
SetCacheHints should be used in filters that request multiple frames from any single PClip source per input GetFrame call. frame_range is maximal 21.<br />
<br />
The possible values of cachehints are:<br />
<br />
CACHE_NOTHING=0 // Filter requested no caching.<br />
CACHE_RANGE=1 // An explicit cache of "frame_range" frames around the current frame.<br />
CACHE_ALL=2 // This is default operation, a simple LRU cache.<br />
CACHE_AUDIO=3 // Audio caching.<br />
CACHE_AUDIO_NONE=4 // Filter requested no audio caching.<br />
CACHE_AUDIO_AUTO=5 // Audio caching (difference with CACHE_AUDIO?).<br />
<br />
When caching video frames (cachehints=0, 1, 2), frame_range is the radius around the current frame. When caching audio samples (cachehints=3, 4, 5), the value 0 creates a default buffer of 64kb and positive values allocate frame_range bytes for the cache.<br />
<br />
E.g. If you have a single PClip source, i.e. child and you get asked for frame 100 and you in turn then ask for frames 98, 99, 100, 101 and 102 then you need to call CACHE_RANGE with frame_range set to 3:<br />
<br />
child->SetCacheHints(CACHE_RANGE, 3);<br />
<br />
Frames outside the specified radius are candidate for normal LRU caching.<br />
<br />
// TODO - describe input and output for v5<br />
// http://forum.doom9.org/showthread.php?p=1595750#post1595750<br />
<br />
=== GetVideoInfo ===<br />
<br />
virtual const VideoInfo& __stdcall GetVideoInfo() = 0;<br />
<br />
GetVideoInfo returns a [[Filter_SDK/Cplusplus_API/VideoInfo|VideoInfo]] structure.<br />
<br />
== PClip ==<br />
<br />
PClip is a smart pointer to an IClip, and IClip is a generic abstract class.. It maintains a reference count on the IClip object and automagically deletes it when the last PClip referencing it goes away. For obvious reasons, you should always use PClip rather than IClip* to refer to clips. <br />
<br />
Like a genuine pointer, a PClip is only four bytes long, so you can pass it around by value. Also like a pointer, a PClip can be assigned a null value (0), which is often useful as a sentinel. Unlike a pointer, <br />
<br />
PClip is initialized to 0 by default. <br />
<br />
You'll need to make sure your class doesn't contain any circular PClip references, or any PClips sitting in dynamically allocated memory that you forget to delete. Other than that, you don't have to worry about the reference-counting machinery. <br />
<br />
AviSynth filters have a standardized output channel via IClip, but (unlike VirtualDub filters) no standardized input channel. Each filter is responsible for obtaining its own source material -- usually (as in this case) from another clip, but sometimes from several different clips, or from a file. <br />
<br />
The clip functionality must be provided by some concrete subclass of IClip which implements the functions GetFrame(), etc. So you cannot create a PClip without having an appropriate IClip subclass. For most filters, the GenericVideoFilter class provides the basis for this, but 'source' filters (which is basically what you have) do not have a parent clip and so GenericVideoFilter is not appropriate.<br />
<br />
== AVSValue ==<br />
<br />
Inside Avisynth, the value of a (script) variable is represented by an instance of the class AVSValue. Such objects have a one-character type field which denotes the script language type of the value:<br />
* 'a' for an array of AVSValues<br />
* 'b' for boolean<br />
* 'c' for clip<br />
* 'f' for float (IEEE single precision (32-bit) floating point)<br />
* 'i' for int (32-bit signed integer)<br />
* 's' for string<br />
* 'v' for void<br />
<br />
A variable of type AVSValue, if simply declared and not initialised, will have its type set to 'v' by the AVSValue constructor, meaning void (or 'undefined'), and not just left as random garbage.<br />
<br />
A numeric script variable is either an integer or an float. The latter will be the case if the value of the numeric variable contains a dot (so for example the variable x = '10.' will be parsed as float since its value contains a dot).<br />
<br />
You can test which type a variable is with the methods (return true or false):<br />
<br />
{| border="1"<br />
|- <br />
| '''Method'''<br />
| '''true condition'''<br />
| '''false condition'''<br />
|-<br />
| IsArray()<br />
| variable is an array<br />
| anything else<br />
|-<br />
| IsBool()<br />
| variable is true or false<br />
| anything else<br />
|-<br />
| IsClip()<br />
| variable is a clip<br />
| anything else<br />
|-<br />
| IsFloat()<br />
| variable is float or int<br />
| anything else<br />
|-<br />
| IsInt()<br />
| variable is int<br />
| anything else<br />
|-<br />
| IsString()<br />
| variable is float or string<br />
| anything else<br />
|-<br />
| Defined()<br />
| anything else<br />
| variable is "undefined"<br />
|}<br />
<br />
You can get the value of a variable with the methods:<br />
<br />
{| border="1"<br />
|- <br />
| '''Method'''<br />
| '''return type'''<br />
|-<br />
| AsBool(), AsBool(bool def)<br />
| bool<br />
|-<br />
| AsClip()<br />
| PClip<br />
|-<br />
| AsDblDef(double def)<br />
| double<br />
|-<br />
| AsFloat(), AsFloat(float def)<br />
| double<br />
|-<br />
| AsFloatf(), AsFloatf(float def)<br />
| float<br />
|-<br />
| AsInt(), AsInt(int def)<br />
| int<br />
|-<br />
| AsString(), AsString(const char* def)<br />
| const char*<br />
|}<br />
<br />
Boolean values are not treated as numeric (unlike C).<br />
<br />
Note that not all 32-bit integers can be represented as IEEE 32-bit floating point numbers. 16777216 and 16777217 have the same IEEE 32-bit floating point representation. Namely [0|10010111|00000000000000000000000]. See [[Float|IEEE-754]] for more information.<br />
<br />
For arrays, you can use the ArraySize() method to get the number of elements, and [] indexing to get the elements themselves.<br />
<br />
AVSValue holds an array of AVSValues in the following way:<br />
<br />
AVSValue(const AVSValue* a, int size) { type = 'a'; array = a; array_size = size; }<br />
<br />
'''Examples'''<br />
<br />
'''Arrays'''<br />
<br />
Using Invoke to apply a filter:<br />
<br />
AVSValue up_args[3] = {child, 384, 288}; <br />
PClip resized = env->Invoke("LanczosResize", AVSValue(up_args, 3)).AsClip();<br />
<br />
Note that<br />
<br />
AVSValue(up_args, 3)<br />
<br />
returns the following: {'a'; {child, 384, 288}; 3}.<br />
<br />
Also [[#Invoke|Invoke]] returns an AVSValue (see its declaration) which in that case is a PClip.<br />
<br />
You can get the number of elements of up_args and its elements in the following way:<br />
<br />
int num_args, width, height;<br />
PClip clip;<br />
if (up_args.IsArray()) {<br />
num_args = up_args.ArraySize();<br />
clip = up_args[1].AsClip();<br />
width = up_args[2].AsInt();<br />
height = up_args[3].AsInt();<br />
}<br />
<br />
'''Integers and floats'''<br />
<br />
Note that 123.0 can be accurately represented as an int, float or double. So for getting the exact value of x=123.0 you can use either AsInt(123), AsFloat(x), AsFloatf(x) or AsDblDef(x). All of them will return the same value with the same accuracy.<br />
<br />
As noted above, 16777217 can't be accurately represented as a float. So for getting the exact value of x=16777217.0 you need to use either AsInt(16777217) or AsDblDef(x). Both will return the same value with the same accuracy. Note that AsFloat() will return a double, but it is cast to a float first (losing accuracy).<br />
<br />
= Structures =<br />
<br />
The following structure is available: VideoInfo structure. It holds global information about a clip (i.e. information that does not depend on the framenumber). The GetVideoInfo method in IClip returns this structure. A description (for AVISYNTH_INTERFACE_VERSION=6) of it can be found [[Filter_SDK/Cplusplus_API/VideoInfo|here]].<br />
<br />
= Constants =<br />
<br />
The following constants are defined in avisynth.h:<br />
<br />
// Audio Sample information<br />
typedef float SFLOAT;<br />
<br />
enum { // sample types<br />
SAMPLE_INT8 = 1<<0,<br />
SAMPLE_INT16 = 1<<1,<br />
SAMPLE_INT24 = 1<<2,<br />
SAMPLE_INT32 = 1<<3,<br />
SAMPLE_FLOAT = 1<<4<br />
};<br />
<br />
enum { // plane types<br />
PLANAR_Y = 1<<0,<br />
PLANAR_U = 1<<1,<br />
PLANAR_V = 1<<2,<br />
PLANAR_ALIGNED = 1<<3,<br />
PLANAR_Y_ALIGNED = PLANAR_Y | PLANAR_ALIGNED,<br />
PLANAR_U_ALIGNED = PLANAR_U | PLANAR_ALIGNED,<br />
PLANAR_V_ALIGNED = PLANAR_V | PLANAR_ALIGNED,<br />
PLANAR_A = 1<<4, // v5<br />
PLANAR_R = 1<<5, // v5<br />
PLANAR_G = 1<<6, // v5<br />
PLANAR_B = 1<<7, // v5<br />
PLANAR_A_ALIGNED = PLANAR_A | PLANAR_ALIGNED, // v5<br />
PLANAR_R_ALIGNED = PLANAR_R | PLANAR_ALIGNED, // v5<br />
PLANAR_G_ALIGNED = PLANAR_G | PLANAR_ALIGNED, // v5<br />
PLANAR_B_ALIGNED = PLANAR_B | PLANAR_ALIGNED, // v5<br />
};<br />
<br />
enum { // cache types<br />
// Old 2.5 poorly defined cache hints (v3).<br />
// Reserve values used by 2.5 API<br />
// Do not use in new filters<br />
CACHE_25_NOTHING = 0, // Filter requested no caching.<br />
CACHE_25_RANGE = 1, // An explicit cache of "frame_range" frames around the current frame.<br />
CACHE_25_ALL = 2, // This is default operation, a simple LRU cache.<br />
CACHE_25_AUDIO = 3, // Audio caching.<br />
CACHE_25_AUDIO_NONE = 4, // Filter requested no audio caching.<br />
CACHE_25_AUDIO_AUTO = 5, // Audio caching (difference with CACHE_AUDIO?).<br />
<br />
// New 2.6 explicitly defined cache hints (v5).<br />
CACHE_NOTHING = 10, // Do not cache video.<br />
CACHE_WINDOW = 11, // Hard protect upto X frames within a range of X from the current frame N.<br />
CACHE_GENERIC = 12, // LRU cache upto X frames.<br />
CACHE_FORCE_GENERIC = 13, // LRU cache upto X frames, override any previous CACHE_WINDOW.<br />
<br />
CACHE_GET_POLICY = 30, // Get the current policy.<br />
CACHE_GET_WINDOW = 31, // Get the current window h_span.<br />
CACHE_GET_RANGE = 32, // Get the current generic frame range.<br />
<br />
CACHE_AUDIO = 50, // Explicitly do cache audio, X byte cache.<br />
CACHE_AUDIO_NOTHING = 51, // Explicitly do not cache audio.<br />
CACHE_AUDIO_NONE = 52, // Audio cache off (auto mode), X byte intial cache.<br />
CACHE_AUDIO_AUTO = 53, // Audio cache on (auto mode), X byte intial cache.<br />
<br />
CACHE_GET_AUDIO_POLICY = 70, // Get the current audio policy.<br />
CACHE_GET_AUDIO_SIZE = 71, // Get the current audio cache size.<br />
<br />
CACHE_PREFETCH_FRAME = 100, // Queue request to prefetch frame N.<br />
CACHE_PREFETCH_GO = 101, // Action video prefetches.<br />
<br />
CACHE_PREFETCH_AUDIO_BEGIN = 120, // Begin queue request transaction to prefetch audio (take critical section).<br />
CACHE_PREFETCH_AUDIO_STARTLO = 121, // Set low 32 bits of start.<br />
CACHE_PREFETCH_AUDIO_STARTHI = 122, // Set high 32 bits of start.<br />
CACHE_PREFETCH_AUDIO_COUNT = 123, // Set low 32 bits of length.<br />
CACHE_PREFETCH_AUDIO_COMMIT = 124, // Enqueue request transaction to prefetch audio (release critical section).<br />
CACHE_PREFETCH_AUDIO_GO = 125, // Action audio prefetches.<br />
<br />
CACHE_GETCHILD_CACHE_MODE = 200, // Cache ask Child for desired video cache mode.<br />
CACHE_GETCHILD_CACHE_SIZE = 201, // Cache ask Child for desired video cache size.<br />
CACHE_GETCHILD_AUDIO_MODE = 202, // Cache ask Child for desired audio cache mode.<br />
CACHE_GETCHILD_AUDIO_SIZE = 203, // Cache ask Child for desired audio cache size.<br />
<br />
CACHE_GETCHILD_COST = 220, // Cache ask Child for estimated processing cost.<br />
CACHE_COST_ZERO = 221, // Child response of zero cost (ptr arithmetic only).<br />
CACHE_COST_UNIT = 222, // Child response of unit cost (less than or equal 1 full frame blit).<br />
CACHE_COST_LOW = 223, // Child response of light cost. (Fast)<br />
CACHE_COST_MED = 224, // Child response of medium cost. (Real time)<br />
CACHE_COST_HI = 225, // Child response of heavy cost. (Slow)<br />
<br />
CACHE_GETCHILD_THREAD_MODE = 240, // Cache ask Child for thread safetyness.<br />
CACHE_THREAD_UNSAFE = 241, // Only 1 thread allowed for all instances. 2.5 filters default!<br />
CACHE_THREAD_CLASS = 242, // Only 1 thread allowed for each instance. 2.6 filters default!<br />
CACHE_THREAD_SAFE = 243, // Allow all threads in any instance.<br />
CACHE_THREAD_OWN = 244, // Safe but limit to 1 thread, internally threaded.<br />
<br />
CACHE_GETCHILD_ACCESS_COST = 260, // Cache ask Child for preferred access pattern.<br />
CACHE_ACCESS_RAND = 261, // Filter is access order agnostic.<br />
CACHE_ACCESS_SEQ0 = 262, // Filter prefers sequential access (low cost)<br />
CACHE_ACCESS_SEQ1 = 263, // Filter needs sequential access (high cost)<br />
};<br />
<br />
enum { // For GetCPUFlags. These are backwards-compatible with those in VirtualDub.<br />
/* oldest CPU to support extension */<br />
CPUF_FORCE = 0x01, // N/A<br />
CPUF_FPU = 0x02, // 386/486DX<br />
CPUF_MMX = 0x04, // P55C, K6, PII<br />
CPUF_INTEGER_SSE = 0x08, // PIII, Athlon<br />
CPUF_SSE = 0x10, // PIII, Athlon XP/MP<br />
CPUF_SSE2 = 0x20, // PIV, K8<br />
CPUF_3DNOW = 0x40, // K6-2<br />
CPUF_3DNOW_EXT = 0x80, // Athlon<br />
CPUF_X86_64 = 0xA0, // Hammer (note: equiv. to 3DNow + SSE2, which only Hammer will have anyway)<br />
CPUF_SSE3 = 0x100, // PIV+, K8 Venice<br />
<br />
// Additional CPU flags in 2.6 (v5-v6).<br />
CPUF_SSSE3 = 0x200, // Core 2<br />
CPUF_SSE4 = 0x400, // Penryn, Wolfdale, Yorkfield<br />
CPUF_SSE4_1 = 0x400,<br />
CPUF_SSE4_2 = 0x1000, // Nehalem (note this was 0x800 in v5)<br />
};<br />
<br />
[[Category:AviSynth_Development]]<br />
[[Category:FilterSDK]]</div>Martin53http://avisynth.nl/index.php/Filter_SDK/Cplusplus_APIFilter SDK/Cplusplus API2017-03-11T20:27:07Z<p>Martin53: /* GetVarDef, v6 */</p>
<hr />
<div>The header, avisynth.h, declares all the classes, structures and miscellaneous constants of the C++ API that you might need when writing a plugin. All external plugins should #include it:<br />
<br />
#include "avisynth.h"<br />
<br />
Note, sometimes there is a reference to a version number of the plugin api (for example v3, v5 or v6). This refers to the value of [[Filter_SDK/AVISYNTH_INTERFACE_VERSION|AVISYNTH_INTERFACE_VERSION]]. The classes and miscellaneous constants are described below.<br />
<br />
= CreateScriptEnvironment =<br />
<br />
IScriptEnvironment* __stdcall CreateScriptEnvironment(int version = AVISYNTH_INTERFACE_VERSION);<br />
<br />
AviSynth exports this. It enables you to use AviSynth as a library, without writing an AviSynth script or without going through AVIFile. [todo add link]<br />
<br />
= Classes =<br />
<br />
== AvisynthError ==<br />
<br />
AvisynthError(const char* _msg)<br />
<br />
Wrap your code in try/catch statements to enable exception handling. AvisynthError will tell you what's wrong.<br />
<br />
try <br />
{ <br />
Val = Env->Invoke("Import", Args, 0);<br />
Clip = Val.AsClip();<br />
VidInfo = Clip->GetVideoInfo();<br />
Frame = Clip->GetFrame( 1, Env);<br />
}<br />
catch (AvisynthError err) <br />
{<br />
printf("%s\n", err.msg);<br />
return 1;<br />
}<br />
<br />
== VideoFrameBuffer ==<br />
<br />
VideoFrameBuffer (VFB) holds information about a memory block which is used for video data. For efficiency, instances of this class are not deleted when the refcount reaches zero; instead they are stored in a linked list to be reused. The instances are deleted when the corresponding AVS file is closed. Or more accurately, a VideoFrameBuffer once new'd generally is not released until the IScriptEnvironment is deleted, except if SetMemoryMax is exceeded by too much then not in use VideoFrameBuffer's are forcible deleted until SetMemoryMax is satisfied.<br />
<br />
== VideoFrame ==<br />
<br />
VideoFrame holds a "window" into a VideoFrameBuffer. Operator new is overloaded to recycle class instances. Its members can be called by:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
src->GetReadPtr(..)<br />
<br />
VideoFrame has the following members: GetPitch, GetRowSize, GetHeight, GetReadPtr, GetWritePtr and IsWritable.<br />
<br />
All those filters (except IsWritable) will give you a property (pitch, rowsize, etc ...) of a plane (of the frame it points to). The interleaved formats (BGR(A) or YUY2) consist of one plane, and the planar formats consists of one (Y) or three (YUV) planes. The default plane is just the first plane (which is plane Y for the planar formats).<br />
<br />
=== GetPitch ===<br />
<br />
int GetPitch(int plane=0) const;<br />
<br />
The "pitch" (also called stride) of a frame buffer is the offset (in bytes) from the beginning of one scan line to the beginning of the next. The source and destination buffers won't necessarily have the same pitch. The pitch can vary among frames in a clip, and it can differ from the width of the clip. [todo add link]<br />
<br />
The scan line will be padded to a multiple of 8 (if necessary) due to speed reasons, so the pitch will always be a multiple of 8. Image processing is expensive, so SIMD instructions are used to speed tasks up: <br><br />
SSE uses 128 bit = 16 byte registers, so 8 YUY2 pixels can be processed the same time. <br><br />
AVX uses 256 bit = 32 byte registers, so 16 YUY2 pixels can be processed the same time.<br />
<br />
NOTE that the pitch can change anytime, so in most use cases you must request the pitch dynamically.<br />
<br />
Usage:<br />
<br />
GetPitch must be used on every plane (interleaved like YUY2 means 1 plane...) of every PVideoFrame that you want to read or write to. It is the only way to get the size of the Video Buffer (e.g. get the size of PVideoFrame):<br />
<br />
int buffer_size = src->GetPitch() * src->GetHeight(); //YUY2, interleaved<br />
<br />
This will give you the pitch of the U-plane (it will be zero if the plane doesn't exist):<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const int src_pitchUV = src->GetPitch(PLANAR_U);<br />
<br />
=== GetRowSize ===<br />
<br />
int GetRowSize(int plane=0) const;<br />
<br />
GetRowSize gives the length of each row in bytes (thus not in pixels). It's usually equal to the pitch or slightly less, but it may be significantly less if the frame in question has been through [[Crop]]. <br />
This will give you the rowsize of a frame for the interleaved formats, or the rowsize of the Y-plane for the planar formats (being the default plane).<br />
<br />
const int src_width = src->GetRowSize();<br />
<br />
=== GetHeight ===<br />
<br />
int GetHeight(int plane=0) const;<br />
<br />
GetHeight gives the height of the plane in pixels.<br />
<br />
=== GetReadPtr ===<br />
<br />
const BYTE* GetReadPtr(int plane=0) const;<br />
<br />
GetReadPtr gives you a read pointer to a plane. This will give a read pointer to the default plane:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const unsigned char* srcp = src->GetReadPtr()<br />
<br />
=== GetWritePtr ===<br />
<br />
BYTE* GetWritePtr(int plane=0) const;<br />
<br />
GetWritePtr gives you a write pointer to a plane.<br />
<br />
Any buffer you get from NewVideoFrame is guaranteed to be writable (as long as you only assign it to one PVideoFrame). Our filter's dst came from NewVideoFrame, so we can safely call dst->GetWritePtr(). However, frames you get from other clips via GetFrame may not be writable, in which case GetWritePtr() will return a null pointer.<br />
<br />
PVideoFrame dst = env->NewVideoFrame(vi); <br />
unsigned char* dstp = dst->GetWritePtr();<br />
<br />
If you want to write a frame which is not new (the source frame for example), you will have to call MakeWritable first:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
unsigned char* srcp = src->GetWritePtr(PLANAR_Y);<br />
<br />
See IsWritable for more details.<br />
<br />
=== IsWritable ===<br />
<br />
bool IsWritable() const;<br />
<br />
All frame buffers are readable, but not all are writable. This method can be used to find out if a buffer is writable or not, and there's a MakeWritable callback (described below) to ensure that it is.<br />
<br />
The rule about writability is this: A buffer is writable if and only if there is exactly one PVideoFrame pointing to it. In other words, you can only write to a buffer if no one else might be reading it. This rule guarantees that as long as you hold on to a PVideoFrame and don't write to it yourself, that frame will remain unchanged. The only drawback is that you can't have two PVideoFrames pointing to a writable buffer.<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
if (src->IsWritetable()) {...}<br />
<br />
== AlignPlanar ==<br />
<br />
AlignPlanar(PClip _clip);<br />
<br />
AlignPlanar does nothing, if the pitch of a frame is at least mod16 (16 bytes, being the default frame alignment for luma and chroma). Otherwise it realigns the image, by blitting it to a larger buffer.<br />
<br />
Filters can enforce a lower pitch, but they must always apply the AlignPlanar filter after itself, if they intend to return a frame with a lower pitch. VFW delivers a 4 byte alignment for example, so the AlignPlanar filters needs to be applied on all frames when using AviSource.<br />
<br />
== FillBorder ==<br />
<br />
FillBorder(PClip _clip);<br />
<br />
This function fills up the right side of the picture on planar images with duplicates of the rightmost pixel if the planes are not aligned. That is, if src->GetRowSize(PLANAR_Y) != src->GetRowSize(PLANAR_Y_ALIGNED).<br />
<br />
== ConvertAudio ==<br />
<br />
ConvertAudio(PClip _clip, int prefered_format);<br />
<br />
ConvertAudio converts the sample type of the audio to one of the following sample types: SAMPLE_INT8 (8 bits), SAMPLE_INT16 (16 bits), SAMPLE_INT24 (24 bits), SAMPLE_INT32 (32 bits) or SAMPLE_FLOAT (float).<br />
<br />
The following example converts the sample type of the clip child to SAMPLE_INT16 (16 bit) if the input isn’t 16 bit.<br />
<br />
ConvertAudio(child, SAMPLE_INT16);<br />
<br />
== IScriptEnvironment ==<br />
<br />
AviSynth exports an IScriptEnvironment interface. It enables you to use AviSynth as a library, without writing an AVS script or without going through AVIFile. Its members can be called by:<br />
<br />
IScriptEnvironment* env<br />
env->Invoke(..)<br />
<br />
IScriptEnvironment has the following members: ThrowError, GetCPUFlags, SaveString, Sprintf, VSprintf, Invoke, BitBlt, AtExit, AddFunction, MakeWritable, FunctionExists, GetVar, GetVarDef, SetVar, SetGlobalVar, PushContext, PopContext, NewVideoFrame, CheckVersion, Subframe, SubframePlanar, SetMemoryMax, SetWorkingDir, DeleteScriptEnvironment and ApplyMessage. They are described in the following subsections.<br />
<br />
=== ThrowError ===<br />
<br />
__declspec(noreturn) virtual void __stdcall ThrowError(const char* fmt, ...) = 0;<br />
<br />
ThrowError throws an exception (of type AvisynthError). Usually, your error message will end up being displayed on the user's screen in lieu of the video clip they were expecting:<br />
<br />
if (!vi.IsRGB()) {<br />
env->ThrowError("RGBAdjust requires RGB input");<br />
}<br />
<br />
You can use [http://www.cplusplus.com/reference/cstdio/printf/ format specifiers] to print variables. The additional arguments following fmt are formatted and inserted in the resulting string replacing their respective specifiers:<br />
<br />
if (w[j] < 0.01) {<br />
env->ThrowError("%s Resizer: [Internal Error] Got Zero Coefficient; j: %d; w[j]: %f", "Spline", j, w[j]);<br />
}<br />
<br />
=== GetCPUFlags ===<br />
<br />
virtual long GetCPUFlags();<br />
<br />
GetCPUFlags returns the instruction set of your CPU. To find out if you're running for example on a CPU that supports MMX, test:<br />
<br />
env->GetCPUFlags() & CPUF_MMX<br />
<br />
There's a complete list of flags in avisynth.h.<br />
<br />
=== SaveString ===<br />
<br />
virtual char* SaveString(const char* s, int length = -1);<br />
<br />
This function copies its argument to a safe "permanent" location and returns a pointer to the new location. <br />
Each ScriptEnvironment instance has a buffer set aside for storing strings, which is expanded as needed. The strings are not deleted until the ScriptEnvironment instance goes away (when the script file is closed, usually). This is usually all the permanence that is needed, since all related filter instances will already be gone by then. <br />
The returned pointer is not const-qualified, and you're welcome to write to it, as long as you don't stray beyond the bounds of the string.<br />
<br />
Example usage (converting a string to upper case):<br />
<br />
AVSValue UCase(AVSValue args, void*, IScriptEnvironment* env) {<br />
return _strupr(env->SaveString(args[0].AsString()));<br />
}<br />
<br />
=== Sprintf and VSprintf ===<br />
<br />
virtual char* Sprintf(const char* fmt, ...);<br />
virtual char* VSprintf(const char* fmt, char* val);<br />
<br />
These store strings away in the same way as SaveString, but they treat their arguments like printf and vprintf. <br />
Currently there's a size limit of 4096 characters on strings created this way. (The implementation uses _vsnprintf, so you don't need to worry about buffer overrun.) <br />
<br />
=== Invoke ===<br />
<br />
virtual AVSValue Invoke(const char* name, const AVSValue args, const char** arg_names=0);<br />
<br />
You can use this to call a script function. There are many script functions which can be useful from other filters; for example, the Bob filter uses SeparateFields, and several source filters use UnalignedSplice. Some functions, like Weave, are implemented entirely in terms of other functions. <br />
If you're calling a function taking exactly one argument, you can simply pass it in the args parameter; Invoke will convert it into an array for you. In order to call a function taking multiple arguments, you will need to create the array yourself; it can be done like this: <br />
<br />
AVSValue up_args[3] = {child, 384, 288}; <br />
PClip resized = env->Invoke("LanczosResize", AVSValue(up_args,3)).AsClip();<br />
<br />
In this case LanczosResize would need to have a parameter-type string like "cii". <br />
<br />
Invoking a filter without arguments (for example catching the path of the loaded script with [[Internal_functions/ScriptDir#ScriptDir|ScriptDir]]):<br />
<br />
const char* V = env->Invoke("ScriptDir", AVSValue(0,0)).AsString();<br />
<br />
The arg_names parameter can be used to specify named arguments. Named arguments can also be given positionally, if you prefer. For example:<br />
<br />
int size_text = 24;<br />
int align = 8;<br />
const char *names[] = {NULL, NULL, "align", "size", "text_color"};<br />
AVSValue avsv[5] = {clip, "text", align, size_text, 0xFFFF00};<br />
clip = env->Invoke("Subtitle", AVSValue(avsv, 5), names).AsClip();<br />
<br />
Invoke throws IScriptEnvironment::NotFound if it can't find a matching function prototype. You should be prepared to catch this unless you know that the function exists and will accept the given arguments.<br />
<br />
=== BitBlt ===<br />
<br />
virtual void BitBlt(unsigned char* dstp, int dst_pitch, const unsigned char* srcp, int src_pitch, int row_size, int height);<br />
<br />
This brilliantly-named function does a line-by-line copy from the source to the destination. It's useful for quite a number of things; the built-in filters DoubleWeave, FlipVertical, AddBorders, PeculiarBlend, StackVertical, StackHorizontal, and ShowFiveVersions all use it to do their dirty work.<br />
<br />
In AddBorders it’s to copy the Y-plane from the source to the destination frame (for planar formats):<br />
<br />
const int initial_black = top*dst_pitch + vi.BytesFromPixels(left);<br />
if (vi.IsPlanar()) {<br />
env->BitBlt(dstp+initial_black, dst_pitch, srcp, src_pitch, src_row_size, src_height);<br />
...<br />
}<br />
<br />
left is the number of pixels which is added to the left, top the number which is added to the top. So the first source pixel, srcp[0], is copied to its new location dstp[x], and so on. The remaining bytes are zeroed and can be refilled later on.<br />
<br />
=== AtExit ===<br />
<br />
virtual void AtExit(ShutdownFunc function, void* user_data);<br />
<br />
When IScriptEnvironment is deleted on script close the AtExit functions get run. When you register the function you can optionally provide some user data. When the function is finally called this data will be provided as the argument to the procedure.<br />
<br />
The example below (thanks to tsp) loads a library and automatically unloads it (by using AtExit) after the script is closed. It can be useful when your plugin depends on a library and you want to load the library in your script (the plugin fft3dfilter.dll depends on the library fftw3.dll for example):<br />
<br />
void __cdecl UnloadDll(void* hinst, IScriptEnvironment* env) {<br />
if (hinst)<br />
FreeLibrary(static_cast<HMODULE>(hinst)); <br />
}<br />
<br />
AVSValue __cdecl LoadDll(AVSValue args, void* user_data, IScriptEnvironment* env){<br />
HMODULE hinst = 0;<br />
hinst = LoadLibrary(args[0].AsString()); // loads a library<br />
env->AtExit(UnloadDll, hinst); // calls UnloadDll to unload the library upon script exit<br />
return hinst!=NULL;<br />
}<br />
<br />
=== AddFunction ===<br />
<br />
virtual void __stdcall AddFunction(const char* name, const char* params, ApplyFunc apply, void* user_data) = 0; <br />
<br />
The main purpose of the AvisynthPluginInit2 (or AvisynthPluginInit3) function is to call env->AddFunction.<br />
<br />
env->AddFunction("Sepia", "c[color]i[mode]s", Create_Sepia, 0);<br />
<br />
AddFunction is called to let Avisynth know of the existence of our filter. It just registers a function with Avisynth's internal function table. This function takes four arguments: the name of the new script function; the parameter-type string; the C++ function implementing the script function; and the user_data cookie.<br />
<br />
The added function is of type AVSValue and can therefore return any AVSValue. Here are a few options how to return from the "added" function:<br />
<br />
AVSValue __cdecl returnSomething(AVSValue args, void* user_data, IScriptEnvironment* env){<br />
<br />
char *strlit = "AnyOldName";<br />
int len = strlen(strlit);<br />
char *s = new char[len+1];<br />
if (s==NULL)<br />
env->ThrowError("Cannot allocate string mem");<br />
strcpy(s, strlit); // duplicate<br />
char *e = s+len; // point at null<br />
// make safe copy of string (memory is freed on Avisynth closure)<br />
AVSValue ret = env->SaveString(s,e-s); // e-s is text len only (excl null) {SaveString uses memcpy)<br />
// AVSValue ret = env->SaveString(s); // alternative, Avisynth uses strlen to ascertain length<br />
delete []s; // delete our temp s buffer<br />
return ret; // return saved string as AVSValue<br />
// return strlit; // alternative to MOST of above code char* converted to AVSValue.<br />
// return "AnyOldName"; // alternative to ALL of above code char* converted to AVSValue.<br />
// String literals are read only and at constant address and so need not be saved.<br />
}<br />
<br />
=== MakeWritable ===<br />
<br />
virtual bool __stdcall MakeWritable(PVideoFrame* pvf) = 0;<br />
<br />
MakeWritable only copies the active part of the frame to a completely new frame with a default pitch. You need this to recieve a valid write pointer to an existing frame. <br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
<br />
=== FunctionExists ===<br />
<br />
virtual bool __stdcall FunctionExists(const char* name) = 0;<br />
<br />
FunctionExists returns true if the specified filter exists, otherwise returns false: <br />
<br />
if (env->FunctionExists("Import")) {<br />
env->ThrowError("Yes, the IMPORT function exist.");<br />
} else {<br />
env->ThrowError("No, the IMPORT function don't exist.");<br />
}<br />
<br />
=== GetVar ===<br />
<br />
virtual AVSValue __stdcall GetVar(const char* name) = 0;<br />
<br />
GetVar can be used to access AviSynth variables. It will throw an error if the variable doesn't exist.<br />
<br />
Internal and external (plugin) functions are, for example, exported as AviSynth variables:<br />
<br />
* $InternalFunctions$ Should contain a string consisting of function names of all internal functions.<br />
* $InternalFunctions!Functionname!Param$ Should contain all parameters for each internal function.<br />
* $PluginFunctions$ Should contain a string of all plugins in your autoloading plugin folder.<br />
* $Plugin!Functionname!Param$ Should contain all parameters.<br />
<br />
Use env->GetVar() to access them. This example returns a string consisting of all parameters of ConvertToYV12:<br />
<br />
const char* plugin_dir;<br />
plugin_dir = env->GetVar("$Plugin!ConverttoYV12!Param$").AsString();<br />
<br />
This example returns the plugin folder which is used to autoload your plugins (and returns an error if it’s not set):<br />
<br />
try {<br />
const char* plugin_dir;<br />
plugin_dir = env->GetVar("$PluginDir$").AsString();<br />
env->ThrowError(plugin_dir);<br />
} catch(...) {<br />
env->ThrowError("Plugin directory not set.");<br />
}<br />
<br />
If you are making a conditional filter you can use it to get the current framenumber:<br />
<br />
// Get current frame number<br />
AVSValue cf = env->GetVar("current_frame");<br />
if (!cf.IsInt())<br />
env->ThrowError("MinMaxAudio: This filter can only be used within ConditionalFilter");<br />
int n = cf.AsInt();<br />
PVideoFrame src = child->GetFrame(n, env);<br />
<br />
=== GetVarDef, v6 ===<br />
<br />
virtual AVSValue __stdcall GetVarDef(const char* name, const AVSValue& def=AVSValue()) = 0;<br />
<br />
GetVarDef can be used to access AviSynth variables. It will return 'def' if the variable doesn't exist (instead of throwing an error):<br />
<br />
int error;<br />
AVSValue error = env->GetVarDef("VarUnknown", AVSValue(-1)); // returns -1 when 'VarUnknown' doesn't exist<br />
if (error==-1)<br />
env->ThrowError("Plugin: The variable 'VarUnknown' doesn't exist!");<br />
<br />
Note: the example uses a default value -1 which is returned in both cases when the variable exists and has this value, and when it doesn't exist. A plugin can distinguish only with a second call, e.g. with a different default value if the variable realy exists (both return the same value) or if it doesn't exist (they return the different defaults).<br />
<br />
=== SetVar ===<br />
<br />
virtual bool __stdcall SetVar(const char* name, const AVSValue& val) = 0;<br />
<br />
WARNING: memory used by ''name'' and ''val.AsString()'' parameters must be allocated till IScriptEnvironment is destroyed.<br />
<br />
It will return true if the variable was created and filled with the given value. It will return false in case the variable was already there and we just updated its value.<br />
<br />
SetVar can be used to set or create AviSynth variables. The created variables are only visible in the local scope, e.g. script functions have a new scope.<br />
<br />
This example sets the autoloading plugin folder to "C:\\"<br />
<br />
if (env->SetVar("$PluginDir$", AVSValue("C:\\"))) {<br />
//variable was created<br />
} else {<br />
//variable was already existing and updated<br />
}<br />
<br />
This example sets variables in GetFrame which can be accessed later on in a script within the conditional environment:<br />
<br />
// saves the blue value of a pixel<br />
int BlueValue;<br />
BlueValue = srcp[x];<br />
env->SetVar("BlueValue", AVSValue(BlueValue));<br />
<br />
=== SetGlobalVar ===<br />
<br />
virtual bool __stdcall SetGlobalVar(const char* name, const AVSValue& val) = 0;<br />
<br />
WARNING: memory used by ''name'' and ''val.AsString()'' parameters must be allocated till IScriptEnvironment is destroyed.<br />
<br />
Usage:<br />
<br />
SetGlobalVar can be used to create or set AviSynth variables that are visible within global scope. It is possible that a single filter may want to use SetVar in order to exchange signals to possible other instances of itself.<br />
<br />
There are at least 4 different components that make use of Set(Global)Var functions:<br />
* the core itself<br />
* the user within the avs script<br />
* filters/plugins<br />
* a custom application that invoked the environment<br />
<br />
All of above may have their own requirements for the SetVar function. Some may want to be visible globally, others may not.<br />
<br />
=== PushContext ===<br />
<br />
virtual void __stdcall PushContext(int level=0) = 0;<br />
<br />
// TODO - see (also similar functions) http://forum.doom9.org/showthread.php?p=1595750#post1595750<br />
<br />
=== PopContext ===<br />
<br />
virtual void __stdcall PopContext() = 0;<br />
<br />
?<br />
<br />
=== PopContextGlobal ===<br />
<br />
virtual void __stdcall PopContextGlobal() = 0;<br />
<br />
?<br />
<br />
=== NewVideoFrame ===<br />
<br />
virtual PVideoFrame __stdcall NewVideoFrame(const VideoInfo& vi, int align=FRAME_ALIGN) = 0; // default align is 16<br />
<br />
The NewVideoFrame callback allocates space for a video frame of the supplied size. (In this case it will hold our filter's output.) The frame buffer is uninitialized raw memory (except that in the debug build it gets filled with the repeating byte pattern 0A 11 0C A7 ED, which is easy to recognize because it looks like "ALLOCATED"). <br><br />
"vi" is a protected member of GenericVideoFilter. It is a structure of type VideoInfo, which contains information about the clip (like frame size, frame rate, pixel format, audio sample rate, etc.). NewVideoFrame uses the information in this structure to return a frame buffer of the appropriate size.<br />
<br />
The following example creates a new VideoInfo structure and creates a new video frame from it:<br />
<br />
VideoInfo vi;<br />
PVideoFrame frame;<br />
memset(&vi, 0, sizeof(VideoInfo));<br />
vi.width = 640;<br />
vi.height = 480;<br />
vi.fps_numerator = 30000;<br />
vi.fps_denominator = 1001;<br />
vi.num_frames = 107892; // 1 hour<br />
vi.pixel_type = VideoInfo::CS_BGR32;<br />
vi.sample_type = SAMPLE_FLOAT;<br />
vi.nchannels = 2;<br />
vi.audio_samples_per_second = 48000;<br />
vi.num_audio_samples = vi.AudioSamplesFromFrames(vi.num_frames);<br />
frame = env->NewVideoFrame(vi);<br />
<br />
=== CheckVersion ===<br />
<br />
virtual void __stdcall CheckVersion(int version = AVISYNTH_INTERFACE_VERSION) = 0;<br />
<br />
CheckVersion checks the interface version (avisynth.h). It throws an error if ‘version’ is bigger than the used interface version. The following interface versions are in use:<br />
<br />
AVISYNTH_INTERFACE_VERSION = 1 (v1.0-v2.0.8), 2 (v2.5.0-v2.5.5), 3 (v2.5.6-v2.5.8), 5 (v2.6.0a1-v2.6.0a5), or 6 (v2.6.0) [version 4 doesn’t exist].<br />
<br />
This example will throw an error if v2.5x or an older AviSynth version is being used:<br />
<br />
env->CheckVersion(5)<br />
<br />
This can be used in a plugin, for example, if it needs at least a certain interface version for it to work.<br />
<br />
=== Subframe ===<br />
<br />
virtual PVideoFrame __stdcall Subframe(PVideoFrame src, int rel_offset, int new_pitch, int new_row_size, int new_height) = 0;<br />
<br />
Subframe (for interleaved formats) extracts a part of a video frame. For planar formats use SubframePlanar. For examples see SubframePlanar.<br />
<br />
=== SubframePlanar ===<br />
<br />
virtual PVideoFrame __stdcall SubframePlanar(PVideoFrame src, int rel_offset, int new_pitch, int new_row_size, int new_height, int rel_offsetU, int rel_offsetV, int new_pitchUV) = 0;<br />
<br />
SubframePlanar (for planar formats) extracts a part of a video frame. The example below returns the first field of a frame:<br />
<br />
vi.height >>= 1; // sets new height in the constructor<br />
<br />
PVideoFrame frame = child->GetFrame(n, env);<br />
if (vi.IsPlanar()) { // SubframePlanar works on planar formats only<br />
const int frame_pitch = frame->GetPitch(PLANAR_Y);<br />
const int frame_width = frame->GetRowSize(PLANAR_Y);<br />
const int frame_height = frame->GetHeight(PLANAR_Y);<br />
const int frame_pitchUV = frame->GetPitch(PLANAR_U);<br />
return env->SubframePlanar(frame, 0, 2*frame_pitch, frame_width, frame_height>>1, 0, 0, 2*frame_pitchUV);<br />
}<br />
<br />
Note that it copies the first row of pixels and moves on to the third row (by moving the offset by ‘2*frame_pitch’). After frame_height/2 it stops reading.<br />
<br />
The following example keeps the left 100 pixels of a clip (it leaves the height unaltered) and throws away the rest:<br />
<br />
vi.width = 100; // sets new width in the constructor<br />
<br />
PVideoFrame frame = child->GetFrame(n, env);<br />
if (vi.IsPlanar()) { // SubframePlanar works on planar formats only<br />
const int frame_pitch = frame->GetPitch(PLANAR_Y);<br />
const int frame_height = frame->GetHeight(PLANAR_Y);<br />
const int frame_pitchUV = frame->GetPitch(PLANAR_U);<br />
return env->SubframePlanar(frame, 0, frame_pitch, 100, frame_height, 0, 0, frame_pitchUV);<br />
}<br />
<br />
Note that it copies 100 pixels and moves on to the next row (by moving the offset by ‘frame_pitch’).<br />
<br />
You need to check somewhere that the source frames is more than 100 pixels wide, otherwise throw an error.<br />
<br />
=== SetMemoryMax ===<br />
<br />
virtual int __stdcall SetMemoryMax(int mem) = 0;<br />
<br />
There is a builtin cache automatically inserted in between all filters. You can use SetmemoryMax to increase the size.<br />
<br />
SetMemoryMax only sets the size of the frame buffer cache. It is independent of any other memory allocation. Memory usage due to the frame cache should ramp up pretty quickly to the limited value and stay there. Setting a lower SetMemoryMax value will make more memory available for other purposes and provide less cache buffer frames. It is pointless having more buffers available than are needed by the scripts temporal requirements. If each and every frame generated at each and every stage of a script is only ever used once then the cache is entirely useless. By definition a cache is only useful if a generated element is needed a second or subsequent time.<br />
<br />
=== SetWorkingDir ===<br />
<br />
virtual int __stdcall SetWorkingDir(const char * newdir) = 0;<br />
<br />
Sets the default directory for AviSynth.<br />
<br />
=== DeleteScriptEnvironment, v5 ===<br />
<br />
virtual void __stdcall DeleteScriptEnvironment() = 0;<br />
<br />
Provides a method to delete the ScriptEnvironment which is created with CreateScriptEnvironment.<br />
<br />
=== ApplyMessage, v5 ===<br />
<br />
virtual void _stdcall ApplyMessage(PVideoFrame* frame, const VideoInfo& vi, const char* message, int size, int textcolor, int halocolor, int bgcolor) = 0;<br />
<br />
ApplyMessage writes text on a frame. For example:<br />
<br />
char BUF[256];<br />
PVideoFrame src = child->GetFrame(n, env);<br />
env->MakeWritable(&src);<br />
sprintf(BUF, "Filter: Frame %d is processed.", n);<br />
env->ApplyMessage(&src, vi, BUF, vi.width/4, 0xf0f080, 0, 0);<br />
<br />
=== GetAVSLinkage , v5 ===<br />
<br />
virtual const AVS_Linkage* const __stdcall GetAVSLinkage() = 0;<br />
<br />
Returns the [[Filter_SDK/AVS_Linkage|AVSLinkage]].<br />
<br />
todo: how and when to use that ...<br />
<br />
== PVideoFrame ==<br />
<br />
PVideoFrame is a smart pointer to VideoFrame.<br />
<br />
In this example it gives a pointer to frame ‘n’ from child:<br />
<br />
PVideoFrame src = child->GetFrame(n, env);<br />
<br />
"child" is a protected member of GenericVideoFilter, of type PClip. It contains the clip that was passed to the constructor. For our filter to produce frame n we need the corresponding frame of the input. If you need a different frame from the input, all you have to do is pass a different frame number to child->GetFrame.<br />
<br />
In this example it gives a pointer to a new created VideoFrame from vi (which is a VideoInfo structure):<br />
<br />
PVideoFrame dst = env->NewVideoFrame(vi);<br />
<br />
"vi" is another protected member of GenericVideoFilter (the only other member, actually). It is a structure of type VideoInfo, which contains information about the clip (like frame size, frame rate, pixel format, audio sample rate, etc.). NewVideoFrame uses the information in this struct to return a frame buffer of the appropriate size.<br />
<br />
== IClip ==<br />
<br />
An Avisynth filter is simply a C++ class implementing the IClip interface. IClip has four pure virtual methods: GetVideoInfo, GetFrame, GetParity, and GetAudio. <br />
The class GenericVideoFilter is a simple do-nothing filter defined in avisynth.h. It derives from IClip and implements all four methods. Most filters can inherit from GenericVideoFilter rather than directly from IClip; this saves you from having to implement methods that you don't care about, like GetAudio. <br />
<br />
IClip has the following members: GetVersion, GetFrame, GetParity, GetAudio, SetCacheHints and GetVideoInfo. They are described in the following subsections.<br />
<br />
=== GetVersion ===<br />
<br />
virtual int __stdcall GetVersion() { return AVISYNTH_INTERFACE_VERSION; }<br />
<br />
GetVersion returns the interface version of the loaded avisynth.dll:<br />
<br />
AVISYNTH_INTERFACE_VERSION = 1 (v1.0-v2.0.8), 2 (v2.5.0-v2.5.5), 3 (v2.5.6-v2.5.8), or 6 (v2.6.0) [version 4 doesn’t exist, version 5 refers to the alpha versions of v2.6.0 so you won't need that one].<br />
<br />
=== GetFrame ===<br />
<br />
virtual PVideoFrame __stdcall GetFrame(int n, IScriptEnvironment* env) = 0;<br />
<br />
GetFrame returns a video frame. In this example, the even frames (0, 2, 4, ...) of ‘child’ are returned:<br />
<br />
PVideoFrame src = child->GetFrame(2*n, env);<br />
<br />
You should do all the GetFrame() calls BEFORE you get any pointers and start manipulating any data.<br />
<br />
=== GetParity ===<br />
<br />
virtual bool __stdcall GetParity(int n) = 0;<br />
<br />
GetParity returns the field parity if the clip is field-based, otherwise it returns the parity of first field of a frame. In other words, it distinguishes between top field first (TFF) and bottom field first (BFF). When it returns true, it means that this frame should be considered TFF, otherwise it should be considered BFF.<br />
<br />
=== GetAudio ===<br />
<br />
virtual void __stdcall GetAudio(void* buf, __int64 start, __int64 count, IScriptEnvironment* env) = 0;<br />
<br />
Audio processing is handled through the GetAudio method. You must fill in the buffer with count samples beginning at the sample start. A sample may vary from one to four bytes, depending on whether the audio is 8, 16, 24 or 32-bit (float is also 32-bit). The flag vi.SampleType() will tell you this. <br />
<br />
If you cannot do your audio processing in-place, you must allocate your own buffer for the source audio using new or malloc.<br />
<br />
In this example, the audio of frame ‘n’ is returned (in the buffer ‘samples’):<br />
<br />
VideoInfo vi = child->GetVideoInfo();<br />
PVideoFrame src = child->GetFrame(n, env);<br />
const __int64 start = vi.AudioSamplesFromFrames(n);<br />
const __int64 count = vi.AudioSamplesFromFrames(1);<br />
SFLOAT* samples = new SFLOAT[count*vi.AudioChannels()];<br />
child->GetAudio(samples, max(0,start), count, env);<br />
<br />
=== SetCacheHints ===<br />
<br />
void __stdcall SetCacheHints(int cachehints, int frame_range) = 0 ; // We do not pass cache requests upwards, only to the next filter.<br />
// int __stdcall SetCacheHints(int cachehints, int frame_range) = 0 ; // We do not pass cache requests upwards, only to the next filter.<br />
<br />
SetCacheHints should be used in filters that request multiple frames from any single PClip source per input GetFrame call. frame_range is maximal 21.<br />
<br />
The possible values of cachehints are:<br />
<br />
CACHE_NOTHING=0 // Filter requested no caching.<br />
CACHE_RANGE=1 // An explicit cache of "frame_range" frames around the current frame.<br />
CACHE_ALL=2 // This is default operation, a simple LRU cache.<br />
CACHE_AUDIO=3 // Audio caching.<br />
CACHE_AUDIO_NONE=4 // Filter requested no audio caching.<br />
CACHE_AUDIO_AUTO=5 // Audio caching (difference with CACHE_AUDIO?).<br />
<br />
When caching video frames (cachehints=0, 1, 2), frame_range is the radius around the current frame. When caching audio samples (cachehints=3, 4, 5), the value 0 creates a default buffer of 64kb and positive values allocate frame_range bytes for the cache.<br />
<br />
E.g. If you have a single PClip source, i.e. child and you get asked for frame 100 and you in turn then ask for frames 98, 99, 100, 101 and 102 then you need to call CACHE_RANGE with frame_range set to 3:<br />
<br />
child->SetCacheHints(CACHE_RANGE, 3);<br />
<br />
Frames outside the specified radius are candidate for normal LRU caching.<br />
<br />
// TODO - describe input and output for v5<br />
// http://forum.doom9.org/showthread.php?p=1595750#post1595750<br />
<br />
=== GetVideoInfo ===<br />
<br />
virtual const VideoInfo& __stdcall GetVideoInfo() = 0;<br />
<br />
GetVideoInfo returns a [[Filter_SDK/Cplusplus_API/VideoInfo|VideoInfo]] structure.<br />
<br />
== PClip ==<br />
<br />
PClip is a smart pointer to an IClip, and IClip is a generic abstract class.. It maintains a reference count on the IClip object and automagically deletes it when the last PClip referencing it goes away. For obvious reasons, you should always use PClip rather than IClip* to refer to clips. <br />
<br />
Like a genuine pointer, a PClip is only four bytes long, so you can pass it around by value. Also like a pointer, a PClip can be assigned a null value (0), which is often useful as a sentinel. Unlike a pointer, <br />
<br />
PClip is initialized to 0 by default. <br />
<br />
You'll need to make sure your class doesn't contain any circular PClip references, or any PClips sitting in dynamically allocated memory that you forget to delete. Other than that, you don't have to worry about the reference-counting machinery. <br />
<br />
AviSynth filters have a standardized output channel via IClip, but (unlike VirtualDub filters) no standardized input channel. Each filter is responsible for obtaining its own source material -- usually (as in this case) from another clip, but sometimes from several different clips, or from a file. <br />
<br />
The clip functionality must be provided by some concrete subclass of IClip which implements the functions GetFrame(), etc. So you cannot create a PClip without having an appropriate IClip subclass. For most filters, the GenericVideoFilter class provides the basis for this, but 'source' filters (which is basically what you have) do not have a parent clip and so GenericVideoFilter is not appropriate.<br />
<br />
== AVSValue ==<br />
<br />
Inside Avisynth, the value of a (script) variable is represented by an instance of the class AVSValue. Such objects have a one-character type field which denotes the script language type of the value:<br />
* 'a' for an array of AVSValues<br />
* 'b' for boolean<br />
* 'c' for clip<br />
* 'f' for float (IEEE single precision (32-bit) floating point)<br />
* 'i' for int (32-bit signed integer)<br />
* 's' for string<br />
* 'v' for void<br />
<br />
A variable of type AVSValue, if simply declared and not initialised, will have its type set to 'v' by the AVSValue constructor, meaning void (or 'undefined'), and not just left as random garbage.<br />
<br />
A numeric script variable is either an integer or an float. The latter will be the case if the value of the numeric variable contains a dot (so for example the variable x = '10.' will be parsed as float since its value contains a dot).<br />
<br />
You can test which type a variable is with the methods (return true or false):<br />
<br />
{| border="1"<br />
|- <br />
| '''Method'''<br />
| '''true condition'''<br />
| '''false condition'''<br />
|-<br />
| IsArray()<br />
| variable is an array<br />
| anything else<br />
|-<br />
| IsBool()<br />
| variable is true or false<br />
| anything else<br />
|-<br />
| IsClip()<br />
| variable is a clip<br />
| anything else<br />
|-<br />
| IsFloat()<br />
| variable is float or int<br />
| anything else<br />
|-<br />
| IsInt()<br />
| variable is int<br />
| anything else<br />
|-<br />
| IsString()<br />
| variable is float or string<br />
| anything else<br />
|-<br />
| Defined()<br />
| anything else<br />
| variable is "undefined"<br />
|}<br />
<br />
You can get the value of a variable with the methods:<br />
<br />
{| border="1"<br />
|- <br />
| '''Method'''<br />
| '''return type'''<br />
|-<br />
| AsBool(), AsBool(bool def)<br />
| bool<br />
|-<br />
| AsClip()<br />
| PClip<br />
|-<br />
| AsDblDef(double def)<br />
| double<br />
|-<br />
| AsFloat(), AsFloat(float def)<br />
| double<br />
|-<br />
| AsFloatf(), AsFloatf(float def)<br />
| float<br />
|-<br />
| AsInt(), AsInt(int def)<br />
| int<br />
|-<br />
| AsString(), AsString(const char* def)<br />
| const char*<br />
|}<br />
<br />
Boolean values are not treated as numeric (unlike C).<br />
<br />
Note that not all 32-bit integers can be represented as IEEE 32-bit floating point numbers. 16777216 and 16777217 have the same IEEE 32-bit floating point representation. Namely [0|10010111|00000000000000000000000]. See [[Float|IEEE-754]] for more information.<br />
<br />
For arrays, you can use the ArraySize() method to get the number of elements, and [] indexing to get the elements themselves.<br />
<br />
AVSValue holds an array of AVSValues in the following way:<br />
<br />
AVSValue(const AVSValue* a, int size) { type = 'a'; array = a; array_size = size; }<br />
<br />
'''Examples'''<br />
<br />
'''Arrays'''<br />
<br />
Using Invoke to apply a filter:<br />
<br />
AVSValue up_args[3] = {child, 384, 288}; <br />
PClip resized = env->Invoke("LanczosResize", AVSValue(up_args, 3)).AsClip();<br />
<br />
Note that<br />
<br />
AVSValue(up_args, 3)<br />
<br />
returns the following: {'a'; {child, 384, 288}; 3}.<br />
<br />
Also [[#Invoke|Invoke]] returns an AVSValue (see its declaration) which in that case is a PClip.<br />
<br />
You can get the number of elements of up_args and its elements in the following way:<br />
<br />
int num_args, width, height;<br />
PClip clip;<br />
if (up_args.IsArray()) {<br />
num_args = up_args.ArraySize();<br />
clip = up_args[1].AsClip();<br />
width = up_args[2].AsInt();<br />
height = up_args[3].AsInt();<br />
}<br />
<br />
'''Integers and floats'''<br />
<br />
Note that 123.0 can be accurately represented as an int, float or double. So for getting the exact value of x=123.0 you can use either AsInt(123), AsFloat(x), AsFloatf(x) or AsDblDef(x). All of them will return the same value with the same accuracy.<br />
<br />
As noted above, 16777217 can't be accurately represented as a float. So for getting the exact value of x=16777217.0 you need to use either AsInt(16777217) or AsDblDef(x). Both will return the same value with the same accuracy. Note that AsFloat() will return a double, but it is cast to a float first (losing accuracy).<br />
<br />
= Structures =<br />
<br />
The following structure is available: VideoInfo structure. It holds global information about a clip (i.e. information that does not depend on the framenumber). The GetVideoInfo method in IClip returns this structure. A description (for AVISYNTH_INTERFACE_VERSION=6) of it can be found [[Filter_SDK/Cplusplus_API/VideoInfo|here]].<br />
<br />
= Constants =<br />
<br />
The following constants are defined in avisynth.h:<br />
<br />
// Audio Sample information<br />
typedef float SFLOAT;<br />
<br />
enum { // sample types<br />
SAMPLE_INT8 = 1<<0,<br />
SAMPLE_INT16 = 1<<1,<br />
SAMPLE_INT24 = 1<<2,<br />
SAMPLE_INT32 = 1<<3,<br />
SAMPLE_FLOAT = 1<<4<br />
};<br />
<br />
enum { // plane types<br />
PLANAR_Y = 1<<0,<br />
PLANAR_U = 1<<1,<br />
PLANAR_V = 1<<2,<br />
PLANAR_ALIGNED = 1<<3,<br />
PLANAR_Y_ALIGNED = PLANAR_Y | PLANAR_ALIGNED,<br />
PLANAR_U_ALIGNED = PLANAR_U | PLANAR_ALIGNED,<br />
PLANAR_V_ALIGNED = PLANAR_V | PLANAR_ALIGNED,<br />
PLANAR_A = 1<<4, // v5<br />
PLANAR_R = 1<<5, // v5<br />
PLANAR_G = 1<<6, // v5<br />
PLANAR_B = 1<<7, // v5<br />
PLANAR_A_ALIGNED = PLANAR_A | PLANAR_ALIGNED, // v5<br />
PLANAR_R_ALIGNED = PLANAR_R | PLANAR_ALIGNED, // v5<br />
PLANAR_G_ALIGNED = PLANAR_G | PLANAR_ALIGNED, // v5<br />
PLANAR_B_ALIGNED = PLANAR_B | PLANAR_ALIGNED, // v5<br />
};<br />
<br />
enum { // cache types<br />
// Old 2.5 poorly defined cache hints (v3).<br />
// Reserve values used by 2.5 API<br />
// Do not use in new filters<br />
CACHE_25_NOTHING = 0, // Filter requested no caching.<br />
CACHE_25_RANGE = 1, // An explicit cache of "frame_range" frames around the current frame.<br />
CACHE_25_ALL = 2, // This is default operation, a simple LRU cache.<br />
CACHE_25_AUDIO = 3, // Audio caching.<br />
CACHE_25_AUDIO_NONE = 4, // Filter requested no audio caching.<br />
CACHE_25_AUDIO_AUTO = 5, // Audio caching (difference with CACHE_AUDIO?).<br />
<br />
// New 2.6 explicitly defined cache hints (v5).<br />
CACHE_NOTHING = 10, // Do not cache video.<br />
CACHE_WINDOW = 11, // Hard protect upto X frames within a range of X from the current frame N.<br />
CACHE_GENERIC = 12, // LRU cache upto X frames.<br />
CACHE_FORCE_GENERIC = 13, // LRU cache upto X frames, override any previous CACHE_WINDOW.<br />
<br />
CACHE_GET_POLICY = 30, // Get the current policy.<br />
CACHE_GET_WINDOW = 31, // Get the current window h_span.<br />
CACHE_GET_RANGE = 32, // Get the current generic frame range.<br />
<br />
CACHE_AUDIO = 50, // Explicitly do cache audio, X byte cache.<br />
CACHE_AUDIO_NOTHING = 51, // Explicitly do not cache audio.<br />
CACHE_AUDIO_NONE = 52, // Audio cache off (auto mode), X byte intial cache.<br />
CACHE_AUDIO_AUTO = 53, // Audio cache on (auto mode), X byte intial cache.<br />
<br />
CACHE_GET_AUDIO_POLICY = 70, // Get the current audio policy.<br />
CACHE_GET_AUDIO_SIZE = 71, // Get the current audio cache size.<br />
<br />
CACHE_PREFETCH_FRAME = 100, // Queue request to prefetch frame N.<br />
CACHE_PREFETCH_GO = 101, // Action video prefetches.<br />
<br />
CACHE_PREFETCH_AUDIO_BEGIN = 120, // Begin queue request transaction to prefetch audio (take critical section).<br />
CACHE_PREFETCH_AUDIO_STARTLO = 121, // Set low 32 bits of start.<br />
CACHE_PREFETCH_AUDIO_STARTHI = 122, // Set high 32 bits of start.<br />
CACHE_PREFETCH_AUDIO_COUNT = 123, // Set low 32 bits of length.<br />
CACHE_PREFETCH_AUDIO_COMMIT = 124, // Enqueue request transaction to prefetch audio (release critical section).<br />
CACHE_PREFETCH_AUDIO_GO = 125, // Action audio prefetches.<br />
<br />
CACHE_GETCHILD_CACHE_MODE = 200, // Cache ask Child for desired video cache mode.<br />
CACHE_GETCHILD_CACHE_SIZE = 201, // Cache ask Child for desired video cache size.<br />
CACHE_GETCHILD_AUDIO_MODE = 202, // Cache ask Child for desired audio cache mode.<br />
CACHE_GETCHILD_AUDIO_SIZE = 203, // Cache ask Child for desired audio cache size.<br />
<br />
CACHE_GETCHILD_COST = 220, // Cache ask Child for estimated processing cost.<br />
CACHE_COST_ZERO = 221, // Child response of zero cost (ptr arithmetic only).<br />
CACHE_COST_UNIT = 222, // Child response of unit cost (less than or equal 1 full frame blit).<br />
CACHE_COST_LOW = 223, // Child response of light cost. (Fast)<br />
CACHE_COST_MED = 224, // Child response of medium cost. (Real time)<br />
CACHE_COST_HI = 225, // Child response of heavy cost. (Slow)<br />
<br />
CACHE_GETCHILD_THREAD_MODE = 240, // Cache ask Child for thread safetyness.<br />
CACHE_THREAD_UNSAFE = 241, // Only 1 thread allowed for all instances. 2.5 filters default!<br />
CACHE_THREAD_CLASS = 242, // Only 1 thread allowed for each instance. 2.6 filters default!<br />
CACHE_THREAD_SAFE = 243, // Allow all threads in any instance.<br />
CACHE_THREAD_OWN = 244, // Safe but limit to 1 thread, internally threaded.<br />
<br />
CACHE_GETCHILD_ACCESS_COST = 260, // Cache ask Child for preferred access pattern.<br />
CACHE_ACCESS_RAND = 261, // Filter is access order agnostic.<br />
CACHE_ACCESS_SEQ0 = 262, // Filter prefers sequential access (low cost)<br />
CACHE_ACCESS_SEQ1 = 263, // Filter needs sequential access (high cost)<br />
};<br />
<br />
enum { // For GetCPUFlags. These are backwards-compatible with those in VirtualDub.<br />
/* oldest CPU to support extension */<br />
CPUF_FORCE = 0x01, // N/A<br />
CPUF_FPU = 0x02, // 386/486DX<br />
CPUF_MMX = 0x04, // P55C, K6, PII<br />
CPUF_INTEGER_SSE = 0x08, // PIII, Athlon<br />
CPUF_SSE = 0x10, // PIII, Athlon XP/MP<br />
CPUF_SSE2 = 0x20, // PIV, K8<br />
CPUF_3DNOW = 0x40, // K6-2<br />
CPUF_3DNOW_EXT = 0x80, // Athlon<br />
CPUF_X86_64 = 0xA0, // Hammer (note: equiv. to 3DNow + SSE2, which only Hammer will have anyway)<br />
CPUF_SSE3 = 0x100, // PIV+, K8 Venice<br />
<br />
// Additional CPU flags in 2.6 (v5-v6).<br />
CPUF_SSSE3 = 0x200, // Core 2<br />
CPUF_SSE4 = 0x400, // Penryn, Wolfdale, Yorkfield<br />
CPUF_SSE4_1 = 0x400,<br />
CPUF_SSE4_2 = 0x1000, // Nehalem (note this was 0x800 in v5)<br />
};<br />
<br />
[[Category:AviSynth_Development]]<br />
[[Category:FilterSDK]]</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:45:25Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:45:19Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
(count)<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:45:02Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:44:55Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
(try to make enough edits)<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:44:39Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:44:31Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
(not edited enough yet)<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:44:16Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:44:07Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
(and more test edits)<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:43:53Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:43:44Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
(another test edit)<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:43:28Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-03-02T17:43:07Z<p>Martin53: /* External Links */</p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
(Just a test edit)<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/FixChromaticAberrationFixChromaticAberration2017-02-24T20:58:11Z<p>Martin53: </p>
<hr />
<div>{{FilterCat4|External_filters|Scripts|Restoration_filters|Chroma correction}}<br />
{{Filter3<br />
|martin53 at doom9<br />
|04/09/2007<br />
|3=[[Media:FixChromaticAberration.avsi|FixChromaticAberration.avsi]]<br />
|4=Chroma Correction<br />
|5=<br />
|6=[http://forum.doom9.org/showthread.php?t=162286 Doom9 Thread]}}<br />
== Description ==<br />
A script to reduce [http://en.wikipedia.org/wiki/Chromatic_aberration chromatic aberration]. This function stretches the red, green and/or blue channel according to a given factor symmetrically around the center of the frame and crops it afterwards. Note that chromatic aberration also smears the image a bit, which is not compensated by this function.<br />
<br><br />
<br><br />
== Requirements ==<br />
* AviSynth 2.5.8 or [http://sourceforge.net/projects/avisynth2/ greater]<br />
* Supported color formats: [[RGB32]], [[RGB24]]<br />
<br><br />
== [[Script variables|Syntax and Parameters]] ==<br />
:{{Template:FuncDef|FixChromaticAberration (clip clip, val "red", val "green", val "blue", val "x", val "y")}}<br />
<br><br />
::{{Par2| |clip| }}<br />
:::Input clip.<br />
<br><br />
::{{Par2|red|val|1}}<br />
::{{Par2|green|val|1}}<br />
::{{Par2|blue|val|1}}<br />
:::{{Template:FuncDef3|red}}, {{Template:FuncDef3|green}} and {{Template:FuncDef3|blue}} are stretching (resizing) factors against the original clip size. Factors of e.g. <code>{{Template:FuncDef3|red}}=1.015</code>, <code>{{Template:FuncDef3|green}}=1.01</code> allow to compensate the colored edges near the corners of the image which appear from lenses with 'chromatic aberration'.<br />
<br><br />
::{{Par2|x|val| }}<br />
::{{Par2|y|val| }}<br />
:::{{Template:FuncDef3|x}} and {{Template:FuncDef3|y}} allow to set the center of the aberration circle. It defaults to the center of the image.<br />
<br><br />
== Examples ==<br />
FixChromaticAberration with default settings:<br />
[[AviSource]]("Blah.avi")<br />
FixChromaticAberration(red=1, green=1, blue=1)<br />
<br />
<br><br />
== Changelog ==<br />
Version Date(D/M/Y) Changes<br><br />
04/09/2007 - Initial release<br />
<br><br />
== External Links ==<br />
<br><br />
<br><br />
-----------------------------------------------<br />
'''Back to [[External_filters#Chroma_correction|External Filters]] &larr;'''</div>Martin53http://avisynth.nl/index.php/External_filtersExternal filters2017-02-16T20:38:20Z<p>Martin53: documented FFT2DFilter v2.2</p>
<hr />
<div>Rough classification of third-party filters for AviSynth - a perpetual work in progress.<br />
<br />
This page lists both scripts (see [[Import]]) and plugins (see [[Plugins]]).<br />
<br />
== Introduction ==<br />
<br />
==== Download sites ====<br />
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.<br />
<br />
*[http://web.archive.org/web/20130803185015/http://www.64k.it/andres/dettaglio.php?sez=avisynth Andres' Filter Collection] <br />
*[http://chaosking.de/repo/avsfilters/ AviSynth Filter DB by ChaosKing] | [http://web.archive.org/web/20140412062911/http://chaosking.de/avisynth-filter-db mirror]<br />
*[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]<br />
*[http://xhmikosr.1f0.de/_old/avisynth/plugins/ XhmikosR's Builds] <br />
*[http://www.avisynth.nl/users/warpenterprises/ Warp Enterprises' AviSynth Filter Collection]<br />
<br />
====64-bit filters====<br />
A comprehensive list of 64-bit filters is available in the [[AviSynth%2B#AviSynth.2B_x64_plugins|AviSynth+]] page.<br />
<br />
====Outdated AviSynth plugins====<br />
[[External plugins old|External plugins (old)]] - these older plugins are not recommended, page is there mainly for historical purposes.<br />
<br />
==== Using filters ====<br />
Most scripts will apply filters in the following order:<br />
<br />
# Create an AviSynth clip from a video file using a source filter.<br />
# Correct or remove any unwanted features in the video (e.g. dot crawl, field blending or telecine).<br />
# Denoise the video (optional).<br />
# Manipulate the video into the desired format (by e.g. changing the size and frame rate).<br />
<br />
<!--AviSynth filters have been classified under these four basic tasks, with a fifth category for filters that fall outside this scheme, and a sixth category for filters that process audio only.--><br />
<br />
== Source Filters ==<br />
<br />
{{FilterTable}}<br />
| [http://forum.doom9.org/showthread.php?t=135855 BassAudio]<br />
| [http://un4seen.com/bass.html 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.<br />
| N/A<br />
| [http://forum.doom9.org/showthread.php?t=135855 Plugin]<br />
| dimzon<br />
|-<br />
| [http://www.gyroshot.com/cmvsource.htm CMVSource]<br />
| Load [http://www.bay12games.com/dwarves/ Dwarf Fortress] CMV and CCMV movies.<br />
| [[RGB32]]<br />
| [http://forum.doom9.org/showthread.php?t=162850 Plugin]<br />
| {{Author/Robert Martens}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=122598 DGAVCDecode] <br />
| AVC/H.264 decoder plug-in. <br />
| [[YV12]]<br />
| [http://www.videohelp.com/tools/DGAVCDec Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| [[DGDecode]] <br />
| Decode MPEG1/MPEG2 streams from: DVD VOBs, captured transport streams, *.mpg/*.m2v/*.pva files, etc. Use this instead of MPEGDecoder/MPEG2Dec3.<br />
| [[RGB24]], [[YUY2]], [[YV12]], [[I420]] <br />
| [{{N2Moved}}/dgmpgdec/dgmpgdec.html Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=170107 DGMVCSource]<br />
|MVC source filter for AviSynth.<br />
| [[YV12]]<br />
|[http://rationalqm.us/dgmvcsource/dgmvcsource100b22.zip Plugin]<br />
|{{Author/Donald Graft}}<br />
|-<br />
| DVInfo<br />
| Grabs the timestamp and recording date info from a DV-AVI. See [http://forum.doom9.org/showthread.php?t=61688 discussion].<br />
| N/A<br />
| [http://www.avisynth.nl/users/warpenterprises/files/dvinfo_20100602.zip Plugin] [http://forum.doom9.org/showthread.php?p=1740824#post1740824 Update]<br />
| {{Author/WarpEnterprises}}<br />
|-<br />
| [http://web.archive.org/web/20071025023927/http://mvideo.ddpp.net/eng/dvtimestampex.htm DVTimeStampEx]<br />
| Shows DV timestamp information over a DV clip.<br />
| N/A<br />
| [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]<br />
| [http://web.archive.org/web/20071025023932/http://mvideo.ddpp.net/eng/index.htm basilik]<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=134275 DSS2]<br />
| 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.<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20130923230211/http://haali.su/mkv/ Plugin]<br />
| Haali<br />
|-<br />
| [http://forum.doom9.org/showpost.php?p=1699301&postcount=33 DSS2mod]<br />
| DirectShowSource2 mod, this version does not require Haali Media Splitter. <br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20160224130743/https://filetea.me/t1sFlzxrp9xSdaqTlf3qZ6nCQ/dl Plugin]<br />
| forclip<br />
|-<br />
| [[FFmpegSource]]<br />
| 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].<br />
| [[RGB]], [[YUY2]], [[YV12]], [[I420]]<br />
| [http://github.com/FFMS/ffms2/releases Plugin]<br />
| {{Author/Myrsloik}}, TheFluff, Plorkyeran, others<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=169651 FRIMSource]<br />
|FRIMSource is an AviSynth plugin for sequential reading of elementary or transport streams (MPEG2, H.264 AVC/MVC-3D, VC1).<br />
|[[YV12]]<br />
|[http://forum.doom9.org/showthread.php?t=169651 Plugin]<br />
|videofan3d<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=110021 HDVInfo] <br />
| Grabs the timestamp and recording date info out of a M2T-D2V file<br />
| N/A<br />
| [http://web.archive.org/web/20120419204535/http://strony.aster.pl/paviko/hdvinfo0.93.zip Plugin]<br />
| {{Author/paviko}}<br />
|-<br />
| [[ImageSequence]]<br />
| Load png, jpg, bmp, pcx, tga and gif image sequences using the [http://corona.sourceforge.net/ Corona Image I/O Library]. CoronaSequence/RawSequence.<br />
| [[RGB32]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/imagesequence_20101115.zip Plugin]<br />
| {{Author/WarpEnterprises}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=135928 Immaavs]<br />
| ImmaRead uses the ImageMagick libraries to read images. Many formats are supported including animations, multipage files, image sequences and images with different sizes.<br />
|<br />
| [http://www.wilbertdijkhof.com/ Plugin]<br />
| {{Author/Wilbert Dijkhof}}<br />
|-<br />
| IUF<br />
| 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].<br />
| [[RGB]]<br />
| [http://web.archive.org/web/20091016215740/http://geocities.com/hanfrunz/iuf_v1.5.zip Plugin] <br />
| hanfrunz<br />
|-<br />
| [[JpegSource]]<br />
| An advanced JPEG decoder for Avisynth 2.6. See [http://forum.doom9.org/showthread.php?t=170028 discussion].<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://dl.dropboxusercontent.com/s/rjnt0y3ead2c6ef/JpegSource_20140419.7z Plugin] <br />
| SEt<br />
|-<br />
| [[LSMASHSource]]<br />
| 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.]<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [[LSMASHSource|Plugin]]<br />
| {{Author/VFR-maniac}}<br />
|-<br />
| [[NicAudio]]<br />
| 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].<br />
| N/A<br />
| [http://nicaudio.codeplex.com/ Plugin]<br />
| {{Author/Nic}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=103931 OmfSource] <br />
| Opens the AVID OMF file format (video only, and only works with captured files). See [http://forum.doom9.org/showthread.php?t=103931 discussion].<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.tateu.net/software/ Plugin]<br />
| {{Author/tateu}}<br />
|-<br />
| [[QTSource]]<br />
| Quicktime Import/Export Filter using an existing installation of Quicktime 6/7. See [http://forum.doom9.org/showthread.php?t=104293 discussion].<br />
| [[RGB32]], [[RGB24]], [[YUY2]]<br />
| [http://www.tateu.net/software/ Plugin]<br />
| {{Author/tateu}}<br />
|-<br />
| [http://web.archive.org/web/20120124010957/http://arenafilm.hu/alsog/avisynthr3d/ R3DSource]<br />
| Redcode RAW source plugin to load R3D clips. See [http://reduser.net/forum/showthread.php?25398 discussion].<br />
| [[RGB32]]<br />
| [http://web.archive.org/web/20120124010957/http://arenafilm.hu/alsog/avisynthr3d/ Plugin]<br />
| {{Author/Kertai Gábor}}<br />
|-<br />
| [[RawSource26]]<br />
| Loads raw video data directly from files. Further modifications (most raw formats, YUV4MPEG2 compatible with latest spec) [http://forum.doom9.org/showthread.php?t=39798 discussion].<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [https://github.com/chikuzen/RawSource_2.6x/releases Plugin]<br />
| {{Author/Chikuzen}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?p=1403600 Sashimi]<br />
(function "RawReader")<br />
| 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].<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://sites.google.com/site/ourenthusiasmsasham/soft Plugin with scripts]<br />
| [http://sites.google.com/site/ourenthusiasmsasham/ PitifulInsect]<br />
|-<br />
| [[VapourSource]]<br />
| VapourSynth script reader for AviSynth2.6x. [http://forum.doom9.org/showthread.php?t=168339 Discussion].<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
| [http://github.com/chikuzen/VapourSource/releases Plugin]<br />
| {{Author/Chikuzen}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=170311 VideoInputSource]<br />
| Capture video frames from video capture card or webcam in real-time.<br />
|[[RGB24]]<br />
|[http://github.com/fieliapm/himawari_avs_plugin/raw/master/VideoInputSource/VideoInputSource.dll Plugin]<br />
|[http://github.com/fieliapm fieliapm]<br />
|-<br />
|[https://github.com/slavanap/ssifSource ssifSource]<br />
| 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.<br />
|[[YV12]]<br />
|[https://github.com/slavanap/ssifSource/releases plugin]<br />
|[http://github.com/slavanap slavanap]<br />
|}<br />
<br />
== Restoration Filters ==<br />
<br />
These remove effects or artifacts introduced (deliberately or accidentally) into the source video. Denoisers are classified separately.<br />
<br />
=== Anti-[[aliasing]] ===<br />
<br />
{{FilterTable}}<br />
| [[DAA]]<br />
| Anti-aliasing with contra-sharpening.<br />
| [[YV12]]<br />
| Script<br />
| {{Author/Didée}}<br />
|-<br />
| mcDAA3<br />
| 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]<br />
| [[YV12]]<br />
| [http://www.mediafire.com/?wqkob7zx1p119e0 Script]<br />
| AmjadSONY<br />
|-<br />
| [[MAA2]]<br />
| Updated version of the MAA antialising script.<br />
| [[Y8]], [[YV12]], [[YV24]]<br />
| [http://web.archive.org/web/20140624125132/https://raw.githubusercontent.com/AviSynth/avs-scripts/master/maa2.avsi Script]<br />
| line0<br />
|-<br />
| [[santiag]]<br />
| Simple anti-aliasing with independent horizontal and vertical anti-aliasing strength.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=1393006 Script]<br />
| {{Author/cretindesalpes}}<br />
|-<br />
| SharpAAMCmod<br />
| 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]<br />
| [[YV12]]<br />
| Script<br />
| thetoof<br />
|-<br />
| [[TIsophote]]<br />
| A level-set (isophote) smoothing filter.<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20070222162751/http://bengal.missouri.edu/~kes25c/TIsophotev091.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
|[[xaa]]<br />
|Versatile anti-aliasing script.<br />
|[[Y8]], [[YV12]], [[YV24]]<br />
|[http://www.mediafire.com/download/sygi04y47eknvc2/xaa_v1.1.1.avsi Script]<br />
|Desbreko<br />
|}<br />
<br />
=== Chroma correction ===<br />
<br />
{{FilterTable}}<br />
| [{{N2Archived}}/trbarry/Readme_BT709ToBT601.txt BT709ToBT601]<br />
| Convert from BT.709 (HDTV) to BT.601 (SDTV) colorimetry.<br />
| [[YV12]]<br />
| [{{N2Archived}}/trbarry/BT709ToBT601.zip Plugin]<br />
| {{Author/Tom Barry}}<br />
|-<br />
|[[caf]]<br />
|Chromatic Aberration Fixer.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/ChromaShiftSP.avsi Script]<br />
| Torchlight<br />
|-<br />
| [[ChromaShift]]<br />
| 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.]<br />
| [[YV12]], [[YUY2]], [[RGB32]]<br />
| [http://web.archive.org/web/20091026153334/http://www.geocities.com/siwalters_uk/chromashift27.zip Plugin]<br />
| {{Author/Simon Walters}}<br />
|-<br />
| [[ChromaShiftSP]]<br />
| This script can shift chroma in all directions with subpixel accuracy.<br />
| [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://avisynth.nl/images/ChromaShiftSP.avsi Script]<br />
| IanB, McCauley <br />
|-<br />
| ColorMatrix<br />
| 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. See [http://forum.doom9.org/showthread.php?t=82217 discussion].<br />
| [[YV12]], [[YUY2]]<br />
| [http://web.archive.org/web/20140420180927/http://bengal.missouri.edu/~kes25c/ColorMatrixv25.zip Plugin]<br />
| {{Author/Wilbert Dijkhof}}<br />
{{Author/tritical}} (v2.0+)<br />
|-<br />
| [[FixChromaBleeding]]<br />
| 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]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20091026141730/http://www.geocities.com/alex_j_jordan/chroma.txt Script]<br />
| {{Author/Alex Jordan}}<br />
|-<br />
| [[FixChromaBleedingMod]]<br />
| 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]<br />
| [[YV12]], [[YUY2]], [[YV411]]<br />
| [[FixChromaBleedingMod_source|Script]]<br />
| AmjadSONY<br />
|-<br />
| [[FixChromaticAberration]]<br />
| 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.]<br />
| [[RGB24]], [[RGB32]]<br />
| [http://avisynth.nl/index.php/FixChromaticAberration Script]<br />
| Martin Wagener<br />
|-<br />
| [[MoveChroma]]<br />
| Chroma shifting filter; can be used to independently shift the U/V channels left or right.<br />
| [[YUY2]], [[YV12]]<br />
| [http://sky.geocities.jp/apechironnup/MoveChroma.20090823.zip Plugin]<br />
| [http://sky.geocities.jp/apechironnup/ apechironnup]<br />
|-<br />
| [[ReInterpolate411]]<br />
| 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.<br />
| [[YUY2]]<br />
| [{{N2Archived}}/trbarry/ReInterpolate411.zip Plugin]<br />
| {{Author/Tom Barry}}<br />
|-<br />
| [http://www.avisynth.nl/users/fizick/reinterpolate420/reinterpolate420.html ReInterpolate420]<br />
| Usually, DV decoders upsample [[PAL]] DV (which is YV12) to YUY2 using point sampling. This plugin re-interpolates the original chroma samples.<br />
| [[YUY2]]<br />
| [http://www.avisynth.nl/users/fizick/reinterpolate420/reinterpolate420_v3.zip Plugin]<br />
| {{Author/Wilbert Dijkhof}}<br />
{{Author/Fizick}} (v3)<br />
|}<br />
<br />
=== Debanding ===<br />
<br />
{{FilterTable}}<br />
| AdaptDBMC<br />
| Luma / Fade / Blue adaptive debanding script. <br />
| [[YV12]]<br />
| [http://www.nmm-hd.org/newbbs/viewtopic.php?f=7&t=512 Script]<br />
| {{Author/06_taro}}<br />
|-<br />
| [[GradFun2db]]<br />
| A simple and fast debanding filter. See Wikipedia: [http://en.wikipedia.org/wiki/Color_banding Color Banding]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20140705233110/http://manao4.free.fr/gradfun2db-v1.0.zip Plugin]<br />
| Prunedtree<br />
|-<br />
| [[GradFun2DBmod]]<br />
| An advanced debanding script based on GradFun2DB.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=144537 Script]<br />
| {{Author/LaTo}}<br />
|-<br />
| GradFun3<br />
| This debanding script, part of the [[External_filters#Deepcolor_Filters|Dither]] package, has several gradient smoothing algorithms, including a bilateral filter. It uses an ordered dithering, which has a good resilience to lossy compression.<br />
| [[YV12]], [[YV16]], [[YV24]], [[Y8]], [[YV411]]<br />
| [http://forum.doom9.org/showpost.php?p=1386559&postcount=3 Script]<br />
| {{Author/cretindesalpes}}<br />
|-<br />
| [http://f3kdb.readthedocs.org/en/latest/ flash3kyuu_deband]<br />
| Fast debanding plugin ported from AviUtl.<br />
| [[YV12]], [[YUY2]], [[YV16]], [[YV24]], [[Y8]], [[YV411]]<br />
| [http://forum.doom9.org/showthread.php?t=161411 Plugin]<br />
| [http://github.com/SAPikachu/ SAPikachu]<br />
|-<br />
| LumaDB<br />
| 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.]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20131111114932/http://www.nmm-hd.org/upload/get~3YK_B5TfcyI/LumaDB-0.7.rar Script]<br />
| {{Author/06_taro}}<br />
|-<br />
| LumaDBL<br />
| 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.]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20131111114947/http://www.nmm-hd.org/upload/get~mQYIS9H6Qas/LumaDBL-0.7.rar Script]<br />
| {{Author/06_taro}}<br />
|}<br />
<br />
=== Deblocking ===<br />
<br />
{{FilterTable}}<br />
| BlockKiller<br />
| Deblocking filter, see [http://forum.doom9.org/showthread.php?p=1410479#post1410479 discussion].<br />
| [[YUY2]], [[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=1410479&postcount=19 Script]<br />
| Jawed<br />
|-<br />
| BlockTerminator<br />
| Deblocking filter, see [http://forum.doom9.org/showthread.php?p=831936#post831936 discussion.]<br />
| [[YUY2]], [[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=831936&postcount=24 Script]<br />
| foxyshadis<br />
|-<br />
| [[DeBlock]]<br />
| Deblocking filter, see [http://forum.doom9.org/showthread.php?t=110352 discussion,] and [http://github.com/tp7/Deblock updated version] for AviSynth 2.6. DGDecode uses [{{N2Moved}}/dgmpgdec/DGDecodeManual.html#DeBlock DeBlock.]<br />
| [[YUY2]], [[YV12]]<br />
| [http://avisynth.nl/index.php/DeBlock Plugin]<br />
| {{Author/Fizick}} / {{Author/Manao}}<br />
|-<br />
| [[Deblock_QED]]<br />
| "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]<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/Deblock_QED_MT2Mod.avsi Script]<br />
| {{Author/Didée}}<br />
|-<br />
|[[DeblockPP7]]<br />
| A port of the MPlayer PP7 deblocking filter. See [http://forum.doom9.org/showthread.php?t=172498 discussion].<br />
|[[YUY2]], [[YV12]]<br />
|[http://forum.doom9.org/attachment.php?attachmentid=14970&d=1440108276 Plugin]<br />
|John Doe<br />
|-<br />
| [[FunkyDeBlock]]<br />
| Deblocking script based on BlindPP and high/low pass separation. See [http://forum.doom9.org/showthread.php?t=72431 discussion].<br />
| [[YV12]]<br />
| Script<br />
| Mug Funky<br />
|-<br />
| [[MDeblock]]<br />
| Plugin for removing block artifacts, see [http://home.arcor.de/kassandro/MDeblock/MDeblock.htm homepage.]<br />
| [[YV12]]<br />
| [http://home.arcor.de/kassandro/MDeblock/MDeblock.zip Plugin]<br />
| {{Author/kassandro}}<br />
|-<br />
| [[SmoothD]]<br />
| Filter to deblock frames while keeping high frequency detail. See [http://forum.doom9.org/showthread.php?t=84355 discussion].<br />
| [[YV12]]<br />
| [http://www.funknmary.de/bergdichter/projekte/video/SmoothD Plugin]<br />
| Tobias Bergmann<br />
|-<br />
| [[SmoothD2]]<br />
| Deblocking filter. Rewrite of SmoothD. Faster, better detail preservation, optional chroma deblocking. See [http://forum.doom9.org/showthread.php?t=164800 discussion].<br />
| [[YV12]]<br />
| [http://sites.google.com/site/jconklin754smoothd2/download Plugin]<br />
| Jim Conklin<br />
|-<br />
| SmoothDeblock<br />
| 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].<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=1553458#post1553458 Script]<br>[[SmoothDeblock_source|(alt source)]]<br />
| redfordxx<br />
|-<br />
|[http://avisynth.org.ru/unblock/unblock.html Unblock]<br />
|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].<br />
|[[YV12]]<br />
|[http://avisynth.org.ru/unblock/unblock11.zip Plugin]<br />
|{{Author/Fizick}}<br />
|}<br />
<br />
=== Dehaloing ===<br />
<br />
{{FilterTable}}<br />
| [[abcxyz]]<br />
| Filter to remove halos. See [http://forum.doom9.org/showthread.php?t=144982 discussion].<br />
| [[YV12]]<br />
| [[Media:abcxyz_MT2.avsi|Script]]<br />
| {{Author/Didée}}<br />
|-<br />
| [[BlindDeHalo3]]<br />
| Filter to remove edge enhancement artifacts. See [http://forum.doom9.org/showthread.php?p=622289#post622289 discussion].<br />
| [[YV12]]<br />
| [http://forum.doom9.org/attachment.php?attachmentid=5599&d=1143030001 Script]<br />
| {{Author/Didée}}<br />
|-<br />
| [[DeHalo_alpha]]<br />
| Very powerful filter to remove edge enhancement artifacts. See [http://forum.doom9.org/showthread.php?p=777956#post777956 discussion].<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/Dehalo_alpha_mt.avsi Script]<br />
| {{Author/Didée}}<br />
|-<br />
|[[DeHaloHmod]]<br />
| Another halo reducer, it includes lots of options to tweak for best performance. See [http://forum.doom9.org/showthread.php?p=1675762#post1675762 discussion]<br />
|[[YV12]]<br />
| [[DeHaloHmod|Script]]<br />
|AmjadSONY<br />
|-<br />
|[[FineDehalo]]<br />
|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).<br />
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
|[http://avisynth.nl/images/FineDehalo.avsi Script]<br />
|{{Author/cretindesalpes}}<br />
|-<br />
| Mask_DHA<br />
| 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].<br />
| [[YV12]]<br />
| Script<br />
| 'Orum<br />
|-<br />
| [[VHSHaloremover]]<br />
| 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]<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
| [http://pastebin.com/s24mSgJ5 Script]<br />
| {{Author/cretindesalpes}}<br />
|-<br />
| [[YAHR]]<br />
| Basic filter with no variables to remove edge enhancement artifacts. See [http://forum.doom9.org/showthread.php?p=1205653#post1205653]<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/YAHR.avsi Script]<br />
| {{Author/Didée}}<br />
|-<br />
| YAHRmod<br />
| Basic filter used to reduce halos in modern DVD and other cases.<br />
| [[YV12]]<br />
| [[YAHRmod_source|Script]]<br />
| AmjadSONY<br />
|}<br />
<br />
=== Deringing & Mosquito Noise ===<br />
<br />
{{FilterTable}}<br />
| [[aWarpSharpDering]]<br />
| 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.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/AWarpSharpDering.avsi Script]<br />
| [http://leak.no-ip.org/AviSynth/ Leak]<br />
|-<br />
| [http://rationalqm.us/dgmpgdec/DGDecodeManual.html#BlindPP BlindPP]<br />
| Deblocking & deringing filter; part of [[DGDecode]]. <br>Mosquito noise removal: <code>BlindPP(quant=16, cpu2="ooooxx")</code><br />
| [[YV12]], [[YUY2]]<br />
| [{{N2Moved}}/dgmpgdec/dgmpgdec.html Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?p=636297#post636297 BlindDeRing]<br />
| Deringing filter.<br />
| [[YV12]]<br />
| [http://chaosking.de/wp-content/uploads/avsfilters/Restoration_Filters/Deringing/BlindDeRing___(2005).7z Plugin]<br />
| krieger2005<br />
|-<br />
| [[EdgeCleaner]]<br />
| A simple edge cleaning and weak dehaloing function. See [http://forum.doom9.org/showthread.php?t=164592 discussion.]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=1568521&postcount=13 Script]<br />
| [http://forum.doom9.org/member.php?u=80518 canuckerfan]<br />
|-<br />
| [[HQDering]]<br />
| 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.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=793930#post793930 Script]<br />
| {{Author/mf}}<br />
|-<br />
| [[HQDering mod]]<br />
| Applies deringing by using a smart smoother near edges (where ringing occurs) only.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20140711173345/http://www.nmm-hd.org/upload/get~08CusazVphU/HQDeringmod_v1.8.avsi Script]<br />
| [http://www.nmm-hd.org/newbbs/memberlist.php?mode=viewprofile&u=479&sid=ff62d0f6c22fcfdbe97b53c8351429bc mawen1250]<br />
|-<br />
| [[LazyDering]]<br />
| 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.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20131103155455/http://anime-addict.ani-x.com/files/avisynth/scripts/LazyDering_v0.1.avsi Script]<br />
| [http://leak.no-ip.org/AviSynth/ Leak], RazorbladeByte<br />
|-<br />
| [[MosquitoNR]]<br />
| A noise reduction filter designed for mosquito noise, which is often caused by lossy compression.<br />
| [[Y8]], [[YV411]], [[YV12]], [[YV16]], [[YV24]], [[YUY2]]<br />
| [http://web.archive.org/web/20131028144351/http://www.geocities.jp/w_bean17/files/mosquito_nr_avisynth.zip Plugin]<br />
| {{Author/b_inary}}<br />
|-<br />
|ungibbs<br />
|ungibbs, a gibbs artifact remover.<br />
|[[YV12]]<br />
|[http://forum.doom9.org/showthread.php?t=134502 Script]<br />
|*.mp4 guy<br />
|-<br />
|WarpDeRing<br />
|Uses aWarpSharp2's flattening to clean out ringing/smaller halos, then runs some masks to preserve the edges and avoid the thinning.<br />
|[[YV12]]<br />
|[[WarpDeRing_source|Script]]<br />
|mirkosp<br />
|-<br />
|WarpDeRing_faster<br />
|Same as WarpDeRing but may be a bit faster.<br />
|[[YV12]]<br />
|[[WarpDeRing_faster_source|Script]]<br />
|mirkosp<br />
|}<br />
<br />
=== Deinterlacing ===<br />
<br />
{{FilterTable}}<br />
| Area<br />
| A port of Gunnar Thalin's VirtualDub filter "Deinterlace - area based" to AviSynth.<br />
| [[RGB32]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/area_5F25_dll_20030217.zip Plugin]<br />
| {{Author/Donald Graft}} // {{Author/Gunnar Thalin}}<br />
|-<br />
| BlendBob<br />
| 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].<br />
| [[YV12]]<br />
| [http://leak.no-ip.org/AviSynth/BlendBob/ Plugin]<br />
| {{Author/Leak}}<br />
|-<br />
| DGBob<br />
| 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].<br />
| [[RGB]], [[YUY2]], [[YV12]]<br />
| [{{N2Moved}}/dgbob/dgbob.html Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| [[Decomb]]<br />
| 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.<br />
| [[YUY2]], [[YUY2]]<br />
| [{{N2Moved}}/decomb/decombnew.html Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| [[EEDI2]]<br />
| 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).<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20140420183147/http://bengal.missouri.edu/~kes25c/EEDI2v092.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[eedi3|EEDI3]]<br />
| 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.<br />
| [[RGB24]], [[YUY2]], [[YV12]]<br />
| [http://github.com/Elegant996/EEDI3/releases/download/0.9.2.1/EEDI3_v0_9_2_1.7z Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
|[[FieldHint]]<br />
|FieldHint combines arbitrary fields from the input clip, and optionally adds Telecide-compatible postprocessing hints.<br />
|[[YV12]]<br />
|[http://web.archive.org/web/20120223025813/http://ivtc.org/yatta%20support/fieldhint-0.12.rar Plugin]<br />
|{{Author/akupenguin}}<br />
|-<br />
| IBob<br />
| 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]. <br />
| [[YUY2]], [[YV12]]<br />
| [http://kevin.atkinson.dhs.org/ibob/ Plugin]<br />
| {{Author/Kevin Atkinson}}<br />
|-<br />
| KernelDeint<br />
| 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. <br />
| [[RGB]], [[YUY2]], [[YV12]]<br />
| [{{N2Moved}}/kerneldeint/kerneldeint.html Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| [[LeakKernelDeint]]<br />
| 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.<br />
| [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://leak.no-ip.org/AviSynth/LeakKernelDeint/LeakKernelDeint_1.5.4.zip Plugin]<br />
| {{Author/Leak}}<br />
|-<br />
| [[nnedi3]]<br />
| 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.<br />
| [[RGB24]], [[YUY2]], [[YV12]]<br />
| [http://github.com/jpsdr/NNEDI3/releases Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[nnedi3ocl]]<br />
| OpenCL rewrite of [[nnedi3]]. See [http://forum.doom9.org/showthread.php?t=169766 discussion].<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://dl.dropboxusercontent.com/s/bmemjsu7jqnlk65/nnedi3ocl_20131208.7z Plugin]<br />
| SEt<br />
|-<br />
| [[QTGMC]]<br />
| 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.<br />
| [[YUY2]], [[YV12]]<br />
| [http://avisynth.nl/index.php/QTGMC Script]<br />
| -Vit-<br />
|-<br />
| [[SangNom2]]<br />
| Reimplementation of the old [[SangNom]] plugin. See [http://forum.doom9.org/showthread.php?t=168315 discussion].<br />
| [[Y8]],[[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://github.com/tp7/SangNom2/releases Plugin]<br />
| {{Author/tp7}}<br />
|-<br />
| [http://www.guthspot.se/video/AVSPorts/SmoothDeinterlacer/ SmoothDeinterlace]<br />
| 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><br />
See also [[SmoothDeinterlaceFunctions]]<br />
| [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://www.guthspot.se/video/AVSPorts/SmoothDeinterlacer/AVSSmoothDeinterlacer.zip Plugin]<br />
| {{Author/Gunnar Thalin}}<br />
|-<br />
| [[TDeint]]<br />
| 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].<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20140420182314/http://bengal.missouri.edu/~kes25c/TDeintv11.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[TelecideHints]]<br />
| The filter process the stats file to get the usual progressive matches and identify VFR sections.<br />
| [[YUY2]], [[YV12]]<br />
| [http://mod16.org/fansub/Telecidehints11.rar Plugin]<br />
| {{Author/Myrsloik}}<br />
|-<br />
| [[TempGaussMC]]<br />
| 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<br />
| [[YV12]]<br />
| [http://avisynth.nl/index.php/TempGaussMC Script]<br />
| {{Author/Didée}}<br />
|-<br />
| [[Yadif]]<br />
| 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.<br />
| [[YUY2]], [[YV12]]<br />
| [http://avisynth.org.ru/yadif/yadif.html Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [[yadifmod]]<br />
| 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).<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20140420183914/http://bengal.missouri.edu/~kes25c/yadifmod_v1.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[yadifmod2]]<br />
| Yadif + yadifmod for avisynth2.6/avisynth+. See [http://forum.doom9.org/showthread.php?p=1761361 discussion].<br />
| [[YV24]], [[YV16]], [[YV12]], [[YV411]], [[Y8]]<br />
| [http://github.com/chikuzen/yadifmod2/releases Plugin]<br />
| {{Author/Chikuzen}}<br />
|}<br />
<br />
=== Duplicate Frame Detectors ===<br />
<br />
{{FilterTable}}<br />
| [[ApparentFPS]]<br />
| Shows underlying framerate where a clip has had many duplicates inserted, easier than counting unique frames.<br />
| (see [[ApparentFPS|docs]])<br />
| [http://forum.doom9.org/showthread.php?t=171339 Plugin]<br />
| StainlessS<br />
|-<br />
| Dup <br />
| 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. See [http://forum.doom9.org/showthread.php?t=41850 original] and [http://forum.doom9.org/showthread.php?t=153037 continued] discussion. <!--[http://forum.doom9.org/showthread.php?t=44500 another old link]--><br />
| [[YV12]], [[YUY2]]<br />
| [{{N2Moved}}/dup/dupnew.html Plugin] <br />
[http://forum.doom9.org/showpost.php?p=1747207&postcount=17 Update (v2.32a)]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=134930 Dupped]<br />
| Another frame duplication function, similar to Dup, but hopefully more accurate. See [http://forum.doom9.org/showthread.php?t=134930 discussion.]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20140420181919/http://www.randomdestination.com/members/corran/misc/dupped/dupped.avsi Script]<br />
| Corran<br />
|-<br />
| [http://akuvian.org/src/avisynth/dedup/dedup.txt DeDup] <br />
| Remove (drop) duplicate frames in the interest of compression quality and speed. Resulting clip will have a variable frame rate.<br />
| [[YV12]], [[YUY2]]<br />
| [http://akuvian.org/src/avisynth/dedup/ Plugin]<br />
| {{Author/akupenguin}}<br />
|-<br />
|[[ExactDedup]]<br />
| 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. See [http://tasvideos.org/forum/viewtopic.php?t=12065 discussion].<br />
| [[RGB24]] [[RGB32]], [[YV12]]<br />
| [http://www.mediafire.com/download/9x2ax1rb5un02d5/ExactDedup+Version+0.03.zip Plugin]<br />
|Steve Melenchuk, Arick Chan<br />
|-<br />
| [http://avisynth.org.ru/getdups/getdups.html GetDups] <br />
| Selecting unique duplicate frames from clip, it return frames which have copies only, by one from the series (group). Made for 8mm films.<br />
| [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://avisynth.nl/users/fizick/getdups/getdups096.zip Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=164372 MorphDups]<br />
| Replace duplicate frames by interpolations.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=164372 Script]<br />
| sven_x<br />
|}<br />
<br />
=== Fieldblending and Frameblending removal ===<br />
<br />
{{FilterTable}}<br />
| [[c_deblend]] <br />
| c_deblend is a simple blend replacing function like unblend or removeblend. Superseded by [[srestore]].<br />
| [[YV12]]<br />
| Script<br />
| MOmonster<br />
|-<br />
| [[Cdeint]]<br />
| Restores 24fps FILM out of a fieldblended FILM -> Telecine -> [[NTSC]] -> Blendconversion -> [[PAL]] - Video (alternative for Restore24).<br />
| [[YV12]]<br />
| Script<br />
| MOmonster<br />
|-<br />
| [[Deblend]]<br />
| See [http://forum.doom9.org/showthread.php?p=760375#post760375 discussion].<br />
|<br />
| Script<br />
| actionman133<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=157337 ExBlend]<br />
| 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. See [http://forum.doom9.org/showthread.php?t=157337 discussion]<br />
| [[YV12]], [[YUY2]]<br />
| [http://www.mediafire.com/download/0rxe3675sfr4w9l/ExBlend_25_dll_20100226.zip Plugin]<br />
| StainlessS<br />
|-<br />
| [[FixBlendIVTC]]<br />
| A blend replacing/frame restoring function for doubleblends caused by blend-deinterlacing of telecined sources. Superseded by [[srestore]].<br />
| [[YV12]]<br />
| Script<br />
| MOmonster<br />
|-<br />
| [[mrestore]]<br />
| Uses conditional frame evaluation to undo standard conversions with blends. Superseded by [[srestore]].<br />
| [[YV12]]<br />
| Script<br />
| MOmonster<br />
|-<br />
| [[RemoveBlend]]<br />
| This filter is used to remove blended fields/frames. See [http://forum.doom9.org/showthread.php?t=75772 discussion.]<br />
| [[YV12]]<br />
| [//web.archive.org/web/20061113201230/http://bossanovaguitar.com/video/removeblend-0.3.zip Plugin]<br />
| {{Author/violao}}<br />
|-<br />
| [[Restore24]]<br />
| 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].<br />
|[[YV12]]<br />
| Script<br />
| scharfis_brain<br />
|-<br />
| [[RestoreFPS]]<br />
| RestoreFPS reverses the kind of blending generated by [[ConvertFPS]], restoring original framerate. It will work perfectly well on any regular blend pattern.<br />
| [[YV12]]<br />
| [http://wilbertdijkhof.com/mg262/Restorefps_v10.zip Plugin]<br />
| {{Author/mg262}}<br />
|-<br />
| [[Srestore]]<br />
| Replacement function for mrestore, c_deblend, FixBlendIVTC and DupHq.<br />
| [[YV12]]<br />
| [[Srestore|script]]<br />
| MOmonster<br />
|-<br />
| Specials<br />
| 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].<br />
| [[YV12]]<br />
| [http://horman.net/specials.zip Plugin]<br />
| {{Author/David Horman}}<br />
|-<br />
| Unblend<br />
| 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].<br />
| [[YV12]]<br />
| [http://avisynth.nl/users/warpenterprises/files/unblend_5F25_dll_2003.zip Plugin]<br />
| Bach<br />
|}<br />
<br />
=== Film Damage correction ===<br />
<br />
{{FilterTable}}<br />
| [http://avisynth.org.ru/descratch/descratch.html DeScratch]<br />
| 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). <br />
| [[YV12]]<br />
| [http://avisynth.nl/users/fizick/descratch/descratch110.zip Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [http://avisynth.org.ru/despot/despot.html DeSpot]<br />
| 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).<br />
| [[YV12]]<br />
| [http://avisynth.nl/users/fizick/despot/despot3610.zip Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [[deVCR]]<br />
| deVCR eliminates (to a certain degree) the annoying horizontal lines that keep crawling around your VHS or Beta recorded video. See discussion [http://forum.videohelp.com/threads/323093-How-to-use-DeVCR-for-Avisynth here] and [http://www.digitalfaq.com/forum/video-restore/2607-tracking-lines-video.html here.]<br />
|<br />
| Script<br />
| Ricardo Garcia<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=144271 VideoFred's Film Restoring]<br />
| A suite of scripts for film restoring.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=144271 Script]<br />
| videoFred<br />
|-<br />
| [[RemoveDirt]]<br />
| RemoveDirt is a temporal cleaner for AviSynth 2.5x. It has now become an AVS script function, which involves RestoreMotionBlocks and various filters from the [[RemoveGrain]] package.<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/index.php/RemoveDirt Plugin]<br />
| {{Author/kassandro}}<br />
|}<br />
<br />
=== Frequency Interference removal ===<br />
<br />
{{FilterTable}}<br />
| [http://avisynth.org.ru/defreq/defreq.html DeFreq]<br />
| Defreq uses Fast Fourier Transform method for frequency selecting an removing. See [http://forum.doom9.org/showthread.php?t=82978 discussion].<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.org.ru/defreq/defreq07.zip Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [http://avisynth.nl/users/vcmohan/FanFilter/FanFilter.html FanFilter] <br />
| Regular vertical frequency interference is filtered in spatial domain.<br />
| [[YV12]], [[YUY2]], [[RGB32]], [[RGB24]]<br />
| [http://www.avisynth.nl/users/vcmohan/FanFilter/FanFilter.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|}<br />
<br />
=== IVTC & Decimation ===<br />
<br />
{{FilterTable}}<br />
| [[AnimeIVTC]]<br />
| What it does:<br />
* High quality adaptative field matching for hard telecine<br />
* Bob, remove the blends and decimate back to the desired framerate for DHT/field-blended<br />
* Creating a VFR clip for hybrid sources<br />
* 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<br />
* Very good combing removal and anti-aliasing functions<br />
See [http://forum.doom9.org/showthread.php?t=138305] and See [http://forum.doom9.org/showthread.php?p=1673928] for mod version.<br />
| [[YV12]]<br />
| Script<br />
| thetoof<br />
|-<br />
| BruteIVTC<br />
| Some information [http://web.archive.org/web/20141221181254/http://privatepaste.com/download/77d973422b here]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20091214015625/http://mf.creations.nl/avs/filters/BruteIVTC.dll Plugin]<br />
| {{Author/Marc FD}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=158230 DOCI]<br />
| 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.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=158230 Script]<br />
| jmac698<br />
|-<br />
| FDecimate<br />
| 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).<br />
| [[YUY2]], [[YV12]]<br />
| [{{N2Moved}}/fdecimate/fdecimate.html Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| GreedyHMA<br />
| GreedyHMA is an Avisynth filter that executes DScaler's Greedy/HM algorithm code to perform pulldown matching, filtering, and video deinterlace. It has pretty much been superseded by Donald Graft's [[DeComb]] package. However there may be occasions where it sometimes gives preferable results, especially with some bad [[PAL]] clips.<br />
| [[YUY2]]<br />
| [{{N2Archived}}/trbarry/GreedyHMA.zip Plugin]<br />
| {{Author/Tom Barry}}<br />
|-<br />
| [[IT]]<br />
| Inverse Telecine plugin.<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.dropbox.com/s/002p6yed7dzi8f3/IT_YV12_0103_width8K.zip?dl=1 Plugin]<br />
| {{Author/thejam79}} / {{Author/minamina}}<br />
|-<br />
| ivtc_txt60mc<br />
| Deinterlaces telecined footage with that has been overlayed scrolling text at 60i. More information [http://web.archive.org/web/20140420184542/http://doom10.org/index.php?topic=292.msg5499 here] (last post).<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=1466105&postcount=4 Script]<br />
| {{Author/cretindesalpes}} aka Firesledge<br />
|-<br />
|JIVTC<br />
|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.<br />
|[[YV12]]<br />
|[http://raw.githubusercontent.com/lovesyk/avisynth-scripts/master/JIVTC.avsi Script]<br />
|[http://github.com/lovesyk lovesyk]<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=168397 MDec2]<br />
|MDec2 is a 2 pass decimating filter, acting much like the MultiDecimate filter.<br />
|[[RGB32]], [[RGB24]], ][[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://www.mediafire.com/download/3ajn640ujxr8jnx/MDec2_25%2626_dll_v1.01_20150330.zip Plugin]<br />
|StainlessS<br />
|-<br />
| MultiDecimate<br />
| 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].<br />
| [[YUY2]]<br />
| [{{N2Moved}}/multidecimate/multidecimate.html Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| PFR<br />
| PFR (Progressive Frame Restorer) is an Avisynth filter that attempts to produce progressive frames from a mixed progressive/interlaced/IVTCed source.<br />
| [[YUY2]]<br />
| [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/pfravs.html Plugin]<br />
| {{Author/Simon Walters}}<br />
|-<br />
| [[ReMatch]]<br />
| ReMatch is a field matching plugin, specifically for anime.<br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/rematch_5F25_dll_20050306.zip Plugin]<br />
| Dan Donovan<br />
|-<br />
| RePal<br />
| [http://forum.doom9.org/showthread.php?t=48401 Discussion] / [http://forum.doom9.org/showthread.php?p=1092552#post1092552 repal_29.97Hz_mod]<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/repal_5F25_dll_20030523.zip Plugin] - [http://forum.doom9.org/attachment.php?attachmentid=8028&d=1201414683 Mod]<br />
| Bach<br />
|-<br />
| SmartDecimate<br />
| Smart Decimate removes telecine by combining telecine fields and decimating at the same time, which is different from the traditional approach of matching telecine frames and then removing duplicates. See [http://forum.doom9.org/showthread.php?s=&threadid=60031 discussion].<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.kevina.org/tel/ Plugin]<br />
| {{Author/Kevin Atkinson}}<br />
|-<br />
| [[Decomb]]<br />
| The Telecide and Decimate filters can be combined to implement IVTC.<br />
| [[YUY2]], [[YV12]]<br />
| [{{N2Moved}}/decomb/decombnew.html Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| [[TIVTC]]<br />
| 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. [http://forum.doom9.org/showthread.php?t=82264 Discussion]<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20140420181748/http://bengal.missouri.edu/~kes25c/TIVTCv105.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| TPRIVTC<br />
| 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]<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/tprivtc_5F25_dll_20040930.zip Plugin]<br />
| daxab, {{Author/Kurosu}}<br />
|-<br />
| UnComb<br />
| Filter for matching up even and odd fields of properly telecined [[NTSC]] or [[PAL]] film source video. See [http://forum.doom9.org/showthread.php?s=&threadid=52333 discussion].<br />
| [[YV12]]<br />
| [{{N2Archived}}/trbarry/UnComb.zip Plugin]<br />
| {{Author/Tom Barry}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=167875 WeaveMan]<br />
| 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].<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20131208232913/http://chidragon.thedessie.com/Doom9/WeaveMan-v0.2.zip Plugin]<br />
| ChiDragon<br />
|-<br />
| [[IvtcBlend]]<br />
| Waka demonstrated an IvtcBlend function that uses the information in the "extra" fields of a telecined source to help combat temporal noise.<br />
|<br />
| Script<br />
|<br />
|}<br />
<br />
=== Ghost Removal ===<br />
<br />
{{FilterTable}}<br />
| FixVHSOversharp<br />
| 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.] <br />
| | [[YUY2]]<br />
| [http://web.archive.org/web/20091026142456/http://www.geocities.com/mrtibsvideo/fixvhsoversharp.html Plugin]<br />
| [http://web.archive.org/web/20091027001215/http://geocities.com/mrtibsvideo/ MrTibs]<br />
|-<br />
| GhostBuster<br />
| Ghostbuster is an AviSynth filter for removing "ghosts" from a clip. A ghost in this context is a faint copy of the picture offset horizontally. It works by either subtracting or adding the image from itself at the specified offset. With some tweaking the result, while not perfect, can be very pleasing. See discussion [http://forum.doom9.org/showthread.php?t=35339 here] and [http://web.archive.org/web/20121215130729/http://www.videohelp.eu/forum/avisynth/14691-ghostbuster-filter-avisynth.html here.]<br />
| [[YUY2]]<br />
| [http://forum.doom9.org/attachment.php?attachmentid=12721&d=1330678606 Plugin]<br />
| [http://web.archive.org/web/20140420183804/http://www.videohelp.eu/forum/avisynth/14679-sansgrips-avisynth-filters.html SansGrip]<br />
|-<br />
| LGhost<br />
| Plugin intended for ghost removal but can also reduce edge (ringing) artifacts. See [http://forum.doom9.org/showthread.php?p=1176552#post1176552 discussion.]<br />
| [[YV12]], [[YUY2]]<br />
| [http://nullinfo.s21.xrea.com/data/LGhost0301.zip Plugin]<br />
| {{Author/minamina}}<br />
|}<br />
<br />
=== Logo Removal ===<br />
<br />
{{FilterTable}}<br />
| [[DeKafka]]<br />
| This fairly simple filter washes away those annoying bugs from broadcast clips.<br />
| Any<br />
| Script<br />
| poptone<br />
|-<br />
| DeLogo<br />
| 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. <br />
| [[RGB32]]<br />
| [{{N2Moved}}/delogo132/delogo.html Plugin] & [http://forum.doom9.org/showthread.php?t=119447 Script]<br />
| Karel Suhajda<br />
|-<br />
| [[InpaintFunc]]<br />
| Script for logo removal using inpainting. Can remove alpha blended or opaque logos with a basic postprocessing to hide artifacts.<br />
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]<br />
| [http://avisynth.nl/images/InpaintFunc.avs Script]<br />
| Reuf Toc<br />
|-<br />
| [[rm_logo]]<br />
| Combination of deblending and inpainting to remove logos with adjustable postprocessing to further hide artifacts. See [http://forum.doom9.org/showthread.php?t=134919]<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/Rm_logo.avs Script]<br />
| Spuds <br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=154559 s_ExLogo]<br />
|De-logo function with clipping (Dekafka mod).<br />
|[[YUY2]]<br />
|[http://www.mediafire.com/download/40cpnnctd0uutpv/s_ExLogo_1.1.zip Script]<br />
|{{Author/StainlessS}}<br />
|-<br />
| X-Logo<br />
| X-Logo AviSynth plugin and VirtualDub filter. Removes opaque logos. See [http://forum.doom9.org/showthread.php?t=56660 discussion] and [http://forum.videohelp.com/threads/273109-Remove-an-opaque-logo-using-Xlogo-in-Avisynth tutorial].<br />
| [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://www.marzocchi.net/Olafsen/Software/X-Logo?setview=en Plugin]<br />
| [http://web.archive.org/web/20041204210505/http://members.verizon.net/~vze3kkvm/filters.html Leuf]<br />
|}<br />
<br />
=== Luma Equalization ===<br />
<br />
{{FilterTable}}<br />
| [[Antiflicker]]<br />
| "A quick-and-dirty port of my VirtualDub filter (which sucks, by the way; it was one of my first filters)." <br />
See [http://forum.doom9.org/showthread.php?p=224573#post224573 discussion.]<br />
| [[YUY2]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/antiflicker_5F25_dll_20030304.zip Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| [http://avisynth.org.ru/deflicker/deflicker.html DeFlicker]<br />
| Can remove old film intensity flicker by temporal mean luma smoothing. Can also correct blinding of automatic gain control after flashes.<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.org.ru/deflicker/deflicker04.zip Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?p=1326599#post1326599 Dumb Deflicker]<br />
| 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]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=1326599#post1326599 Script]<br />
| {{Author/Didée}}<br />
|-<br />
| [http://avisynth.org.ru/equlines/equlines.html EquLines]<br />
| Equalizes total luminosity in pairs of even and odd lines. Useful for removing inter-line differences from telecined films.<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.org.ru/equlines/equlines03.zip Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [http://akuvian.org/src/avisynth/flicker/lmflicker.txt LMFlicker]<br />
| 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.<br />
| [[YV12]]<br />
| [http://akuvian.org/src/avisynth/flicker/ Plugin]<br />
| {{Author/akupenguin}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=159493 Local Deflicker]<br />
| Deflickers only part of a frame. See [http://forum.doom9.org/showthread.php?t=159493 discussion.]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=159493 Script]<br />
| prokhozhijj<br />
|-<br />
| [[ReduceFlicker]]<br />
| Reduces temporal oscillations in clips; should be applied before deinterlacing. Contains ReduceFlicker, ReduceFluctuations, and LockClense. See [http://videoprocessing.fr.yuku.com/topic/24/ReduceFlicker-05 discussion.] <br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/index.php/ReduceFlicker Plugin]<br />
| {{Author/kassandro}}<br />
|-<br />
| [http://www.zhitenev.com/avisynth/TimeLapseDF/ TimeLapseDF]<br />
| 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. See [http://timescapes.org/phpBB3/viewtopic.php?f=8&t=2410 discussion.] <br />
| [[YV12]], [[YUY2]]<br />
| [http://www.zhitenev.com/avisynth/TimeLapseDF/TimeLapseDF.dll 32-Bit Plugin]<br />
| {{Author/Denis Zhitenev}}<br />
|-<br />
| [[Vinverse]]<br />
| A simple but effective plugin to remove residual combing.<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://github.com/tp7/vinverse/releases Plugin]<br />
| {{Author/Didée}}, {{Author/tritical}}, {{Author/tp7}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=106898 wdeflicker]<br />
| Modifies luma of a source clip by refering to a temporally super-smoothed clip. Heights of source and reference clips must match. <br />
| [[YV12]], [[YUY2]]<br />
| [http://forum.doom9.org/attachment.php?attachmentid=5417&d=1139174468 Plugin]<br />
| Osmiridium<br />
|}<br />
<br />
=== [[:Category:Rainbow & Dot Crawl Removal|Rainbow & Dot Crawl Removal]] ===<br />
<br />
{{FilterTable}}<br />
| [[Bifrost]]<br />
| Bifrost uses temporal blending to remove or at least reduce the effect of rainbows.<br />
| [[YV12]]<br />
| [http://github.com/dubhater/vapoursynth-bifrost/releases/download/v2.0-avs/avisynth-bifrost-v2.0.7z Plugin]<br />
| {{Author/Myrsloik}}, dubhater<br />
|-<br />
| [[CC]]<br />
| Dot crawl and rainbow removal.<br />
| [[YV12]], [[YUY2]]<br />
| [http://www.chiyoclone.net/dl/cc_20040522.lzh Plugin]<br />
| {{Author/chiyo-clone}}<br />
|-<br />
| [[Checkmate]]<br />
| Spatial-temporal dot crawl removal. See [http://github.com/tp7/checkmate Checkmate for AviSynth 2.6].<br />
| [[YV12]]<br />
| [http://avisynth.nl/index.php/Checkmate Plugin]<br />
| {{Author/mf}} / prunedtree<br />
|-<br />
| [[ChubbyRain]]<br />
| Spatial-temporal rainbow reducing script.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/ChubbyRain.avsi Script]<br />
| Mug Funky<br />
|-<br />
| [[ChubbyRain2]]<br />
| Spatial-temporal rainbow reducing script based on [[ChubbyRain]].<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/ChubbyRain2.avsi Script]<br />
| Lothar<br />
|-<br />
| [[DeCrawl]]<br />
| Spatial and temporal dot crawl removal, particularly for animated material.<br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/decrawl_20060924.zip Plugin]<br />
| Dan Donovan<br />
|-<br />
| [[DeCross]]<br />
| Cross Color Reduction. Also known as rainbows.<br />
| [[YV12]], [[YUY2]]<br />
| [http://nullinfo.s21.xrea.com/data/DeCross0002.zip Plugin]<br />
| {{Author/minamina}}<br />
|-<br />
| [[DeDot]]<br />
| Removes dot crawl and may also be useful for rainbows.<br />
| [[YV12]], [[YUY2]]<br />
| [http://nullinfo.s21.xrea.com/data/DeDot_YV12_0002.zip Plugin]<br />
| {{Author/thejam79}} / {{Author/minamina}}<br />
|-<br />
| [[DeRainbow]]<br />
| A simple script to reduce rainbows. See [http://forum.doom9.org/showthread.php?p=398106#post398106 discussion.]<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/images/DeRainbow.avsi Script]<br />
| sh0dan<br />
|-<br />
| [[DFMDeRainbow]]<br />
| Creates mask to process only edges; rainbows are removed by hitting chroma planes with two passes of FluxSmooth (hence "Double-Flux-Mask").<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/DFMDeRainbow-20140223.avsi Script]<br />
| {{Author/Scintilla}}<br />
|-<br />
| [http://avisynth.org.ru/docs/english/externalfilters/guavacomb.htm GuavaComb]<br />
| Removes dot crawl, rainbows, and some kinds of shimmering. See [http://forum.doom9.org/showthread.php?t=37456 discussion]<br />
| [[YUY2]]<br />
| [http://avisynth.nl/users/warpenterprises/files/guavacomb_5F25_dll_20030801.zip Plugin]<br />
| {{Author/Lindsey Dubb}}<br />
|-<br />
| [[LUTDeCrawl]]<br />
| Purely spatial; only targets pixels for dot crawl removal if luma is fluctuating and (optionally) chroma is not.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20140421001939/http://www.aquilinestudios.org/scripts/LUTDeCrawl-20081003.avsi Script]<br />
| {{Author/Scintilla}}<br />
|-<br />
| [[LUTDeRainbow]]<br />
| Purely spatial; only targets pixels for derainbowing if chroma is fluctuating and (optionally) luma is not.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20140421001939/http://www.aquilinestudios.org/scripts/LUTDeRainbow-20081003.avsi Script]<br />
| {{Author/Scintilla}}<br />
|-<br />
| [[mfRainbow]]<br />
| Derainbows in areas of high Y, U and V frequencies, which fluctuate heavily.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/MfRainbow-v0.32.avsi Script]<br />
| {{Author/mf}}<br />
|-<br />
| [[Rainbow_Smooth]]<br />
| A small spatial derainbow function. It uses [[SmoothUV]] to smooth out chroma and edge masking to prevent color bleeding.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/Rainbow_smooth.avsi Script]<br />
| MOmonster<br />
|-<br />
| [[SmartSSIQ]]<br />
| 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.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/SmartSSIQ.avsi Script]<br />
| LB<br />
|-<br />
| [[SSIQ]]<br />
| Rainbow remover. A port of the VirtualDub plugin [http://www.doki.ca/filters/ Smart Smoother IQ.]<br />
| [[YV12]], [[YUY2]], [[RGB32]]<br />
| [http://avisynth.nl/users/warpenterprises/files/ssiq_20070304.zip Plugin]<br />
| {{Author/Myrsloik}}<br />
|-<br />
| [[TComb]]<br />
| A temporal comb filter (it reduces cross-luminance (rainbowing) and cross-chrominance (dot crawl) artifacts in static areas of the picture). See [http://github.com/Elegant996/TComb TComb for AviSynth 2.6.]<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/index.php/TComb Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[YARK]]<br />
| Yet Another Rainbow Killer. Based on mfRainbow v0.31, chubbyrain2, and various other scripts shown [http://forum.doom9.org/showthread.php?t=141165 here].<br />
| [[YV12]]<br />
| [[YARK|Script]]<br />
| jase99<br />
|-<br />
| [[ASTDR]]<br />
| 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].<br />
| [[YV12]]<br />
| [[ASTDR|Script]]<br />
| AmjadSONY<br />
|}<br />
<br />
=== Stabilization ===<br />
<br />
{{FilterTable}}<br />
| [[CelStabilize]]<br />
| Script which holds a fixed background steady. Doesn't work well with pans or fades.<br />
| [[YV12]]<br />
| [http://avisynth.nl/index.php/CelStabilize Script]<br />
| mg262<br />
|-<br />
| [[DePan]]<br />
| Tools for estimation and compensation of global motion (pan) .See [http://avisynth.org.ru/depan/depan.html]<br />
| [[YUY2]], [[YV12]]<br />
| [http://avisynth.org.ru/depan/depan.html Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
|DepanSafe<br />
|Another DePan stabilization script. <br />
|[[YV12]]<br />
|[[DepanSafe_source|Script]]<br />
|[http://pastebin.com/u/tophf tophf]<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=171051 Deshaker3D]<br />
| Experimental 3D image stabiliser (VDub [http://www.guthspot.se/video/deshaker.htm Deshaker] required).<br />
| [[RGB32]]<br />
| [http://forum.doom9.org/showthread.php?t=171051 Plugin]<br />
| {{Author/David Horman}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=172136 SpatialAlign]<br />
|Fix spatial alignment between two clips containing similar scenes.<br />
|Any?<br />
|[http://forum.doom9.org/showthread.php?t=172136 Script]<br />
|StainlessS<br />
|-<br />
| [[Stab]]<br />
| Simple but powerful script to remove small high frequency jitter that appears often on old/bad transfers. See [http://forum.doom9.org/showthread.php?p=1222830#post1222830]<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/Stab.avsi Script]<br />
| g-force<br />
|-<br />
|[http://forum.videohelp.com/threads/371336-Stabilization-Tools-Pack-v1-8 Stabilization Tools Pack]<br />
| A set of tools to work with common stabilization issues, mainly from telecine process.<br />
|[[YV12]]<br />
|[http://forum.videohelp.com/threads/371336-Stabilization-Tools-Pack-v1-8 Script]<br />
|Dogway<br />
|-<br />
| [http://web.archive.org/web/20151223052321/http://code.google.com/p/avisynthrestoration/wiki/TBC TBC]<br />
| 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)<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20151223052318/https://code.google.com/p/avisynthrestoration/downloads/list Script]<br />
| halifaxgeorge<br />
|}<br />
<br />
== Denoisers ==<br />
Strength/Quality of Denoisers<br />
<br />
<br />
(need subclassification)<br />
<br />
{{FilterTable}}<br />
| [[AdaptiveMedian]]<br />
| 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.<br />
| [[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://avisynth.nl/index.php/AdaptiveMedian Plugin]<br />
|{{Author/vcmohan}}<br />
|-<br />
| Atc<br />
| Alternate Temporal Cleaner; a fast temporal cleaner with some cool stuff.<br />
| [[YV12]]<br />
| [http://ziquash.chez-alice.fr/atc%20beta%201.zip Plugin]<br />
| {{Author/Marc FD}}<br />
|-<br />
| ColourizeSmooth<br />
| 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]<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/colourizesmooth_5F25_dll_20050429.zip Plugin]<br />
| insanedesio<br />
|-<br />
| [http://www.kevina.org/temporal_median/ ConditionalTemporalMedian]<br />
|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. <br />
| [[YV12]]<br />
| [http://www.kevina.org/temporal_median/CondTemporalMedian-0.93.zip Plugin]<br />
| {{Author/Kevin Atkinson}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=159148 Deathray]<br />
|OpenCL GPU accelerated spatial/temporal non-local means de-noising. See [http://raw.githubusercontent.com/JawedAshraf/Deathray/master/Deathray%20readme.txt readme] and GitHub source code [http://github.com/JawedAshraf/Deathray/ repository].<br />
|[[YV12]]<br />
|[http://github.com/JawedAshraf/Deathray/raw/master/Deathray.dll Plugin]<br />
|[http://github.com/JawedAshraf Jawed]<br />
|-<br />
| [[DeNoise]]<br />
| 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.<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://avisynth.nl/index.php/DeNoise Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| [http://web.archive.org/web/20071105084352/http://www.geocities.com/fredthompson6/Kiraru2002/Kiraru2002sROOM.htm#dnr2 DNR2]<br />
| Dynamic Noise Reduction 2 is based on the VirtualDub [http://www.shdon.com/vid/dnr DNR] filter by Steve Don and Avery Lee. <br />
| [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/dnr2_5F25_dll_20021225.zip Plugin]<br />
| {{Author/kiraru2002}}<br />
|-<br />
| [[DeSaltPepper]]<br />
| Remove white and black noise.<br />
| Any<br />
| [http://avisynth.nl/index.php/DeSaltPepper Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| ExtendedBilateral<br />
| 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. See [http://forum.doom9.org/showthread.php?t=96015 discussion.]<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/extendedbilateral_5F25_dll_20050622.zip Plugin]<br />
|insanedesio<br />
|-<br />
| [[FFTQuiver]]<br />
| Remove periodic noise. Useful for analog interference.<br />
| Any<br />
| [http://avisynth.nl/index.php/FFTQuiver Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| SmootherHiQ<br />
| 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].<br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/smoothhiq_5F25_dll_20030208.zip Plugin]<br />
| {{Author/Sh0dan}}<br />
|-<br />
| [[TNLMeans]]<br />
| TNLMeans is an implementation of the NL-means denoising algorithm. - [http://forum.doom9.org/showthread.php?t=111344 discussion] - [http://forum.doom9.org/showthread.php?t=168090 TNLMeans built with ICL10]<br />
*[http://forum.doom9.org/showthread.php?t=171817 TfNLMeans] - an AviSynth 2.6 fork of TNLMeans 1.0.3<br />
| [[YV12]], [[YUY2]]<br />
| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TNLMeansv103.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| KNLMeansCL<br />
| KNLMeans is an optimized OpenCL implementation of the Non-local means denoising algorithm. See [http://forum.doom9.org/showthread.php?t=171379 discussion.]. View on [http://github.com/Khanattila/KNLMeansCL/wiki/Filter-description GitHub].<br />
| [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://github.com/Khanattila/KNLMeansCL/releases Plugin]<br />
| [http://github.com/Khanattila Khanattila]<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=172966 xNLMeans]<br />
|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.<br />
|[[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://www.mediafire.com/download/4stpv24pvpfclzm/xNLMeans_0.03_20160324.zip Plugin] <!--[http://www.mediafire.com/download/bmldoqgmmboij8n/xNLMeans_0.01_151212.zip older version]--><br />
|martin53<br />
|}<br />
<br />
=== Spatial Denoisers ===<br />
<br />
{{FilterTable}}<br />
| [[_2DCleanYUY2]]<br />
| 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.]<br />
| [[YV12]], [[YUY2]]<br />
| [http://dl.dropboxusercontent.com/s/vh7a5xmdpyj3d8u/_2DCleanYUY2_v0_10_mod_for_smp_YV12.zip Plugin]<br />
| {{Author/kiraru2002}}, {{Author/xeon533}}<br />
|-<br />
| [[DctFilter]]<br />
| An experimental filter that operates on DCT coefficients. <br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/index.php/DctFilter Plugin]<br />
| {{Author/Tom Barry}}<br />
|-<br />
| [[DCTFun]]<br />
| A fast spatial denoiser that does a hard thresholding of a complete 4x4 ICT transform.<br />
| [[YV12]]<br />
| [http://avisynth.nl/index.php/DCTFun Plugin]<br />
| Prunedtree <br />
|-<br />
| eDeen<br />
| eDeen is a ultra powerfull spatial denoiser for very experienced encoders only.<br />
| [[YV12]]<br />
| [http://ziquash.chez-alice.fr/eDeen%20beta%201.zip Plugin]<br />
| {{Author/Marc FD}}<br />
|-<br />
| [[frfun3b]]<br />
| Fractal denoising. See [http://forum.doom9.org/showthread.php?t=110200 discussion] <br />
| [[YV12]]<br />
| [http://web.archive.org/web/20080905123941/http://soulhunter.chronocrossdev.com/data/frfun3b_rev3.zip Plugin]<br />
| prunedtree<br />
|-<br />
| [[frfun3d]]<br />
| Fractal denoising; frfun3d is a quality optimized frfun3b. See [http://forum.doom9.org/showthread.php?t=110200 discussion] <br />
| [[YV12]]<br />
| [http://dl.dropboxusercontent.com/s/xqxfy59pcv3ea1q/frfun3d_r1.zip Plugin]<br />
| prunedtree<br />
|-<br />
| [[frfun7]]<br />
| Fractal denoising. See [http://forum.doom9.org/showthread.php?t=110200 discussion]<br />
| [[YV12]]<br />
| [http://avisynth.nl/index.php/Frfun7 Plugin]<br />
| prunedtree<br />
|-<br />
|-<br />
| [http://web.archive.org/web/20101201051903/http://gpubilateral.sourceforge.net/ GPUBilateral]<br />
| In short, bilateral filter is a edge-preserving smooth filter. See [http://forum.doom9.org/showthread.php?t=136370 discussion.]<br />
| [[RGB32]]<br />
| [http://sourceforge.net/projects/gpubilateral/files/ Plugin]<br />
| Sompon Virojanadara <br />
|-<br />
|Kuwahara<br />
|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]<br />
|[[RGB24]], [[RGB32]]<br />
|[http://www.wilbertdijkhof.com/Kuwahara_v11.zip Plugin]<br />
|{{Author/Wilbert Dijkhof}}<br />
|-<br />
| [{{N2Moved}}/msmooth/msmooth.html Msmooth]<br />
| Masked smoother, designed specifically for anime.<br />
| [[YV12]], [[RGB32]]<br />
| [{{N2Moved}}/msmooth/msmooth202.zip Plugin]<br />
| {{Author/Donald Graft}}<br />
|-<br />
| [[SmoothUV]]<br />
| A spatial denoising plugin based on [{{N2Moved}}/smooth.html Smart Smoother] and [{{N2Moved}}/hiq/smoothhiq.html Smart Smooth HiQ].<br />
| [[YV12]]<br />
| [http://avisynth.nl/users/warpenterprises/files/smoothuv_5F25_dll_20030902.zip Plugin]<br />
| {{Author/Kurosu}}<br />
|-<br />
|[[SPresso]]<br />
|A fast script to make SD content compress better while keeping the "original look".<br />
|[[YV12]]<br />
|[http://forum.doom9.org/showpost.php?p=867316&postcount=23 Script]<br />
|{{Author/Didée}}<br />
|-<br />
| [[TBilateral]] <br />
| TBilateral is a spatial smoothing filter that uses the bilateral filtering algorithm. It does a nice job of smoothing while retaining picture structure.<br />
| [[YV12]], [[YUY2]]<br />
| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TBilateralv0911.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[UnDot]]<br />
| 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].<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20130207143129/http://neuron2.net/trbarry/UnDot.zip Plugin]<br />
| {{Author/Tom Barry}}<br />
|-<br />
| [http://avisynth.org.ru/vague/vaguedenoiser.html VagueDenoiser]<br />
| 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. See [http://forum.doom9.org/showthread.php?s=&threadid=56871 discussion.]<br />
| [[YV12]], [[YUY2]], [[RGB32]]<br />
| [http://avisynth.nl/users/warpenterprises/files/vaguedenoiser_5F25_dll_20050926.zip Plugin]<br />
| {{Author/Lefungus}}, {{Author/Kurosu}}, {{Author/Fizick}}<br />
|-<br />
| [[VerticalCleaner]]<br />
| Fast vertical cleaner. Parameter information [http://videoprocessing.fr.yuku.com/sreply/651/Can-use-quantile-like-vertical-median-filter here.] Explanation of mode 2 [http://videoprocessing.fr.yuku.com/sreply/649/Can-use-quantile-like-vertical-median-filter here.]<br />
| [[YV12]], [[YUY2]]<br />
| [http://home.arcor.de/kassandro/prerelease/VerticalCleaner.rar Plugin]<br />
| {{Author/kassandro}}<br />
|}<br />
<br />
=== Temporal Denoisers ===<br />
<br />
{{FilterTable}}<br />
| [[Cnr2]]<br />
| A fast chroma denoiser. Very effective against stationary rainbows and huge analogic chroma activity. Useful to filter VHS/TV caps. See [http://forum.doom9.org/showthread.php?t=78905 discussion.]<br />
| [[YV12]], [[YUY2]]<br />
| [http://web.archive.org/web/20140420181313/http://bengal.missouri.edu/~kes25c/cnr2_v261.zip Plugin]<br />
| {{Author/Marc FD}}, {{Author/tritical}}<br />
|-<br />
| [[FluxSmooth]]<br />
| Examines each pixel and compares it to the corresponding pixel in the previous and last frame.<br />
| [[YV12]], [[YUY2]]<br />
| [http://web.archive.org/web/20070225212908/http://bengal.missouri.edu/~kes25c/FluxSmooth-1.1b.zip Plugin]<br />
| {{Author/SansGrip}}, {{Author/Sh0dan}}<br />
|-<br />
| [http://avisynth.org.ru/docs/english/externalfilters/grapesmoother.htm GrapeSmoother]<br />
| This filter averages out visual noise between frames.<br />
| [[YUY2]]<br />
| [http://avisynth.nl/users/warpenterprises/files/grapesmoother_5F25_dll_20030801.zip Plugin]<br />
| {{Author/Lindsey Dubb}}<br />
|-<br />
| MVDegrain<br />
| Strong and effective temporal denoiser. Part of the [[MVTools]] package.<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/index.php/MVTools Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [http://avisynth.nl/users/fizick/docs/english/externalfilters/temporalcleaner.htm TemporalCleaner]<br />
| 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.]<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/users/warpenterprises/files/temporalcleaner_5F25_dll.zip Plugin]<br />
| vlad59<br />
|-<br />
| [[TTempSmooth]] <br />
| TTempSmooth is a motion adaptive (it only works on stationary parts of the picture), temporal smoothing filter.<br />
| [[YV12]], [[YUY2]]<br />
| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TTempSmoothv094.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[Temporal Degrain]]<br />
| SLOW but very effective at removing most grain from video sources.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/TemporalDegrain.avs Script]<br />
| Didée, Sagekilla <br />
|}<br />
<br />
=== Spatio-Temporal Denoisers ===<br />
<br />
{{FilterTable}}<br />
| [http://web.archive.org/web/20130118045049/http://hellninjacommando.com/con3d/beta/index.html Convolution3D]<br />
| Convolution3D is a spatio-temporal smoother, it applies a 3D convolution filter to all pixels of consecutive frames. See [http://forum.doom9.org/showthread.php?s=&threadid=38281 discussion], [http://forum.doom9.org/showthread.php?s=&threadid=49806 continued].<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20130118045049/http://hellninjacommando.com/con3d/beta/con3d-yv12-beta5.zip Plugin]<br />
| {{Author/Vlad59}}<br />
|-<br />
| [[Deen]]<br />
| Deen is a set of assembly-optimised denoisers, like various 3d and 2d convolutions.<br />
| [[YV12]]<br />
| [http://avisynth.nl/index.php/Deen Plugin]<br />
| {{Author/Marc FD}}<br />
|-<br />
| DenoiseMF<br />
| 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].<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=162603 Script]<br />
| rean<br />
|-<br />
| [[dfttest]]<br />
| A 2D/3D frequency domain denoiser. See [http://forum.doom9.org/showthread.php?t=132194 discussion.]<br />
| [[YUY2]], [[YV12]], [[YV16]], [[YV24]]<br />
| [http://ldesoras.free.fr/src/avs/dfttest-1.9.4.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| dfttestMC<br />
| A script that motion compensates dfttest. See [http://forum.doom9.org/showthread.php?t=147676 discussion.]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=147676 Script]<br />
| thewebchat<br />
|-<br />
| [[DeGrainMedian]]<br />
| Two stage Spatio-Temporal Limited Median filter for grain removal. [http://forum.doom9.org/showthread.php?t=80834 See]<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.org.ru/degrain/degrainmedian082.zip Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [http://avisynth.org.ru/fft3dfilter/fft3dfilter.html FFT3DFilter]<br />
| A 3D Frequency Domain filter - gives strong denoising and moderate sharpening. See [http://forum.doom9.org/showthread.php?t=85790 discussion].<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]], [[YUY2]]<br />
| [http://forum.doom9.org/showthread.php?p=1797567 Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| FFT3DGPU <br />
| Similar algorithm to FFT3DFilter, but uses graphics hardware for increased speed. See [http://forum.doom9.org/showthread.php?t=89941 discussion.]<br />
| [[YUY2]], [[YV12]]<br />
| [http://avisynth.nl/users/tsp/fft3dgpu0.8.2.7z Plugin]<br />
| {{Author/tsp}}<br />
|-<br />
| [[hqdn3d]] <br />
| 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. <br />
| [[YV12]]<br />
| [http://akuvian.org/src/avisynth/hqdn3d/hqdn3d-0.11.zip Plugin]<br />
| {{Author/akupenguin}}<br />
|-<br />
| [[MC_Spuds]]<br />
| Motion compensated noise removal with sharpening. Extremely slow, but extremely effective.<br />
| [[YV12]]<br />
| Script<br />
| Spuds, {{Author/Didée}}<br />
|-<br />
| [[MCTemporalDenoise]]<br />
| 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)<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=139766 Script]<br />
| {{Author/LaTo}}<br />
|-<br />
| [http://avisynth.org.ru/docs/english/externalfilters/mipsmooth.htm MipSmooth]<br />
| 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.]<br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/mipsmooth_5F25_dll_20051223.zip Plugin]<br />
| {{author/Sh0dan}}<br />
|-<br />
| [http://avisynth.org.ru/docs/english/externalfilters/nomosmooth.htm NoMoSmooth]<br />
| 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.]<br />
| [[YUY2]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/nomosmooth_5F25_dll_200309015.zip Plugin]<br />
| SansGrip<br />
|-<br />
| [http://avisynth.org.ru/docs/english/externalfilters/peachsmoother.htm PeachSmoother]<br />
| PeachSmoother was designed to cope with the oddities of analog broadcast TV.<br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/peachsmoother_5F25_dll_20030801.zip Plugin]<br />
| {{Author/Lindsey Dubb}}<br />
|-<br />
| RemoveDirtMC<br />
| See [http://forum.doom9.org/showthread.php?p=1485300#post1485300 discussion].<br />
| [[YV12]]<br />
| [http://pastebin.com/PgkQc9X4 Script]<br />
| Nephilis/A.SONY<br />
|-<br />
| [[RemoveGrain]]<br />
| RemoveGrain is a plugin package containing various plugins for spatial and temporal denoising, repairing, sharpening, deinterlacing, and other utility functions.<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/index.php/RemoveGrain Plugin]<br />
| {{Author/kassandro}}<br />
|-<br />
| [[RemoveGrainHD]]<br />
| 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.]<br />
| [[YV12]], [[YUY2]]<br />
| [http://chaosking.de/wp-content/uploads/avsfilters/Denoisers/Spatial_Denoisers/RemoveGrainHD___(0.5_-_2011-08-11).7z Plugin]<br />
| {{Author/kassandro}}<br />
|-<br />
|-<br />
| RemoveNoiseMC<br />
| 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.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=110078 Script]<br />
| Heini011<br />
|-<br />
| [[RgTools]]<br />
| 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. <br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://github.com/pinterf/RgTools/releases Plugin]<br />
| {{Author/tp7}}, {{Author/pinterf}}<br />
|-<br />
|[[SMDegrain]]<br />
|SMDegrain is a convenience function for using MDegrain, including 16bit and interlaced support, with extra capabilities for light sharpening and spatial filtering.<br />
| [[YUY2]], [[YV12]]<br />
|[http://forum.videohelp.com/threads/369142-Simple-MDegrain-Mod-v3-0d-A-Quality-Denoising-Solution Script]<br />
|{{Author/Dogway}}<br />
|-<br />
|[[STMedianFilter]]<br />
|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. <br />
|[[YUY2]], [[YV12]]<br />
|[http://web.archive.org/web/20130207143129/http://neuron2.net/trbarry/STMedianFilter.zip Plugin]<br />
|{{Author/Tom Barry}}, {{Author/Fizick}}<br />
|-<br />
|[[STPresso]]<br />
|A fast script to make SD/720p content compress better without losing detail and original grain structure. See [http://forum.doom9.org/showthread.php?p=1551871#post1551871 discussion.]<br />
|[[YV12]]<br />
|[http://forum.doom9.org/showpost.php?p=1551871&postcount=2 Script]<br />
|{{Author/Didée}}<br />
|-<br />
| zzz_denoise<br />
| Simple wrapper around a combination of dfttest and MDegrain3. Requires the [[External_filters#Deepcolor_Filters|Dither]] package.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=1390594#post1390594 Script]<br />
| {{Author/cretindesalpes}} <br />
|}<br />
<br />
== Adjustment Filters ==<br />
<br />
=== Averaging/Layering/Masking ===<br />
<br />
{{FilterTable}}<br />
| [[Average]]<br />
| A simple plugin that calculates weighted frame-by-frame average from multiple clips. <br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://avisynth.nl/index.php/Average Plugin]<br />
| {{Author/tp7}}, {{Author/mg262}}<br />
|-<br />
|[http://sourceforge.net/projects/avisynthgmplyr/files/ AviSynthGimpLayer]<br />
|AviSynth Gimp-style Layer merge plugin.<br />
|[[RGB24]], [[RGB32]]<br />
|[http://sourceforge.net/projects/avisynthgmplyr/files/ Plugin]<br />
| [http://sourceforge.net/u/panzerboy66/profile/ panzerboy66]<br />
|-<br />
| BlockAverage<br />
| 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 satifies the requirements in [http://forum.doom9.org/showthread.php?s=&threadid=91580&perpage=10&pagenumber=1 this thread].<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/blockaverage01.zip Plugin]<br />
| {{Author/Simon Walters}}<br />
|-<br />
|CheckMask<br />
|A YV12 spatial dot finding filter for AviSynth.<br />
|[[YV12]]<br />
|[http://www.avisynth.nl/users/warpenterprises/files/checkmask_5F25_dll_20050310.zip Plugin]<br />
|[http://web.archive.org/web/20090618112048/http://kawaii-shoujo.net/AntiAliased/index.html Dan Donovan]<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=159274 ColorScreenMask]<br />
|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. <br />
|[[RGB32]]<br />
|[http://forum.doom9.org/attachment.php?attachmentid=15699&d=1483786544 Plugin]<br />
|Grandpa Oddball<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=99890 ColourMask]<br />
|Creates colour masks.<br />
|[[YV12]]<br />
|[http://www.avisynth.nl/users/warpenterprises/files/colourmask_20050911.zip Plugin]<br />
|{{Author/mg262}}<br />
|-<br />
|[http://github.com/chikuzen/CombMask/tree/master/avisynth CombMask]<br />
|A filter to create and process comb masks. These filters were written from scratch, but most of logic comes from tritical's [[TIVTC]] plugin.<br />
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://github.com/chikuzen/CombMask/releases Plugin]<br />
|{{Author/Chikuzen}}<br />
|-<br />
|[[Fusion]]<br />
|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).<br />
|[[RGB32]]<br />
|[http://horman.net/fusion.zip Plugin]<br />
|{{Author/David Horman}}<br />
|-<br />
| [[GraMaMa]]<br />
| Gradient Mask Maker: Creates a mask (either a gradient or black/white) given a prescribed shape (such as circle, ellipse, line, square or rectangle).<br />
| [[YV12]]<br />
| [http://www.wilbertdijkhof.com/GraMaMa_v02.zip Plugin]<br />
| {{author/E-Male}}, <br />
{{author/Wilbert Dijkhof}}<br />
|-<br />
|[http://umezawa.dyndns.info/archive/imck/imck-2.3.0-readme.html ImasMultiColorKeying]<br />
|Chroma keying filter (Japanese)<br />
|[[RGB32]]<br />
|[http://umezawa.dyndns.info/archive/imck/ Plugin]<br />
|Umezawa Takeshi<br />
|-<br />
|MaskCrop<br />
|Non-clip plugin and function to speed up filtering with a mask.<br />
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://www.dropbox.com/s/xcrlno31jqavqob/MaskCrop.7z?dl=1 Plugin]<br />
|<br />
|-<br />
|[http://forum.videohelp.com/threads/369143-ResizersPack-MasksPack-PlaygroundPack-SmoothContrast-Logo-mod-functions?s=7811fcf9c429ffb99f2e0a4b8043832d&p=2364052&viewfull=1#post2364052 MasksPack]<br />
|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.<br />
|[[YV12]]<br />
|[http://www.mediafire.com/download/mch99c0z5957u9z/MasksPack2.3.zip Script]<br />
|Dogway<br />
|-<br />
|[[Median]]<br />
|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. [http://forum.videohelp.com/threads/362361-Median%28%29-plugin-for-AviSynth VideoHelp discussion]<br />
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]<br />
|[http://forum.doom9.org/showthread.php?t=170216 Plugin]<br />
|{{Author/ajk}}<br />
|-<br />
| ParameterisedBlend<br />
| 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().<br />
| [[YV12]]<br />
| [http://sites.google.com/site/ourenthusiasmsasham/soft#TOC-ParameterisedBlend Plugin]<br />
| [http://sites.google.com/site/ourenthusiasmsasham/ PitifulInsect]<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=172388 Polygon]<br />
|The very raw beginning of a plugin for drawing high quality polygons (mainly to be used as masks) in AviSynth.<br />
| [[RGB32]]<br />
| [http://forum.doom9.org/showthread.php?t=172388 Plugin]<br />
| {{Author/David Horman}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=163018 RedAverage]<br />
|Frame-by-frame merging of multiple clips. Includes a masked average, weighted average, and a merge filter. <br />
|[[YV12]]<br />
|[http://chaosking.de/repo/avsfilters/Unclassified/RedAverage___%281.4.3_-_2011-12-02%29.7z Plugin]<br />
|redfordxx<br />
|-<br />
|[http://github.com/jojje/shapemask ShapeMask]<br />
|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.]<br />
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]<br />
|[http://web.archive.org/web/20150702103042/http://snarl.zapto.org/files/ShapeMask-1.0.zip Plugin]<br />
|[http://github.com/jojje jojje]<br />
|-<br />
|[http://github.com/tp7/tcolormask TColorMask]<br />
|A simple color masking plugin for AviSynth. See [http://forum.doom9.org/showthread.php?t=169832 discussion]<br />
| [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://github.com/tp7/tcolormask/releases Plugin]<br />
|{{Author/tp7}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=76595 TCombMask]<br />
|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.<br />
|[[YUY2]], [[YV12]]<br />
|[http://web.archive.org/web/20070222162504/http://bengal.missouri.edu/~kes25c/TCombMaskv094.zip Plugin]<br />
|{{Author/tritical}}<br />
|-<br />
|[http://github.com/tp7/tmaskcleaner TMaskCleaner]<br />
|A really simple mask cleaning plugin for AviSynth based on mt_hysteresis. See [http://forum.doom9.org/showthread.php?t=169832 discussion]<br />
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://github.com/tp7/tmaskcleaner/releases Plugin]<br />
|{{Author/tp7}}<br />
|-<br />
| [[TMM]]<br />
| TMM builds a motion-mask for TDeint, which TDeint uses via its 'emask' parameter. See [http://forum.doom9.org/showthread.php?p=980353#post980353 discussion.]<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20140420183526/http://bengal.missouri.edu/~kes25c/TMMv1.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [http://github.com/chikuzen/TMM2 TMM2]<br />
| A rewrite of TMM<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
| [http://github.com/chikuzen/TMM2/releases Plugin]<br />
| {{Author/Chikuzen}}<br />
|-<br />
| [[Unpremultiply]] <br />
| This plugin convert the input RGBA clip from premultiplied alpha to straight matted alpha. See [http://forum.doom9.org/showthread.php?t=166730 discussion.]<br />
| [[RGB32]]<br />
| [http://forum.doom9.org/attachment.php?attachmentid=13207&d=1356994426 Plugin]<br />
| [http://web.archive.org/web/20160610124858/http://code.google.com/p/avisynth-unpremultiply/ Josh Sutinen]<br />
|-<br />
| [[uu_mt_blend]]<br />
| ''Blend'' (''[[Overlay]], [[Layer]]'') two clips using [[MaskTools2|MaskTools]]. Wide selection of blend modes.<br />
| [[YV12]],[[RGB24]],[[RGB32]]<br />
| [[Media:UU_mt_blend.avs|Script]]<br />
| rafriff42<br />
|}<br />
<br />
=== Blurring ===<br />
<br />
{{FilterTable}}<br />
| [[BucketMedian]]<br />
| BucketMedian is an implementation of spatial median filter adapting bucket (counting) sort algorithm.<br />
| [[Y8]], [[YV411]], [[YV12]], [[YV16]], [[YV24]]<br />
| [http://dl.dropboxusercontent.com/s/bczippngoqy6xbw/BucketMedian-0.3.1.7z Plugin]<br />
| {{Author/Chikuzen}}<br />
|-<br />
| [[GBlur]]<br />
| Gaussian blur.<br />
| Any<br />
| [http://www.avisynth.nl/users/vcmohan/GBlur/GBlur.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
|[[MedianBlur]]<br />
| A plugin with 5 different types of median blur filters. See [http://forum.doom9.org/showthread.php?t=84636 discussion.] <br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/tsp/medianblur084.zip Plugin]<br />
| {{Author/tsp}}<br />
|-<br />
|[[MedianBlur2]]<br />
| Implementation of [http://nomis80.org/ctmf.html constant time median filter] for AviSynth 2.6, similar to MedianBlur.<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://github.com/tp7/MedianBlur2/releases Plugin]<br />
| {{Author/tp7}}<br />
|-<br />
| [[VariableBlur]]<br />
| VariableBlur is a Gaussian, binomial or average blur filter with a variable radius (variance).<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]],<br />
| [http://web.archive.org/web/20140420184040/http://bengal.missouri.edu/~kes25c/variableblur.zip Plugin]<br />
| {{Author/tsp}}, {{Author/tritical}}<br />
|-<br />
| [[VariableMedian]]<br />
| A simple median filter. See [http://forum.doom9.org/showthread.php?t=83985 discussion]<br />
| [[RGB32]]<br />
| [http://web.archive.org/web/20091027134543/http://www.geocities.com/siwalters_uk/variablemedian.zip Plugin]<br />
| {{Author/Simon Walters}}<br />
|}<br />
<br />
=== Borders and Cropping ===<br />
<br />
{{FilterTable}}<br />
|[[BorderControl]]<br />
| 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].<br />
| [[YUY2]], [[YV12]]<br />
|[http://web.archive.org/web/20140709005736/http://www.geocities.com/siwalters_uk/bordercontrol14.zip Plugin]<br />
|{{Author/Simon Walters}}<br />
|-<br />
|[[FillMargins]]<br />
|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]<br />
|[[YV12]]<br />
|[http://web.archive.org/web/20130207143129/http://neuron2.net/trbarry/FillMargins.zip Plugin]<br />
|{{Author/Tom Barry}}<br />
|-<br />
| Padding<br />
| Duplicate edge pixels to the outside with [[PointResize]]. See [http://forum.doom9.org/showthread.php?t=165946 discussion.]<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://forum.doom9.org/showpost.php?p=1596804&postcount=5 Script]<br />
| {{Author/Didée}}<br />
|}<br />
<br />
<br />
{{FilterTable}}<br />
|[[AutoCrop]]<br />
|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]<br />
| [[YUY2]], [[YV12]]<br />
| [http://len0x.leffe.dnsalias.com/autocrop12.zip Plugin]<br />
| [http://web.archive.org/web/20050404182221/http://www.videofringe.com/autocrop/ Glenn Bussell], len0x<br />
|-<br />
|[https://github.com/slavanap/ssifSource CropDetect]<br />
| 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<br />
|[[RGB32]]<br />
|[https://github.com/slavanap/ssifSource/releases plugin]<br />
|[http://github.com/slavanap slavanap]<br />
|-<br />
|[[RoboCrop]]<br />
| 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.]<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://www.mediafire.com/download/72y0im53kao3124/RoboCrop_25%2626_dll_v1-06_20150422.zip Plugin]<br />
| StainlessS<br />
|}<br />
<br />
=== Colourspace Conversion ===<br />
<br />
{{FilterTable}}<br />
| [{{N2Moved}}/autoyuy2/autoyuy2.html AutoYUY2]<br />
| This filter is correctly converts YV12 to YUY2 without color bias.<br />
| [[YV12]]<br />
| Plugin<br />
| {{Author/Donald Graft}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=171786 Cnv2]<br />
| Universal [[Convert|ConvertTo...()]] wrapper with some additional features. Requires [http://forum.doom9.org/showthread.php?t=147846 GScript]<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://forum.doom9.org/showthread.php?t=171786 Script]<br />
| martin53<br />
|-<br />
| ConvertToYCgCo<br />
| Converts to the YCgCo colorspace. See [http://forum.doom9.org/showthread.php?t=161736 discussion.]<br />
| [[RGB24]], [[RGB32]]<br />
| [http://forum.doom9.org/attachment.php?attachmentid=12748&d=1331769022 Plugin]<br />
| xv<br />
|-<br />
| InterleavedConversions<br />
| Tools for interleaving and de-interleaving 2, 3, and 4-channel data.<br />
| <br />
| Script<br />
| PitifulInsect<br />
|-<br />
| ManualColorMatrix<br />
| Can perform any matrix-based color conversion. See [http://forum.doom9.org/showthread.php?t=161777 discussion.]<br />
| [[RGB24]], [[RGB32]], [[YV24]]<br />
| [http://forum.doom9.org/attachment.php?attachmentid=12346&d=1309522614 Plugin]<br />
| xv<br />
|-<br />
|[[nnedi3_resize16]]<br />
|An advanced script for high quality 16-bit image resizing and colorspace conversion. <br />
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
|[http://avisynth.nl/index.php/Nnedi3_resize16 Script]<br />
|mawen1250<br />
|-<br />
|[http://github.com/chikuzen/PlanarTools PlanarTools]<br />
|This plugin is a set of filters that offers converting packed(interleaved) formats to planar formats and vice versa.<br />
|[[RGB24]], [[RGB32]], [[YUY2]], [[YV16]]<br />
|[http://github.com/chikuzen/PlanarTools/releases Plugin]<br />
|{{Author/Chikuzen}}<br />
|-<br />
| YUY2inRGB<br />
| A quick filter that stuffs YUY2 into RGB24. See [http://forum.doom9.org/showthread.php?p=639948#post639948 discussion.]<br />
| [[YUY2]]<br />
| [http://trevlac.us/YUY2inRGB.zip Plugin]<br />
| {{Author/Trevlac}}<br />
|-<br />
| YUY2toRGB219<br />
| 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.]<br />
| [[YUY2]]<br />
| [http://trevlac.us/colorCorrection/YUY2toRGB219.zip Plugin] <br />
| {{Author/Trevlac}}<br />
|-<br />
|[http://github.com/chikuzen/YV12To422 YV12To422]<br />
|YV12 to YV16/YUY2 converter for AviSynth 2.6.<br />
|[[YV12]]<br />
|[http://github.com/chikuzen/YV12To422/releases Plugin]<br />
|{{Author/Chikuzen}}<br />
|}<br />
<br />
=== Effects ===<br />
<br />
{{FilterTable}}<br />
| [[AddGrainC]]<br />
| 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 <br />
| [[RGB24]], [[RGB32]], [[YUY2]],<br />
[[Y8]], [[YV411]], [[YV12]], [[YV16]], [[YV24]]<br />
| [http://ldesoras.free.fr/src/avs/AddGrainC-1.7.1.7z Plugin]<br />
|{{Author/Tom Barry}}, {{Author/Foxyshadis}}<br><br />
{{Author/LaTo}}, {{Author/cretindesalpes}}<br />
|-<br />
| AddStaticGrainM<br />
| This function adds static grain in dark areas based on a mask.<br />
| [[YV12]]<br />
| [[AddStaticGrainM_source|Script]]<br />
| [http://canihaziframe.wordpress.com/2011/02/23/addstaticgrainm/ Daiz]<br />
|-<br />
| [http://kvcd.net/sansgrip/avisynth/Blockbuster-readme.html AddNoise/Blockbuster]<br />
| Makes encoder allocate more bits to darker areas, thus eliminating DCT blocks by decreasing the clips compressibility.<br />
| <br />
| [http://www.avisynth.nl/users/warpenterprises/files/blockbuster_5F25_src_20021229.zip Plugin]<br />
| Ross Thomas<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=87295 AviShader]<br />
| generic plugin that uses your 3D card's hardware to assist with rendering<br />
| [[RGB32]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/avishader_5F25_dll_20041228.zip Plugin]<br />
| Antitorgo<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=97706 ColorLooks]<br />
| 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.<br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://www.geocities.com/wilbertdijkhof/ColorLooks_v13.zip Plugin]<br />
| {{author/Wilbert Dijkhof}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=170732 crt_display]<br />
| 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.]<br />
| [[RGB24]], [[RGB32]]<br />
| [http://forum.doom9.org/showthread.php?t=170732 Script]<br />
|{{Author/cretindesalpes}}<br />
|-<br />
| [[EffectsMany]]<br />
| 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.<br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://avisynth.nl/users/vcmohan/EffectsMany/EffectsMany.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| [[f3kgrain]]<br />
| Another 8/16-bit luma adaptive grain generator.<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
| [http://web.archive.org/web/20131111114900/http://www.nmm-hd.org/upload/get~ElhZlazJbsQ/f3kgrain_v0.4.avsi Script]<br />
| {{Author/06_taro}}<br />
|-<br />
| [[GNoise]]<br />
| Adds random noise to a clip. See [http://forum.doom9.org/showthread.php?p=841700#post841700 duscussion.]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20080905123941/http://soulhunter.chronocrossdev.com/data/gnoise_r5.zip Plugin]<br />
| {{Author/mf}}<br />
|-<br />
| [[GrainFactory3]]<br />
| Noise generator that tries to simulate the behavior of silver grain on film. See [http://forum.doom9.org/showthread.php?t=141303 discussion.]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=1191292#post1191292 Script]<br />
| {{Author/Didée}}<br />
|-<br />
| [[GrainFactory3mod]]<br />
| Luma adaptive grain generating filter in 8-bit precision. Based on Didée's [[GrainFactory3]] script.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20140722190952/http://www.nmm-hd.org/upload/get~kvNvGpuyxfc/GrainFactory3mod_v1.2.avsi Script]<br />
| {{Author/06_taro}}<br />
|-<br />
| [[GrainFactoryLite]]<br />
| 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.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20140722185917/http://www.nmm-hd.org/upload/get~FaqsQaMom9s/GrainFactoryLite_v1.2.avsi Script]<br />
| {{Author/06_taro}}<br />
|-<br />
| [http://www.avisynth.nl/users/vcmohan/HollywoodSq/HollywoodSq.html HollywoodSQ]<br />
| Creates popup album, akin to Hollywood squares TV show<br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://avisynth.nl/users/vcmohan/HollywoodSq/HollywoodSq.html Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| KenBurnsEffect<br />
| Given clip, zooms, pans & rotates clip. See [http://en.wikipedia.org/wiki/Ken_Burns_Effect wikipedia:Ken Burns Effect]<br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://forum.doom9.org/showthread.php?t=135776 Script]<br />
| mikeytown2<br />
|-<br />
| [[MPlayerNoise]]<br />
| Noise Generator ported from MPlayer. See [http://forum.doom9.org/showthread.php?t=84181 discussion.]<br />
| [[YV12]]<br />
| [http://avisynth.nl/users/warpenterprises/files/bergfiltercollection_5F25_dll_20041019.zip Plugin]<br />
| {{Author/bergi}}<br />
|-<br />
| [[NoiseGenerator]]<br />
| Newer function based off of Blockbuster. Adds random noise to clip.<br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/noisegenerator_5F25_dll_20050616.zip Plugin]<br />
| Shubin<br />
|-<br />
| [[Scanlines]]<br />
| Add Scanlines (black horizontal bars) to a video. see [http://en.wikipedia.org/wiki/Scan_line wikipedia:Scan Line]<br />
| [[YV12]]<br />
| [http://avisynth.nl/users/warpenterprises/files/scanlines_5F25_dll_20031103.zip Plugin]<br />
| turulo<br />
|-<br />
| [[StaticNoiseC]]<br />
| 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.]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20131228160225/http://www.nmm-hd.org/upload/get~YnWFecZw0Uo/StaticNoiseC20110108b.zip Plugin]<br />
| histamine<br />
|-<br />
| [http://www.gyroshot.com/turnstile.htm TurnsTile]<br />
| Applies mosaic and/or palette effects to a clip.<br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://forum.doom9.org/showthread.php?t=158695 Plugin]<br />
| {{Author/Robert Martens}}<br />
|}<br />
<br />
=== Field Order ===<br />
<br />
{{FilterTable}}<br />
| PFR<br />
| 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.]<br />
| [[YV12]], [[YUY2]]<br />
| [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/pfravs.html Plugin]<br />
| {{Author/Simon Walters}}<br />
|-<br />
| ReverseFieldDominance<br />
| This filter is intended to reverse the field dominance of [[PAL]] DV video. See [http://forum.doom9.org/showthread.php?t=46765 discussion.]<br />
| [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://web.archive.org/web/20091028073306/http://geocities.com/siwalters_uk/reversefielddominance.html Plugin]<br />
| {{Author/Simon Walters}}<br />
|}<br />
<br />
=== Frame Rate Conversion ===<br />
<br />
{{FilterTable}}<br />
| [[AlterFPS]]<br />
| 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.<br />
| Any<br />
| Script<br />
| actionman133<br />
|-<br />
| [[convert60ito24p]]<br />
| convert60ito24p converts a 60fps interlaced NTSC Video into a 24fps progressive Video using different blending techniques.<br />
| [[RGB32]], [[RGB24]], [[YUY2]]<br />
| Script<br />
| scharfis_brain<br />
|-<br />
| [http://github.com/arkeet/fpsdown/blob/master/README.md FPSDown]<br />
| 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.<br />
| [[RGB32]]<br />
| [http://github.com/arkeet/fpsdown/blob/master/README.md Plugin]<br />
| [http://github.com/arkeet/ arkeet]<br />
|-<br />
| [[FrameDbl]]<br />
| 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.]<br />
| [[YV12]]<br />
| [{{N2Archived}}/trbarry/FrameDbl.zip Plugin]<br />
| {{Author/Tom Barry}}<br />
|-<br />
| [http://www.spirton.com/uploads/InterFrame/InterFrame2.html InterFrame]<br />
| 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.]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=1486831&postcount=1 Script]<br />
|{{Author/SubJunk}}<br />
|-<br />
|[http://www.compression.ru/video/frame_rate_conversion/index_en_msu.html MSU_FRC]<br />
|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.<br />
|[[YV12]]<br />
|[http://www.compression.ru/video/frame_rate_conversion/src/msu_frc.zip Plugin]<br />
|Dmitriy Vatolin, et al.<br />
|-<br />
| Motion<br />
| 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]<br />
| [[YV12]]<br />
| [http://wilbertdijkhof.com/mg262/Motion_v10.zip plugin]<br />
| mg262<br />
|-<br />
| NTSC tools<br />
| Automatic [[NTSC]] to [[PAL]] conversion with 24p, 30p, 60i detection. See [http://forum.doom9.org/showthread.php?t=114054 discussion].<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/NTSC_tools.avsi Script]<br />
| Mug Funky<br />
|-<br />
| [[SalFPS3]]<br />
| A modded version of MotionProtectedFPS for extra protection.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/SalFPS3.avs Script]<br />
| Mug Funky, {{Author/Didée}}<br />
|-<br />
| [http://www.svp-team.com/wiki/Plugins:_SVPflow SVPflow]<br />
| SVPflow provides fast and high quality GPU accelerated frame rate interpolation. See [http://forum.doom9.org/showthread.php?t=164554 discussion.] <br />
| [[YV12]]<br />
| [http://www.svp-team.com/files/gpl/svpflow-4.0.0.128.zip Plugin]<br />
| [http://www.svp-team.com/wiki/Credits SVP Team]<br />
|-<br />
| [http://github.com/gnaggnoyil/tc2cfr tc2cfr]<br />
| 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.<br />
| [[YV12]]<br />
| [http://github.com/gnaggnoyil/tc2cfr/releases Plugin]<br />
| [http://github.com/gnaggnoyil gnaggnoyil]<br />
|-<br />
| [http://tasvideos.org/forum/viewtopic.php?t=12763 TimecodeFPS]<br />
| Converts clip from VFR to CFR. Timing information from clip is discarded, and matroska v2 timecodes from the timecodes file are used instead.<br />
| Any<br />
| [http://www.mediafire.com/?a51pifo438i7hdb Plugin]<br />
| natt<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=165045 VFRtoCFR]<br />
| Converts a variable frame rate (VFR) video to a constant frame rate (CFR) video with the help of Matroska Version 2 Timecodes.<br />
| [[YV12]]<br />
| [http://www.mediafire.com/download/q6zfgpo5dhh50si/VFRtoCFR20120730.zip Plugin]<br />
| Aktan<br />
|-<br />
| [http://griffeltavla.wordpress.com/2013/01/18/convert-vfr-to-cfr-using-avisynth/ VfrToCfr]<br />
| This plugin converts variable frame rate clips to constant frame rate by introducing null frames. [http://github.com/jojje/VfrToCfr-the-other-one GitHub repository]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20130430033132/http://snarl.zapto.org/files/vfrtocfr-1.0.zip Plugin]<br />
| joyje<br />
|-<br />
|[[YFRC]]<br />
| Yushko Frame Rate Converter - doubles the frame rate with strong artifact detection and scene change detection.<br />
|[[YV12]]<br />
|[http://avisynth.nl/images/YFRC-01dd-10mm-2015yyyy.avsi Script]<br />
| Oleg Yushko<br />
|}<br />
<br />
=== Frame Replacement/Range Processing ===<br />
{{FilterTable}}<br />
|[http://forum.doom9.org/showthread.php?p=461878#post461878 ApplyEvery]<br />
|A collection of AviSynth functions that operate at regular intervals in a clip. <br />
|<br />
|[http://www.avisynth.nl/users/stickboy/ApplyEvery.zip Plugin]<br />
|{{Author/stickboy}}<br />
|-<br />
|[http://www.avisynth.nl/users/fizick/badframes/badframes.html BadFrames]<br />
|Replaces given bad frames by neighbors or blend (interpolation). Useful for frames with very large defects. <br />
|<br />
|[http://www.avisynth.nl/users/fizick/badframes/badframes20.zip Plugin]<br />
|{{Author/Fizick}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=162266 ClipClop]<br />
|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.<br />
|<br />
|[http://www.mediafire.com/folder/hb26mthbjz7z6/StainlessS Plugin]<br />
|StainlessS<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=168047 FrameRepeat]<br />
|FrameRepeat() is a simple plugin to select frames to repeat. Requires AviSynth 2.6.<br />
|<br />
|[http://www.mediafire.com/folder/hb26mthbjz7z6/StainlessS Plugin]<br />
|StainlessS<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=167971 FrameSel/FrameRep]<br />
|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.<br />
|<br />
|[http://www.mediafire.com/folder/hb26mthbjz7z6/StainlessS Plugin]<br />
|StainlessS<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=164766 MatchFrames/LocateFrames]<br />
|MatchFrames, intended for matched frames extraction,LocateFrames, intended to be usable by other scripts to identify matches.<br />
|<br />
|[http://www.mediafire.com/folder/hb26mthbjz7z6/StainlessS Plugin]<br />
|StainlessS<br />
|-<br />
|[http://forum.doom9.org/showpost.php?p=1644971&postcount=28 RemapFrames]<br />
|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>. <br />
|<br />
|[http://ldesoras.free.fr/src/avs/RemapFrames-0.4.1.zip Plugin]<br />
|{{Author/stickboy}}, {{Author/cretindesalpes}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=162446 Prune]<br />
|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.<br />
|<br />
|[http://www.mediafire.com/folder/hb26mthbjz7z6/StainlessS Plugin]<br />
|StainlessS<br />
|}<br />
<br />
=== Levels and Chroma ===<br />
<br />
{{FilterTable}}<br />
| [http://forum.doom9.org/showthread.php?t=167573 AutoAdjust]<br />
| 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. AutoAdjust has a smoothing & dithering algorithm to avoid banding issue. Calculations are made in 32bits float to avoid rounding errors and can also input/output 16-bits. AutoAdjust is internally multithreaded and SSE2 optimized.<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://forum.doom9.org/showthread.php?t=167573 Plugin]<br />
| {{Author/LaTo}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=173208#post1757661 AutoContrast]<br />
|Auto contrast adjustment.<br />
|[[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://forum.doom9.org/showthread.php?t=173208#post1757661 Script]<br />
|{{Author/StainlessS}}<br />
|-<br />
| [http://www.thebattles.net/video/autolevels.html Autolevels]<br />
| 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. [http://forum.doom9.org/showthread.php?t=128585 Discuss]<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://www.thebattles.net/video/autolevels_0.6_20110109.zip Plugin]<br />
| {{Author/frustum}} & Theodor Anschütz<br />
|-<br />
| AWB<br />
| Automatic white balance for real world footage, similar to the known function in digital cameras. See [http://forum.doom9.org/showthread.php?t=168062 discussion.]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=168062 Script]<br />
| martin53<br />
|-<br />
| [[ChanMix]]<br />
| Creates a grayscale image from an RGB24 source, it has 3 parameters to specify how much of each color-channel is used.<br />
| [[RGB24]]<br />
| [{{N2Moved}}/misc/chanmix.zip Plugin]<br />
| E-Male<br />
|-<br />
| [[ChannelMixer]]<br />
| Very similar to the ChannelMixer function found in Photoshop. 9 Adjustments are possible, 3 for each color channel.<br />
| [[RGB24]], [[RGB32]]<br />
| [http://forum.videohelp.com/images/guides/p1767998/channelmixer_v1_0.zip Plugin]<br />
| Gustaf Ullberg<br />
|-<br />
| [[ChromaJig]]<br />
| Automatic Colorization.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=1775733#post1775733]<br />
| MWilson<br />
|-<br />
| [[ColorBalance]]<br />
| Same tool that is found in Gimp & Cinepaint. See [http://forum.doom9.org/showthread.php?p=1180090#post1180090 discussion.]<br />
| [[RGB24]], [[RGB32]]<br />
| [http://dl.dropbox.com/s/ve66ayxfnfet9u0/ColorBalance_0.26.zip Plugin]<br />
| Gavino & mikeytown2<br />
|-<br />
|ColorLooks<br />
| This plugin is based on Trev's VDub filter [http://www.trevlac.us/FilterDocs/ Colorlooks] and Donald Graft's [http://rationalqm.us/colorize.html Colorize] (well it works a bit similar). I also added some new stuff. The plugin contains the following filters: Technicolor, Colorize, Sepia and Posterize. See [http://forum.doom9.org/showthread.php?t=97706 discussion]<br />
|[[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
|[http://www.wilbertdijkhof.com/ColorLooks_v13.zip Plugin]<br />
|{{Author/Wilbert Dijkhof}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=163829 ColorYUV2]<br />
|YUV color adjustment plugin with a graffer. <br />
|[[YV12]]<br />
|[http://www.mediafire.com/download/875czvfnigu72ds/ColorYUV2_25_dll_20120529.zip Plugin]<br />
|{{Author/StainlessS}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=96308 ColourLike]<br />
| Makes a clip look like a 'reference' clip by adjusting each colour mask. Updated [http://forum.doom9.org/showpost.php?p=1582935&postcount=38 documentation]<br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/colourlike_5F25_dll_20050825.zip Plugin]<br />
| {{Author/mg262}}<br />
|-<br />
| [http://expsat.sourceforge.net/ ExpLabo]<br />
| ExpSat apply a non-linear transformation of saturation, Colorize change the image color dominance in a flexible manner, HLSnoise adds a noise to the image separately to the HLS dimensions. See [http://forum.doom9.org/showthread.php?t=97052 discussion.]<br />
| [[RGB24]], [[RGB32]]<br />
| [http://sourceforge.net/projects/expsat/ Plugin]<br />
| brabbudu<br />
|-<br />
|[http://mpierce.pie2k.com/pages/211.php Exposure]<br />
|Exposure function for AviSynth.<br />
|[[RGB24]]<br />
|[http://mpierce.pie2k.com/downloads/exposure.zip Plugin]<br />
|Matt Pierce<br />
|-<br />
| [[FlimsYlevels]]<br />
| Luma adjustment function to give a more "film-ish" look. (Based on {{Author/Didée}}'s [[Ylevels]]).<br />
| [[YV12]]<br />
| Script<br />
| FlimsyFeet <br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=173695 GamMac]<br />
|Useful to correct color cast on old 8mm films.<br />
|[[RGB32]], [[RGB24]]<br />
|[http://www.mediafire.com/folder/hb26mthbjz7z6/StainlessS Plugin]<br />
|{{Author/StainlessS}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?p=605890#post605890 GiCocu]<br />
| Use GIMP/Photoshop curve files, see [http://avisynth.org.ru/docs/english/externalfilters/gicocu.htm documentation.] <br />
| [[RGB24]], [[RGB32]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/gicocu_5F25_dll_20050620.zip Plugin]<br />
| E-Male<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=167027#post1629321 Gray_Balance]<br />
|A gray balance script, which is based on Black/White/Gray balance picker.<br />
|[[RGB24]], [[YUY2]], [[YV12]]<br />
|[http://forum.doom9.org/showthread.php?t=167027#post1629321 Script]<br />
|Kisa_AG<br />
|-<br />
| [http://web.archive.org/web/20130812061301/http://strony.aster.pl/paviko/hdragc.htm HDRAGC]<br />
| 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. See [http://forum.doom9.org/showthread.php?t=93571 discussion.]<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20120419193005/http://strony.aster.pl/paviko/Hdragc-1.8.7.zip Plugin]<br />
| {{Author/paviko}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=161986 HighlightLimiter]<br />
| "Darkening highlight". Works well on over exposed clips. It can also be combined with ContrastMask to create HDR effect<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=1522100#post1522100 Script]<br />
| javlak<br />
|-<br />
| [[HistogramAdjust]]<br />
| 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.<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/users/vcmohan/HistogramAdjust/HistogramAdjust.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| [[Histograms in RGB & CMY]]<br />
| Similar to Histogram("levels") but for RGB and CMY instead of YUV. It also includes a RGB parade color scope.<br />
| [[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://avisynth.nl/images/Histograms_in_RGB_%26_CMY.avsi Script]<br />
| -Vit-<br />
|-<br />
|HSVAdjust<br />
|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. See [http://forum.doom9.org/showthread.php?t=162022 discussion]<br />
|[[RGB24]], [[RGB32]]<br />
|[http://www.wilbertdijkhof.com/HSVAdjust_v01.zip Plugin]<br />
|{{Author/Wilbert Dijkhof}}<br />
|-<br />
|Hue<br />
|This plugin is a port of Donald Graft's VirtualDub [http://rationalqm.us/hue.html Hue] filter. See [http://forum.doom9.org/showthread.php?s=&threadid=87439&pagenumber=2 discussion]<br />
|[[RGB24]], [[RGB32]]<br />
|[http://www.wilbertdijkhof.com/Hue_v10.zip Plugin]<br />
|{{Author/Wilbert Dijkhof}}<br />
|-<br />
|MatchHistogram<br />
| 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. See [http://forum.doom9.org/showthread.php?t=153196 discussion]<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://latoninf.free.fr/d9/MatchHistogram.7z Plugin]<br />
| {{Author/LaTo}}<br />
|-<br />
| [[OutRange]]<br />
| A simple function to scan the whole video and output a log file, in which out-of-tv-range frames are logged.<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://avisynth.nl/images/OutRange.avsi Script]<br />
| 06_taro<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=170642 RGBAdapt]<br />
|Another RGB color correction plugin, it also also includes a graffer.<br />
|[[RGB24]], [[RGB32]]<br />
|[http://www.mediafire.com/download/bo4afg77u4dfu8k/RGBAdapt_dll_v0.3-20150617.zip Plugin]<br />
|{{Author/StainlessS}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=168293 RgbAmplifier]<br />
|An AviSynth forensic plugin to amplify color shifts.<br />
|[[RGB24]], [[RGB32]]<br />
|[http://www.mediafire.com/download/432rxa9ed1lr2in/RgbAmplifier_25_dll_v1.03_20140607.zip Plugin]<br />
|{{Author/StainlessS}}<br />
|-<br />
| [[SGradation]]<br />
| SGradation is much like a gamma function, but '2nd order'.<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| Script<br />
| martin53<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=163829 ShowChannels]<br />
|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.<br />
|[[RGB24]], [[RGB32]], [[Y8]], [[YUY2]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://www.mediafire.com/download/2dgk1y1cohql64r/ShowChannels_25%2626_v0-8_dll_20150330.zip Plugin]<br />
|{{Author/StainlessS}}<br />
|-<br />
| [[ShowOverRange]]<br />
| Shows illegal "TV range" by painting pixels blue for anything less than 16 and red for anything greater than 235.<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.nmm-hd.org/newbbs/download/file.php?id=164 Plugin]<br />
| {{Author/SAPikachu}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=154971 SmoothAdjust]<br />
| SmoothAdjust is a set of 5 plugins to make YUV adjustements. These 5 plugins have a smoothing & dithering algorithm to avoid banding issue. Calculations are made in 32bits float to avoid rounding errors and artifacts. SmoothAdjust is multithreaded (up to 16 threads) and SSE2 optimized. SmoothAdjust is [[SmoothLevels|SmoothLevels']] successor. <br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://forum.doom9.org/showthread.php?t=154971 Plugin]<br />
| {{Author/LaTo}}<br />
|-<br />
| [[Tint]]<br />
| Tints the image toward a specified colour.<br />
| [[YUY2]], [[YV12]]<br />
| Script<br />
| actionman133 <br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=74334 TweakColor]<br />
| Target specific hue and saturation ranges for hue and saturation adjustments.<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.nl/users/warpenterprises/files/tweakcolor_5F25_dll_20040412.zip Plugin]<br />
| {{Author/Trevlac}}<br />
|-<br />
| [[VideoScope]]<br />
| Similar to Histogram("classic") but with additional features, it shows waveform monitors and a vectorscope. <br />
| [[YUY2]]<br />
| [http://www.wilbertdijkhof.com/VScope12.zip Plugin]<br />
| {{Author/Randy French}}<br />
|-<br />
| [[WhiteBalance]]<br />
| Correct the white balance of a clip with a large degree of control and accuracy over other methods of correcting white balance. See [http://forum.doom9.org/showthread.php?t=106196 discussion.]<br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://www.64k.it/andres/data/avisynth/WhiteBalance100.zip Plugin]<br />
| SomeJoe<br />
|-<br />
| [[Ylevels]]<br />
| A simple replacement for Avisynth's internal [[Levels]] command, with a few neat differences.<br />
| [[YV12]]<br />
| Script<br />
| {{Author/Didée}}<br />
|}<br />
<br />
=== Line Darkening ===<br />
<br />
{{FilterTable}}<br />
| FastLineDarkenMOD<br />
| 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.]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=1060081#post1060081 Script]<br />
| Vectrangle / {{Author/Didée}}<br />
|-<br />
|[[Hysteria]]<br />
|Hysteria, a line darkening script by Scintilla.<br />
|[[YV12]]<br />
|[http://pastebin.com/raw/fvDdiV6m Script]<br />
|Scintilla<br />
|-<br />
|[http://forum.doom9.org/showpost.php?p=993939&postcount=2 LineDarkenToon]<br />
| 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.<br />
|[[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=993939&postcount=2 Script]<br />
| MOmonster<br />
|-<br />
| [[mfToon]]<br />
| mfToon darkens cartoon edges. In default operation, it performs line darkening, Xsharpening, and warp sharpening. <br />
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]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20090212071718/http://mf.creations.nl/avs/functions/mfToon-v0.52.avs Script]<br />
| {{Author/mf}}<br />
|-<br />
|[[proToon]]<br />
|Line darkening script, used to be known as vmToon and before that mfToon.<br />
|[[YV12]]<br />
|[http://pastebin.com/raw/Aw9En26L Script]<br />
|TheProfileth<br />
|-<br />
| [[SuperToon]]<br />
| An attempt to optimize/speed up the previous versions of mfToon, vmToon, etc. See [http://forum.doom9.org/showthread.php?t=163987 discussion]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=163987 Script]<br />
| Hadien<br />
|-<br />
| [[Toon]]<br />
| Simple and fast line darkener. <br />
| [[YV12]]<br />
| [http://dl.dropbox.com/s/guk5plphkthdy2f/Toon-v1.1.7z Plugin]<br />
| {{Author/mf}}<br />
|-<br />
| [[ToonLite]]<br />
| It's the same as [[Toon]], just without the warpsharp processing..<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20090218093135/http://mf.creations.nl/avs/filters/Toon-v1.0-lite.dll Plugin]<br />
| {{Author/mf}}<br />
|-<br />
| [[vmToon]]<br />
| The successor to mfToon. Darkens lines, thins lines, and does supersampled sharpening all in one, but slow. <br />
| [[YV12]]<br />
| [http://avisynth.nl/images/Vmtoon-v0.74.avsi Script]<br />
| Vectrangle<br />
|}<br />
<br />
=== Resizers ===<br />
<br />
{{FilterTable}}<br />
| [[AreaResize]]<br />
| An area-average resizer plugin; only use to downscale.<br />
| [[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://www.mediafire.com/download.php?kn56wh7r81vk2rx Plugin]<br />
| {{Author/Chikuzen}}<br />
|-<br />
| [[Debicubic]]<br />
| This filter is designed to reverse the effects of bicubic upsampling.<br />
| [[RGB24]], [[RGB32]], [[YV12]]<br />
| [http://web.archive.org/web/20140622040033/http://rgb.chromashift.org/debicubic%20r2.zip Plugin]<br />
| Prunedtree<br />
|-<br />
| [[Debilinear]]<br />
| This filter is designed to reverse the effects of bilinear upsampling.<br />
| [[RGB24]], [[RGB32]], [[YV12]]<br />
| [http://web.archive.org/web/20140214021604/http://rgb.chromashift.org/debilinear%20r6.zip Plugin]<br />
| Prunedtree<br />
|-<br />
|[http://forum.doom9.org/showthread.php?p=1738351#post1738351 edi_rpow2]<br />
|An improved rpow2 function for nnedi3, nnedi3ocl, eedi3, and eedi2. Requires [http://www.mediafire.com/download/lcbtb7uta4ta5pc/ResizeX_v1.0.avsi ResizeX]<br />
|[[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://www.mediafire.com/view/pcmkxaauku375xd/edi_rpow2_v1.0.avsi Script]<br />
|Desbreko<br />
|-<br />
| [[JincResize]]<br />
| Jinc (EWA Lanczos) Resampler Plugin for Avisynth/Avisynth+. See [http://forum.doom9.org/showthread.php?t=169813 discussion.]<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://github.com/AviSynth/jinc-resize/releases Plugin]<br />
| innocenat<br />
|-<br />
| Lanczosplusv3<br />
| Very slow, but high quality resizer. See [http://forum.doom9.org/showthread.php?t=136690]<br />
| <br />
| Script<br />
| *.mp4 guy<br />
|-<br />
|[[nnedi3/nnedi3_rpow2|nnedi3_rpow2]]<br />
| Enlarge images by the powers of 2 using Neural Network New-Edge Directed Interpolation ; nnedi3_rpow2 is a function included in [[nnedi3]].<br />
|[[RGB24]], [[YUY2]], [[YV12]]<br />
|[http://avisynth.nl/index.php/Nnedi3 Plugin]<br />
|{{Author/tritical}}<br />
|-<br />
|[[nnedi3ocl/nnedi3x_rpow2|nnedi3x_rpow2]]<br />
| Enlarge images by the powers of 2 using Neural Network New-Edge Directed Interpolation ; nnedi3x_rpow2 is a script function included in [[nnedi3ocl]].<br />
|[[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://avisynth.nl/index.php/nnedi3ocl Script and Plugin]<br />
|SeT<br />
|-<br />
|[[nnedi3_resize16]]<br />
|An advanced script for high quality image resizing and colorspace conversion. <br />
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
|[http://avisynth.nl/index.php/Nnedi3_resize16 Script]<br />
|mawen1250 <br />
|-<br />
| [[PointSize]]<br />
| 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). See [http://forum.doom9.org/showthread.php?t=154674 discussion].<br />
| [[RGB32]]<br />
| [http://www.dropbox.com/s/2uvflijgrngvi7x/PointSize_0.2.zip?dl=1 Plugin]<br />
| `Orum<br />
|-<br />
| [http://svn.int64.org/viewvc/int64/resamplehq/doc/index.html ResampleHQ] <br />
| ResampleHQ provides gamma-aware resizing and colorspace conversion.<br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://sourceforge.net/projects/int64/files/ResampleHQ/ResampleHQ-v1.zip/download Plugin]<br />
| Cory Nelson<br />
|-<br />
|[[Resize8]]<br />
|<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. <br />
|[[RGB24]], [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
|[http://web.archive.org/web/20150911013350/http://www.nmm-hd.org/upload/get~8y1IjaaqvoI/Resize8_v1.2.avsi Script]<br />
|mawen1250 <br />
|-<br />
|ResizeX<br />
|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.<br />
|[[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://www.mediafire.com/download/lcbtb7uta4ta5pc/ResizeX_v1.0.avsi Script]<br />
|Desbreko<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=135735 Seamer]<br />
| Seam Carving/Liquid Rescale for Content-Aware Image Resizing. See [http://en.wikipedia.org/wiki/Seam_carving wikipedia:Seam Carving]<br />
| [[RGB24]], [[RGB32]]<br />
| [http://avisynth.nl/users/vcmohan/Seamer/Seamer.html Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
|SincResize<br />
|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.<br />
|[[YV12]]<br />
|[http://cafxx.strayorange.com/files/SincResize4.7z Plugin]<br />
|[http://cafxx.strayorange.com/ CAFxX]<br />
|-<br />
| [[SimpleResize]]<br />
| Resizing plugin with 4 filters: SimpleResize, WarpResize, InterlacedResize and InterlacedWarpedResize.<br />
| [[YV12]], [[YUY2]]<br />
| [{{N2Archived}}/trbarry/SimpleResize.zip Plugin]<br />
| {{Author/Tom Barry}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=147117 SplineResize]<br />
| 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.<br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://www.wilbertdijkhof.com/SplineResize_v02.zip Plugin]<br />
| {{Author/Wilbert Dijkhof}}<br />
|-<br />
|[http://github.com/sunnyone/Waifu2xAvisynth waifu2x]<br />
|Single-Image Super-Resolution for anime/fan-art using Deep Convolutional Neural Networks.<br />
|[[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
|[http://github.com/sunnyone/Waifu2xAvisynth/releases Plugin]<br />
|[http://github.com/sunnyone sunnyone]<br />
|-<br />
| [http://forum.doom9.org/showthread.php?p=1111789#post1111789 ZoomBox]<br />
| 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.<br />
| <br />
| Script<br />
| mikeytown2<br />
|}<br />
<br />
=== Sharpeners ===<br />
<br />
{{FilterTable}}<br />
| [[aSharp]] <br />
| Simple unsharp mask filter with optional adaptive sharpening. See [http://forum.doom9.org/showthread.php?s=&threadid=38436 discussion].<br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/asharp_5F25_dll_20030118.zip Plugin]<br />
| {{Author/Marc FD}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=122443 AVSShock]<br />
|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). <br />
|[[YUY2]], [[YV12]]<br />
|[http://forum.gleitz.info/showthread.php?33105-Neues-Plugin-zum-Video-sch%E4rfen-Patent-Problem!&p=321585#post321585 Plugin]<br />
|AMSS0815<br />
|-<br />
| [[aWarpSharp2]]<br />
| A modern rewrite of aWarpSharp with several bugfixes and optimizations. See [http://forum.doom9.org/showthread.php?t=147285 discussion]<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
| [http://github.com/pinterf/aWarpSharp/releases Plugin]<br />
| {{Author/SEt}}<br />
|-<br />
| [[blah]]<br />
| Sharpening. See [http://forum.doom9.org/showthread.php?t=155030 discussion.]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=1406843 Script]<br />
| *.mp4 guy<br />
|-<br />
| [[FineSharp]]<br />
| 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].<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=1569035#post1569035 Script]<br />
| {{Author/Didée}}<br />
|-<br />
| [[LimitedSharpen]]<br />
| 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.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/LimitedSharpenFaster.avsi Script]<br />
| {{Author/Didée}}<br />
|-<br />
| [[LSFmod]]<br />
| A LimitedSharpenFaster mod with a lot of new features and optimizations. <br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=142706 Script]<br />
| {{Author/LaTo}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=173515 MCLS_16]<br />
|Motion Compensate Limited Sharpen 16bit<br />
|[[YV12]]<br />
|[http://forum.doom9.org/showthread.php?t=173515 Script]<br />
|Motenai Yoda<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=153201 MedSharp]<br />
|Soft thresholded median sharpening function. See [http://forum.doom9.org/showthread.php?t=153201 discussion].<br />
|[[YV12]]<br />
|[http://forum.doom9.org/showthread.php?t=153201 Script]<br />
|*.mp4 guy <br />
|-<br />
| [[MSharpen]]<br />
| <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. See [http://forum.doom9.org/showthread.php?t=169832 discussion].<br />
| [[RGB32]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://avisynth.nl/index.php/MSharpen Plugin]<br />
| {{Author/tp7}}<br />
|-<br />
| [[NonlinUSM]]<br />
| Non-linear Unsharp Masking.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=1555234&postcount=46 Script]<br />
| {{Author/Didée}}<br />
|-<br />
| [[pSharpen]]<br />
| Performs two-point sharpening to avoid overshoot. See [http://forum.doom9.org/showthread.php?t=172422 discussion].<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=172422#post1732663 Script]<br />
| ilpippo80, colours<br />
|-<br />
|[[ReCon]]<br />
|'''ReCon'''volution - makes things sharp by mixing pixels together. See [http://forum.doom9.org/showthread.php?t=153201 discussion].<br />
|[[YV12]]<br />
|[http://forum.doom9.org/showthread.php?p=1409582#post1409582 Script]<br />
|*.mp4 guy <br />
|-<br />
| [[SeeSaw]]<br />
| 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.<br />
| [[YV12]]<br />
| [http://avisynth.nl/images/SeeSaw.avs Script]<br />
| {{Author/Didée}}<br />
|-<br />
| SharpenComplex2<br />
| 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.]<br />
| [[YV12]]<br />
| [[SharpenComplex2_source|Script]]<br />
|<br />
|-<br />
| SSXSharpen<br />
| Included in SharpTools. Sharpens the picture using [[supersampling]] techniques.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20100120201434/http://mf.creations.nl/avs/functions/SharpTools-v0.3.avs Script]<br />
| {{Author/mf}}, {{Author/Didée}}<br />
|-<br />
| [[SSSharp]]<br />
| Also known as Super Slow Sharpen - a very slow, but high quality sharpener. See [http://forum.doom9.org/showthread.php?t=132330 discussion]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showpost.php?p=1071731 Script]<br />
| *.mp4 guy<br />
|-<br />
| [[TUnsharp]]<br />
| 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. See [http://forum.doom9.org/showthread.php?t=84344 discussion].<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20070222162107/http://bengal.missouri.edu/~kes25c/TUnsharpv093.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[UnFilter]]<br />
| 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. See [http://forum.doom9.org/showthread.php?s=&threadid=28197&pagenumber=3 discussion].<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/unfilter_5F25_dll_20030116.zip Plugin]<br />
| {{Author/Tom Barry}}<br />
|-<br />
| [[UnsharpHQ]]<br />
| A strong and fast unsharp mask with some new features. See [http://forum.doom9.org/showthread.php?t=159637 discussion].<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20160302123821/https://filetea.me/t1sl65PsDLsT0mXMZL0s14xEg/dl Plugin]<br />
| list<br />
<br />
|-<br />
| [[WarpSharp]]<br />
| WarpSharp contains these sharpeners: <tt>UnsharpMask, WarpSharp, Xsharpen</tt>.<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.dropbox.com/s/g6z1tohioqnw5b9/warpsharp_20080325.zip?dl=1 Plugin]<br />
|???, {{Author/seraphy}}<br />
|}<br />
<br />
=== Rotation/Shear/Skew/Perspective ===<br />
<br />
{{FilterTable}}<br />
| [[DeBarrel]]<br />
| Remove barrel and pincushion distortion, where straight lines appear curved.<br />
| Any<br />
| [http://www.avisynth.nl/users/vcmohan/DeBarrel/DeBarrel.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=152860 Defish]<br />
|Barrel and pincushion distortion correction filter. [http://forum.doom9.org/showthread.php?t=127432 Old discussion]<br />
|[[RGB32]]<br />
|[http://horman.net/defish.zip Plugin]<br />
|{{Author/David Horman}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=171922 Defish Different Projections]<br />
|Defish with different map projections, like Lambert Cylindrical Equal Area, Mercator and Miller projections.<br />
|[[RGB32]]<br />
|[http://forum.doom9.org/showthread.php?t=171922 Script]<br />
|Kisa_AG<br />
|-<br />
| [[FTurn]]<br />
| Fast implementation of [[TurnLeft]](), [[TurnRight]]() and [[Turn180]]() AviSynth functions. See [http://forum.doom9.org/showthread.php?t=168315 discussion.]<br />
| [[Y8]], [[YV12]],[[YV24]]<br />
| [http://github.com/tp7/fturn/releases Plugin]<br />
| {{Author/tp7}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=165978 Quad]<br />
|An Avisynth plugin to perform quadrilateral transformations.<br />
|[[RGB32]]<br />
|[http://horman.net/quad.zip Plugin] -- [http://forum.doom9.org/showpost.php?p=1602709&postcount=22 no SSE]<br />
|{{Author/David Horman}}<br />
|-<br />
| [http://www.avisynth.nl/users/vcmohan/Reform/Reform.html Reform]<br />
| Skewed images are corrected or vice versa, useful if video is recorded with slightly incorrectly located camera. Sometimes refered to as perspective correction.<br />
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/vcmohan/Reform/Reform.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| [[Reformer]]<br />
| Perspective correction and warping.<br />
| Any<br />
| [http://www.avisynth.nl/users/vcmohan/Reformer/Reformer.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| [http://avisynth.org.ru/rotate/rotate.html Rotate]<br />
| Rotate or shear on any given angle. See [http://forum.doom9.org/showthread.php?t=131307 discussion.]<br />
| [[RGB32]], [[YV12]]<br />
| [http://avisynth.org.ru/rotate/rotate134.zip Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
| [http://www.avisynth.nl/users/vcmohan/Spinner/Spinner.html Spinner]<br />
| Spinner plugin rotates a frame or selected part of it about the given axis coordinates in floating point precision.<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/vcmohan/Spinner/Spinner.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=166087 xyremap]<br />
|xyremap is a filter for remapping pixels using formulae written in [http://en.wikipedia.org/wiki/Reverse_Polish_notation reverse Polish notation].<br />
|[[RGB32]]<br />
|[http://horman.net/avisynth/download/xyremap0.3.zip Plugin]<br />
|{{Author/David Horman}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=49429 Zoom]<br />
| Zoom, Pan & Rotate Clip. Adds alpha layer to clip.<br />
| [[RGB32]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/zoom_5F25_dll_20050122.zip Plugin]<br />
| {{Author/WarpEnterprises}}<br />
|}<br />
<br />
=== Subtitling ===<br />
<br />
{{FilterTable}}<br />
| AssRender<br />
| Libass-based subtitle renderer. See [http://forum.doom9.org/showthread.php?t=148926 discussion]. [http://github.com/pingplug/assrender Updated version]; only source code available. <br />
| [[RGB32]], [[RGB24]], [[YV24]], [[YV12]], [[Y8]]<br />
| [http://srsfckn.biz/assrender/ C Plugin] <!--[http://encodan.srsfckn.biz/assrender/ C Plugin] - dead link ---><br />
| lachs0r, TheFluff<br />
|-<br />
|[https://github.com/slavanap/ssifSource sub3d]<br />
|Plugin for rendering subtitles on 3D video with correct depth.<br />
|[[RGB32]]<br />
|[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] <br />
|slavanap<br />
|-<br />
| [http://web.archive.org/web/20071025023938/http://mvideo.ddpp.net/eng/subtitleex_plugin.htm SubtitleEx]<br />
| 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. [http://hosiken.jp/dev/win/subtitleex.html Plugin update (Japanese)]<br />
| [[RGB32]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/subtitleex_5F25_dll_20040819.zip Plugin] / [http://avisynth.nl/users/warpenterprises/files/dvutilities_20050717.zip .chm (help)]<br />
|[http://web.archive.org/web/20070821222318/http://mvideo.ddpp.net/eng/index.htm basilik]<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=119390 SUPtext]<br />
|Overlays SUP-subtitles on a video clip.<br />
|[[RGB32]], [[YV12]]<br />
|[http://forum.doom9.org/attachment.php?attachmentid=7846&d=1196858433 Plugin]<br />
|emmel<br />
|-<br />
| [http://www.zachsaw.com/?pg=suptitle_pgs_avisynth_plugin SupTitle]<br />
| Blu-ray PGS .SUP Subtitle Renderer Plugin for AviSynth. See [http://forum.doom9.org/showthread.php?t=148167 discussion] <br />
| [[YV12]]<br />
| [http://www.zachsaw.com/?pg=suptitle_pgs_avisynth_plugin Plugin]<br />
| {{Author/ZachSaw}}<br />
|-<br />
| [http://avisynth.org.ru/docs/english/externalfilters/vsfilter.htm VSFilter]<br />
| 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]<br />
| <br />
| [http://sourceforge.net/project/showfiles.php?group_id=205650&package_id=246121&release_id=541232 Plugin]<br />
|<br />
|-<br />
| [http://web.archive.org/web/20141227072702/https://code.google.com/p/vsfiltermod/ VSFilterMod]<br />
| VSFilterMod is modification of original VSFilter subtitle renderer by Gabest. This mod brings up new features and some minor bugfixes. <br />
|<br />
| [http://web.archive.org/web/20141227072702/https://code.google.com/p/vsfiltermod/ Plugin]<br />
|<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=168282 xy-VSFilter]<br />
|High performance VSFilter compatible subtitle filters. [http://web.archive.org/web/20151213235432/http://code.google.com/p/xy-vsfilter/ Google Code repository]<br />
|<br />
|[http://forum.doom9.org/showthread.php?t=168282 Plugin]<br />
|cyberbeing<br />
|}<br />
<br />
=== Transitions ===<br />
<br />
{{FilterTable}}<br />
| DissolveAGG<br />
| Wipe Transition with a soft edge. See [http://forum.doom9.org/showthread.php?t=118016 discussion]. <br />
'''Note:''' There exist multiple variants of the script as the result of the interaction between authors in that discussion.<br />
| <br />
| [http://forum.doom9.org/showthread.php?p=900674#post900674 Script (v1)] <br />
[http://forum.doom9.org/showthread.php?p=1152440#post1152440 Script (v2)] <br />
[http://forum.doom9.org/showthread.php?p=1152632#post1152632 Script (v3)] <br />
| {{Author/zemog}}, {{Author/mikeytown2}}, {{Author/Gavino}} and others<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=62277 JDL_MaskTransition]<br />
| 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.<br />
| <br />
| [http://avisynth.nl/users/stickboy/jdl-effects.avsi Script]<br />
| {{Author/stickboy}}<br />
|-<br />
| [[TransAll]]<br />
| Around 150 distinct transitions can be created with this plugin. <br />
| [[RGB]], [[YUY2]], [[YV12]]<br />
| [http://avisynth.nl/users/vcmohan/TransAll/TransAll.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| Transition (Albert Gasset)<br />
| Various Wipe and Random Block modes. Has 19 built in patterns or it can use an external file.<br />
| <br />
| [http://avisynth.nl/users/warpenterprises/#transition Plugin]<br />
| {{Author/Albert Gasset}}<br />
|-<br />
| Transition (shubin)<br />
| Contains 2 modes: circle and line. In circle mode the area has radius R and center xCenter,yCenter. In line mode the line passes through xCenter,yCenter with slope R.<br />
| <br />
| [http://avisynth.nl/users/warpenterprises/#transition Plugin]<br />
| {{Author/shubin}}<br />
|}<br />
<br />
== Other Filters ==<br />
<br />
=== Debugging/Diagnostic Filters ===<br />
<br />
{{FilterTable}}<br />
| AVInfo<br />
| 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. <br />
| <br />
| [http://www.avisynth.nl/users/warpenterprises/files/avinfo_5F25_dll_20050417.zip Plugin]<br />
| trevlac, wilbert <br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=170647 Avisynth Info Tool]<br />
|This program gathers all available info about the installed Avisynth version. It should be useful for troubleshooting since especially novice users don't always know which Avisynth version they have installed, what DLLs/DLL-versions reside in their plugin directory, etc. The tool also helps resolve problems with plugin DLL dependencies like missing Microsoft runtime libraries.<br />
|<br />
|<br />
|Groucho2004<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=165528 AVSMeter]<br />
| AVSMeter is a CLI (command line interface) tool that "runs" an Avisynth script with virtually no overhead, displays clip info, CPU and memory usage and the minimum, maximum and average frames processed per second. It measures how fast Avisynth can serve frames to a client application (x264, for example) and comes in handy when testing filters/plugins to evaluate their performance and memory requirements.<br />
|<br />
| Command line executable<br />
| Groucho2004<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=116949 ColorDiff]<br />
|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. Documentation is at the beginning of the source file. This is a [http://avisynth.nl/index.php/Plugins#LoadCPlugin C Plugin!]<br />
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]] <br />
|[http://forum.doom9.org/attachment.php?attachmentid=7811&d=1196110203 C Plugin]<br />
|Ignus2<br />
|-<br />
| [[DumpPixelValues]]<br />
| 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.]<br />
| [[RGB32]], [[YUY2]]<br />
| [http://www.theneitherworld.com/mcpoodle/Tools/DumpPixelValues.zip Plugin]<br />
| [http://www.theneitherworld.com/mcpoodle/Tools/index.html McPoodle]<br />
|-<br />
|[[GrainEvaluate]]<br />
| A script to analyze and log the strength of grain for each frame. See [http://forum.doom9.org/showthread.php?t=167455 discussion.]<br />
| [[YV12]]<br />
|[http://www.nmm-hd.org/upload/get~-eJfUjEXJY4/GrainEvaluate.avsi Script]<br />
|{{Author/06_taro}}<br />
|-<br />
| [http://forum.doom9.org/showpost.php?p=1462931&postcount=81 Glitch Analyzer]<br />
| Glitch Analyzer generates a diagnostic video, then analyzes the recorded version of it, to detect swapped, dropped, or repeated fields.<br />
| [[YUY2]], [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?p=1467907#post1467907 Script]<br />
| jmac698<br />
|-<br />
| [[Grid]]<br />
| Overlays a grid, useful for pixel counting.<br />
| Any<br />
| [http://www.avisynth.nl/users/vcmohan/Grid/Grid.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| [http://web.archive.org/web/20160610124531/http://code.google.com/p/avisynthrestoration/wiki/Measure Measure]<br />
| Measures luminence of greyscale bars and prints results on-screen. Can be used to set brightness/contrast in capture settings accurately.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20151223052318/https://code.google.com/p/avisynthrestoration/downloads/list Script]<br />
| halifaxgeorge<br />
|-<br />
|[http://github.com/lcferrum/segment-display-ocr SegmentDisplayOCR]<br />
|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.<br />
| [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://sourceforge.net/projects/segmentdisplayocr/files/SegmentDisplayOCR/ Plugin]<br />
|[http://github.com/lcferrum lcferrum]<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=61128 SSIM]<br />
|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.<br />
|[[YV12]]<br />
|[http://web.archive.org/web/20070129114000/http://perso.orange.fr/reservoir/dl/SSIM-0.24.rar Plugin] / [http://web.archive.org/web/20070129115059/http://perso.orange.fr/reservoir/dl/SSIMSrc-0.24.rar source]<br />
|[http://web.archive.org/web/20060507012947/http://perso.wanadoo.fr/reservoir/ Lefungus]<br />
|-<br />
| [[ShowPixelValues]]<br />
| 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.]<br />
| [[RGB32]], [[YUY2]]<br />
| [http://web.archive.org/web/20091028122947/http://geocities.com/siwalters_uk/showpixelvalues1.4c.zip Plugin]<br />
| {{Author/Simon Walters}}<br />
|-<br />
| [http://web.archive.org/web/20151223052321/http://code.google.com/p/avisynthrestoration/wiki/Testpatterns Testpatterns]<br />
| This filter creates a sinewave frequency sweep directly in YV12, useful to measuring video response.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20151223052318/https://code.google.com/p/avisynthrestoration/downloads/list Script]<br />
| halifaxgeorge<br />
|-<br />
| [http://avisynth.org.ru/docs/english/externalfilters/tmonitor.htm TMonitor]<br />
| 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.<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TMonitorv094.zip Plugin]<br />
|{{Author/tritical}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=53238 ViewFields/UnViewFields]<br />
| [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]<br />
| <br />
| Plugin<br />
| {{Author/Simon Walters}}<br />
|-<br />
| [[Comptest]]<br />
| The script Compressibility test can be used for a compressibility test on a clip.<br />
|<br />
| Script<br />
|<br />
|-<br />
| [[SeeTheDifference]]<br />
| 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.<br />
|<br />
| Script<br />
|<br />
|}<br />
<br />
=== Edge Detection ===<br />
<br />
{{FilterTable}}<br />
| [[aWarpsharp2/aSobel|aSobel]]<br />
| Sobel edge dectecion filter included in [[aWarpSharp2]]. <br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
| [[aWarpSharp2| Plugin]]<br />
| {{Author/SEt}}<br />
|-<br />
|[[MaskTools2/Mt edge| mt_edge]]<br />
| Edge detection filter included in [[MaskTools2]].<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [[MaskTools2|Plugin]]<br />
| {{Author/Manao}}<br />
|-<br />
| [[tcanny]]<br />
| Contains a canny edge detection filter and distance transform filter.<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20140804144614/http://bengal.missouri.edu/~kes25c/tcanny.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[TCannyMod]]<br />
| Canny edge detection filter for Avisynth 2.6. Reimplementation of tcanny. See [http://forum.doom9.org/showthread.php?t=168449 discussion]<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://github.com/chikuzen/TCannyMod/releases/ Plugin]<br />
| {{Author/Chikuzen}}<br />
|-<br />
| [[TEdgeMask]]<br />
| TEdgeMask creates an edge mask based off gradient vector magnitude.<br />
| [[YUY2]], [[YV12]]<br />
| [http://web.archive.org/web/20151125175557/http://bengal.missouri.edu/~kes25c/TEdgeMaskv09.zip Plugin]<br />
| {{Author/tritical}}<br />
|-<br />
| [[TEMmod]]<br />
| 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]<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://github.com/chikuzen/TEMmod/releases Plugin]<br />
| {{Author/Chikuzen}}<br />
|}<br />
<br />
=== Export Filters ===<br />
<br />
These filters can write directly to media files. <br />
<br />
{{FilterTable}}<br />
| [http://forum.doom9.org/showthread.php?t=135928 Immaavs]<br />
| ImmaWrite uses the ImageMagick libraries to write images. Many formats are supported including animations and multipage files.<br />
| <br />
| [http://www.geocities.com/wilbertdijkhof/ Plugin]<br />
| {{author/Wilbert Dijkhof}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=172837 TWriteAVI]<br />
| 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].<br />
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]<br />
| [http://www.mediafire.com/download/84csi0174ettu5l/TWriteAVI_dll_v2.03-20160603.zip Plugin]<!--[http://www.mediafire.com/download/c5iboqi43ijprap/TWriteAVI_dll_v2.02-20160106.zip older version]--><br />
| {{Author/tritical}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?p=1403600 Sashimi]<br />
(function "RawWriter")<br />
| 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]].<br />
| [[RGB]], [[YUY2]],[[YV12]]<br />
| [http://sites.google.com/site/ourenthusiasmsasham/soft Plugin with scripts]<br />
| [http://sites.google.com/site/ourenthusiasmsasham/ PitifulInsect]<br />
|-<br />
| [[SoundOut]]<br />
| SoundOut is a GUI driven sound file output module for AviSynth (it exports audio to several compressors).<br />
| All audio.<br />
| [[SoundOut|Plugin]]<br />
| {{Author/Sh0dan}}<br />
|}<br />
<br />
=== Import Filters ===<br />
<br />
These filters are used to import filters written for other audio and video packages.<br />
<br />
{{FilterTable}}<br />
| [http://forum.doom9.org/showthread.php?threadid=92174 FreeFrame]<br />
| Allows [http://freeframe.sourceforge.net/ freeframe] filters (mostly effects) to be used directly in AviSynth.<br />
| [[RGB24]], [[RGB32]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/freeframe_5F25_dll_20050426.zip Plugin]<br />
| {{Author/Myrsloik}}<br />
|}<br />
<br />
=== Meta-Filters ===<br />
<br />
These filters are primarily designed to be used with other filters, to restrict or augment their effect.<br />
<br />
{{FilterTable}}<br />
|[http://forum.doom9.org/showthread.php?t=164407 AVSTP]<br />
|A library for multithreaded plug-in development<br />
|Any<br />
|[http://forum.doom9.org/showthread.php?t=164407 Plugin]<br />
|{{Author/cretindesalpes}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=163281 MP_Pipeline]<br />
|Run parts of an AviSynth script in external processes.<br />
|Any<br />
|[http://forum.doom9.org/showthread.php?t=163281 Plugin]<br />
|[http://github.com/SAPikachu/ SAPikachu]<br />
|-<br />
| [[MT]]<br />
| 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]<br />
| Any<br />
| [http://www.avisynth.nl/users/warpenterprises/files/mt_20070301.zip Plugin]<br />
| tsp<br />
|-<br />
| [[MVTools]] <br />
| 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]<br />
| [[YUY2]], [[YV12]]<br />
| [[MVTools|Plugin]]<br />
| {{Author/Fizick}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=164073 SoraThread]<br />
|Sora's avs multi-process/multi-thread plugin package<br />
|Any<br />
|[http://forum.doom9.org/showthread.php?t=164073 Plugin]<br />
|leiming2006<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=154886 ThreadRequest]<br />
|Yet another plugin for multithread processing. [http://web.archive.org/web/20130124045626/http://lantis.homeunix.org/avisynth.shtml Archive homepage (Japanese)]<br />
|Any<br />
|[http://www.mediafire.com/download/4xux7d7l1u3toy8/ThreadRequest+102a.rar Plugin]<br />
|lantis<br />
|}<br />
<br />
=== Multipurpose Filters ===<br />
<br />
{{FilterTable}}<br />
| [http://forum.doom9.org/showthread.php?t=166061 HybridFuPP]<br />
| An adaptive processor, allowing picture cleaning and compressibility gain. Original [http://forum.doom9.org/showthread.php?t=146632 discussion.]<br />
| [[YV12]]<br />
| [http://www.mediafire.com/download/6g09aazs4z7m11a/HybridFuPP_0.992b.zip Script]<br />
| Fupp<br />
|-<br />
| [[MaskTools2]]<br />
| This plugin provides tools for the creation, enhancement and manipulation of masks for each [[YUV]] component.<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]]<br />
| [http://avisynth.nl/index.php/MaskTools2#Download Plugin]<br />
| {{Author/Manao}}, {{Author/tp7}}<br />
|-<br />
| [[MVTools]]<br />
| This plugin provides a collection of functions for motion estimation and compensation.<br />
| [[YV12]], [[YUY2]]<br />
| [http://avisynth.org.ru/mvtools/mvtools2.html Plugin]<br />
| Various<br />
|}<br />
<br />
=== Scene Change Detection ===<br />
<br />
{{FilterTable}}<br />
|[http://forum.doom9.org/showthread.php?t=171624 DBSC]<br />
|A scene change detection tool set/kit/box (work-in-progress).<br />
|All<br />
|[http://forum.doom9.org/showthread.php?t=171624 Script]<br />
|{{Author/StainlessS}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=145143 EDLmaker]<br />
| Simple scenechange detector that writes to EDL file.<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=145143 Script]<br />
| Mug Funky<br />
|-<br />
| [[MVTools2/MSCDetection|MSCDetection]]<br />
| Part of MVTools2; MSCDetection creates a scene detection mask clip from motion vectors data. <br />
| [[YV12]], [[YUY2]]<br />
| [[MVTools|Plugin]]<br />
| {{Author/Fizick}}<br />
|-<br />
| SCDetect<br />
| Detect scene change and output scene change frames to a file.<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20140614152525/http://www.nmm-hd.org/upload/get~TfPm2QO4jbk/SCDetect_v0.3.rar Script]<br />
| {{Author/06_taro}}<br />
|-<br />
| [http://akuvian.org/src/avisynth/sclavc/readme.txt SceneChangeLavc]<br />
| SClavc is an AviSynth plugin intended to allow access to libavcodec's scene-change metrics. See [http://akuvian.org/src/avisynth/sclavc/ homepage.]<br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/scenechangelavc_5F25_dll_20041201.zip Plugin]<br />
| {{Author/akupenguin}}<br />
|-<br />
| [[SCXvid]]<br />
| 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.<br />
| [[YV12]]<br />
| [http://dl.dropbox.com/s/402hlckyn669p9n/SCXvid-1.1.rar Plugin]<br />
| {{Author/Myrsloik}}<br />
|-<br />
| [[SCXvidMask]]<br />
| A tiny AviSynth plugin that reads an SCXvid log and creates a binary mask based on it.<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://github.com/tp7/SCXvidMask/releases Plugin]<br />
| {{Author/tp7}}<br />
|}<br />
<br />
=== Support filters ===<br />
<br />
These filters are primarily designed to augment the creation of custom script-based filters.<br />
<br />
{{FilterTable}}<br />
| [[ApplyInterlacedFilter]]<br />
| ApplyInterlacedFilter safely processes interlaced video with spatial and temporal filters.<br />
|<br />
| Script<br />
|<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=162874 ArcFuns]<br />
|This plugin expands the available numerical functions with missing inverse trig functions.<br />
|N/A<br />
|[http://forum.doom9.org/attachment.php?attachmentid=12494&d=1319627190 Plugin]<br />
|{{Author/Gavino}}<br />
|-<br />
|[http://github.com/tp7/AvsMotion#avsmotion AvsMotion]<br />
|AviSynth plugin for animating clips with AAE motion tracking data.<br />
| [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://github.com/tp7/AvsMotion/releases Plugin]<br />
|{{Author/tp7}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=46506 Call]<br />
| Call an external program from the script.<br />
| N/A<br />
| [http://avisynth.nl/users/warpenterprises/files/call_5F25_dll_20030310.zip Plugin]<br />
| Nic, DDogg<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=166063 CallCmd]<br />
|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].<br />
|N/A<br />
|[http://www.mediafire.com/download/i6m7wffyi3dftxx/CallCmd_25_dll_v1.02_20130101.zip Plugin]<br />
|StainlessS<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=173538 ClipBoard]<br />
|Get text from Clipboard.<br />
|N/A<br />
|[http://www.mediafire.com/download/qct5uj786ub28to/ClipBoard_25_dll_v0.01_20160530.zip Plugin]<br />
|StainlessS<br />
|-<br />
| FrameCache<br />
| Frame cache plugin. It helps greatly increase performance, especially in combination with another plugins, like SmoothDeinterlace. Usage FrameCache( [number of frames to remember], (path to log file) ). <br />
| any<br />
| johny5 dot coder via gmail<br />
| {{Author/Evgeny}} <br />
|-<br />
| GetSystemEnv<br />
| An AviSynth plug-in to retrieve information from the system. <br />
| N/A<br />
| [http://www.avisynth.nl/users/stickboy/GetSystemEnv.zip Plugin]<br />
| {{Author/stickboy}}<br />
|-<br />
| [[GRunT]]<br />
| Extends AviSynth's [[Runtime_environment|Runtime Environment]], making it easier to use, especially inside script functions.<br />
| Any<br />
| [http://forum.doom9.org/showthread.php?t=139337 Plugin]<br />
| {{Author/Gavino}}<br />
|-<br />
| [[GScript]]<br />
| Extends the Avisynth scripting language to provide additional control-flow constructs: multi-line conditionals (if-then-else blocks), 'while' loops and 'for' loops.<br />
| Any<br />
| [http://forum.doom9.org/showthread.php?t=147846 Plugin]<br />
| {{Author/Gavino}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=119200 LoadDLL]<br />
| Used to manually load dll files in AviSynth. Useful if a filter relies on an external dll that is not in the system PATH.<br />
| N/A<br />
| [http://www.avisynth.nl/users/tsp/LoadDll.zip Plugin]<br />
|{{Author/tsp}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=97748 PlaneMinMax]<br />
| Frame-based YV12 plane Min/Max/Avg functions without [[ConditionalFilter]].<br />
| [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/planeminmax_5F25_dll_20050727.zip Plugin]<br />
| Bart Silverstein<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=83451 pop]<br />
|A filter to get values from variables that may not yet be initialized.<br />
|Any<br />
|[http://www.tsp.person.dk/pop.zip Plugin] <!--[http://web.archive.org/web/20160224093903/http://www.tsp.person.dk/pop.zip archived]--><br />
|{{Author/tsp}}<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=165479 Rt_Stats]<br />
| Compile-time/Runtime Functions.<br />
| N/A<br />
| [http://www.mediafire.com/folder/hb26mthbjz7z6/StainlessS Plugin] [http://www.sendspace.com/folder/2mwrco mirror]<br />
| StainlessS<br />
|}<br />
<br />
=== Deepcolor Filters ===<br />
(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)<br />
{{FilterTable}}<br />
| [[Dither_tools|Dither]]<br />
| 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.<br />
| [[Planar]] colorspaces<br />
| [http://forum.doom9.org/showpost.php?p=1386559&postcount=3 Plugin + scripts]<br />
| {{Author/cretindesalpes}} <br />
|}<br />
<br />
=== 3D Filters ===<br />
<br />
{{FilterTable}}<br />
| [http://web.archive.org/web/20110809073332/http://arenafilm.hu/alsog/anaglyph/ Analglyph]<br />
| 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.<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [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]<br />
| {{Author/Kertai Gábor}}<br />
|-<br />
| Anaglypher <br />
| A plugin for combining stereopairs into single anaglyph image.<br />
| [[RGB32]], [[RGB24]]<br />
| [http://shura.luberetsky.ru/anaglypher/Anaglypher.zip Plugin]<br />
| [http://shura.luberetsky.ru/ Shura Luberetsky]<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=162616 Displace / McM_2D_to_3D]<br />
|Plugin and script that enables you to convert 2d to 3d stereo with bidirectional pulfrich effect + add depth to stationary objects.<br />
|[[RGB32]]<br />
|[http://forum.doom9.org/showthread.php?t=162616#post1539121 Plugin/Script]<br />
|Mcmount<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=143855 fauxD]<br />
|2D to stereo-3D conversion in real-time.<br />
|[[RGB24]], [[RGB32]]<br />
|[http://forum.doom9.org/attachment.php?attachmentid=9278&d=1232092731 Plugin]<br />
|eslave<br />
|-<br />
| [http://www.pantarheon.org/AviSynth3DToolbox/ Pantarheon 3D AviSynth Toolbox]<br />
| 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.<br />
| [[YUY2]], [[YV12]]<br />
| [http://www.pantarheon.org/AviSynth3DToolbox/zip/ Script]<br />
| [http://www.pantarheon.org/ G. Adam Stanislav]<br />
|}<br />
<br />
=== Libraries ===<br />
<br />
{{FilterTable}}<br />
|[http://avslib.sourceforge.net/ AVSLib]<br />
|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.<br />
|<br />
|[http://sourceforge.net/projects/avslib/ AVSLib]<br />
|[http://gzarkadas.users.sourceforge.net/ gzarkadas]<br />
|}<br />
<br />
<br />
== Audio Filters ==<br />
<br />
{{FilterTable}}<br />
| [[AddAudio]]<br />
| A function that adds silent audio to a clip. Needed for CCE 2.50 users.<br />
| N/A<br />
| Script<br />
|<br />
|-<br />
| [[AudioGraph]]<br />
| 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. [http://forum.doom9.org/showthread.php?t=59412 Doom9 discussion]. Ihor Bobalo added a few additional features to AudioGraph, only the source code is provided: [http://sourceforge.net/projects/audiograph/ SourceForge repository].<br />
| [[RGB32]], [[RGB24]], [[YUY2]]<br />
| [http://web.archive.org/web/20060517015407/http://beta.zenaria.com/kpo/avisynth/AudGraph_25.zip Plugin]<br />
| Richard Ling, {{author/Sh0dan}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=108470 AudioLimiter]<br />
| To increase volume for silent sounds a lot, to increase volume for middle-volume sounds a little and to keep hi-volume sounds untoched.<br />
| N/A<br />
|[http://forum.doom9.org/attachment.php?attachmentid=6586&d=1167241138 Plugin]<br />
|dimzon<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=171813 AudioTimeline]<br />
|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.<br />
|[[RGB24]], [[RGB32]], [[Y8]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://forum.doom9.org/showthread.php?t=171813 Plugin]<br />
|martin53<br />
|-<br />
| BeFa <br />
| Band Eliminate Filter for Audio. See [http://web.archive.org/web/20071105084352/http://www.geocities.com/fredthompson6/Kiraru2002/Kiraru2002sROOM.htm#Befa English documentation] (translated from the original [http://web.archive.org/web/20081122113014/http://kiraru2002.at.infoseek.co.jp/#befa Japanese documentation]).<br />
| N/A<br />
| [http://www.avisynth.nl/users/warpenterprises/files/befa_5F25_dll_20030924.zip Plugin]<br />
| {{Author/kiraru2002}}<br />
|-<br />
| [[FindAudioSyncScript]]<br />
| FindAudioSyncScript helps you to find the appropriate audio delays, if you have desync'ed audio.<br />
| N/A<br />
| Script<br />
| IanB<br />
|-<br />
| MinMaxAudio<br />
| 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[http://forum.doom9.org/showpost.php?p=1197592&postcount=19]. It's a conditional audio filter, so the computation is done framewise. See [http://forum.doom9.org/showthread.php?t=127530 discussion]<br />
| N/A<br />
| [http://www.wilbertdijkhof.com/MinMaxAudio_v02.zip Plugin]<br />
| {{author/Wilbert Dijkhof}}<br />
|-<br />
|Normalize2<br />
|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).<br />
|N/A<br />
|[http://sourceforge.net/projects/jorydownloader/files/Normalize2%20for%20AviSynth/Normalize%20v0.1%20for%20AviSynth%202.5/ Plugin]<br />
|[http://sourceforge.net/u/jcsston/profile/ jcsston]<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=104792 Sox Audio Effect Filter]<br />
| Use [http://sox.sourceforge.net/ SOX] effects within AviSynth. Most effects are supported, and multiple effects can be stacked after each other.<br />
| N/A<br />
| [http://forum.doom9.org/showthread.php?p=761154#post761154 Plugin]<br />
| {{author/Sh0dan}}<br />
|-<br />
|[[Spectrogram]]<br />
|Linear [http://en.wikipedia.org/wiki/Spectrogram spectrogram] for AviSynth 2.6.<br />
|Any<br />
|[http://www.dropbox.com/s/9p2t1mv5t5yjpgd/Spectrogram_r5.7z?dl=1 Plugin]<br />
|[http://github.com/innocenat innocenat]<br />
|-<br />
|SwitchByAudio<br />
|Plugin to switch video source based on audio. See [http://forum.doom9.org/showthread.php?t=167011 discussion]<br />
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]] <br />
|[http://www.avisynth.nl/users/vcmohan/SwitchByAudio/SwitchByAudio.zip Plugin]<br />
|{{Author/vcmohan}}<br />
|-<br />
|[http://forum.doom9.org/showpost.php?p=1722472&postcount=20 TimeStretchPlugin]<br />
|[[TimeStretch]] with multichannel support and updated SoundTouch library. <br />
|N/A<br />
|[http://www.wilbertdijkhof.com/TimeStretch_v258.zip Plugin]<br />
|{{Author/Wilbert Dijkhof}}<br />
|-<br />
| [[ViewAudio]]<br />
| Includes two filters: ViewAudio and CacheAudio. <br />
| [[YUY2]], [[YV12]]<br />
| [http://nullinfo.s21.xrea.com/data/ViewAudio0301.zip Plugin] <!--[http://www.avisynth.nl/users/warpenterprises/files/viewaudio_5F25_dll_20031103.zip Plugin]--><br />
| {{Author/minamina}}<br />
|-<br />
| [[Waveform]]<br />
| Displays audio waveforms superimposed on the video, similar to AudioGraph below but with multi-channel support and consistent support for all colourspaces. See [http://forum.doom9.org/showthread.php?t=165703 discussion]<br />
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]] <br />
| [http://horman.net/avisynth/download/waveform0.3.zip Plugin]<!--[https://web.archive.org/web/20130413095328/http://horman.net/waveform0.2.zip archived]--><br />
| {{Author/David Horman}}<br />
|}<br />
<br />
== As Yet Unclassified ==<br />
<br />
{{FilterTable}}<br />
| [http://forum.doom9.org/showthread.php?p=397426#post397426 Adjust]<br />
| Generic Y-Channel mapping. Can define a function for the Y Channel. See [http://forum.doom9.org/showthread.php?p=397426 discussion.]<br />
| [[RGB24]], [[RGB32]], [[YUY2]]<br />
| [http://avisynth.nl/users/warpenterprises/files/adjust_5F25_dll_20031110.zip Plugin]<br />
| [http://avisynth.nl/users/warpenterprises/ WarpEnterprises]<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=166588 Adaptive Lens Blur Repair]<br />
|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.<br />
|[[YV12]]<br />
| [http://forum.doom9.org/attachment.php?attachmentid=13154&stc=1&d=1354907363 Script]<br />
| fvisagie<br />
|-<br />
|[http://forum.doom9.org/showpost.php?p=1703332&postcount=172 amp]<br />
|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.<br />
| [[RGB24]], [[RGB32]], [[YUY2]], [[YV12]]<br />
| [http://horman.net/avisynth/amp.zip Plugin]<br />
| {{Author/David Horman}}<br />
|-<br />
|[http://github.com/Xenoveritas/AviSynth-Stuff/tree/master/AutoTrace AutoTraceFilter]<br />
|An intentionally useless plugin that uses [http://autotrace.sourceforge.net/ AutoTrace] to trace and then resize a source video, rendering the result using GDI+.<br />
|[[RGB24]]<br />
| [http://github.com/Xenoveritas/AviSynth-Stuff/tree/master/AutoTrace Plugin]<br />
| [http://github.com/Xenoveritas Xenoveritas]<br />
|-<br />
|[http://nutbread.github.io/ave/ ave]<br />
| A set of experimental audio/video filters.<br />
| [[RGB24]], [[RGB32]]<br />
| [http://nutbread.github.io/ave/ Plugin]<br />
| [http://github.com/nutbread nutbread]<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=172698 AviSynth Shader]<br />
|This plugin allows running HLSL pixel shaders within AviSynth. This gives access to various HLSL filters that haven't been programmed in AviSynth.<br />
|[[RGB32]], [[YV24]], [[YV12]]<br />
|[http://github.com/mysteryx93/AviSynthShader Plugin]<br />
|[http://github.com/mysteryx93 MysteryX]<br />
|-<br />
| [http://forum.doom9.org/showthread.php?p=675275#post675275 BeforeAfter]<br />
| 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.)<br />
| any<br />
| Script<br />
| Corran<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=158696 ccc]<br />
|A plugin specifically designed for Cross-Conversion Correction.<br />
|[[YV12]]<br />
|[http://web.archive.org/web/20150403181720/http://japland.org/ccc/ccc_v0.4a_avs.zip Plugin]<br />
|Daemon404<br />
|-<br />
|[http://github.com/tp7/CLExpr CLExpr]<br />
|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. More information [http://forum.doom9.org/showpost.php?p=1672638 here].<br />
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://github.com/tp7/CLExpr/releases Plugin]<br />
|{{Author/tp7}}<br />
|-<br />
| [http://www.avisynth.nl/users/vcmohan/ColorIt/ColorIt.html Colorit]<br />
| Color a black and white image or recolor a color image. See [http://forum.doom9.org/showthread.php?t=93990 discussion.]<br />
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/vcmohan/ColorIt/Colorit.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| CutFrames<br />
| Cut a range of frames from a single a/v clip. Opposite of Trim with extras.<br />
| <br />
| [http://forum.doom9.org/showthread.php?t=135423 Script]<br />
| mikeytown2<br />
|-<br />
| DCT<br />
| Plugin with the following functions: IDCT, IDCT2, FDCT, FDCT2. See [http://forum.doom9.org/showthread.php?p=667382#post667382 discussion]<br />
| [[YUY2]]<br />
| [http://alainmuchembled.free.fr/DCT.zip Plugin]<br />
| lcld<br />
|-<br />
| [http://forum.doom9.org/showthread.php?p=1444027#post1444027 DDigit]<br />
| DDigit Plugin Text Rendering Pack for Plugin writers. See [http://forum.doom9.org/showthread.php?t=156888 discussion.]<br />
|<br />
| [http://www.mediafire.com/download/bfhj5crwaxbupeh/DDigitTest_25%2626_v1-06_dll_20150330-RECOMPILE.zip Plugin]<br />
| {{Author/StainlessS}}<br />
|- <br />
| [http://forum.doom9.org/showthread.php?t=80419 DeBlot]<br />
| Color Blot Reduction. <br />
| [[YUY2]],[[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/deblot_5F25_dll_20030628.zip Plugin]<br />
| {{Author/minamina}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=95193 DeJump]<br />
| This is a specific filter which might be used to stabilize some "jumpy" video sources captured from VHS. <br />
|[[YUY2]]<br />
| [http://forum.doom9.org/attachment.php?attachmentid=3988&d=1117479069 Plugin]<br />
| dinstun<br />
|-<br />
| [http://avisynth.org.ru/exinpaint/exinpaint.html ExInpaint]<br />
| Exemplar-Based Image Inpainting - removing large objects from images. <br />
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]<br />
| [http://avisynth.org.ru/exinpaint/exinpaint0200.zip Plugin]<br />
| {{Author/Fizick}}<br />
|-<br />
|[[FFAvisynth]]<br />
| A plugin which lets you directly use [http://en.wikipedia.org/wiki/Ffdshow ffdshow] video and audio filters from AviSynth scripts. <br />
| [[YV12]], [[YUY2]], [[RGB24]], [[RGB32]]<br />
| [http://sourceforge.net/projects/ffdshow-tryout/ Plugin]<br />
| Milan Cutka <br />
|-<br />
|[http://github.com/Youka/FLuaG FLuaG]<br />
| 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] <br />
| [[RGB32]]<br />
| [http://github.com/Youka/FLuaG/archive/master.zip Plugin]<br />
| [http://github.com/Youka Youka]<br />
|-<br />
| [http://forum.doom9.org/showthread.php?t=150291 FritzPhoto]<br />
| Use Avisynth to process still images.<br />
| <br />
| [http://forum.doom9.org/showthread.php?t=150291 FritzPhoto]<br />
|<br />
|-<br />
|[http://forum.doom9.org/showthread.php?p=1600151#post1600151 FSubstitute]<br />
|Tries to automate the task of replacing bad frames using adjacent or close-by frames.<br />
|[[YV12]]<br />
|[http://forum.doom9.org/showthread.php?p=1600151#post1600151 Script]<br />
|martin53<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=130611 GrainOptimizer]<br />
|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]<br />
|[[YV12]]<br />
|[http://web.archive.org/web/20081228144846/http://mirror05.x264.nl/Dark/force.php?file=./GrainOptimizer_2.02.zip Plugin]<br />
|Dark Shikari<br />
|-<br />
|[http://github.com/Khanattila/KPassFilterCL KPassFilterCL]<br />
|KPassFilterCL is a set of tools in the frequency domain.<br />
|[[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
|[http://github.com/Khanattila/KPassFilterCL/releases Plugin]<br />
|[http://github.com/Khanattila Khanattila ]<br />
|-<br />
|[http://github.com/Youka/LVS LVS]<br />
| 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] <br />
| [[RGB32]], [[RGB24]]<br />
| [http://sourceforge.net/projects/lua-video-sync/files/ Plugin]<br />
| [http://github.com/Youka Youka]<br />
|-<br />
| [http://www.avisynth.nl/users/vcmohan/NeuralNet/NeuralNet.html NeuralNet]<br />
| Neural networks through back propagation learn and filter some types of noise. Classification and linear type networks are included.<br />
| [[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]<br />
| [http://www.avisynth.nl/users/vcmohan/NeuralNet/NeuralNet.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
| PseudoColor <br />
| 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.]<br />
| [[RGB32]], [[RGB24]], [[YV12]]<br />
| [http://www.avisynth.nl/users/warpenterprises/files/pseudocolor_5F25_dll_20030919.zip Plugin]<br />
| Shubin<br />
|-<br />
|[http://github.com/jeremypoulter/QRCodeSource QRCodeSource]<br />
|AviSynth plugin to provide a means to embed QR codes in video.<br />
|[[RGB32]]<br />
|[http://github.com/jeremypoulter/QRCodeSource/releases Plugin]<br />
|[http://github.com/jeremypoulter jeremypoulter]<br />
|-<br />
|RemoveDeadPixels<br />
|See [http://forum.doom9.org/showthread.php?p=699915#post699915 here] and [http://videoprocessing.fr.yuku.com/topic/27/Removedeadpixels here].<br />
|[[YUY2]]<br />
|[http://home.arcor.de/kassandro/RemoveDeadPixels.rar Plugin]<br />
|{{Author/kassandro}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=172601 rgba_rpn]<br />
|A filter for manipulating the pixels of [[RGB]] (and also [[YUV]]) clips using [http://en.wikipedia.org/wiki/Reverse_Polish_notation reverse Polish notation.] <br />
|[[RGB32]], [[RGB24]], [[YUY2]], [[YV12]]<br />
|[http://horman.net/avisynth/downloads/rgba_rpn0.1.zip Plugin]<br />
|{{Author/David Horman}}<br />
|-<br />
| [[SegmentedAmp]] <br />
| Image is segmented with watershed algorithm for smoothing and/or sharpening.<br />
| [[RGB32]], [[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| [http://avisynth.nl/index.php/SegmentedAmp Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=172377 SmoothSkip]<br />
|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]. <br />
|[[YUY2]], [[YV12]]<br />
|[http://github.com/jojje/SmoothSkip/releases/download/v1.0.2/SmoothSkip-1.0.2.zip Plugin]<br />
|[http://github.com/jojje jojje]<br />
|-<br />
| [[Soothe]]<br />
| 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.]<br />
| [[YV12]]<br />
| [http://forum.doom9.org/showthread.php?t=99679 Script]<br />
| {{Author/Didée}}<br />
|-<br />
| [http://sourceforge.net/projects/avisynthtrackin/ Tracking]<br />
| Use computer vision to track objects in the video, and produce ConditionalReader input. Demo at [http://www.youtube.com/watch?v=SQ-JtJs7US0 Youtube]. <br />
| [[RGB24]]<br />
| [http://sourceforge.net/projects/avisynthtrackin/files/1.1/AvisynthTrackin.1.1.binary.zip/download Plugin]<br />
| [http://avisynthtrackin.sourceforge.net/ Shlomo Matichin]<br />
|-<br />
| UnSmooth<br />
| 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.]<br />
| [[YV12]]<br />
| [http://web.archive.org/web/20090821183550/http://mf.creations.nl/avs/functions/UnSmooth-v0.1.avs Script]<br />
| {{Author/mf}}<br />
|-<br />
|[http://forum.doom9.org/showthread.php?t=163870 Watermark]<br />
|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.<br />
|[[RGB32]]<br />
|[http://forum.doom9.org/showthread.php?p=1554560#post1554560 Plugin]<br />
|[http://sourceforge.net/u/phillvanleersum/profile/ DrPhill]<br />
|-<br />
| [http://www.avisynth.nl/users/vcmohan/WaterShed/Watershed.html WaterShed] <br />
| Assuming image grey values to be elevations, it is segmented into basins and watershed lines. Useful in certain medical image analysis and recoloring work.<br />
| [[RGB32]], [[RGB24]], [[YUY2]], [[Y8]], [[YV12]], [[YV16]], [[YV24]], [[YV411]]<br />
| AviSynth 2.5.8: [http://www.avisynth.nl/users/vcmohan/WaterShed/Watershed.zip Plugin]<br />
AviSynth 2.6.0: [http://www.avisynth.nl/users/vcmohan/WaterShed/Watershed_2_6.zip Plugin]<br />
| {{Author/vcmohan}}<br />
|-<br />
|[http://github.com/Xenoveritas/AviSynth-Stuff/tree/master/xvplugins xvplugins]<br />
|This is simply a bunch of AviSynth stuff that isn't (really) possible using plain AviSynth and instead required a plugin.<br />
|[[RGB32]]<br />
| [http://github.com/Xenoveritas/AviSynth-Stuff/tree/master/xvplugins Plugin]<br />
| [http://github.com/Xenoveritas Xenoveritas]<br />
|}<br />
<br/><br />
<br />
[[Category:AviSynth_Usage]]<br />
[[Category:External_filters]]</div>Martin53http://avisynth.nl/index.php/High_bit-depth_Support_with_AvisynthHigh bit-depth Support with Avisynth2013-11-15T16:32:32Z<p>Martin53: </p>
<hr />
<div>Currently, Avisynth 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).<br />
<br />
<br />
'''What is deepcolor?'''<br />
<br />
Deepcolor 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, deepcolor/high bit-depth allows finer graduations of color, allowing 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<br />
<br />
<br />
'''Why Use Deepcolor?'''<br />
<br />
-Higher internal precision, using high-bit depth color, when processing an image in a filter, gives a higher quality (8-bit) output<br />
<br />
-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 ResampleHQ, http://int64.org/projects/resamplehq/<br />
<br />
-If you encode high-bit depth video, you can get better compression (reportedly up to 30%) and less banding. <br />
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:<br />
<br />
http://x264.nl/x264/10bit_02-ateme-why_does_10bit_save_bandwidth.pdf <br />
<br />
http://x264.nl/x264/10bit_01-ateme_pierre_larbier_422_10-bit.pdf <br />
<br />
http://x264.nl/x264/10bit_03-422_10_bit_pristine_video_quality.pdf<br />
<br />
-Professional video is stored in 10bit formats (like ProRes 422) and people want to use Avisynth for processing.<br />
<br />
<br />
'''Importing High Bit-depth Video into Avisynth'''<br />
<br />
Patched ffms2/ffms2-ffmbc - http://forum.doom9.org/showthread.php?p=1580141#post1580141 (See SAPikachu's signature for downloading) Can import DNxHD, ProRes, or other 10 bit videos in their native chroma format (4:2:2 and 4:4:4 are also supported), outputting in the Avisynth high bit-depth convention. Uses Avisynth 2.6's new colorspace. You can process with the full quality of the format. <br />
<br />
Note: <br />
# There may be a long delay on opening, as FFMS2 performs an automatic indexing operation. <br />
# At the time of writing (1-8-2012), the official libav library has a bug with decoding of DNxHD video, so you should use the ffmbc build to decode that. Other than that, both builds should be OK, but ffmbc may have better support for professional video formats (ProRes etc.), and libav is better for H264 and other common formats.<br />
<br />
<br />
The following methods are obsoleted now, except as a verification or workaround:<br />
<br />
Readv210mod - http://forum.doom9.org/showthread.php?p=1526131#post1526131 Can read uncompressed v210 in .mov container as color. Needs a manual setting skip the file header. <br />
<br />
Sashimi - http://sites.google.com/site/ourenthusiasmsasham/soft - Sashimi 0.85 has different bit-depth support. Please see OtherFormats/Read_v210.avs included in the package.<br />
<br />
ReadV210 - http://forum.doom9.org/archive/index.php/t-158985.html Can read uncompressed v210 in .mov container as greyscale. <br />
<br />
Alternative builds and methods of importing:<br />
<br />
ffms2mod - http://forum.doom9.org/showthread.php?p=1528494 Can return most 10bit video in the Avisynth high bit-depth convention.<br />
<br />
rawsource with ffmpeg - http://forum.doom9.org/showthread.php?t=162598&page=2 - shows an example of using ffmpeg to convert to a 16bit format which can be read by rawsource in Avisynth 2.6.<br />
<br />
<br />
'''Processing High Bit-depth Video with Avisynth'''<br />
<br />
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.<br />
<br />
Most developers have adopted a vertically stacked format, where the high bits are stored in the upper half of a video, and the lower bits in the lower half of the video. This special format must be processed only with high-bit aware scripts and plugins.<br />
<br />
RedAverage - http://forum.doom9.org/showthread.php?t=163018 - 16bit capable average with masking.<br />
<br />
Dither - http://forum.doom9.org/showthread.php?p=1386559 - A set of scripts, original and modified plugins to process 16-bit clips in the native 8-bit Avisynth environment. <br />
<br />
ResampleHQ - http://svn.int64.org/viewvc/int64/resamplehq/doc/index.html - Provides gamma-aware resizing and colorspace conversion. Uses 32-bit linear color internally.<br />
<br />
Tweak3 - ? - same as Tweak but with dithering.<br />
<br />
Smoothlevels - http://forum.doom9.org/showthread.php?t=137479 - Advanced levels adjustment function, with limiting & smoothing parameters. <br />
<br />
Deep Color Tools - http://forum.doom9.org/showthread.php?p=1467907#post1467907 - This Script provides basic functions to import 10bit video, do color adjustments, and export to 8bit <br />
<br />
flash3kyuu_deband - another deband filter for avisynth - https://github.com/SAPikachu/flash3kyuu_deband#readme http://forum.doom9.org/showthread.php?t=161411 Dither 10bit to 8bit: <br />
ReadV210(...)<br />
f3kdb(precision_mode=3,input_mode=1,input_depth=16)<br />
<br />
8/16 bit denoise - deepcolor denoise - http://forum.doom9.org/showthread.php?t=162342<br />
<br />
You can also check http://avisynth.org/mediawiki/External_filters#Deepcolor_Filters for possibly more listings.<br />
<br />
8bit Video to 16bit Scene Referred Linear guide http://blendervse.wordpress.com/2011/09/16/8bit-video-to-16bit-scene-referred-linear-exrs/<br />
<br />
<br />
'''Codecs which support high bit-depth'''<br />
<br />
-H.264, High 10 Profile (Hi10P) and above https://en.wikipedia.org/wiki/H.264<br />
<br />
-ProRes 422 https://en.wikipedia.org/wiki/ProRes<br />
<br />
-DNxHD https://en.wikipedia.org/wiki/DNxHD also supported by ffmbc https://code.google.com/p/ffmbc/<br />
<br />
-Apple Animation https://en.wikipedia.org/wiki/Animation_codec<br />
<br />
https://en.wikipedia.org/wiki/Digital_cinematography#Digital_acquisition_codecs_compared<br />
<br />
<br />
'''Exporting High Bit-depth Video'''<br />
<br />
You can encode out of AVIsynth to 10bit x264 via <br />
<br />
AVS4x264 https://astrataro.wordpress.com/2012/06/04/avs4x264mod-v0-8-0-supports-d2v-dgi-dga-avi-mkv-mp4-m2ts-wmv-input-and-auto-fps-correction/ 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 blog for updated versions.<br />
<br />
x264+tmod https://astrataro.wordpress.com/2012/07/21/x264-rev2208677-tmod/ tmod is 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<br />
<br />
10bit x264 command-line example:<br />
<br />
avs2yuv -raw "script.avs" -o - | x264-10bit --demuxer raw --input-depth 10 --input-res 1280x720 --fps 24 --output "out.mp4" -<br />
<br />
AVS2yuv (http://akuvian.org/src/avisynth/avs2yuv/) <br />
<br />
AVS2pipemod (https://github.com/chikuzen/avs2pipemod#readme). The Dither html doc with the plugin gives examples of using AVS2yuv including lossless 10bit.<br />
<br />
AVS2x264mod http://forum.doom9.org/showthread.php?p=1529305#post1529305 Example:<br />
<br />
avs4x264mod.exe --x264-binary “C:\x264_64-abc.exe” -o out.264 in.avs<br />
<br />
<br />
'''Playback of High Bit-depth Videos'''<br />
<br />
-Most of the time you will only get to see dithered 8-bit video, as equipment to truly display high bit-depths is rare at the consumer level in 2011. Digital theatres project up to 12-bit video. Guide: http://coalgirls.wakku.to/?page_id=4635<br />
<br />
-The Bluray standard does not support xvColor (using full-range 8 bit video) or high bit-depth video.<br />
<br />
Playback Software<br />
<br />
MPlayer with high-bit codecs installed, such as http://samples.mplayerhq.hu/drivers32/new/AppleProResDecoder.qtx ProRES 422<br />
<br />
MadVR http://forum.doom9.org/showthread.php?t=146228<br />
<br />
VLC http://www.videolan.org<br />
<br />
Other sofware and information<br />
<br />
Further information on high-bit playback http://forum.doom9.org/showthread.php?t=161548<br />
<br />
FFdshow builds with 10-bit support http://forum.doom9.org/showthread.php?t=161915<br />
<br />
An excellent guide on 10-bit playback: http://haruhichan.com/wpblog/?p=205<br />
<br />
'''Sample High Bit-Depth Videos'''<br />
<br />
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<br />
<br />
[[Category:Advanced topics]]</div>Martin53http://avisynth.nl/index.php/SrestoreSrestore2013-11-04T19:56:38Z<p>Martin53: /* Abstract */</p>
<hr />
<div>{{FilterCat|External_filters|Restoration_filters|Deblenders}}<br />
{{Filter|MOmonster|2.7e, 2.7f|[[Media:srestore.avsi|srestore.avsi]] [[Media:srestore_27f.avsi|srestore_27f.avsi]]|Deblenders|<br />
* YV12<br />
|}}<br />
{{Template:FuncDef| srestore(clip source, float ''frate'', int ''dmode'', ''omode'', float ''blocks'', int ''mthresh'', int ''bthresh'', bool ''chroma'', int ''cache'', float ''rr'', clip ''dclip'') }}<br />
<br />
<br />
== Abstract ==<br />
[[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.<br />
<br />
Important note: Srestore 2.7e can only be called one time in any script due to its use of global variables.<br />
Srestore 2.7f (currently only available via forum) can be called as many times as you like. This is hopefully the only functional difference.<br />
<br />
== Requires Filters ==<br />
*[[MaskTools2]]<br />
*[[TIVTC]] Version 1.04 or higher (only for cache>0, not default)<br />
*[[RemoveGrain]] (only for double-blend-removal, not default)<br />
*[http://forum.doom9.org/showthread.php?p=1129919#post1129919 Average] (only for double-blend-removal, not default)<br />
*[http://forum.doom9.org/showthread.php?t=139337 GRunT] Version 1.0.1 or higher (only for v2.7f)<br />
<br />
==Parameters==<br />
{{Par|frate|float|optional}}<br />
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.<br />
<br />
{{ParR|omode|string|6|0-6 or mode}}<br />
Srestore can be used as blend-decimation-function, as simple deblend-function and for double-blend-removal<br />
: 1 - deblend-mode 1 -> detected blends will be replaced with the previous frame<br />
: 2 - deblend-mode 2 -> next frame is used instead of the detected blend<br />
: 3 - deblend-mode 3 -> detected blends will be replaced with the neighbour that has the smaller difference<br />
: 4 - deblend-mode 4 -> use the neighbour with the smaller blend-possibility<br />
: 5 - deblend-special -> outputs the one of four frames with the smallest blend-possibility<br />
: >5 - blend-decimation -> for all decimation operations<br />
<br />
The output-modes 1-5 are simple deblending modes, so the framerate will not change.<br />
<br />
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:<br />
: pp0 -> the fastest mode, no postprocessing<br />
: pp1 -> use difference masking, higher quality and still good speed<br />
: pp2 -> use a special blurring mask on luma and chroma that reduces artefacts<br />
: pp3 -> combines postprocessing 1 and 2 -> slowest<br />
<br />
You can add also your own postprocessing to these modes. Just add your function like this:<br />
<br />
omode="pp3.blur(1)" -> pp3 + blurring<br />
If you want to add a function with its own inputstrings use three quotation marks:<br />
omode="""pp2.deen("a2d")"""<br />
<br />
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:<br />
<br />
source #progressive<br />
srestore(dmode=-4,omode="pp0")<br />
decimate(cycle=5,quality=0) #recommed decimating<br />
<br />
{{ParR|speed|int|9|-25-25}}<br />
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.<br />
<br />
{{ParR|mode|int|2|1-3}}<br />
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:<br />
: 1 - simple output mode, decimation is not touched<br />
: 2 - duping feature, if a frame has a dup-neighbour, that seems to have a higher quality, this one will be outputed<br />
: 3 - like 2 but the duplicates will be merged<br />
: >3 - mode 2 and 3 combined<br />
By setting the compatible negative values, the chroma values will be also used for the detection.<br />
Note: The double-blend-removal does not use this parameter (-> only mode 1 or -1).<br />
<br />
{{ParR|thresh|int|22|12-44}}<br />
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.<br />
<br />
{{ParR|cache|int|-1|-1-10}}<br />
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.<br />
<br />
{{Par|dclip|clip|input}}<br />
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. <br />
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.<br />
It's recommended to crop the bobbed source (deinterlace BEFORE cropping!) to avoid the detection influence of the bobbing borders (second code example).<br />
<br />
== Examples== <br />
<br />
bobbed (or progressive) source<br />
srestore()<br />
<br />
or:<br />
ord = last.getparity() ? 1 : 0<br />
leakkernelbob(ord,4,true,true)<br />
srestore(dclip=last.crop(8,16,-8,-24))<br />
<br />
or:<br />
d = last.bob(-0.2,0.6).reduceflicker(strength=1)<br />
tdeint(mode=1) #or for example yadif(mode=1)<br />
srestore(mode=4,dclip=d)<br />
<br />
==External Links==<br />
*[http://forum.doom9.org/showthread.php?t=95924 Discussion thread] at [http://forum.doom9.org/ Doom9's Forum]</div>Martin53http://avisynth.nl/index.php/SrestoreSrestore2013-11-04T19:55:07Z<p>Martin53: /* Abstract */</p>
<hr />
<div>{{FilterCat|External_filters|Restoration_filters|Deblenders}}<br />
{{Filter|MOmonster|2.7e, 2.7f|[[Media:srestore.avsi|srestore.avsi]] [[Media:srestore_27f.avsi|srestore_27f.avsi]]|Deblenders|<br />
* YV12<br />
|}}<br />
{{Template:FuncDef| srestore(clip source, float ''frate'', int ''dmode'', ''omode'', float ''blocks'', int ''mthresh'', int ''bthresh'', bool ''chroma'', int ''cache'', float ''rr'', clip ''dclip'') }}<br />
<br />
<br />
== Abstract ==<br />
[[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.<br />
<br />
Important note: Srestore 2.7e can only be called one time in any script due to its use of global variables.<br />
Srestore 2.7f (currently only available via forum) can be called as many times you like. This is hopefully the only functional difference. Formatting was also changed a bit to improve clarity of the nested '?' operators.<br />
<br />
== Requires Filters ==<br />
*[[MaskTools2]]<br />
*[[TIVTC]] Version 1.04 or higher (only for cache>0, not default)<br />
*[[RemoveGrain]] (only for double-blend-removal, not default)<br />
*[http://forum.doom9.org/showthread.php?p=1129919#post1129919 Average] (only for double-blend-removal, not default)<br />
*[http://forum.doom9.org/showthread.php?t=139337 GRunT] Version 1.0.1 or higher (only for v2.7f)<br />
<br />
==Parameters==<br />
{{Par|frate|float|optional}}<br />
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.<br />
<br />
{{ParR|omode|string|6|0-6 or mode}}<br />
Srestore can be used as blend-decimation-function, as simple deblend-function and for double-blend-removal<br />
: 1 - deblend-mode 1 -> detected blends will be replaced with the previous frame<br />
: 2 - deblend-mode 2 -> next frame is used instead of the detected blend<br />
: 3 - deblend-mode 3 -> detected blends will be replaced with the neighbour that has the smaller difference<br />
: 4 - deblend-mode 4 -> use the neighbour with the smaller blend-possibility<br />
: 5 - deblend-special -> outputs the one of four frames with the smallest blend-possibility<br />
: >5 - blend-decimation -> for all decimation operations<br />
<br />
The output-modes 1-5 are simple deblending modes, so the framerate will not change.<br />
<br />
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:<br />
: pp0 -> the fastest mode, no postprocessing<br />
: pp1 -> use difference masking, higher quality and still good speed<br />
: pp2 -> use a special blurring mask on luma and chroma that reduces artefacts<br />
: pp3 -> combines postprocessing 1 and 2 -> slowest<br />
<br />
You can add also your own postprocessing to these modes. Just add your function like this:<br />
<br />
omode="pp3.blur(1)" -> pp3 + blurring<br />
If you want to add a function with its own inputstrings use three quotation marks:<br />
omode="""pp2.deen("a2d")"""<br />
<br />
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:<br />
<br />
source #progressive<br />
srestore(dmode=-4,omode="pp0")<br />
decimate(cycle=5,quality=0) #recommed decimating<br />
<br />
{{ParR|speed|int|9|-25-25}}<br />
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.<br />
<br />
{{ParR|mode|int|2|1-3}}<br />
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:<br />
: 1 - simple output mode, decimation is not touched<br />
: 2 - duping feature, if a frame has a dup-neighbour, that seems to have a higher quality, this one will be outputed<br />
: 3 - like 2 but the duplicates will be merged<br />
: >3 - mode 2 and 3 combined<br />
By setting the compatible negative values, the chroma values will be also used for the detection.<br />
Note: The double-blend-removal does not use this parameter (-> only mode 1 or -1).<br />
<br />
{{ParR|thresh|int|22|12-44}}<br />
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.<br />
<br />
{{ParR|cache|int|-1|-1-10}}<br />
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.<br />
<br />
{{Par|dclip|clip|input}}<br />
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. <br />
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.<br />
It's recommended to crop the bobbed source (deinterlace BEFORE cropping!) to avoid the detection influence of the bobbing borders (second code example).<br />
<br />
== Examples== <br />
<br />
bobbed (or progressive) source<br />
srestore()<br />
<br />
or:<br />
ord = last.getparity() ? 1 : 0<br />
leakkernelbob(ord,4,true,true)<br />
srestore(dclip=last.crop(8,16,-8,-24))<br />
<br />
or:<br />
d = last.bob(-0.2,0.6).reduceflicker(strength=1)<br />
tdeint(mode=1) #or for example yadif(mode=1)<br />
srestore(mode=4,dclip=d)<br />
<br />
==External Links==<br />
*[http://forum.doom9.org/showthread.php?t=95924 Discussion thread] at [http://forum.doom9.org/ Doom9's Forum]</div>Martin53http://avisynth.nl/index.php/SrestoreSrestore2013-11-04T19:26:06Z<p>Martin53: </p>
<hr />
<div>{{FilterCat|External_filters|Restoration_filters|Deblenders}}<br />
{{Filter|MOmonster|2.7e, 2.7f|[[Media:srestore.avsi|srestore.avsi]] [[Media:srestore_27f.avsi|srestore_27f.avsi]]|Deblenders|<br />
* YV12<br />
|}}<br />
{{Template:FuncDef| srestore(clip source, float ''frate'', int ''dmode'', ''omode'', float ''blocks'', int ''mthresh'', int ''bthresh'', bool ''chroma'', int ''cache'', float ''rr'', clip ''dclip'') }}<br />
<br />
<br />
== Abstract ==<br />
[[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.<br />
<br />
Important note: Srestore can only be called one time in any script due to its use of global variables.<br />
<br />
== Requires Filters ==<br />
*[[MaskTools2]]<br />
*[[TIVTC]] Version 1.04 or higher (only for cache>0, not default)<br />
*[[RemoveGrain]] (only for double-blend-removal, not default)<br />
*[http://forum.doom9.org/showthread.php?p=1129919#post1129919 Average] (only for double-blend-removal, not default)<br />
*[http://forum.doom9.org/showthread.php?t=139337 GRunT] Version 1.0.1 or higher (only for v2.7f)<br />
<br />
==Parameters==<br />
{{Par|frate|float|optional}}<br />
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.<br />
<br />
{{ParR|omode|string|6|0-6 or mode}}<br />
Srestore can be used as blend-decimation-function, as simple deblend-function and for double-blend-removal<br />
: 1 - deblend-mode 1 -> detected blends will be replaced with the previous frame<br />
: 2 - deblend-mode 2 -> next frame is used instead of the detected blend<br />
: 3 - deblend-mode 3 -> detected blends will be replaced with the neighbour that has the smaller difference<br />
: 4 - deblend-mode 4 -> use the neighbour with the smaller blend-possibility<br />
: 5 - deblend-special -> outputs the one of four frames with the smallest blend-possibility<br />
: >5 - blend-decimation -> for all decimation operations<br />
<br />
The output-modes 1-5 are simple deblending modes, so the framerate will not change.<br />
<br />
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:<br />
: pp0 -> the fastest mode, no postprocessing<br />
: pp1 -> use difference masking, higher quality and still good speed<br />
: pp2 -> use a special blurring mask on luma and chroma that reduces artefacts<br />
: pp3 -> combines postprocessing 1 and 2 -> slowest<br />
<br />
You can add also your own postprocessing to these modes. Just add your function like this:<br />
<br />
omode="pp3.blur(1)" -> pp3 + blurring<br />
If you want to add a function with its own inputstrings use three quotation marks:<br />
omode="""pp2.deen("a2d")"""<br />
<br />
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:<br />
<br />
source #progressive<br />
srestore(dmode=-4,omode="pp0")<br />
decimate(cycle=5,quality=0) #recommed decimating<br />
<br />
{{ParR|speed|int|9|-25-25}}<br />
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.<br />
<br />
{{ParR|mode|int|2|1-3}}<br />
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:<br />
: 1 - simple output mode, decimation is not touched<br />
: 2 - duping feature, if a frame has a dup-neighbour, that seems to have a higher quality, this one will be outputed<br />
: 3 - like 2 but the duplicates will be merged<br />
: >3 - mode 2 and 3 combined<br />
By setting the compatible negative values, the chroma values will be also used for the detection.<br />
Note: The double-blend-removal does not use this parameter (-> only mode 1 or -1).<br />
<br />
{{ParR|thresh|int|22|12-44}}<br />
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.<br />
<br />
{{ParR|cache|int|-1|-1-10}}<br />
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.<br />
<br />
{{Par|dclip|clip|input}}<br />
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. <br />
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.<br />
It's recommended to crop the bobbed source (deinterlace BEFORE cropping!) to avoid the detection influence of the bobbing borders (second code example).<br />
<br />
== Examples== <br />
<br />
bobbed (or progressive) source<br />
srestore()<br />
<br />
or:<br />
ord = last.getparity() ? 1 : 0<br />
leakkernelbob(ord,4,true,true)<br />
srestore(dclip=last.crop(8,16,-8,-24))<br />
<br />
or:<br />
d = last.bob(-0.2,0.6).reduceflicker(strength=1)<br />
tdeint(mode=1) #or for example yadif(mode=1)<br />
srestore(mode=4,dclip=d)<br />
<br />
==External Links==<br />
*[http://forum.doom9.org/showthread.php?t=95924 Discussion thread] at [http://forum.doom9.org/ Doom9's Forum]</div>Martin53http://avisynth.nl/index.php/SrestoreSrestore2013-11-04T19:11:48Z<p>Martin53: </p>
<hr />
<div>{{FilterCat|External_filters|Restoration_filters|Deblenders}}<br />
{{Filter|MOmonster|2.7e, 2.7f|[[Media:srestore.avsi|srestore.avsi]]|Deblenders|<br />
* YV12<br />
|}}<br />
{{Template:FuncDef| srestore(clip source, float ''frate'', int ''dmode'', ''omode'', float ''blocks'', int ''mthresh'', int ''bthresh'', bool ''chroma'', int ''cache'', float ''rr'', clip ''dclip'') }}<br />
<br />
<br />
== Abstract ==<br />
[[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.<br />
<br />
Important note: Srestore can only be called one time in any script due to its use of global variables.<br />
<br />
== Requires Filters ==<br />
*[[MaskTools2]]<br />
*[[TIVTC]] Version 1.04 or higher (only for cache>0, not default)<br />
*[[RemoveGrain]] (only for double-blend-removal, not default)<br />
*[http://forum.doom9.org/showthread.php?p=1129919#post1129919 Average] (only for double-blend-removal, not default)<br />
*[http://forum.doom9.org/showthread.php?t=139337 GRunT] Version 1.0.1 or higher (only for v2.7f)<br />
<br />
==Parameters==<br />
{{Par|frate|float|optional}}<br />
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.<br />
<br />
{{ParR|omode|string|6|0-6 or mode}}<br />
Srestore can be used as blend-decimation-function, as simple deblend-function and for double-blend-removal<br />
: 1 - deblend-mode 1 -> detected blends will be replaced with the previous frame<br />
: 2 - deblend-mode 2 -> next frame is used instead of the detected blend<br />
: 3 - deblend-mode 3 -> detected blends will be replaced with the neighbour that has the smaller difference<br />
: 4 - deblend-mode 4 -> use the neighbour with the smaller blend-possibility<br />
: 5 - deblend-special -> outputs the one of four frames with the smallest blend-possibility<br />
: >5 - blend-decimation -> for all decimation operations<br />
<br />
The output-modes 1-5 are simple deblending modes, so the framerate will not change.<br />
<br />
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:<br />
: pp0 -> the fastest mode, no postprocessing<br />
: pp1 -> use difference masking, higher quality and still good speed<br />
: pp2 -> use a special blurring mask on luma and chroma that reduces artefacts<br />
: pp3 -> combines postprocessing 1 and 2 -> slowest<br />
<br />
You can add also your own postprocessing to these modes. Just add your function like this:<br />
<br />
omode="pp3.blur(1)" -> pp3 + blurring<br />
If you want to add a function with its own inputstrings use three quotation marks:<br />
omode="""pp2.deen("a2d")"""<br />
<br />
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:<br />
<br />
source #progressive<br />
srestore(dmode=-4,omode="pp0")<br />
decimate(cycle=5,quality=0) #recommed decimating<br />
<br />
{{ParR|speed|int|9|-25-25}}<br />
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.<br />
<br />
{{ParR|mode|int|2|1-3}}<br />
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:<br />
: 1 - simple output mode, decimation is not touched<br />
: 2 - duping feature, if a frame has a dup-neighbour, that seems to have a higher quality, this one will be outputed<br />
: 3 - like 2 but the duplicates will be merged<br />
: >3 - mode 2 and 3 combined<br />
By setting the compatible negative values, the chroma values will be also used for the detection.<br />
Note: The double-blend-removal does not use this parameter (-> only mode 1 or -1).<br />
<br />
{{ParR|thresh|int|22|12-44}}<br />
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.<br />
<br />
{{ParR|cache|int|-1|-1-10}}<br />
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.<br />
<br />
{{Par|dclip|clip|input}}<br />
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. <br />
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.<br />
It's recommended to crop the bobbed source (deinterlace BEFORE cropping!) to avoid the detection influence of the bobbing borders (second code example).<br />
<br />
== Examples== <br />
<br />
bobbed (or progressive) source<br />
srestore()<br />
<br />
or:<br />
ord = last.getparity() ? 1 : 0<br />
leakkernelbob(ord,4,true,true)<br />
srestore(dclip=last.crop(8,16,-8,-24))<br />
<br />
or:<br />
d = last.bob(-0.2,0.6).reduceflicker(strength=1)<br />
tdeint(mode=1) #or for example yadif(mode=1)<br />
srestore(mode=4,dclip=d)<br />
<br />
==External Links==<br />
*[http://forum.doom9.org/showthread.php?t=95924 Discussion thread] at [http://forum.doom9.org/ Doom9's Forum]</div>Martin53http://avisynth.nl/index.php/SrestoreSrestore2013-11-04T19:07:19Z<p>Martin53: /* Requires Filters */</p>
<hr />
<div>{{FilterCat|External_filters|Restoration_filters|Deblenders}}<br />
{{Filter|MOmonster|2.7e|[[Media:srestore.avsi|srestore.avsi]]|Deblenders|<br />
* YV12<br />
|}}<br />
{{Template:FuncDef| srestore(clip source, float ''frate'', int ''dmode'', ''omode'', float ''blocks'', int ''mthresh'', int ''bthresh'', bool ''chroma'', int ''cache'', float ''rr'', clip ''dclip'') }}<br />
<br />
<br />
== Abstract ==<br />
[[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.<br />
<br />
Important note: Srestore can only be called one time in any script due to its use of global variables.<br />
<br />
== Requires Filters ==<br />
*[[MaskTools2]]<br />
*[[TIVTC]] Version 1.04 or higher (only for cache>0, not default)<br />
*[[RemoveGrain]] (only for double-blend-removal, not default)<br />
*[http://forum.doom9.org/showthread.php?p=1129919#post1129919 Average] (only for double-blend-removal, not default)<br />
*GRunT[http://forum.doom9.org/showthread.php?t=139337] Version 1.0.1 or higher (only for v2.7f)<br />
<br />
==Parameters==<br />
{{Par|frate|float|optional}}<br />
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.<br />
<br />
{{ParR|omode|string|6|0-6 or mode}}<br />
Srestore can be used as blend-decimation-function, as simple deblend-function and for double-blend-removal<br />
: 1 - deblend-mode 1 -> detected blends will be replaced with the previous frame<br />
: 2 - deblend-mode 2 -> next frame is used instead of the detected blend<br />
: 3 - deblend-mode 3 -> detected blends will be replaced with the neighbour that has the smaller difference<br />
: 4 - deblend-mode 4 -> use the neighbour with the smaller blend-possibility<br />
: 5 - deblend-special -> outputs the one of four frames with the smallest blend-possibility<br />
: >5 - blend-decimation -> for all decimation operations<br />
<br />
The output-modes 1-5 are simple deblending modes, so the framerate will not change.<br />
<br />
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:<br />
: pp0 -> the fastest mode, no postprocessing<br />
: pp1 -> use difference masking, higher quality and still good speed<br />
: pp2 -> use a special blurring mask on luma and chroma that reduces artefacts<br />
: pp3 -> combines postprocessing 1 and 2 -> slowest<br />
<br />
You can add also your own postprocessing to these modes. Just add your function like this:<br />
<br />
omode="pp3.blur(1)" -> pp3 + blurring<br />
If you want to add a function with its own inputstrings use three quotation marks:<br />
omode="""pp2.deen("a2d")"""<br />
<br />
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:<br />
<br />
source #progressive<br />
srestore(dmode=-4,omode="pp0")<br />
decimate(cycle=5,quality=0) #recommed decimating<br />
<br />
{{ParR|speed|int|9|-25-25}}<br />
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.<br />
<br />
{{ParR|mode|int|2|1-3}}<br />
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:<br />
: 1 - simple output mode, decimation is not touched<br />
: 2 - duping feature, if a frame has a dup-neighbour, that seems to have a higher quality, this one will be outputed<br />
: 3 - like 2 but the duplicates will be merged<br />
: >3 - mode 2 and 3 combined<br />
By setting the compatible negative values, the chroma values will be also used for the detection.<br />
Note: The double-blend-removal does not use this parameter (-> only mode 1 or -1).<br />
<br />
{{ParR|thresh|int|22|12-44}}<br />
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.<br />
<br />
{{ParR|cache|int|-1|-1-10}}<br />
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.<br />
<br />
{{Par|dclip|clip|input}}<br />
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. <br />
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.<br />
It's recommended to crop the bobbed source (deinterlace BEFORE cropping!) to avoid the detection influence of the bobbing borders (second code example).<br />
<br />
== Examples== <br />
<br />
bobbed (or progressive) source<br />
srestore()<br />
<br />
or:<br />
ord = last.getparity() ? 1 : 0<br />
leakkernelbob(ord,4,true,true)<br />
srestore(dclip=last.crop(8,16,-8,-24))<br />
<br />
or:<br />
d = last.bob(-0.2,0.6).reduceflicker(strength=1)<br />
tdeint(mode=1) #or for example yadif(mode=1)<br />
srestore(mode=4,dclip=d)<br />
<br />
==External Links==<br />
*[http://forum.doom9.org/showthread.php?t=95924 Discussion thread] at [http://forum.doom9.org/ Doom9's Forum]</div>Martin53