AviSynth#"Hello World"

AviSynth acts as a non-linear video editor controlled entirely by scripting (without a GUI).{{cite web|title=Main Page - Avisynth|url=http://avisynth.nl/index.php/Main_Page|work=AviSynth Mediawiki|publisher=AviSynth Team|accessdate=10 April 2013}} It emulates an AVI video file (or WAV audio file) as seen by the VFW downstream application, which is typically a media player, video editing software, or an encoder.{{cite web|title=More about AviSynth - Avisynth|url=http://avisynth.nl/index.php/More_about_AviSynth|work=AviSynth Wiki|publisher=AviSynth Team|accessdate=10 April 2013}}

AviSynth is built upon filters, which are much like DirectShow filters, but with a different binary interface. Filter capabilities include cropping, deinterlacing, inverse telecine, working with still images, doing basic color grading, reducing video noise, and many other things. AviSynth also performs traditional video editing tasks like cutting, trimming and re-sequencing segments.

For example, consider the script "myAvi.avs" (just a plain text-file saved with the extension "avs")

AviSource("myAvi.avi")
Crop(0, 0, 320, 240)
Blur(0.1)

This script file can be opened in most media players (such as Windows Media Player). The program will play the video file "myAvi.avi" cropped down to its top-left 320 pixels by 240 pixels and blurred by a small amount. Operations occur in sequential order, so the cropping occurs first, then the blurring.

Technically, AviSynth constructs a filter graph (like Microsoft GraphEdit but with added capabilities),{{cite web|title=The Script Execution Model: The Filter Graph|url=http://avisynth.nl/index.php/The_script_execution_model/The_filter_graph|work=AviSynth Wiki|publisher=AviSynth Team|accessdate=25 October 2019}} controlled by scripts written in the [http://avisynth.nl/index.php/Grammar AviSynth scripting language]. Its functionality can be extended through the use of third-party filters known as plugins. An external plugin list is maintained at [http://avisynth.nl/index.php/External_filters AviSynth Filter Collection].

AviSynth is a frameserver – the calling program requests audio/video frames and the script serves them. The calling program can call frames in any order, allowing it to pause, jump forward or backward etc., just as with a physical file.

The scripting language is a dataflow language: a programming paradigm that describes a directed graph of the data flowing between operations. It lacks some procedural programming control structures,{{cite web|url=http://avisynth.nl/index.php/Control_structures |title=AviSynth syntax: control structures |work=AviSynth Wiki |publisher=Avisynth Team|accessdate=Sep 21, 2014}} but it contains many features familiar to programmers, including variables, distinct datatypes, conditionals, and complex expressions.

The language works primarily with the audio/video clip as a built-in data type. The clip is a complex structure with many attributes such as width, height and duration.{{cite web|url=http://avisynth.nl/index.php/Clip_properties |title=Clip Properties |work=AviSynth Wiki |publisher=Avisynth Team|accessdate=Oct 27, 2019}} The language also has several other more standard data types: int, float, bool and string.{{cite web|url=http://avisynth.nl/index.php/Script_variables |title=Script Variables |work=AviSynth Wiki |publisher=Avisynth Team|accessdate=Sep 14, 2017}} These can be used to perform calculations, decisions, and write text such as subtitles to the video.

The script has a single return value, which is the audio and video 'seen' by the program running the script. This is normally the last line of the script, but a return statement may be inserted at any point.

This example is a "Hello World" program.

BlankClip()
Subtitle("Hello, world!")

If the above text is entered into a text file with the .avs extension, it can be opened in Windows Media Player or any of the other programs in the list below, and a video containing the words "Hello, world!" will be displayed.

The {{mono|BlankClip}} function creates a new video. The parentheses at the end of the word are optional, since no arguments are being passed, but are given in this case to indicate it is a function and not a variable.

The {{mono|Subtitle}} function draws the words "Hello, world!" on top of the previously-created blank video.

Although both functions both accept many more arguments (for example, controlling the size and length of the blank video, and the positioning, font, and color of the subtitle), this example leaves them out; the functions use built-in default arguments.

Avisynth uses syntactic sugar that makes simple scripts far easier to write: an implicit variable called {{mono|Last}}. Without implicit variables, the above script would have to be written like this:

Last = BlankClip()
Last = Last.Subtitle("Hello, world!")
return Last

or like this:

A = BlankClip()
B = A.Subtitle("Hello, world!")
return B

Explicit clip variables are normally only used for functions involving more than one clip:

A = BlankClip()
B = A.Subtitle("Hello, world!")
return Dissolve(A, B, 30) # 30-frame cross fade

This example takes an actual video, applies some simple processing, and returns it to the output.

AviSource("C:\Example.avi")
ReduceBy2()
GreyScale()

The {{mono|AviSource}} function is used to load an AVI video from a real location. To open other media types, the {{mono|DirectShowSource}} function could be used instead. {{mono|ReduceBy2}} divides the vertical and horizontal size of the video in half, and {{mono|GreyScale}} removes all color information.

AviSynth filters work in many RGB and YUV color spaces to allow all kinds of video input and output.{{cite web|title=Convert - Avisynth|url=http://avisynth.nl/index.php/Convert|work=AviSynth Wiki|publisher=AviSynth Team|accessdate=27 October 2019}} Certain functions only work on specific color spaces, requiring conversion – for example, most videos are distributed in a YUV color space, but most color correction is done in one of the RGB spaces. A color-correcting script might look like this:

DirectShowSource("movie.mp4") # YV12 color space
ConvertToRGB32
RGBAdjust(1.0, 0.95, 1.0) # decrease Green channel
ConvertToYV12

The AviSynth scripting language allows for users to define their own functions.

This is an example of a function that allows you to dissolve from one clip to another without damaging interlacing lines.

clip1 = AVISource("video1.avi")
clip2 = AVISource("video2.avi")
# call the user-defined function which is defined below:
interlaced_dissolve(clip1, clip2, 30)
# ...the script returns the above result to the calling program
# user-defined function:
# dissolve from clip1 to clip2 over 30 frames
function interlaced_dissolve(clip clip1, clip clip2, int iter) {
clip1 = clip1.SeparateFields
evn1  = clip1.SelectEven
odd1  = clip1.SelectOdd
clip2 = clip2.SeparateFields
evn2  = clip2.SelectEven
odd2  = clip2.SelectOdd
evn = Dissolve(evn1, evn2, iter)
odd = Dissolve(odd1, odd2, iter)
Interleave(evn, odd).Weave.DoubleWeave.SelectOdd
# ...the function returns the above result to the main script
}

AviSynth 3.0 was a complete rewrite of AviSynth 2.x, and aimed to overcome the limitations of AviSynth 2.x.

Adding improvements such as an abstracted color space model, in which new color spaces (including two with 45-bit depth) could be supported through a plug-in mechanism, better cache management for better performance, and using Ruby rather than the homegrown language employed in current versions.{{cite web|url=http://forum.doom9.org/showthread.php?t=140376|title=Avisynth 3 - dead project? |website=Doom9 Forum |accessdate=2009-06-17}}

AviSynth 3.0 was to be available for other operating systems than Windows, instead relying on GStreamer, extending support to platforms such as Linux, Mac OS X and BSD. Development has been stalled since August 2007.{{cite web

|url=http://avisynth.nl/index.php/AviSynth_v3#Q5.29_How_many_developers_are_working_on_it.3F

|title=AviSynth v3

|work=AviSynth Mediawiki

|accessdate=22 September 2019}}

[https://github.com/AviSynth/AviSynthPlus AviSynth+] is a fork of the official AviSynth 2.xx, introducing long-sought features such as 64-bit support, multithreading, deep color spaces, support for recent compilers, new scripting constructs (new control-flow constructs such as loops), and increased performance in many areas.{{cite web

|url=http://avisynth.nl/index.php/AviSynth%2B

|title=AviSynth+

|work=AviSynth Mediawiki

|access-date=22 September 2019

}} At the same time it retained 100% compatibility to the AviSynth 2.5/2.6 series, both for filters and host applications. At the time of writing (2023-06), it is also actively maintained.

AviSynth 2.xx may be used under operating systems other than Windows through the use of Wine. To work on scripts VirtualDub/VirtualDubMod can be used as on Windows. To interface between AviSynth under Wine and for example FFmpeg running on a Linux host, Avs2YUV can be used. Avs2YUV is a Windows command line program that is run under Wine and renders the output of an AviSynth script to stdout that is then piped to FFmpeg. Avs2YUV also supports writing to a named pipe.{{cite web|url=http://akuvian.org/src/avisynth/avs2yuv/|title=Avs2YUV|work=Akuvian.org|accessdate=2011-01-09}}

There is a Linux port of AviSynth called AvxSynth.{{cite web|url=https://github.com/avxsynth/avxsynth|title=avxsynth/avxsynth: Linux Port of Avisynth|work=GitHub|accessdate=2017-09-16}}

In addition, several programs have now been created which accept only AviSynth scripts as input - thereby simplifying the programs themselves but giving users the full power of AviSynth for input.

There are also several batch encoding applications that tie together AviSynth with command line audio and video encoders and muxers to provide an all-in-one, modular, customizable video encoding application. MeGUI is an example of this kind of application.

Although AviSynth scripts are meant to be easily opened in simple text editing programs, there are several editors meant especially for editing AviSynth scripts such as [http://forum.doom9.org/showthread.php?t=153248 AvsPMod].

{{Expand section|date=May 2008}}

• List of video editing software

{{Reflist}}

• AviSynth home page: [http://avisynth.nl/index.php/ (English)] [https://www.avisynth.info/ (Japanese)]
• [http://www.avisynth.nl/users/warpenterprises/ AviSynth Filter Collection]
• [https://forum.doom9.org/forumdisplay.php?s=&forumid=67 Doom9's AviSynth Forums]
• [http://avisynth3.unite-video.com/ AviSynth 3.0 development homepage]

{{DEFAULTSORT:Avisynth}}

Category:Free video software