View source for Avs

__NOTOC__
[[AviSynth|quick link to old guide]]
<br>[http://en.wikipedia.org/wiki/How_to_edit quick link to wiki editing]
<br>


<b>Snow's new AviSynth guide.</b> Yeah, I hope I actually finish this.


<u>Ideas for layout</u>
* Custom table of contents, not so linear.
* Use PNG! Lossless is cool.
* Color headings.

<u>Ideas for guide</u>
* No more follow-these-steps-blindly instructions this time.
* Include more pictures. Use thumbnails when necessary.
* At the start of each section, show a typical script in progress.
* Include exercises with downloadable packages containing a video and a partial script.


<b>Stuff to do:</b>

<u>The script</u>
* Loading the source files - capture card
* Appending 
* Deinterlacing
* Trimming 
* Resizing 
* Sharpening 
* Cropping / Adding borders 
* Color / Brightness 
* SDA StatID 
* QuickTime compatibility 

<u>Extras</u>
* Sample scripts 
* Script verification

<u>Fixes</u>
* Fixing Constant audio desync 
* Fixing Progressive audio desync 





<b>Table of contents:</b>
#[[#intro | Introduction]]
#[[#workenvironment | Setting up your work environment]]
#[[#installation | Installation]]
#[[#walkthrough | Walkthrough]]
#[[#loadsource | Loading the source files]]
#[[#deinterlacing | Deinterlacing]]



<br>
<div id="intro" style="background:#194BA2;width:100%;"><font size="+1" color="#FFFFFF">&nbsp;Introduction</font></div>

IMPORTANT NOTE: AviSynth scripting is an advanced topic. All beginners are recommended to use [[Anri-chan]] instead.

[[Glossary of terms]]


<br>
<div id="workenvironment" style="background:#194BA2;width:100%;"><font size="+1" color="#FFFFFF">&nbsp;Setting up your work environment</font></div>

<b>File extensions</b>

You'll very likely need to rename file extensions but they may be hidden by the operating system.
# open Windows Explorer
# open the <font color=lightblue>Tools</font> menu
# select <font color=lightblue>Folder Options</font>
# select the <font color=lightblue>View</font> tab
# choose to <font color=lightblue>Show hidden files and folders</font>
# uncheck <font color=lightblue>Hide extensions for known file types</font>
# click OK to apply changes.

<br>
[[Image:AviSynth_showhidden.png]]


<br>
<b>Association of avs file extension with text editor</b>

Now that you can see file extensions, let's associate the avs file extension with Notepad or other text editor of your choice.
# open Windows Explorer
# open the <font color=lightblue>File</font> menu
# select <font color=lightblue>New</font>
# select <font color=lightblue>Text Document</font>
# rename the new text file to <font color=lightblue>New Text Document.avs</font>. It should show up as an unknown type.
# open the avs file or right-click and select Open With. Windows will ask which program you want to use.
# select <font color=lightblue>Notepad</font> in the list
# place a checkmark in the box that says <font color=lightblue>Always use the selected program to open this kind of file</font>
# click OK

<br>
[[Image:AviSynth_avsnotepad.png]]


<br>
<div id="installation" style="background:#194BA2;width:100%;"><font size="+1" color="#FFFFFF">&nbsp;Installation</font></div>

<b>Download and install a stable release version of [http://avisynth.org/ AviSynth]</b><br>
* [http://sourceforge.net/project/showfiles.php?group_id=57023 AviSynth download page]
<font color=lightgreen>The picture below identifes a stable release.</font><br>
[[Image:AviSynth_download.png]]


<br>
<b>Download and install necessary AviSynth plugins</b>
* [[Media:avisynthplugins.zip|SDA plugins]].

# Go to Start menu
# [All] Programs
# AviSynth
# Plugin Directory. (This is where AviSynth stores its plugins.)
# Copy the files from inside the AviSynth plugins zip file to the Avisynth plugins directory window you just opened.

<font color=lightgreen>The plugins directory should look similar to what's shown in the picture. AviSynth will automatically load dll and avsi files.</font><br>
[[Image:AviSynth_pluginsdir.png]]


<br>
<font color=red><b>Special instructions for those working with DVD sources</b></font><br>
If you followed the instructions on the [[DVD#DVD_software_installation |DVD page]] properly you should already have DGMPGDec installed. You need to copy a dll file from this directory to the AviSynth plugins directory in order for AviSynth to be able to load DVD video.
# navigate to the DGMPGDec directory. Should be <font color=lightblue>C:\Program Files\DGMPGDec</font>
# copy <font color=lightblue>DGDecode.dll</font> to the AviSynth plugins directory.


<br>
<b>Download and install [http://www.virtualdub.org/ VirtualDub]</b><br>
*  [http://www.virtualdub.org/download.html VitualDub download page]

This program will be useful for testing your script as you go along.


<br>
<b>Verify that everything is installed properly</b><br>

Download the following package and unzip the contents anywhere you'd like. Run VirtualDub and drag and drop the avs file into the window. You should see a frame that says "So far so good..".

* [[Media:AviSynth_verifyinstall.zip|AviSynth_verifyinstall.zip]]

<!-- <font color=red>Move to a troubleshooting section?</font> - If AviSynth complains that the MSVCR71.dll file is missing, you can download it at http://www.dll-files.com/. Place it in your "C:\WINDOWS\SYSTEM32\" directory.
<br> -->



<br>
<div id="walkthrough" style="background:#198d3a;width:100%;"><font size="+1" color="#FFFFFF">&nbsp;Walkthrough of a typical AviSynth script</font></div>

Before starting your own script you should have an idea of how AviSynth operates. The following script is typical for DVD video. AviSynth will execute each line of code sequentially; in this walkthrough you will see what the video looks like after each step.

<pre><nowiki>
Ac3Source(MPEG2source("VTS_01_1.d2v", upconv=1),"VTS_01_1 T80 2_0ch 192Kbps DELAY 0ms.ac3")
mvbob()
trim(13801,13900)
Lanczos4Resize(640,480)
</nowiki></pre>


<b>A glance at the work folder</b>

As you can see, the VOB has already been processed by DGIndex generating the files:
* VTS_01_1.d2v
* VTS_01_1 T80 2_0ch 192Kbps DELAY 0ms.ac3

[[Image:AviSynth_walkthrough_workfolder.png]]


<b>Load audio/video</b>

I open my_AviSynth_script.avs in Notepad and add the line below to load the Ac3 audio and MPEG2 video. VirtualDub shows that both have loaded succesfully.

<font color=orange>Ac3Source(</font><font color=magenta>MPEG2source("VTS_01_1.d2v", upconv=1)</font><font color=orange>,"VTS_01_1 T80 2_0ch 192Kbps DELAY 0ms.ac3")</font>

[[Image:AviSynth_walkthrough_loadsource.png]]


<b>Deinterlace</b>

I've identified that the video is D1 F1 3D (will go into this later) so the appropriate deinterlacing method is mvbob. Notice how the number of frames has doubled from approximately 10000 frames to 20000.

<font color=orange>mvbob()</font>

[[Image:AviSynth_walkthrough_deinterlace.png]]


<b>Trimming the fat</b>

I've decided, for the sake of this walkthrough, to <u>keep</u> only 20 frames.

<font color=orange>trim(17451,17470)</font>

[[Image:AviSynth_walkthrough_trim.png]]


<b>Resize</b>

My NTSC DVD has a resolution of 720x480. I need to resize to 640x480 resolution so that the aspect ratio is correct and everything doesn't look so wide.

<font color=orange>Lanczos4Resize(640,480)</font>

[[Image:AviSynth_walkthrough_resize.png]]


There are more commands you will use in your script, but the above are the essentials.


<br>
<div id="loadsource" style="background:#194BA2;width:100%;"><font size="+1" color="#FFFFFF">&nbsp;Loading the source files</font></div>

Let's start with a new AviSynth script. Remember when you created an avs text file back in [[#workenvironment | Setting up your work environment]]? That's all an AviSynth script really is, a text file with an avs file extension. We'll create the High Quality script first and move on to the other SDA qualities later. Open mygame_HQ.avs in Notepad.

# open Windows Explorer
# open the <font color=lightblue>File</font> menu
# select <font color=lightblue>New</font>
# select <font color=lightblue>Text Document</font>
# rename the new text file to <font color=lightblue>mygame_HQ.avs</font>.


This chapter will diverge into three sections. Depending on how you recorded your video, follow the appropriate link.

* [[#PC game recorded with Fraps / Camtasia / other screen capture software | PC game recorded with Fraps / Camtasia / other screen capture software]]
* [[#Console game recorded with DVD recorder / capture card using DVD settings | Console game recorded with DVD recorder / capture card using DVD settings]]
* [[#Console game recorded with capture card to AVI file | Console game recorded with capture card to AVI file]]


==PC game recorded with Fraps / Camtasia / other screen capture software==

Screen capture software typically creates an AVI file containing both video and audio. All we need is the <b>AviSource()</b> command with your AVI file as the argument.

<pre><nowiki>
avisource("clip1.avi")
</nowiki></pre>


Simple, isn't it? What if you have more than one file and want to append them together, as is usually the case when recording for longer periods of time? Let's bring in the <b>AlignedSplice()</b> command with AviSource as the arguments.

<pre><nowiki>
a = avisource("clip1.avi")
b = avisource("clip2.avi")
namedoesntmatter = avisource("clip3.avi")

AlignedSplice(a,b,namedoesntmatter)
</nowiki></pre>


<font color=lightgreen>An example of three videos that were split by Fraps being joined together in AviSynth.</font>
[[Image:AviSynth_loadsource_pcgame.png]]


<br>
==Console game recorded with DVD recorder / capture card using DVD settings==

There are three main types of audio when working from a DVD source: AC3, MPA and sometimes even PCM (wav). When you indexed the VOB files with DGIndex as per the [[DVD#Creating_the_project_file_.28.d2v.29 | DVD guide]] it should have created the d2v file and an audio file. Notice how the d2v file is only 19 KB in size since it only contains data <i>about</i> the VOB MPEG2 video stream; you still need that VOB file!


<font color=lightgreen>The picture below shows that an AC3 audio file was extracted with an audio desync of 78 milliseconds.</font>
[[Image:AviSynth_loadsource_DVDdir.png]]


Here are the different ways to load AC3 / MPA / PCM (WAV). The first example would work with the files in the picture above.


<b>AC3 with a -78 ms desync.</b>
<pre><nowiki>
Ac3Source(MPEG2source("VTS_01_1.d2v", upconv=1),"VTS_01_1 T80 2_0ch 192Kbps DELAY -78ms.ac3").DelayAudio(-0.078)
</nowiki></pre>

<b>MPA with a +46 ms desync.</b>
<pre><nowiki>
AudioDub(MPEG2source("VTS_01_1.d2v", upconv=1),MPASource("vob T01 2_0ch 192Kbps DELAY 46ms.mpa")).DelayAudio(0.046)
</nowiki></pre>

<b>PCM with no desync.</b>
<pre><nowiki>
AudioDub(MPEG2source("VTS_01_1.d2v", upconv=1),WAVSource("vob T01 2_0ch 192Kbps DELAY 0ms.wav"))
</nowiki></pre>


<font color=lightgreen>DVD MPEG2 in all its interlaced glory...</font>
[[Image:AviSynth_loadsource_DVD.png]]

<br>
==Console game recorded with capture card to AVI file==

<font color=red>Write me!</font>



<br>
<div id="deinterlacing" style="background:#194BA2;width:100%;"><font size="+1" color="#FFFFFF">&nbsp;Deinterlacing</font></div>

<b>Outline</b>
* Intro, with image of interlaced / deinterlaced frame.
* What is an interlaced frame?
* Make new image with concept of the [[AviSynth#What_is_deinterlacing.3F | ABCD ]] split but say "Field 1", "Field 2", etc.
* Above idea but actual game footage screens (thumbnail link to massive 3600 width pic)
* Go through each method of deinterlacing for all the qualities. Show images!!!




If you recorded a PC game with screen capture software such as Fraps or Camtasia, there is a 99.9% chance that your video does not need to be deinterlaced and you can skip this entire section. For just about everyone else, your video probably needs to be deinterlaced.

<font color=lightgreen>The animated picture below shows the difference between interlaced and progressive/deinterlaced.</font>

[[Image:AviSynth_deinterlacing_ipanim.gif]]


===What is an interlaced frame?===

An interlaced frame has two fields. Think of it as a single frame with two smaller frames inside. Those two fields (the smaller frames) represent two different moments in time. Take the picture as an example, with four different fields numbered 1 to 4:

[[Image:AviSynth_deinterlacing_fields1234_i.png]]


The fields have been separated.

[[Image:AviSynth_deinterlacing_fields1234_i2.png]]


Demonstrating how the top field (fields 1 and 3) is on even numbered lines, while the bottom field (fields 2,4) is on odd numbered lines.

[[Image:AviSynth_deinterlacing_fields1234_izoom.png]]


The sequence of frames is now deinterlaced and is progressive.

[[Image:AviSynth_deinterlacing_fields1234_p.png]]



Here is an example from a game.

(a more complete version is available: [[Media:AviSynth_deinterlacing_fields_game.jpg | jpg, 1.18 MB]] / [[Media:AviSynth_deinterlacing_fields_game.png | png, 5.75 MB]] - 3600×2047)

[[Image:AviSynth_deinterlacing_fields_game_thumb.jpg]]


You'll notice that the height has been cut in half and Dante looks too short (or too wide). Not to worry, we'll be fixing that later on.


===Determining the framerate of the game===

Right now your AviSynth script is one measly line of code, e.g.:
<pre><nowiki>
Ac3Source(MPEG2source("segment1.d2v",upConv=1),"segment1 192Kbps DELAY -48ms.ac3").DelayAudio(-0.048)
</nowiki></pre>

I'm going to <i>temporarily</i> add <b>SeparateFields</b> at the end of the script solely for the purpose of determining the framerate of the game. This will do exactly what is shown in the previous section "What is an interlaced frame?".
<pre><nowiki>
Ac3Source(MPEG2source("segment1.d2v",upConv=1),"segment1 192Kbps DELAY -48ms.ac3").DelayAudio(-0.048)
SeparateFields
</nowiki></pre>

The script is saved and loaded into VirtualDub(Mod). The amount of frames and the framerate have both doubled.

[[Image:AviSynth_deinterlacing_framerate_loadvdub.png]]



<b>Example of a game that runs at half framerate or 29.97 frames per second</b>

[[Image:F2_animation.gif]]



<b>Example of a game that runs at full framerate or 59.94 frames per second</b>

<font color=red>to do</font>


<b>Example of a game that runs at one third framerate or 19.98 frames per second</b>

<font color=red>to do</font>


===Determining if the video is top or bottom field first===

<font color=red>to do</font>


===Determining the resolution of the game===

This section requires a bit of your own research. Wikipedia is a good place to start. Older consoles like the NES and Sega Genesis can only output in low resolution, however the SNES, N64 and PS1 are capable of high resolution. From the PS2 and onwards, high resolution for games is more probable.

You may find your game in our [[DF | list of dimensions and framerates]].


===Deinterlacing scenarios===

<font color=red>to do</font>


====Scenario 1: D1 F1====

<font color=red>to do</font>


====Scenario 2: D1 F2====

<font color=red>to do</font>


====Scenario 3: D1 F3====

<font color=red>to do</font>


====Scenario 4: D4 F1====

<font color=red>to do</font>


====Scenario 5: D4 F2====

<font color=red>to do</font>


====Scenario 6: D4 F3====

<font color=red>to do</font>

[http://speeddemosarchive.com/forum/index.php/topic,9956.15.html use decimate() from f2 for d4 f3]


====Scenario 7: One pixel bob====

<font color=red>to do</font>


====Scenario 8: Quarter pixel bob====

<font color=red>to do</font>