用户手册 on Aegisub

主页

Mon, 01 Jan 0001 00:00:00 +0000

欢迎来到 Aegisub 手册。要获取更多关于此程序的信息，请查看我们的关于页面，或浏览左侧栏中各个主题的文章。与开发、编译 Aegisub 相关的文档位于 Bug 跟踪系统上。

开始

关于

Mon, 01 Jan 0001 00:00:00 +0000

开发 Aegisub 的初衷是让字幕排版的工作（尤其是对动漫字幕组而言）不再那么痛苦。在这个项目诞生之初，许多支持 ASS 格式的字幕软件都因缺少一些关键功能（时至今日，它们中的多数依然没有改善；此外，几款竞品的开发进程也出于各种原因而中止，当然这与 Aegisub 没有任何联系），或是 bug 太多、不够可靠，导致它们并不真正实用。

概述

Mon, 01 Jan 0001 00:00:00 +0000

这张截图展示的是打开所有面板的Aegisub主窗口：

两个最重要的区域是字幕栏和编辑框。

字幕栏显示您正在编辑的文件中的所有字幕行。所有行标有不同的颜色，这取决于他们的属性。例如，背景色为绿色的行是所选行。蓝色背景的行是注释行且不会显示在屏幕上。黄色背景的行是在当前帧能看见的行。红色字的行是与当前所选行时间重叠的行。从这里点击一行来编辑它。

亮点

Mon, 01 Jan 0001 00:00:00 +0000

Aegisub 的一些亮点：

简单易用却不失强大的编辑界面

在拼写检查／词典、翻译助手、特效标签提示、语法高亮以及各种脚本宏的协助下，字幕的翻译、编辑与校对将变得前所未有地简单。
误操作了？系统崩溃了？不用担心！Aegisub 的多级撤销／重做、自动保存、备份和应急恢复等特性帮您挽救您的字幕文件，从容应对系统崩溃、程序崩溃等诸多不测。

多种格式与字符集的支持

Aegisub 并不限制您使用某种特定的格式，它支持多种字幕格式（无论是 TTXT 还是 MicroDVD）的导入与导出操作。
多语言字幕？使用不支持 Unicode 的旧软件生成的字幕？完全没问题！Aegisub 对 Unicode 和大多数常见的过时编码方案都有完善的读取、写入支持。

强大的视频输入模式

Aegisub 原生支持几乎所有的视频格式，但如果这仍然无法满足需求，Aegisub 还可以调用您系统中的 DirectShow 环境来打开任何能够使用 Windows Media Player 播放的格式。
在您输入内容的同时，预览画面将会自动、实时地更新，让您能够直观地看到字幕在播放器中的实际样式。
完全支持可变帧率（variable frame rate）视频与 Matroska 时间码。Aegisub 能够直接读取 Matroska 媒体文件中的时间码，无缝集成于 VFR 视频的工作中。
长宽比变形？过扫描？Aegisub 拥有专门处理这类视频的工具。

可视化排版工具

为排版工作减负！无需手动编辑特效标签，您可以直接使用鼠标对画面上的字幕进行拖动、旋转和裁剪。
想要在不同分辨率或长宽比的视频中复用您的排版？无法辨别出视频中字符所使用的颜色？Aegisub 的相关工具可为您化解难题。

直观且可定制的音频打轴模式

利用高度可定制的音频工作界面，您将能以任何您喜欢的方式来制作对白或卡拉OK的时间轴。打轴从未如此轻松！频谱分析模式、时间后续处理器等功能甚至可以让这个过程更为高效。
支持几乎所有现存的音频格式。如果您恰好遇到了 libavcodec 无法识别的格式，还有 DirectShow 作为备选方案。

通过自动化脚本解决一切问题

上述功能还不能让您满意？您可以使用 Lua 语言来编写宏或导出滤镜来扩展软件的功能。
Aegisub 内置了一些现成的脚本，便于您快速地生成属于您自己的卡拉OK字幕特效。

贡献者名单

Mon, 01 Jan 0001 00:00:00 +0000

Aegisub 最初由 Rodrigo Braz Monteiro 所编写，Niels Martin Hansen 在此过程中也做出了重要贡献。开发工作在 2008 年由 Monteiro 主导，2010 年由 Hansen 接替，2011 年以后则由 Thomas Goyne 负责。

主程序

主要开发者：
- Rodrigo Braz Monteiro (ArchMage ZeratuL) - Lead developer, video system, audio system, subtitles I/O, tools
- Niels Martin Hansen (jfs) - Automation, Lua automation, audio system, tools
- Thomas Goyne (Plorkyeran) - Lead developer for 3.0 onwards.
开发组成员：
- Karl Blomster (TheFluff) - General code, FFmpegSource video provider
- Fredrik Mellbin (Myrsloik) - FFmpegSource and Avisynth-related code
- Amar Takhar (verm) - New unix build system
- David Lamparter (equinox) - Unix port
- Alysson Souza e Silva (demi_alucard) - General code
其他贡献者：
- Dan Donovan (Dansolo) - Miscellaneous tools
- Patryk Pomykalski (Pomyk) - Miscellaneous patching
- ai-chan - ASSDraw3
- Evgeniy Stepanov (Azzy) - Some Linux patches, libass
- Mike Matsnev (Haali) - Some DirectShow code and Matroska Parser library
- 2points - Linux patches
- p-static - Linux patches
- David Conrad (Yuvi) - Mac patches
- Daniel Moscoviter (Mosc) - General patches
- Harukalover - Usability, various patches
- SAPikachu - General patches
- tophf - General patches
- nodame - General patches

安装程序

2.x：
- Niels Martin Hansen (jfs)
- Fredrik Mellbin (Myrsloik)
- Rodrigo Braz Monteiro (ArchMage ZeratuL)
早期：
- movax

用户手册

3.x：
- Thomas Goyne (Plorkyeran)
2.x：
- Karl Blomster (TheFluff)
- Niels Martin Hansen (jfs)
- Rodrigo Braz Monteiro (ArchMage ZeratuL)
早期：
- Motoko-chan
- Kobi
- movax
- Jcubed

内容托管

当前：
- DeathWolf: SVN repository for versions 2.1.2+
- Sigurd Tao Lyngse (Bot1): Forums and Main Wiki
- Niels Martin Hansen (jfs): Bug Tracker
- Marcello Bastéa-Forte: Documentation Wiki
- Rodrigo Braz Monteiro (ArchMage ZeratuL): Domain administration
早期：
- David Lamparter (equinox): SVN repository for versions 2.00 - 2.1.2
- BerliOS: SVN repository for version 1.10
- Mentar: SVN repository up to version 1.09
- Bot1: Bug Tracker

本地化

2.00 翻译：
- ArchMage ZeratuL: Brazilian Portuguese
- Ereza: Catalan
- Yuri: Hungarian
- Hiroshi: Japanese
- Jeroi: Finnish
1.11 翻译：
- Karasu: Traditional Chinese
1.10 翻译：
- TechNiko: French
- Crysral: French
- thrash-sensei: Russian
- equinox: German
- Nesukun: Spanish
- EmBolo: Italian
- Mazinga: Italian
- oblisk: Korean
- mulrich: Danish

额外致谢

Combined Community Codec Pack staff
Gabest for VSFilter
squid_80 for the x64 builds of Avisynth and CSRI-enabled VSFilter
Firebird for some of the toolbar icons
Kayle for help with Win32 VfW interface
ender for yawning a lot
Alpha testers: b0nk, Bot1, deathbygirl, DoGfOoD, grimlock, Jagobah, Jcubed, Kintaro, Kobi, kodachrome, maxx-, mASSIVe, Maya, Mentar, movax, msb, neo2sonic, nich, nwa, omgifos, SOzuken, TheFluff, thrash_sensei, Vincent, zegnat

General Disclaimer

Mon, 01 Jan 0001 00:00:00 +0000

This manual is a work in progress. It is at present incomplete and no information in it can be taken for granted. We attempt to be accurate on every point, to a reasonable degree.

Aegisub is software under constant development. While it is a goal to provide up-to-date documentation there will almost always be cases where the actual functionality of the program has changed since this documentation was last updated.

支持

Mon, 01 Jan 0001 00:00:00 +0000

您想支持 Aegisub 吗？这很简单！

反馈

您可以向我们提交反馈——通过意见、评论、建议等形式，也随时欢迎您报告 bug 或提出增添新功能的要求。您可以访问我们的论坛和 Bug 跟踪系统，或是到 IRC 频道上和我们聊聊。

FAQ

Mon, 01 Jan 0001 00:00:00 +0000

Aegisub 的常见疑问小整合——大多是其他页面没有涉及的问题。

制作卡拉OK特效？

请阅读卡拉OK模版教程。

我能用 Aegisub 制作 DVD 字幕吗？

不能直接做，不过有一款实用的软件叫作 MaestroSBT，它可以将 SSA 转换为 VOBsub。由于这款软件在特效标签以及其他方面有着诸多限制，所以建议您先阅读一下它的使用说明。还需特别注意，它不支持 ASS——只支持 SSA。您可以在 Aegisub 的“文件 -> 导出字幕…”对话框中将字幕另存为 SSA 格式。

教程

Mon, 01 Jan 0001 00:00:00 +0000

以下教程可供学习 Aegisub（视频使用英语讲解）：

视频教程（录屏）

对白计时

简介：讲解如何使用 Aegisub 制作时间轴。
作者：Karl Blomster
链接：http://mod16.org/aegisub/timingtutorialimprovisation.mkv
简介：展示一位经验丰富的用户使用 Aegisub 全速打轴。

卡拉OK计时

Mon, 01 Jan 0001 00:00:00 +0000

本篇教程将介绍如何用Aegisub读取一首歌, 将歌词划分成音节并添加时间码。

这篇教程基本是为零起点的人准备的。

开始之前

开始之前我们要准备好一些东西:

一首歌的音频文件。文件的格式可以是 MP3 或者在视频文件中。Aegisub能从视频中读取音频，在不出意外的情况下，你无须从视频中提取音轨出来。

这首歌的歌词。如果是已经分好段的纯文本(.txt 文件)，后续工作会更简单。

这里使用一首日文歌作为例子。但是不得不提一下，Aegisub的大多数高级歌词功能都是为日语或者其它语言设计的。这些语言最终可以被体现为西文字母(罗马音、汉语拼音)。具体用法见视频教程。

卡拉OK内联特效

Mon, 01 Jan 0001 00:00:00 +0000

卡拉OK inline-fx（内联特效）可以用来给打过k的时间轴的不同部分分配不同的特效。

inline-fx标记本身并不会有任何影响，只有当应用可以识别它的卡拉ok特效脚本时才会应用于打了k的轴。

标记

内联特效标签是一个（无效的）ASS特效标签，格式是\-特效名，其中 特效名 是内联特效所定义的。

注音卡拉OK

Mon, 01 Jan 0001 00:00:00 +0000

Furigana (in Aegisub often shortened to furi) refers to little phonetic guide characters written along the main text in Japanese, specifically using the hiragana phonetic alphabet to describe how the ideographic kanji characters should be pronounced. Putting smaller text next to a main line of text is in general referred to as ruby text, but since the implementation discussed here is designed specifically with Japanese furigana in mind, the ruby text is also referred to as furigana everywhere.

编辑字幕

Mon, 01 Jan 0001 00:00:00 +0000

开发Aegisub的目的是编辑字幕。本页面将会就字幕的基本文本编辑进行一系列的讲解；若想了解更多关于字幕排版的信息，请看排版。关于字幕的时间轴编辑，另见载入音频。

打开字幕

在文件菜单中，提供了4种打开/创建字幕的方式：

导出

Mon, 01 Jan 0001 00:00:00 +0000

在常见的 “保存字幕” 和 “另存为字幕” 功能外，Aegisub还有一项 “导出字幕"功能，它可以通过输出滤镜筛选保存你想要的信息。它可以达到许多目的，例如输出帧率转换后的脚本、卡拉OK特效脚本为其他支持的格式。

将字幕加到视频上

Mon, 01 Jan 0001 00:00:00 +0000

在数字化编码中，有两种方式可以把字幕融入到视频文件中: 软字幕和硬字幕。两种方法都有其独特的优缺点，有关两种方式优劣的讨论也未曾停止过。

硬字幕

硬字幕是一种把字幕 “烧录” 在视频部分中的方法。数字硬字幕更像是VHS录像带；字幕是不能被关闭的。

拼写检查器

Mon, 01 Jan 0001 00:00:00 +0000

为了保障字幕的质量，Aegisub 特意为您准备了一个完善的拼写检查器。它采用了由 OpenOffice.org 的 MySpell 发展而来的 Hunspell 拼写检查库，这意味着 Aegisub 的纠错能力将不亚于同样使用了 Hunspell 的高级文字处理软件（※译者注：例如 WPS Office、印象笔记等）。您可以通过"字幕 -> 拼写检查器 “打开它，它会在您输入内容的同时进行检查。此外，字幕编辑框的右键菜单中也有与之相关的选项（详见编辑字幕）。

翻译助手

Mon, 01 Jan 0001 00:00:00 +0000

翻译助手是一个很有用的翻译辅助工具。它可以让您以最高效的方式翻译字幕，而不必为选取文字的事情费心，也无需担心忘记原文的内容。在您翻译时，它还能从文本中识别出 ASS 特效标签并自动略过它们。

选择性粘贴

Mon, 01 Jan 0001 00:00:00 +0000

选择性粘贴是传统的 Ctrl+C & Ctrl+V 组合键的"智能"升级版。它可以在不影响其他字段的情况下，将一行或多行字幕中特定字段的内容粘贴至对应的区域。您可以通过"编辑 -> 选择性粘贴 “来打开，也可以在字幕栏的鼠标右键菜单中找到它。

选择多行

Mon, 01 Jan 0001 00:00:00 +0000

选择多行用于选取符合特定标准的字幕行，是一个非常实用的工具。它有许多应用场景，从删除所有注释行到查找某个说话人的全部台词，不一而足。您可以从"字幕 -> 选择多行" 打开它。

排版

Mon, 01 Jan 0001 00:00:00 +0000

维基上关于排版的定义: “排版可以指文字材料在纸或其它一些介质上的可视化呈现。” 在字幕工作的环境里，它意味着下面的三件事：

把对话以一种更易于阅读和更佳的视觉效果形式呈现给观众。
翻译背景里所有外语文字（如选段标题，背景里的时间/地点和其他推动情节发展的重要文字），并且把翻译呈现给观众，最好让翻译和原文一起出现（但保留可读性）。
在视频里面设计其他文字（如logo，卡拉OK特效等等）

尤其在一些字幕组里，“排版"通常意味着第二点或者第三点

视频

Mon, 01 Jan 0001 00:00:00 +0000

Aegisub不是一个视频（或媒体）播放器，但它依然支持载入多种视频文件。这一篇就是关于Aegisub是如何载入和处理视频文件的，如果你只是想做一个安静的美男子（萌妹子），建议您还是直接参考排版教程或可视化排版 .

样式

Mon, 01 Jan 0001 00:00:00 +0000

样式在ASS格式中是指一套固定的字幕排版方案。样式可以在单独的行里被特效标签覆写;由于样式的存在，你不必再单独为每一行进行排版。

样式管理器

Aegisub的样式管理器工具 (字幕菜单下可找到) 提供了多种多样的方式以便组织保存和编辑字幕样式，它看起来是这个样子:

可视化排版

Mon, 01 Jan 0001 00:00:00 +0000

关于这个功能，你能在视频教程中找到。

总览

播放

播放视频, 从当前帧开始。查看使用视频来获取Aegisub中有关的信息。

播放当前行

从当前活动行的开始帧播放视频，到该行结束帧停止。

自动定位视频至行开始帧

当选择新一行时，视频自动定位到该行的开始帧。

ASS标签

Mon, 01 Jan 0001 00:00:00 +0000

The following is a list of every tag supported by the Advanced Substation Alpha format. This is basically a detailed version of ass-quickref.txt. See the tutorial for an introduction to typesetting, using some basic tags.

下面列出所有ASS格式支持的标签。这基本上算是ass-quickref.txt的一个详细版本。你可以在本教程手册的排版教程获取关于使用一些基本标签来排版文本的教程。

颜色选择器

Mon, 01 Jan 0001 00:00:00 +0000

Aegisub引入了一个比Windows自带取色器高端很多的颜色选择器。它允许你使用不同的色彩空间输入颜色值，可以直接输入16进制的HTML和ASS颜色值，也可以从迷你截屏中取色或者使用三种不同的色彩光谱取色。

样式助手

Mon, 01 Jan 0001 00:00:00 +0000

样式助手对于处理多样式字幕文件是一个有用的工具，例如碰到几个说话人都拥有各自的样式的时候，或者其他一个字幕中含有很多样式的情况。

总览

从上图我们能看到，样式助手由以下区域组成:

重设分辨率

Mon, 01 Jan 0001 00:00:00 +0000

重设分辨率是一个Aegisub自带的工具，用来修改脚本分辨率同时修改所有与脚本分辨率相关的特效标签，所以应用过后看起来的效果能保持一致。它能根据分辨率修正所有边距的偏移量(甚至绝对位置)。它的用途包括：合并两个不同分辨率的脚本文件；对一个脚本进行4:3到16:9的比例适配；也能在像素宽高比1:1和变形像素比例之间进行转化。

字体收集器

Mon, 01 Jan 0001 00:00:00 +0000

字体收集器是一个自动化工具，它可以收集目前脚本中的所有字体，扫描系统的字体文件夹，并复制字体文件到你所选择的指定目录下。对话框看起来是这个样子：

音频

Mon, 01 Jan 0001 00:00:00 +0000

毫不夸张的说，Aegisub有着很先进的、可定制的音频模式，它既能显示波形也能显示频谱。有几种方式可以进行整句时间轴编辑和卡拉OK时间轴编辑。

制作时间轴

Mon, 01 Jan 0001 00:00:00 +0000

主音频视图

当你加载了音频文件，Aegisub将会出现如下图的界面：

你可以按住并拖动该视图底部来改变音频波形/频谱显示的高度。

右边那几个能按下去的是切换按钮。按下去表示启用。按钮和控制按键的功能如下（许多默认都有快捷键）：

平移时间

Mon, 01 Jan 0001 00:00:00 +0000

平移时间 工具用来批量处理时间轴；它可以以不同的方式调整行的开始/结束时间。你可以在计时 -> 平移时间 中使用。

它看起来是这个样子:

窗口的左侧包含几个选项。

时间后续处理器

Mon, 01 Jan 0001 00:00:00 +0000

时间后续处理器是很有用的工具，它可以通过各种方式来自动修正时间。

总览

正如截图所示，该工具具有三个功能:

提前开始/延后结束
使相邻字幕行连续，通过延后或者提前它们的开始和(或)结束时间
使行的开始/结束时间紧贴关键帧(只有在读取了视频的情况下才有效)

汉字计时器

Mon, 01 Jan 0001 00:00:00 +0000

汉字计时器使得把打好K值的时间轴快速赋予到一条未打K值的时间轴非常方便。它多用于日文歌曲的卡拉OK时间轴制作。(常用于快速对应日文和罗马音)

这里有个汉字计时器的实际操作演示视频: 下载演示视频 (XviD MP3 AVI, 5 min 20 sec, 12 MB)

自动化

Mon, 01 Jan 0001 00:00:00 +0000

自动化这个名词涵盖了Aegisub全部的脚本功能。

关于自动化

自动化的目的单纯得就像名字一样——能够自动完成字幕创作和编辑的不同的功能。原本主要用于创作卡拉OK特效，但随着时间推移，用法也变得多样，支持更多的通用宏来向Aegisub添加新的功能。

卡拉OK模版执行器

Mon, 01 Jan 0001 00:00:00 +0000

卡拉OK模版执行器是一个Aegisub自带的自动化脚本。它的主要目的是帮助你使用特别设计的模版语言来制作卡拉OK特效。卡拉OK模版执行器已随Aegisub安装并可以使用。

教程：卡拉OK模版执行器介绍

一个简单的例子
使用数学表达式
Using multiple template lines
More advanced effects with positioned syllables

TODO: 计划制作更多教程，并补完上面的教程。

对于使用过 multi-template 的用户

译者注：从2.x或是3.x版本入门的用户可以无视下面这块……

声明template行和code行

Mon, 01 Jan 0001 00:00:00 +0000

本文档讲解如何声明template行和code行

template行和code行要把注释（Comment）左边的方框打上√

在特效栏，第一个被空格分隔的单词决定了该行是template行还是code行，是打好时间的karaoke行，还是设置好样式（被应用模板后）的karaoke行抑或其他的东西。

如果在特效栏填入的第一个单词是template，这行就是template行。

如果在特效栏填入的第一个单词是code，这行就是code行。

如果在特效栏看到 fx，这行就是karaoke行被应用模板后生成的行，执行自动化模板时，这些行首先会被删除。

如果在特效栏看到Karaoke，karaoke 或者是空白的，这行就是打好时间的karaoke行。

如果特效栏含有其它的东西，这行就是未声明类型，不会被自动化模板执行器处理。

Template行和code行可以在template或code之后添加额外的文本，这些文本用一系列的被空格分隔的单词组成，被称作修饰语。欲了解更多请阅读Template修饰语。

卡拉OK模板执行环境和顺序

Mon, 01 Jan 0001 00:00:00 +0000

本页描述了许多有关卡拉OK模板执行器(kara-templater) 的工作方式，并且会解释为什么许多东西起作用，而另一些不起作用。

大多数的细节你在卡拉OK模板执行器中是不需要用到的，但是如果你在某些脚本中看到了你不理解的行为，那么本页面可能会解释它。

模版修饰语

Mon, 01 Jan 0001 00:00:00 +0000

template行和code行都可以带上几种修饰语

在修饰语和模板行类型中间请留一个半角空格，即在template 或 code 后面添加空格后再添加修饰语。

内联变量

Mon, 01 Jan 0001 00:00:00 +0000

本文档讲解在卡拉OK模板自动化时可用的内联变量（$变量）。

如何使用内联变量（inline variables）

所有的内联变量头部都是一个$符号。内联变量只能用在template行，而不能用于code行。不过你可以在模板行的code区使用它们。

Code行和 Code区

Mon, 01 Jan 0001 00:00:00 +0000

Code行和Code区是由卡拉OK模板执行器产生的概念，它们允许你使用小段的Lua代码来创作高级特效。代码可以是几个数字之间的简单运算，也可以是复杂的函数，例如生成各种各样的图形和颜色。

Execution envirionment

Mon, 01 Jan 0001 00:00:00 +0000

在code区和code行的Lua代码运行在一个隔离的全局环境，这让它们不会意外地影响到主脚本函数。

为了后期使用，你可以把你的数据存放到这个环境里，例如先在code行预先计算一些数值，然后后期再用code区把它们添加进模板。这个环境也可以包含许多预先定义的变量和函数，它们可以让特效模板书写起更加方便。

Automation Tutorials

Mon, 01 Jan 0001 00:00:00 +0000

教程一

Mon, 01 Jan 0001 00:00:00 +0000

欢迎来到这里！这是有关卡拉OK模板执行器的第一篇教程，它可以帮助你创作卡拉OK特效。在一系列教程里，我们由简单到复杂来进行教学。

找到卡拉OK模板执行器(Karaoke Templater)

你可以用两种方式运行卡拉OK模板应用器。我们主要讲解其中一种。

在Aegisub中的自动化菜单下找到卡拉OK模板应用器。

教程二

Mon, 01 Jan 0001 00:00:00 +0000

在前一篇教程中，我们了解了如何使用卡拉OK模板执行器的基本特性，并且能创作简单的卡拉OK效果。本篇中，我们将继续走下去，拓展一些知识。

TODO: 制作并插入截屏

准备

就像前篇一样，准备好打好K值的行和用来预览效果的视频。在此不赘述有关细节。

Lua 相关

Mon, 01 Jan 0001 00:00:00 +0000

Automation 4 Lua脚本引擎基于5.1版本的Lua脚本语言。

此手册不会涉及Lua语言本身与Lua附带的标准库，而只会介绍Aegisub Automation 4附加的功能和数据结构。请参阅Lua 5.1 手册来了解语言本身和它的标准库。

注册

Mon, 01 Jan 0001 00:00:00 +0000

注册涵盖了以下内容：使你自己编写的Lua脚本Automation 4 Lua出现在Aegisub中、提供和脚本有关的信息、该脚本提供了什么样的特性。

有关特性(Feature)的解释

Automation 4 中的一个最基础的概念就是特性。特性决定了Aegisub如何响应用户的动作去调用脚本。

字幕文件接口

Mon, 01 Jan 0001 00:00:00 +0000

This page describes the subtitle file interface use in Automation 4 Lua scripts to manipulate subtitle files.

此页面描述了用于 Automation 4 Lua 脚本中操作字幕文件的字幕文件接口。

There is one special object (the subtitles user data object) which has a number of functions, and a number of table formats defined.

这里定义了一个拥有多个方法（function）、表格式（table format）定义的特殊对象（subtitles用户数据对象）。

进度报告

Mon, 01 Jan 0001 00:00:00 +0000

There functions are used to report various status and progress back to the GUI while a script is running.

Progress reporting

A progress dialogue box is always shown when an Automation 4 Lua script is running. You can use these functions to control what is displayed in it.

aegisub.progress.set

Synopsis: aegisub.progress.set(percent)

Set the position of the percent-done bar in the progress window.

percent (number): Number from 0 to 100.

aegisub.progress.task

Synopsis: aegisub.progress.task(msg, ...)

对话框

Mon, 01 Jan 0001 00:00:00 +0000

These functions are used to display dialogs for the user to interact with.

Display dialog functions

aegisub.dialog.display

Synopsis: button, result_table = aegisub.dialog.display(dialog, buttons, button_ids)

This function displays a configuration dialog to the user and waits for it to close. It then returns whether the user accepted or cancelled the dialog, and what values were input.

@dialog (table): A Dialog Definition table containing the controls to be in the dialog.
@buttons (table): Optional. This is an array of strings defining the buttons that appear in the dialog. If this is left out, empty or is otherwise not a table, the standard Ok and Cancel buttons appear. The strings in this table are used as labels on the buttons, and for identifying them in the return values of the function.
@button_ids (table): Optional. A table which specifies which buttons in the dialog correspond to which platform button IDs, making it possible to specify which button will be triggered if the user hits Enter or ESC.
button (boolean or string): If no custom buttons were specified, this is a boolean telling whether Ok (true) or Cancel (false) were clicked in the dialog. If custom buttons were specified, this is the text on the button clicked by the user. Even if custom buttons were specified, this can still be boolean false if the user closes the dialog without pressing any button.
result_table (table): The Dialog Result table corresponding to the values the user input in the dialog.

Example

config = {
{class="label", text="Times to frobulate", x=0, y=0},
{class="intedit", name="times", value=20, x=0, y=1}
}
btn, result = aegisub.dialog.display(config,
{"Frobulate", "Nevermind"},
{"ok"="Frobulate", "cancel"="Nevermind"})
if btn then
frobulate(result.times)
end

aegisub.dialog.open

Synopsis: file_name = aegisub.dialog.open(title, default_file, default_dir, wildcards, allow_multiple=false, must_exist=true)

杂项API

Mon, 01 Jan 0001 00:00:00 +0000

This page documents miscellaneous APIs useful for working with subtitles. These can’t be clearly placed into any of the other main categories and there’s too few of each kind to warrant a separate category.

aegisub.cancel

Synopsis: aegisub.cancel()

Immediately end execution of the current script, rolling back any changes that have been made in it.

This function never returns.

aegisub.text_extents

Synopsis: width, height, descent, ext_lead = aegisub.text_extents(style, text)

Obtain system font metrics and determine the rendered size in pixels of the given text when using the style.

Lua模块

Mon, 01 Jan 0001 00:00:00 +0000

Aegisub内置了许多lua模块。一些模块例如 karaskel.lua 用来实现字幕特效功能，而其他的模块例如 re 则补充了Lua标准库缺少的部分内容。

使用模块

在脚本顶部添加modulename = require 'aegisub.modulename' 格式的代码即可。例如，想要包含 re 模块，就添加一句:re = require 'aegisub.re'.

karaskel.lua

Mon, 01 Jan 0001 00:00:00 +0000

Automation 4的核心文件 karaskel.lua 内置了许多函数，用来协助Automation 4 Lua方面的卡拉OK特效制作它定义了几种新的数据结构，也拓展了Automation 4 本身定义的一些。

utils.lua

Mon, 01 Jan 0001 00:00:00 +0000

Automation 4 Lua include的文件 utils.lua 包括了多种不同的辅助函数来帮助你写Lua脚本。这个文件并没有统一的主题。

用法

使用 util = require 'aegisub.util' 来导入这个模块。

Table functions

以多种方式复制一个table是经常要做的工作之一。 util 提供了一些函数来解决这些问题。

unicode.lua

Mon, 01 Jan 0001 00:00:00 +0000

unicode模块包含一系列为Auto4设置的辅助函数，主要用来处理 UTF-8 编码的文本。

用法

用 unicode = require 'aegisub.unicode'导入模块。

unicode.charwidth

摘要：width = unicode.charwidth(instring, index=1)

cleantags.lua

Mon, 01 Jan 0001 00:00:00 +0000

TODO: Write documentation

剪贴板

Mon, 01 Jan 0001 00:00:00 +0000

clipboard模块提供读取和写入剪贴板的函数。

使用

使用clipboard = require 'aegisub.clipboard'导入此模块。

clipboard.get()

示例：text = clipboard.get()

re

Mon, 01 Jan 0001 00:00:00 +0000

re模块是对 boost::regex 的封装，旨在完全替代 Lua 内置的正则表达式。相比 Lua 的内置正则表达式，它具有两个主要优势：

完整的 Unicode 支持。Lua 正则表达式操作的是字节而非字符，这在使用多字节字符时经常引发问题。
更强大、更灵活的语法。严格来说，Lua 并不支持正则表达式；它只具备一种基础的模式匹配语言，仅支持正则表达式功能的一小部分子集。而 boost::regex 则支持 Perl 兼容的正则表达式。

用法

通过 re = require 'aegisub.re' 导入此模块。

自动化脚本管理器

Mon, 01 Jan 0001 00:00:00 +0000

自动化管理器窗口被用来查看，读取和卸载自动化脚本。

自动化管理器窗口从自动化菜单或者按键打开。

脚本列表

窗口的主要区域是已经被挂载的脚本文件.记住一个脚本文件可能含有几个 features，例如一个脚本文件能定义两个宏和一个输出过滤器。

运行宏

Mon, 01 Jan 0001 00:00:00 +0000

自动化的宏是以选项的形式出现在自动化菜单中的。

通常可以使用自动化菜单中的，在分隔线前的第一个选项来打开自动化脚本管理器窗口。

分隔线以下是所有已加载宏的列表。在上面示例图中共加载了七个宏。第三个，卡拉OK模版执行器是不可用状态，因为这个宏不能在当前的字幕文件里运行，这是因为当前字幕文件中没有卡拉OK模版行。其它的宏也可能因其他一些原因而不可用。第四个宏在选项对话框中设置了快捷键。

如果想运行一个宏，只需在自动化菜单中点击一个即可。一些宏可能还会找你要一些参数信息，还有些只会作用于所选的字幕行。当你从网上下到一个宏之后，一定要记得看一下附带的说明。

附带的宏

Mon, 01 Jan 0001 00:00:00 +0000

这里列出了Aegisub自带了几个宏。

应用卡拉OK模版

这个是卡拉OK脚本执行器的宏，用法请参见卡拉OK脚本执行器。

这个宏只有在字幕文件中至少有一行模版行时才可用。

转换为全角字符

将所有ASCII半角字符转为日文的全角字符。

History of Automation

Mon, 01 Jan 0001 00:00:00 +0000

The Automation system in Aegisub has evolved from a very basic and hardly useful stand-alone system for creating basic karaoke effects into a very powerful extension mechanism. Here’s a short account of its history, from the principal author of the systems.

Automation 1, really just Karaoke Effector

The Karaoke Effector program was originally created for making karaoke effects for a small translation project, that later died. It was written in Borland Delphi and used Lua 5.0 for scripting. This use of Lua is the primary reason I even call it “Automation 1” today. It basically allowed creating effects similar to what the simple-k-replacer script from Automation 3 does, but in a more complicated and not as usable way.

选项

Mon, 01 Jan 0001 00:00:00 +0000

Aegisub是可高度定制的软件，因而它有大量的选项供用户选择。这些选项都在选项对话框中，您可以在"查看"菜单里找到。这个页面提供可用选项的说明。

自动保存

Mon, 01 Jan 0001 00:00:00 +0000

默认情况下Aegisub每隔固定的时间就会自动保存一份当前正在编辑的字幕文件的备份(如果在这几分钟内有更改文件内容)。这些备份文件在 Windows 系统中位于 %APPDATA%\Aegisub\autosave，在 Linux 系统中位于 ~/.aegisub/autosave，在 OS X 系统中则位于 ~/Library/Application Support/Aegisub/autosave。您还可以直接在 Aegisub 中通过 “文件” → “打开自动保存的字幕…” 浏览这些备份。

Aegisub路径变量

Mon, 01 Jan 0001 00:00:00 +0000

Aegisub使用一个简单的系统来表示文件的位置。大部分Aegisub表示的路径可以用一个特殊变量表示，每个变量都对应一个路径。注意，路径说明符号末尾应该有，除非它是一个完整路径(例如 ?scripta 就是一个错误写法)。

脚本配置

Mon, 01 Jan 0001 00:00:00 +0000

脚本配置 是指一些头部信息和其他选项，它们会以不同的方式影响整个字幕脚本。在文件 -> 配置中查看和更改。

脚本配置的内容有:

标题, 脚本原作, 翻译, 编辑, 计时, 同步点, 编修者 和 更新摘要 - 这些信息不会影响到任何显示字幕的渲染(只用来填写脚本作者)。如果觉得它们有用就填上合适的内容。

脚本分辨率

Mon, 01 Jan 0001 00:00:00 +0000

ASS字幕文件，在某种程度上可以独立于视频文件使用。这就需要使用虚拟视频分辨率来控制字体大小和坐标，这个分辨率这就是"脚本分辨率"。不幸的是，由于VSFilter的一些BUG，渲染和视频分辨率不同的字幕脚本时这是不可靠的。

附件管理器

Mon, 01 Jan 0001 00:00:00 +0000

附件管理器允许你把字体或者图片附在字幕脚本文件中(通过将它们编码为文本)。有时候用于多人共同工作的脚本上，这样生成的字幕文件和字体是一个整体，免去了小伙伴之间单独传输字体文件的麻烦。然而它的功能有限并且容易引起问题。

Commands

Mon, 01 Jan 0001 00:00:00 +0000

REDIRECT Audio#basicaudiotiming

Mon, 01 Jan 0001 00:00:00 +0000

REDIRECT Shift_Times

Mon, 01 Jan 0001 00:00:00 +0000

REDIRECT Options#hotkeys

Automation script feature

Mon, 01 Jan 0001 00:00:00 +0000

In Automation 4 a feature is a function a script makes available to Aegisub. Currently two kinds of features are specified: Export filters and macros.

If a script defines two macros and one export filter, it is said to have defined three features in total.

宏

Mon, 01 Jan 0001 00:00:00 +0000

In computer programs, a macro is a (usually relatively small) snippet of program code that can easily be added to the program, to add a new function or such, intended to automate some aspect of using the program.

卡拉OK特效

Mon, 01 Jan 0001 00:00:00 +0000

卡拉OK就是（业余爱好者）跟着唱一首歌，通常是只有伴奏的版本。当唱卡拉OK时歌词通常会显示在电视屏幕上，并且会把唱过的部分高亮显示。

而在字幕制作中，卡拉OK通常是指那些歌词本身。卡拉OK特效是指它们被高亮的方式。

用户手册 on Aegisub

主页

开始 #

关于

概述

亮点

贡献者名单

主程序 #

安装程序 #

用户手册 #

内容托管 #

本地化 #

额外致谢 #

相关项目 #

General Disclaimer

支持

反馈 #

FAQ

制作卡拉OK特效？ #

我能用 Aegisub 制作 DVD 字幕吗？ #

教程

视频教程（录屏） #

对白计时 #

卡拉OK计时

开始之前 #

卡拉OK内联特效

标记 #

注音卡拉OK

编辑字幕

打开字幕 #

导出

将字幕加到视频上

硬字幕 #

拼写检查器

翻译助手

选择性粘贴

选择多行

排版

视频

样式

样式管理器 #

可视化排版

总览 #

播放 #

播放当前行 #

自动定位视频至行开始帧 #

ASS标签

颜色选择器

样式助手

总览 #

重设分辨率

字体收集器

音频

制作时间轴

主音频视图 #

平移时间

时间后续处理器

总览 #

汉字计时器

自动化

关于自动化 #

卡拉OK模版执行器

教程：卡拉OK模版执行器介绍 #

相关 #

对于使用过 multi-template 的用户 #

声明template行和code行

卡拉OK模板执行环境和顺序

模版修饰语

内联变量

如何使用内联变量（inline variables） #

Code行 和 Code区

Execution envirionment

Automation Tutorials

教程一

找到卡拉OK模板执行器(Karaoke Templater) #

教程二

准备 #

Lua 相关

注册

有关特性(Feature)的解释 #

开始

主程序

安装程序

用户手册

内容托管

本地化

额外致谢

相关项目

反馈

制作卡拉OK特效？

我能用 Aegisub 制作 DVD 字幕吗？

视频教程（录屏）

对白计时

开始之前

标记

打开字幕

硬字幕

样式管理器

总览

播放

播放当前行

自动定位视频至行开始帧

总览

主音频视图

总览

关于自动化

教程：卡拉OK模版执行器介绍

相关

对于使用过 multi-template 的用户

如何使用内联变量（inline variables）

Code行和 Code区

找到卡拉OK模板执行器(Karaoke Templater)

准备

有关特性(Feature)的解释

Progress reporting

aegisub.progress.set

aegisub.progress.task

Display dialog functions

aegisub.dialog.display

aegisub.dialog.open

aegisub.cancel

aegisub.text_extents

使用模块

用法

Table functions

用法

unicode.charwidth

使用

clipboard.get()

用法

脚本列表

应用卡拉OK模版

转换为全角字符

Automation 1, really just Karaoke Effector