=AviSynth2.5疑难解答=
当遇到问题时请首先阅读下面的文字

===安装问题===

如AviSynth工作时您遇到了问题，请首先尝试下面的脚本

Version()

然后用Windows Media Player 6.4(文件名是”mplayer2.exe”，位于”C: \Program Files\Windows Media Player”文件夹中，注意其他版本的WMP是无效的)。如果您能看到一段显示Avisynth版本号和版权说明文字的视频，说明AviSynth已被正确安装。

如果这样不能工作，您可以尝试下面的方法：
*清空AviSynth的插件目录：自动加载的avsi脚本（在2.0x版本中为avs）或一些滤镜可能会导致问题（详见[[检查您自动装载插件目录下的文件]]）
*安装解码器，特别是[http://www.avisynth.org/mediawiki/wiki/huffyuv.htm Huffyuv]：问题有可能是因为您没有提供显示您视频和脚本所需的解码器造成的。
*如果您使用了编码集成软件包（如DVD2SVCD，GKnot，DVX等），请确定您使用的是这些软件包中集成的AviSynth版本：有可能新版本的AviSynth与您使用的软件包不兼容（当然也有可能兼容）。尝试与软件包的开发者联系获得帮助。
*重新安装AviSynth：可能在安装过程中存在问题。如果您使用的是新的测试（beta）版本，请使用稳定的发布版本。
*如果以上这些仍不能解决问题，请到[http://forum.doom9.org/forumdisplay.php@s=&forumid=33 Doom9论坛]发帖寻求帮助。

===其他问题===

使用AviSynth创建脚本并非永远都很简单，有时候AviSynth会输出非常奇怪的结果。以下是一个有助于您解决最常见错误的简短指南。

====简化书写====

如果AviSynth输出了奇怪的结果，尝试简化您的脚本。尝试把您的脚本写成尽可能多行的形式。这将有助于您确认问题，比如：

video = AviSource("file23.avi").ConvertToYUY2().Trim(539,8534)
return AudioDub(Blur(video,1.5).Reduceby2().Bilinearrresize(512,384),Wavsource("file23.wav").AmplifyDB(4.5)

上述语句的可读性显然不如下面的语句

AviSource("file23.avi")
ConvertToYUY2()
Trim(539, 8534)
Blur(video, 1.5)
Reduceby2()
Bilinearrresize(512, 384)
AudioDub(Wavsource("file23.wav"))
AmplifyDB(4.5)

另外，这还有一些好处，您将能更轻松的

*对单行指令进行注释，这对测试一个滤镜的效果很有帮助。
*获得问题指令的正确位置（行数），如果有语法错误的话。
*在脚本的任意位置放置“return last”语句。这将从一系列滤镜（语句）中的当前位置输出视频。
*观察脚本的整体“流动（flow）”（试想如果[[Trim指令]]只对其前面的视频剪辑有效那将是多么美妙的事情）。

====随时检查参数====

如果您使用的一个滤镜得到了意料之外的结果，请尝试使用最简单的参数。请随时通过AviSynth的主页或者随AviSynth安装的文档检查您内置滤镜的相关信息。

请确认您使用了和文档描述中相同类型的参数。最常见的一种错误是与所有滤镜的第一个参数-视频文件（clip）有关的。请确认您已熟知“后入为主”的原则，如果您没有指定“最后的视频文件（last clip）”，大多数滤镜都会返回一个“无效参数”的错误。

如果您最后一个滤镜的输出赋值给了一个变量，并且不存在“最后的视频剪辑”，您将得到一个“滤镜的返回值不能是一个视频文件（clip）”的错误，比如：

video = AviSource("file.avi")
audio = WavSource("file.wav")
combined = AudioDub(video, audio)

这是一个错误脚本，下面的写法能解决这个问题：

video = AviSource("file.avi")
audio = WavSource("file.wav")
AudioDub(video, audio)

现在此处的“最后”一条指令（last）包含了一个视频剪辑，或者这样：

video = AviSource("file.avi")
audio = WavSource("file.wav")
combined = AudioDub(video, audio)
return combined

现在此处为返回一个变量，甚至可以这样：

video = AviSource("file.avi")
audio = WavSource("file.wav")
return AudioDub(video, audio)

====使用VirtualDub测试脚本====

经常使用[http://www.avisynth.org/mediawiki/wiki/virtualdub.htm VirtualDub]或改进的[http://www.avisynth.org/mediawiki/wiki/virtualdubmod.htm VirtualDubMod]去测试您的脚本。这是所有开发者测试AviSynth功能时使用的方法。AviSynth当然也能在和其他程序上运行，但如果您在其他程序上得到了错误，这经常并非AviSynth本身所致，而是受到了您使用软件内部的限制。

这些限制常常和下面原因有关：
*色彩空间（颜色标准）问题。您使用的应用程序并支持您脚本输出时使用的颜色标准。
*尺寸问题。一些程序不接受所有尺寸的图像。

====单步检查脚本====

正如同在上面“简化书写”中说提到的，如果脚本有问题，单步检查您的每句脚本永远是一个正确的选择。

您可以通过在句首（或在滤镜处理前）添加“#”注释掉一个或多个滤镜。这是让AviSynth忽略该句（以及这之后所有行）的方法。

您可以在脚本的任意位置添加“return last”或“return myvariable”语句。

您可以通过在脚本的任何位置添加[Info()滤镜]获得现阶段滤镜所得的图像和音频。

====检查您自动装载插件目录下的文件====

一般而言，自动装载的插件总能正确工作，但您绝不能在此目录下进行以下操作：
*安装任何与AviSynth版本不兼容的插件（比如旧2.0.x）。
*安装特殊的LoadPluginEx.dll插件（包含在WarpSharp集成包中），其用于加载旧2.0版本的插件。
*安装AviSynth C语言插件，其使用的是AviSynth的C应用界面（API）而非通常界面。
*安装过多的AviSynth插件（在2.5.7版本中，此50个插件的自动预检查装载限制已被去掉）
*安装其他任何DLL文件（通常来说放置其他DLL文件是安全的，但这是不推荐的。）

您同时必须记住，位于您插件文件夹下的所有AVSI文件都会被自动装载到您的脚本中。这是一个允许您使用您自己撰写（或借用他人撰写）的函数而不需要复制粘贴它们的声明定义到每个脚本中的功能。
''
注.在旧AviSynth版本中（直到2.0.7），所有位于您插件文件夹下的AVS文件都被自动包含在您的脚本中。这也意味着您可能复制到插件文件夹下的任何实例脚本都会被自动包含在您的脚本中，而这有可能产生错误（在旧版本中）！''

一般而言，在任何AVSI（早期为AVS）文件中，没有包括在函数中的指令都是有问题的。

AVSI和DLL以外的其他文件格式会被忽略，所以可以安全的把您的文档放在插件文件夹下。

如何清空插件文件夹？只需要创建一些子目录（比如”hide”）然后把全部（或部分）文件移动到这个子目录下。请记住一些文件（DirectShowSource.dll, TCPDeliver.dll插件, ColorRGB.avsi）是AviSynth的组成部分（从2.5.6版起）。

====使用相对保守的图像尺寸====

如果您遇到图像碎裂，请尝试使用相对保守的帧大小，也就是说，使用高度和宽度都能被16整除的大小（译者注：MOD16）。在许多场合，使用不能被2整除的图像尺寸会产生问题，应当永远避免这种用法。

但，如果您确实发现用某些特定图像尺寸时会产生问题，请提交一份BUG报告。请参照下面的提交方法。

====最后请查看AviSynth常见问题解答====

如果您的问题仍然得不到解决（在某些解码器中载入脚本或色彩空间错误），请参阅AviSynth常见问题解答，特别是 [[Q2.4：解码器X读取AVS文件有问题？]] 同时也请确认已查看[[Q1.4: 当前版本的主要缺陷是什么?]]

====BUG报告/寻求帮助====

在能提供有效的帮助前我们需要您提供很多信息。如果您没有向我们提供这些信息，这等于给我们了一个无法为您提供帮助或者定位错误的绝佳机会。

请'''务必'''确认提供了下列信息：
*AviSynth的版本号（如果您使用的不是一个SourceForge上的最终发布，请附上beta版的发布时间）
*一个最简单的可重现错误的脚本
*您得到的'''确切的'''错误信息
*VirutalDub(Mod)的版本号
*从VirtualDub->File->File Information中获得的所有文件信息
*使用的插件版本
*编解码器以及输入素材的图像尺寸

BUG报告可以提交到[http://sourceforge.net/projects/avisynth2 AviSynth2的SourceForge Project页面]。提交前请先在该页面确认是否存在和您遇到情况相近的BUG，请注意这确实是有可能的。外部插件的错误应提交给插件作者，而不是给我们。

一个能获得帮助的好地方是[http://forum.doom9.org/forumdisplay.php@s=&forumid=33 Doom9论坛]。请在提出问题前先搜索论坛是否有相关讨论，那里有很多讨论主题！如果有，您可以直接参加讨论。

Avisynth 2.5中文文档

2008-09-03T13:49:42Z

秋月くれは：/* 常见问题 */

这是NMM开展的AVISynth文档中文化计划。

　　我们希望借助将AVISynth的文档中文化，达到推广AVISynth使用，普及视频处理知识的目的。这份文档是基于AVISynth安装之后自带的HTML版文档翻译而成。

　　目前中文化工作刚刚开展，WIKI程序也刚刚搭建，如果有版面安排不当，内容不全的问题，还望见谅。

　　我们使用MediaWiki搭建了WIKI平台，为了便于管理和维护，我们没有开放普通注册用户的编辑权限。如果您想为本计划贡献一份力量，那么请将您的注册用户名在[http://www.nmm-hd.org/bbs NMM论坛]留言，我们会将您添加至编辑权限组。本WIKI还处在测试阶段，如果出现各种问题还请见谅。

　　维护人员：Dgwxx VempX

　　编写人员：Dgwxx VempX mikoto Nelson Galaxy Holy Lititude

==初步了解==

===视频编辑===

　　基本上来说，AviSynth是这样工作的：首先，你会创建一个包含命令的简单文本文档，它叫做脚本。这些命令代表若干个你想要的视频以及想要运行的滤镜。然后，当你运行一个视频程序，例如VirtualDub，并且打开刚才的脚本时，AviSynth就会运作起来。它会加载脚本中的视频，并且运行指定的滤镜，然后将结果输出给视频程序。然而视频程序并不知道AviSynth在后台运行，而是以为自己在直接读取一个硬盘上的AVI文件。

　　AviSynth2增加了很多新功能，为了突出这些功能（尤其因为他们在以前的文章中都没有被完好阐述过），我们在这篇文章中把它们标记为v2''。

　　由于v2.5在内核上做了较大的升级，请在使用前仔细阅读AviSynth v2.5。相关升级都被标记为v2.5。

====线性编辑：====

　　在AVISynth里能做的最简单的事就好比在VirtualDub里的编辑视频。因为这些语句都太好写了，不需要担心变量以及复杂的表达式。

　　作为测试，请先创建一个文件命名为“test.avs”，然后输入如下一行文字：

Version

　　现在用Windows Media Player或其他来打开这个文件，你会看到一个10秒钟的写有AVS版本号及版权信息内容的视频片段。

　　Version叫做“源滤镜”，这意味着它的作用是生成片段而非修改。在AVISynth脚本中第一个命令永远是源滤镜。

　　现在加入第二句，让它看起来是这样：

Version
ReduceBy2

　　在Media Player中再次打开这个文件，你应该还可以看到那些版权信息，不过只有以前的一半大小。'''ReduceBy2'''是一个“变换滤镜”，它会以某种方式改变原有的视频片段。你可以连续使用多个变换滤镜就好像在VirtualDub里一样。

　　让我们再加一句使视频变成淡出至黑色的结尾，它应该是这个样子：

Version
ReduceBy2
FadeOut(10)

　　现在再次打开文件，片段的前9秒应该是一样的，而最后一秒会平滑的淡出到黑色。

　　FadeOut滤镜需要一个数值，用来代表淡出所需的帧数。

　　渐变开始之前的时间太长了，所以我们需要修剪视频的起始部分以减少等待的时间。

　　我们扔掉前120帧，保留120-150帧：

Version
ReduceBy2
# 砍掉前119帧，保留120-150帧
# (AVISynth的起始帧数是从0算起的)
Trim(120,150)
FadeOut(10)

　　在这个例子中，我们第一次使用了注释。

　　注视以”#”开头，一直到最后一个字母结束，是被AVISynth完全忽视掉的。Trim滤镜需要两个数值，以逗号“,”(英文半角，AVS脚本内一切皆为英文半角)分开，两个数分别代表视频中要保留的起始帧和中止帧，若最后一帧输入的是0，就代表到视频片段的最后一帧。所以如果要砍掉前119帧，可以输入Trim(120,0)。

　　像这样把帧数仔细记录真是一件麻烦事，在VirtualDub等这样的程序里直接打开一个部分完成的脚本就方便多了，它会把帧数都为你显示出来。你还可以用ShowFrameNumber滤镜，它会把帧数直接打在视频上。

　　其实实际使用中在AVISynth里有一个比Version实用很多的源滤镜，就是AVISource，它用来从硬盘中读取一个AVI（或其它视频格式）的文件。如果你手头上已经有了一个AVI文件，那么你可以试试把这些相同的滤镜加到你的文件上。

AVISource("d:\capture.avi") # 这里要写你实际的路径和文件
ReduceBy2
FadeOut(15)
Trim(120,0)

　　只有单独一行AVISource命令的脚本可以为只支持小于2GB文件的视频程序提供大于2GB文件的支持。

----

====非线性编辑：====

　　好了我们到了有趣的部分了，建立一个有如下语句的AVS文件：

StackVertical(Version, Version)

　　打开它，结果是这样：输出的视频中有两行一模一样的版本信息，一行在另一行之上。

　　StackVertical不需要数值或是字符串作为参数，而是需要视频剪辑。在以上语句当中Version滤镜被两次调用，每一次都返回给StackVertical一个版本信息的视频，于是StackVertical把它们拼在一起（不管那视频从哪儿来的）。

　　UnalignedSplice也是有用的此类滤镜之一，它可以将视频剪及首尾相接，这段语句就是将3段视频（例如可能是AVI_IO生成的）读取并连接在一起：

UnalignedSplice(AVISource("d:\capture.00.avi"), \
AVISource("d:\capture.01.avi"), \
AVISource("d:\capture.02.avi"))

　　StackVertical和UnalignedSplice都可以接受少到两个多到六七十个的视频。你也可以用加号“+”代替UnalignedSplice，作为速记。

　　比如说这段语句，与上段语句的功能是一样的：

AVISource("d:\capture.00.avi") + \
AVISource("d:\capture.01.avi") + \
AVISource("d:\capture.02.avi")

　　现在假设你的一个程序捕捉到的视频存到了多个AVI片段里，但音频又存到了一个单独的WAV文件里，你能把他们重新组合在一起么？你说呢：

AudioDub(AVISource("d:\capture.00.avi") + \
AVISource("d:\capture.01.avi") + \
AVISource("d:\capture.02.avi"), \
WAVSource("d:\audio.wav"))

----

===语法===

====表达====

　　一个AVISynth的脚本当中会有形如以下的陈述：

variable_name = expression （变量名 = 表达）

　　在这个例子当中expression被求值并将结果赋予variable_name

　　还有一个很重要的省略形式：

expression

　　以上语句当中expression被求值并将结果赋予一个特殊的视频片段变量last。

　　功能与以下语句相同：

last = expression

　　结尾通常是这样：

return expression

　　在这里expression被求值并用作了这个脚本的返回值，也就是说，若这个AVS文件被打开，视频程序看到的仅是这个值的视频片断。

　　若返回值没有被特意指派，那么last的值就会被用作返回值。

　　基本的调用函数的表达如下：

Function(args) 函数（参数）

　　视频剪辑函数从来都是创建一段新视频而不更改现有视频。

　　args是一串以逗号“,”分隔开的函数参数列表，这个列表可以是空的（意味着所有参数或者部分参数可选）。

　　如果滤镜函数的第一个参数是一个视频剪辑，并且这个视频剪辑并没有被提供，那么将用特殊变量last来替代。

　　AVISynth的滤镜可以识别指定参数(arg=expression)，它们之间的顺序可以随意调换。没有被指定的参数将使用默认值，这会使某些滤镜用起来简单些。

　　你可以写：

Subtitle("Hello, World!", text_color=$00FF00, x=100, y=200)

　　而不用这样：

Subtitle("Hello, World!", 100, 200, 0, 999999, "Arial", 24, $00FF00)

　　　

==核心滤镜==

内容后续添加，敬请期待……

==扩展滤镜==

内容后续添加，敬请期待……

==常见问题==
请参照[[AviSynth2.5疑难解答]]

==FAQ==
请参照[[Avisynth2.5_FAQ]]

==FAQ-YV12==

内容后续添加，敬请期待……

==进阶讨论==

内容后续添加，敬请期待……

==版本历史==

内容后续添加，敬请期待……