Filtres internes
From Avisynth wiki
Revision as of 21:37, 4 February 2008 by 88.162.119.43 (Talk)
Dans AviSynth 2.5, un quatrième format de couleur est supporté en plus du RGB24, du RGB32 et du YUY2: Le YV12. Voir YV12 FAQ pour plus d'informations.
Ce format de couleur est particulier, puisque utilisé par de nombreux codec (Incluant MPEG4 et MPEG2 - donc les DVD). Dans AviSynth v2.6 plusieurs autres échantillonnages chromatiques sont disponibles: YV24 (YUV 4:4:4), YV16 (YUV 4:2:2), YV411 (YUV: 4:1:1) et Y8 (Noir et Blanc).
Les filtres internes (inclus à AviSynth) sont référencés ici et sont classés en catégories. Une brève description les accompagne ainsi que les formats de couleur qu'ils supportent (ou l'échantillonnage pour les filtres audio)
Une liste par ordre alphabétique des filtres internes est disponible ici Category:Internal_filters.
Contents |
Filtres d"import / export"
Ces filtres sont utilisés pour lire ou écrire des fichiers multimédias (image, son ou vidéo). Habituellement ils sont utilisés pour importer une source à traiter. See debug filters fo non-file source filters.
| Filtre | Description | Format de couleur |
|---|---|---|
| AviSource / AviFileSource / OpenDMLSource | Ouvrent un fichier avi. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| DirectShowSource | Ouvre un fichier en utilisant DirectShow. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| ImageReader / ImageSource | Ce filtre produit un clip vidéo à partir d'images. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| ImageWriter | Enregistre sur votre disque dur une image. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| Import | Importe un script AviSynth dans votre script. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| SegmentedAviSource / SegmentedDirectShowSource | Ces filtres peuvent charger automatiquement jusqu'à 100 fichiers. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| WavSource | Ouvre un fichier WAV ou la piste audio d'un fichier AVI. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| SoundOut | SoundOut est un plugin d'export audio avec interface graphique pour AviSynth (Permet d'exporter l'audio dans plusieurs formats). | Tout audio. |
Filtres Colorimétriques
Ils servent à changer de format de couleur une vidéo ou d'ajuster la colorimétrie des images (uniformément ou au travers d'un masque).
| Filtre | Description | Format de Couleur |
|---|---|---|
| ColorKeyMask | Définit la couche alpha (un peu comme Mask le fait) mais le fait en comparant les composant R, V et B. | RGB32 |
| ColorYUV | Permet de régler les couleurs et la luminance de façon distincte | YUY2, Y8, YV411, YV12, YV16, YV24 |
| ConvertBackToYUY2 | Reconvertit un clip RGB en YUY2. | RGB24, RGB32 |
| ConvertToRGB | Convertit en RGB32 à moins que le clip ne soit en RGB24. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| ConvertToRGB24 / ConvertToRGB32 / ConvertToYUY2 / ConvertToY8 / ConvertToYV411 / ConvertToYV12 / ConvertToYV16 / ConvertToYV24 | Convertit en RGB24 / RGB32 / YUY2 / Y8 / YV411 / YV12 / YV16 (version plane? du YUY2) / YV24 (YUV sans perte chromatique). | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| GreyScale | Convertit une vidéo en noir et blanc. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| Invert | Inverse les couches calorimétriques d'une vidéo. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 ? |
| Layer | Superpose deux vidéos. | RGB32, YUY2 |
| Levels | Le filtre Levels ajuste et limite les niveaux de noir et de blanc et permet de régler le gamma. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| Limiter | Un filtre pour limiter les niveaux conformes à la norme CCIR-601 (luminance entre 16 et 235). | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| Mask | Applique un masque alpha à un clip. | RGB32 |
| MaskHS | Ce f iltre retourne le masque (en Y8) d'un clip en fonction de sa saturation et/ou de sa teinte. | YUY2, Y8, YV411, YV12, YV16, YV24 |
| MergeARGB / MergeRGB | Ce filtre permet de sélectionner et de combiner les couches calorimétriques de plusieurs clips vidéo. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| MergeChroma / MergeLuma | Avec ce filtre vous pouvez mélanger la composante chroma/luminance d'un vidéoclip avec un autre. Vous pouvez cependant pondérer le mélange des deux clip via le paramètre "weight". | YUY2, Y8, YV411, YV12, YV16, YV24 |
| Merge | Avec ce filtre vous pouvez mélanger la composante chromatique et la luminance d'un vidéoclip dans un autre. Vous pouvez cependant pondérer le mélange des deux clips via le paramètre "weight". | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| Overlay | Superpose deux clips l'un sur l'autre avec différentes options comme le déplacement du clip superposé, plusieurs méthodes de superposition et l'opacité du clip superposé. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| ResetMask | Réinitialise la couche alpha d'un clip en "tout-opaque". | RGB32 |
| RGBAdjust | Permet le réglage de chaque couche calorimétrique séparément. | RGB24, RGB32 |
| ShowAlpha / ShowRed / ShowGreen / ShowBlue | Montre la couche sélectionnée d'un clip (A)RGB (clip RGB avec ou sans couche alpha). | RGB24, RGB32 |
| SwapUV | Inverse les composantes U et V d'un clip. | YUY2, Y8, YV411, YV12, YV16, YV24 ? |
| Subtract | Produit un clip où la valeur de chaque pixel est déterminé en fonction de la différence des valeurs de pixels entre deux clips. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16 (?), YV24 |
| UToY / VToY | Copie la composante chromatique U ou V à la place de la composante Y (luminance) (image réduite de moitiée) | YUY2, Y8, YV411, YV12, YV16, YV24 |
| UToY8 / VToY8 | Version abrégée de UToY.ConvertToY8 / VToY.ConvertToY8. | YUY2, YV411, YV12, YV16, YV24 |
| YToUV | Injecte la luminance de deux clips en composantes U et V. L'image résultante est deux fois plus grande et sa luminance est un gris à 50%. Utilisez MergeLuma pour ajouter au clip résultant une autre composante de luminance. | YUY2, YV12 ? |
| Tweak | Permet de régler la teinte, la saturation, la luminosité et le contraste d'une vidéo. | YUY2, Y8, YV411, YV12, YV16, YV24 |
| FixLuminance | Corrige et compense une variation verticale de la luminance. | YUY2 |
Filtres géométriques
Ils sont utilisés pour changer la taille d'une image, ajouter ou retirer des bordures ou pour effectuer d'autres transformations.
| Filtre | Description | Format de couleur |
|---|---|---|
| AddBorders | Ajoute des bordures autour de l'image. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| Crop | Rogne l'image. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| CropBottom | Rogne les pixels en excès au bas de l'image. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| Letterbox | Letterbox est une combianaison entre AddBorder et Crop. Au lieu de rogner l'image comme Crop, Letterbox remplace les pixels sélectionnés par du noir. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| ReduceBy2 | Réduit la taille de l'image par 2. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| HorizontalReduceBy2 / VerticalReduceBy2 | Réduit la longueur (horizontal) ou la hauteur (vertical) de l'image par 2. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| BicubicResize / BilinearResize / GaussResize / LanczosResize / Lanczos4Resize / PointResize / Spline16Resize / Spline36Resize | Ces filtres de redimensionnement modifient la taille de l'image à une une valeur choisie. Ces différents filtres utilisent chacun un l'algorithme de redimensionnement différent. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| FlipHorizontal / FlipVertical | Inverse l'image horizontalement ou verticalement (la gauche devient la droite, le haut devient le bas) | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| TurnLeft / TurnRight / Turn180 | Tourne l'image de 90 degrés dans le sens inverse des aiguilles d'une montre / 90 degrés ans le sens des aiguilles d'une montre. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
| StackHorizontal / StackVertical | Prend plusieurs clip en entrée et restitue un clip où ils sont les uns à coté des autres horizontalement ou verticalement. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 |
Pixel filters
These filters are for image detail (pixel) restoration (like denoising, sharpening). Most such filters are implemented as a AviSynth external plugins with various advanced algorithmes of pixel processing.
| 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
This filters are to arrange frames in a 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 are for treating interlaced video. Currently (v2.5x and older versions), AviSynth has no interlaced flag which can be used for interlaced video. There is a field-based flag, but contrary to what you might expect, this flag is not related to interlaced video. In fact, all video (progressive or interlaced) is framebased, unless you use AviSynth filters to change that. There are two filters that turn framebased video into fieldbased video: SeparateFields and AssumeFieldBased. 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 |
| 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 |
| PeculiarBlend | This filter blends each frame with the following frame in a peculiar way. | YUY2 |
Audio filters
Prior to v2.5 the audio samples are converted to 16 bits when using one of these audio filters. Starting from v2.5 the audio samples will be automatically converted if any filters requires a special type of sample. This means that most filters will accept several types of input, but 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 colorspace 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. | 16Bit, 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. | 16Bit, 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. | 16Bit, Float |
| MonoToStereo | Converts two mono signals to one stereo signal. | 16Bit, Float |
| Normalize | Amplifies the entire waveform as much as possible, without clipping. | 16Bit, Float |
| ResampleAudio | Performs a high-quality change of audio sample rate. | 16Bit |
| 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 |
| Tone | This will generate sound. | Float |
Meta filters
These are special filters to control other filters execution.
| Filter | Description | Color format |
|---|---|---|
| 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 ? |
| ConditionalFilter / FrameEvaluate / ScriptClip / ConditionalReader | ConditionalFilter returns source1 if some condition is met, otherwise it returns source2. ScriptClip returns the clip which is returned by the function evaluated on every frame. | YV12 ? |
| 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 streams and combines them in a staggered arrangement from left to right. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16 (?), YV24 |
| ShowFrameNumber / ShowSMPTE | Draws text on every frame indicating what number AviSynth thinks it is. | 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 |
| WriteFile / WriteFileIf / WriteFileStart / WriteFileEnd | Output to a textfile. | RGB24, RGB32, YUY2, Y8, YV411, YV12, YV16, YV24 ? |
| Version | Generates a video clip with a short version and copyright statement. | RGB24 |
