"There is no slow software, there is only slow
hardware."
[unknown coder]
This
guide will help to understand the new concept of using graphs to
create working Avisynth scripts.
If
you are new to Avisynth please visit
the project homepage and get the latest binaries here.
DISCLAIMER: This software is provided as is. You may profit
or not. It may damage your system. There is no support assured.
There are errors. The user interface
is not common.
Use software always at your own risk.
To
achieve a good learning curve things are explained as easy as possible.
Marketing hint: Keep it simple and stupid.
Suggestions
for improvement: vion11[at]innerphase[dot]de
What is it for?
Till now you need some experience in programming to
use AviSynth.That means knowledge about functions, parameters, namespace,
syntax and so on.
With AVE you simply connect icons with lines and when graph is
complete watch the output. Screenshot
The generated script file is ready to render with common video
editing programmes (VirtualDub,
Premiere, After
Effects ....) and mpeg2 encoder.
You want to do visionary things with computer video and
there is no time learning to program - read on!
Preparing your system
AVE works together only with windows. It is tested
with win98, w2k and xp. You must have a mediaplayer installed capable
of playing *.avs files.
Search the folder \Examples in your AviSynth installation path
and click on version.avs. Your media player starts the clip and you see
current version information of Avisynth.
If it doesn't work, you have to tell the system explicit what programm
opens *.avs files. Check your manual for that ;-)
Media Player Classic Try MPC,
it has a lot of other nice features worth to test.This
guide expects MPC opens your *.avs files. To achieve better workflow,
check the key assigning options.(alternate
download) VirtualDubmod.
For experienced users: To touch all pixels of your output. VirtualDubMod
is VirtualDub
extended not only with a script editor. Use it to convert and compress
your scripts to a running avi. AVE uses external libraries, they are included in the
setup. However it is not guaranteed, installation works proper. If you
encounter problems install them in your system language from following
download sites. MS XML Parser AVE saves your graph as xml. You may open them in your internet browser
and check them. XML is called the ascii of the future.
AVE needs at least version 4.0. Download Runtime Libraries AVE is developped with VB6 and you need the runtime installed in your
system language. us/eng is here,
google
for other languages.
Download and Installation
Download latest version and follow the installation
routine. After starting AVE from Startmenu a splash screen appears. At
this time AVE looks if it likes your system. When everything is fine,
splash screen closes and you may read on next chapter.
If not the last line says: 'Doubleclick
to continue...' and the amount of errors is displayed some lines above.
When errors are reported and loading
stops last line tells you, what AVE has tried to do. Mostly XML installation
issues. You'll get some advice in this forum
thread or place your question there.
If you're interested: splash screen shows a snapshot of your prefrontal
neurons activity while following the messages.
From now this guide expects no errors are reported and splash screen
is closed.
First contact
"The
windows seem to be bottom up." Yes, in the real world
most things like trees, cars and humans are connected to the bottom. AVEditor
follows this paradigm and windows stay on their caption bar. Unlike other
user interfaces where windows hang and crash.
Moving and sizing the windows Point your mouse at the
blue caption bar , click and hold the left
button. Now move around, you got it. That's called 'to drag'. It is used
everywhere in this application. Later on you learn 'drag and drop'. (btw.
you can release your mouse button now ;)
Same with sizing - use the [S]
button. [m]
maximizes the window to full screen and back. AVE saves window positions
at [x] leaving.
Most fun you'll get with two monitors.
Double clicking at caption bar hides all but caption
bar. This feature is useful but still experimental. Doubleclick again to
unhide. "I lost control!
Everything is messed up, windows are hidden elsewhere or unvisible and my
taskbar &%/?()!!!...." May happen, simple solution at this point
- locate file AVEditor.ini, kill it and start AVE again.
OK, I see the icons. What's the trick?
Now you are ready to discover visual editing with
graphs. The icons are filter in terms of Avisynth. Think of highly optimized
pieces of code developed to change aspects of your video and audio files.
First you should expand the graph by dragging the filters at a
proper position. Three kind of filters exists depending on the position
of their orange connectors.
A graph has filters, connectors and lines
There is only one filter with no connector at the bottom - the output.
This is the last filter in your graph. It looks like a small TV set and
you cannot delete it.
Other filter have only connectors at bottom. These Filter
send video or audio streams as a signal into the graph. Possible inputs
are avi, mpeg, quicktime, wave, bitmaps and other filetypes. Check the
AviSynth homepage for updates often, the amount of allowed files is progressing.
You have already tested the version filter with your media
player, it sends the information out of itself - no file needed. Other
filters work similar.
Move these input filters at the top of your workplace. The other ones
with connectors at top and bottom stay in the middle. When no lines cross,
you'll get the picture. It looks kind of a tree.
Move them all
You can move filter several at once if you mark them before. Start somewhere
at workplace top left of the magenta colored filter. Open a yellow rectangle
by dragging your mouse over the workplace. Marked filters get a red border.
How to unmark? Drag mouse to top right again.
Auto arrange
To progress your productivity AVE has a build in auto arrange function.
Simply choose a filter from workplace and click at [y] .
Running the graph
This graph you have organized is complete, all filters are connected.
It can run and pushes signal from top to the output. Now click at |Run|
and look what happens. Mediaplayer opens, plays a video and music. Congratulation,
your system is now tested and works perfect with AVE.
Exploring the graph
Before we start from bottom to top, close the objects
window, it is not needed now. Click at |Functions|
. You can open it again same way later. Have a look at the other
small window. Its captions bar tells you the current item.
Click at output (TV set), now you see the properties of the output
displayed - it is the script AVE has written for you. When you click at |Run| Mediaplayer
open this script and plays it. Yes, it is magic.
Next filter is called 'Levels', you will find five different values
waiting for your creativity. You can't change the clip value, it is determined
by graph layout. The video part of our example ist quite dark. Change
input_high value to 120 and test again.
Click at [i] to open your internet
browser with local Avisynth documentation and more infornation about current
properties and values.
Optional and experimental: mouse-enabled-value-change
You can drag values as well, try left and right mouse button, move right
'n' left and up 'n' down.
That's all. Checking and changing filter properties is easy. Frame preview When |preview| window
is open and you click at a filter AVE shows you a frame from the output
of choosed filter.
You may use 1:1, <,
> to adjust current frame and its
stretching. New frame numbers are accepted by typing.
AVE saves
all your changed properties
in realtime
The clip is ok, I don't like
the music.
The example has three media
sources - title, video and audio. The green wavsource filter loads
music. Drag it to the upper left corner and drop onto the recycle symbol
appearing there. Don't forget the
audio dub filter. The graph is broken now und will not run!
Let's connect layer and level filter again. Start dragging
mouse on unused orange connector. A orange line follows mouse pointer, release
mouse button over second connector. Switching color to red signals 'ready
to connect'.
Test again and listen - no more music.
Video and audio have had different length, video loops better now.
Are more filter available?
Definetly,
about 150 are included into AviSynth!
Open objects window again and locate three main groups of objects (filters,
graphs, userfunctions)
Search LancosResize and Info, place them near output. (drag
'n drop). Try reconnecting lines and splice Info between output
and levels. Video resolution is 320x240. Next use LanczosResize
and resize video to dvd resolution 720x576.
Now you have full control over graphs, quite easy isn't it.
Remember: a graph must be completed and fully connected to run.
Saving graphs
You
can save as Autoload or as named graph. Below recyling symbol you'll find
the disk icon. If you place output here whole graph is saved as autoload.
You have to choose an icon.
Save parts of graphs by dropping other filter. Everything along the lines
up to sources will be saved. Save with icon and name.
Saved graphs appear as items connected to object group graphs. Drop them!
Tips for advanced user
-- if you are new to desktop video find out what colorspace, fourcc,
codec, frames, fields, interlace and fps means
-- drop sources directly from explorer onto workplace
(avi, avs, wav, aveuf, grf, mp3, asf)
-- use keys: r, space, s, m, x, f, i, o,
p
-- change MPCs shortcut keys, example: r for exit
-- open words.avs in folder \testdrop, scoll down and
change title (MakeWordClip("We...."))
-- check out Avisynth plugins
here (plugins = more filters)
-- there are different property sets for loaded
and not loaded filters
-- property sets are saved as xml you may edit them
-- adjust pathes for documentation and plugins in ini-file
-- render different files at once with command line tools (avs2avi)
Gimme more!
There
will be updates with minor gui changes. If you want to become an expert
get family with userfunctions described in this thread.
Userfunctions combine full power of AviSynth and AVE.