AviSynth2.5核心滤镜

来自NMM Doc
Dgwxx讨论 | 贡献2008年9月5日 (五) 17:55的版本 (New page: The available (internal) filters are listed here and divided into categories. A short description is added, including the supported color formats (and sample types for the...)
(差异) ←上一版本 | 最后版本 (差异) | 下一版本→ (差异)
跳到导航 跳到搜索

The available (internal) filters are listed here and divided into categories. A short description is added, including the supported color formats (and sample types for the audio filters). There are some functions which combine two or more clips in different ways. How the video content is calculated is described for each function, but here is a summary which explains which properties that the resulting clip will have.

An alphabetical listing of the internal filters can be found here Category:Internal_filters. Note that (as of today) there is no official build of v2.60 yet.

Media file filters

These filters can be used to read or write media files. Usually they produce source clips for processing. See debug filters for non-file source filters.

Filter Description Color format
AviSource / AviFileSource / OpenDMLSource Opens an AVI file. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
DirectShowSource Opens a filename using DirectShow. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
ImageReader / ImageSource This filter produces a video clip by reading in still images. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
ImageWriter Writes frames as images to your hard disk. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Import Imports an AviSynth script into the current script. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
SegmentedAviSource / SegmentedDirectShowSource This filter automatically loads up to 100 avi files per argument. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
WavSource Opens a WAV file or the audio of an AVI file. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
SoundOut SoundOut is a GUI driven sound output module for AviSynth (it exports audio to several compressors). All audio.

Color conversion and adjustment filters

These filters can be used to change the color format or adjust the colors of a clip.

Filter Description Color format
ColorYUV Adjusts colors and luma independently. YUY2, Y8, YV411, YV12, YV16, YV24
ConvertBackToYUY2 Converts a RGB clip back to YUY2. RGB24, RGB32
ConvertToRGB Converts to RGB32 unless clip is RGB24. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
ConvertToRGB24 / ConvertToRGB32 / ConvertToYUY2 / ConvertToY8 / ConvertToYV411 / ConvertToYV12 / ConvertToYV16 / ConvertToYV24 Converts to RGB24 / RGB32 / YUY2 / Y8 / YV411 / YV12 / YV16 (planar version of YUY2) / YV24 (full YUV). RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
FixLuminance Correct shifting vertical luma offset. YUY2
GreyScale Converts a video to greyscale. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Invert Inverts selected color channels of a video. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Levels The Levels filter scales and clamps the blacklevel and whitelevel and adjusts the gamma. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Limiter A filter for clipping levels to within CCIR-601 range. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
MergeARGB / MergeRGB This filter makes it possible to select and combine a color channel from each of the input videoclips. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
MergeChroma / MergeLuma This filter makes it possible to merge chroma/luma from a videoclip into another. There is an optional weighing, so a percentage between the two clips can be specified. YUY2, Y8, YV411, YV12, YV16, YV24
Merge This filter makes it possible to merge both luma and chroma from a videoclip into another. There is an optional weighting, so a percentage between the two clips can be specified. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
RGBAdjust Adjusts each color channel seperately. RGB24, RGB32
ShowAlpha / ShowRed / ShowGreen / ShowBlue Shows the selected channel of an (A)RGB clip. RGB24, RGB32
SwapUV Swaps chroma channels. YUY2, Y8, YV411, YV12, YV16, YV24 ?
Tweak Adjusts the hue, saturation, brightness, and contrast. YUY2, Y8, YV411, YV12, YV16, YV24
UToY / VToY Copies chroma U/V plane to Y plane (image is now half as big) YUY2, Y8, YV411, YV12, YV16, YV24
UToY8 / VToY8 Shorthand for UToY.ConvertToY8 / VToY.ConvertToY8. YUY2, YV411, YV12, YV16, YV24
YToUV Puts the luma channels of the two clips as U and V channels. Image is now twice as big, and luma is 50% grey. Use MergeLuma, if you want to add luma values. YUY2, YV12 ?

Overlay and Mask filters

These filters can be used to layer clips with or without using masks and to create masks.

Filter Description Color format
ColorKeyMask Sets the alpha-channel (similar as Mask does) but generates it by comparing the color. RGB32
Layer Layering two videos. RGB32, YUY2
Mask Applies an alpha-mask to a clip. RGB32
MaskHS This filter returns a mask (as Y8) of clip using a given hue and saturation range. YUY2, Y8, YV411, YV12, YV16, YV24
Overlay Overlay puts two clips on top of each other with an optional displacement of the overlaying image, and using different overlay methods. Furthermore opacity can be adjusted for the overlay clip. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
ResetMask Applies an "all-opaque" alpha-mask to clip. RGB32
Subtract Produces an output clip in which every pixel is set according to the difference between the corresponding pixels. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16 (?), YV24

Geometric deformation filters

These filters can be used to change image size, process borders or make other deformations of a clip.

Filter Description Color format
AddBorders Adds black borders around the image. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Crop Crops excess pixels off of each frame. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
CropBottom Crops excess pixels off of the bottom of each frame. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
FlipHorizontal / FlipVertical Flips the video from left to right/upside-down. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Letterbox Letterbox simply blackens out the top and the bottom and optionally left and right side of each frame. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
HorizontalReduceBy2 / VerticalReduceBy2 / ReduceBy2 Reduces the size of each frame by half horizontally, vertically or in both directions. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
BicubicResize / BilinearResize / BlackmanResize / GaussResize / LanczosResize / Lanczos4Resize / PointResize / SincResize / Spline16Resize / Spline36Resize / Spline64Resize The resize filters rescale the input video frames to an arbitrary new resolution, using different sampling algorithms. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
TurnLeft / TurnRight / Turn180 Rotates the clip 90 degrees counter-clockwise / 90 degrees clockwise. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24

Pixel restoration filters

These filters can be used for image detail (pixel) restoration (like denoising, sharpening) of a clip.

Filter Description Color format
Blur / Sharpen This a simple 3x3-kernel blurring/sharpening filter. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
GeneralConvolution General 3x3 or 5x5 convolution matrix. RGB32
SpatialSoften / TemporalSoften Removes noise from a video clip by selectively blending pixels spatially/temporally. YUY2 (SpatialSoften), Y8, YV411, YV12, YV16, YV24
FixBrokenChromaUpsampling The free Canopus DV Codec v1.00 upsamples the chroma channels incorrectly (although newer non-free versions appear to work fine). FixBrokenChromaUpsampling filter compensates for it. YUY2

Timeline editing filters

These filters can be used to arrange frames in time (clip cutting, splicing and other editing).

Filter Description Color format
AlignedSplice / UnalignedSplice Joins two or more video clips end to end. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
AssumeFPS / AssumeScaledFPS / ChangeFPS / ConvertFPS Changes framerates in different ways. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
DeleteFrame Deletes a single frame, given as an argument. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Dissolve Like AlignedSplice, except that the clips are combined with some overlap. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
DuplicateFrame Duplicates a single frame given as an argument. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
FadeIn0 / FadeIn / FadeIn2 / FadeOut0 / FadeOut / FadeOut2 / FadeIO0 / FadeIO / FadeIO2 Causes the video stream to fade linearly to black at the start or end. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
FreezeFrame Replaces all the frames between first-frame and last-frame with a selected frame. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Interleave Interleaves frames from several clips on a frame-by-frame basis. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Loop Loops the segment from start frame to end frame a given number of times. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Reverse This filter makes a clip play in reverse. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
SelectEven / SelectOdd Makes an output video stream using only the even/odd numbered frames. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
SelectEvery Selects frames with a fixed period, it is a generalization of SelectEven and SelectOdd. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
SelectRangeEvery Selects a range of frames with a fixed period. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Trim Trims a video clip so that it includes only the frames first-frame through last-frame. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24

Interlace filters

These filters can be used for creating and processing field-based material (which is frame-based material separated into fields). AviSynth is capable of dealing with both progressive and interlaced material. The main problem is, that it often doesn't know what it receives from source filters. This is the reason that the field-based flag exists and can be used when dealing with interlaced material. More information about field-based video can be found here.

Filter Description Color format
AssumeFrameBased / AssumeFieldBased Forces frame-based or field-based material. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
AssumeBFF / AssumeTFF Forces field order. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Bob Bob takes a clip and bob-deinterlaces it. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
ComplementParity Changes top fields to bottom fields and vice-versa. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
DoubleWeave The filter operates like Weave, except that it produces double the number of frames by combining both the odd and even pairs of fields. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
PeculiarBlend This filter blends each frame with the following frame in a peculiar way. YUY2
Pulldown This filter simply selects two out of every five frames of the source video. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
SeparateFields Takes a frame-based clip and splits each frame into its component top and bottom fields. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
SwapFields Swaps the two fields in an interlaced frame. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Weave Weave takes even pairs of fields from a Fields Separated input video clip and combines them together to produce interlaced frames. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24

Audio processing filters

These filters can be used to process audio. Audio samples from a clip will be automatically converted if any filters requires a special type of sample. This means that if a filter doesn't support the type of sample it is given, it will automatically convert the samples to something it supports. The internal formats supported in each filter is listed in the sample type column. A specific sample type can be forced by using the ConvertAudio functions.

If the sample type is float, when AviSynth has to output the data, it will be converted to 16 bit, since float cannot be passed as valid AVI data.

Filter Description Sample type
Amplify / AmplifydB Amplify multiply audio samples by amount. 16 bit, Float
AssumeSampleRate Adjusts the playback speed of the audio. All
AudioDub / AudioDubEx AudioDub takes the video stream from the first argument and the audio stream from the second argument and combines them. AudioDubEx is similar, but it doesn't throw an exception if both clips don't have a video or audio stream. All
ConvertAudioTo8bit / ConvertAudioTo16bit / ConvertAudioTo24bit / ConvertAudioTo32bit / ConvertAudioToFloat Converts audio samples to 8/16/24/32/Float bits. All
ConvertToMono Merges all audio channels. 16 bit, Float
DelayAudio Delays the audio track by second seconds. All
EnsureVBRMP3Sync Corrects out-of-sync MP3-AVI's, when seeking or trimming. All
GetChannel / GetLeftChannel / GetRightChannel Returns an audio channel from a clip. All
KillAudio / KillVideo Removes the audio or video from a clip completely. All
MergeChannels Merges channels of two audio clips. All
MixAudio Mixes audio from two clips. 16 bit, Float
MonoToStereo Converts two mono signals to one stereo signal. 16 bit, Float
Normalize Amplifies the entire waveform as much as possible, without clipping. 16 bit, Float
ResampleAudio Performs a high-quality change of audio sample rate. 16 bit
SuperEQ High quality 16 band sound equalizer. Float
SSRC Very high quality samplerate conversion. Float
TimeStretch This filter can change speed of the sound without changing the pitch, and change the pitch of a sound without changing the length of a sound. Float

Conditional and other meta filters

Meta filters can be used to control other filters execution. The basic characteristic of conditional filters is that 'their scripts' are evaluated (executed) at every frame instead of the whole clip. This allows for complex video processing that would be difficult or impossible to be performed by a normal AviSynth script.

Filter Description Color format
ConditionalFilter / FrameEvaluate / ScriptClip ConditionalFilter returns source1 if some condition is met, otherwise it returns source2. ScriptClip/FrameEvaluate returns the clip which is returned by the function evaluated on every frame. YUY2 ?, YV12
ConditionalReader ConditionalReader allows you to import information from a text file, with different values for each frame - or a range of frames. YUY2 ?, YV12
WriteFile / WriteFileIf / WriteFileStart / WriteFileEnd These filters evaluate expressions and output the results to a text-file. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 ?
Animate / ApplyRange Animate (ApplyRange) is a meta-filter which evaluates its parameter filter with continuously varying (the same) arguments. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 ?
TCPServer / TCPSource This filter will enable you to send clips over your network. You can connect several clients to the same machine. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24

Debug filters

Filter Description Color format
BlankClip / Blackness This filter produces a solid color, silent video clip of the specified length (in frames). RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
ColorBars This filter produces a video clip containing SMPTE color bars scaled to any image size. RGB32, YUY2, YV12
Compare Compares two clips and prints out information about the differences. RGB24, RGB32, YUY2, YV12
Histogram Adds a histogram. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Info Prints out image and sound information. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
MessageClip Produces a clip containing a text message. RGB32
ShowFiveVersions Takes five video clips and combines them in a staggered arrangement from left to right. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16 (?), YV24
ShowFrameNumber / ShowSMPTE / ShowTime Draws text on every frame indicating what number AviSynth thinks it is. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
StackHorizontal / StackVertical Takes two or more video clips and displays them together in left-to-right/up-to-down order. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Subtitle Adds a single line of anti-aliased text to a range of frames. RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24
Tone This will generate sound. Float
Version Generates a video clip with a short version and copyright statement. RGB24