1. 下载最新版扩展程序
2. 将你刚刚下载到的压缩文件中的所有文件解压缩到“︀Application Extensions”︀文件夹中。
   如果该文件夹不存在，请新建。
   路径

   C:\ProgramData\VEGAS Pro\Application Extensions

3. 请确保 DLL 文件未锁定。

4. 打开 Vegas Pro 来启动。选择菜单 视图→扩展→Otomad Helper 打开。

音MAD助手是Vegas Pro的音MAD/YTPMV/YTP扩展程序，旨在使Vegas能够接受如MIDI序列文件等乐谱作为输入并自动生成音MAD的轨道。

查看用法部分以了解更多信息，包括如何安装该扩展。

语言

你也可以在任意页面点击右上角的语言按钮来切换语言。

要了解关于Otomad Helper的更多功能，请继续往下看⋯⋯

欢迎修订音MAD助手（Otomad Helper）的说明文档⸺一个Vegas Pro的音MAD/YTPMV/YTP扩展程序。本站点同时涵盖了新版（v8，扩展程序）和旧版（v4，脚本）的说明文档内容。

项目概述

音MAD助手是一个使Vegas Pro能够接受乐谱（如MIDI序列文件）作为输入并自动生成音MAD/YTPMV/YTP轨道的工具。本仓库包含该项目的说明文档网站源代码。

文档涵盖两个主要版本：

技术架构

工作流程： 当代码推送到GitHub的docs分支后，Read the Docs服务器会自动重新构建项目，并生成静态HTML网页。用户可通过 https://otomadhelper.readthedocs.io/zh-CN/ 直接阅读最新文档内容。

单文件多语言文档格式

本项目采用了一种创新的单文件多语言格式。与传统的每种语言单独维护一个文件不同，所有语言的翻译都写在同一个文件中。这样当需要修改错误时，可以同时看到所有语言的对应内容，一次性全部修正。

为什么使用这种格式？

传统的多语言文档方式中，如果文档包含7种语言，修改一个错误需要：

1. 同时打开7个文件（每种语言一个）。
2. 在每个文件中找到错误内容所在的行。
3. 逐个文件修改同样的内容。

使用单文件多语言格式后，各语言的翻译紧挨在一起，可以在同一个位置一次性修改所有语言。

行多语言

以行为单位为其编写多语言翻译。格式以一个 @符号开头，后面紧跟着语言标签，空一格后填写该语言在本行的翻译内容：

﹫en This is English content.
﹫zh 这是中文内容。
﹫ja これは日本語の内容です。

目前支持的语言标签：en（英语）、zh（简体中文）。

块多语言

以块为单位为其编写多语言翻译。适用于大量内容差异或复杂格式的多语言翻译，例如整个表格、警告框等。格式以三个@符号开头，后面紧跟语言标签：

﹫﹫﹫en
This is a large block of English content.
It can span multiple lines and include **formatting**.
﹫﹫﹫zh
这是一大段中文内容。
它可以跨越多行并包含**格式**。
﹫﹫﹫

• 用 @@@ 加语言标签开始一个块。
• 用单独的 @@@（不跟标签）结束整个多语言块。

回退机制

如果在某一段行多语言或块多语言内容中缺少编写了某种语言的翻译内容，网站会自动回退显示为英文文档内容。这意味着你只需要为你会说的语言编写翻译，缺失的语言会自动安全地显示英文。

重要规则

• 不要将行多语言（@）和块多语言（@@@）语法混用于同一段内容⸺选择其中一种即可。
• @或@@@标记必须出现在一行的最开头。
• 对于行多语言翻译，语言的出现顺序可以任意，但保持统一的顺序（例如始终@en在前、@zh在后）有助于提高可读性。

如何编辑文档

以下步骤是为非程序员编写的。你不需要任何编程经验，只需一步步跟着操作即可。如果遇到困难，可以请熟悉电脑的朋友帮忙。

一次性准备工作

以下步骤仅需在第一次配置项目时做一次，以后无需重复。

第一步：安装 Node.js

Node.js 是运行文档工具链所需的运行时环境。

1. 打开浏览器，访问 https://nodejs.org/
2. 点击 LTS（长期支持版）下载按钮⸺这是推荐大多数用户使用的稳定版本。
3. 下载完毕后，双击安装文件（Windows上为 node-vXX.XX.X-x64.msi）。
4. 按照安装向导操作⸺可以全部使用默认设置。
5. 点击完成。

第二步：安装 pnpm

pnpm 是本项目使用的包管理器。

1. 打开命令提示符（开始菜单 → 输入 cmd → 按回车）。
2. 输入以下命令并按回车：
   bash

   npm install -g pnpm

3. 等待安装完成。

第三步：安装 GitHub Desktop

GitHub Desktop 提供了 Git 的图形化界面，这样你就不需要记忆和输入 Git 命令行指令了。

1. 访问 https://desktop.github.com/
2. 点击下载按钮。
3. 下载完成后，运行安装程序。
4. 首次打开 GitHub Desktop 时，会要求你登录 GitHub 账号。如果你还没有账号：
   • 访问 https://github.com/signup 创建一个免费账号。
   • 然后用新账号登录 GitHub Desktop。
5. 按照设置提示操作（对于Git配置相关的提示可以使用默认设置直接跳过）。

第四步：克隆仓库

“︁克隆”︁的意思是将项目的副本下载到你的电脑上。

1. 在 GitHub Desktop 中，点击 File（文件）→ Clone repository…（克隆仓库…）
2. 选择 URL 选项卡。
3. 在 “︁Repository URL（仓库链接）”︁ 字段中输入：

   https://github.com/otomad/OtomadHelper

4. 在 “︁Local path（本地路径）”︁ 中，点击 Choose…（选择…），选择你电脑上想要存放项目的文件夹（例如 D:\Documents\OtomadHelper）。
5. 点击 Clone（克隆）。
6. 重要： 克隆完成后，需要切换到 docs 分支：
   • 在 GitHub Desktop 顶部附近，你会看到一个标有 “︁Current branch（当前分支）”︁ 的按钮（可能显示为 main 或 master）。
   • 点击它，然后从列表中选择 docs 分支。
   • 如果在列表中找不到 docs，请点击分支列表顶部的 “︀Origin”︀ 选项卡⸺仅在GitHub上存在的分支会出现在这里。点击 docs 即可检出该分支。

第五步：安装项目依赖库

依赖库是项目运行所需的外部程序库。

1. 在 GitHub Desktop 中，确保仓库已打开，点击 Repository（仓库）→ Open in Terminal（在终端中打开）（或按 Ctrl + `）。
   • 这会打开一个已定位到项目文件夹的终端窗口。
2. 在终端中输入以下命令并按回车：
   bash

   pnpm i

3. 等待安装完成⸺可能需要一两分钟。你会看到进度指示，最终会显示类似于 “︀Done”︀ 的信息。

你只需要在初始配置时运行一次 pnpm i。以后通常不需要再次运行，除非有人告知你项目新增了依赖库。

第六步（不必要但是推荐）：安装 Visual Studio Code

虽然你可以直接使用记事本编辑文件，但 Visual Studio Code (VS Code) 是一款免费且功能强大的编辑器，具有语法高亮和文件浏览功能，能让编辑工作轻松很多。

1. 访问 https://code.visualstudio.com/
2. 点击下载并安装（可以全部使用默认设置）。
3. 安装完成后，在 GitHub Desktop 中，你可以右键点击仓库并选择 “︁Open in Visual Studio Code（在VS Code中打开）”︁ 直接开始编辑。

日常编辑流程

每次想要修改文档时，按照以下流程操作。

第一步：拉取最新更改

在编辑之前，务必先拉取最新版本，以避免与其他人可能已经做出的更改产生冲突。

1. 打开 GitHub Desktop。
2. 确认当前仓库为 OtomadHelper，当前分支为 docs。
3. 点击顶部工具栏的 “︁Fetch origin（拉取远端）”︁ 按钮。
4. 如果有新的更改，按钮会变为 “︁Pull origin（同步远端）”︁ ⸺点击它下载最新更新。

第二步：编辑文档文件

文档文件是位于 docs/ 文件夹中的 Markdown（.md）文件。

1. 在文件资源管理器中打开项目文件夹，或在 VS Code 中打开。
2. 进入 docs/ 文件夹。里面的内容包括：
   • .vitepress/ — 配置和主题文件（通常不需要修改这些）
   • zh-CN/**/*.md — 中文专属页面（主页等）
   • **/*.md 文件 — 新版 v8 扩展的文档页面（这些页面使用单文件多语言格式）
   • v4/**/*.md — 旧版 v4 脚本的文档页面（这些页面使用单文件多语言格式）
3. 打开你想要编辑的文件。大多数内容文件使用单文件多语言格式，因此英文和中文内容在一起编写。详细格式说明请参见上方的单文件多语言文档格式部分。
4. 进行修改并保存文件（Ctrl + S）。

第三步：本地预览修改

在推送之前，你可以在自己的电脑上预览网站，看看修改后的效果。

1. 如果你有 VS Code，请按 Ctrl + Shift + B，然后选择 npm: dev。

   如果你没有 VS Code，请：

   1. 在项目文件夹中打开终端：
      在 GitHub Desktop 中： 点击 Repository（仓库）→ Open in Terminal（在终端中打开）。
   2. 输入以下命令并按回车：
      bash

      pnpm run dev

2. 稍等片刻。你会看到类似以下输出：

   vitepress vX.X.X
   ➜  Local:   http://localhost:7000/

3. 3. 按住 Ctrl（也有可能是 Alt）键不放并单击链接 http://localhost:7000/。
4. 4. 导航到你编辑过的页面，检查所有内容是否正确显示。

第四步：提交并推送你的更改

“︁提交（Commit）”︁是将你的更改保存到本地仓库。“︁推送（Push）”︁是将更改上传到 GitHub。

1. 打开 GitHub Desktop。你会在左侧看到已更改的文件列表。
2. 在左下角找到 “︁Summary（摘要）”︁ 字段。用简短清晰的文字描述你改了什么。例如：
   • 修复安装指南中的错别字
   • 在音频页面添加新功能说明
   • 为FAQ页面补充中文翻译
3. （可选）在下面的 “︁Description（说明）”︁ 字段中添加更多细节。
4. 点击 “︁Commit to docs（提交到docs）”︁ 按钮。
5. 提交完成后，点击 “︁Push origin（推送远端）”︁ 按钮（右上角），将你的更改上传到 GitHub。

项目结构

OtomadHelper_docs/                     # 仓库根目录（docs 分支）
├── .gitignore                         # Git 忽略的文件
├── .readthedocs.yaml                  # Read the Docs 构建配置
├── .vscode/                           # VS Code 编辑器配置
│   ├── extensions.json                # 推荐安装的扩展
│   ├── settings.json                  # 编辑器设置（自动格式化等）
│   └── tasks.json                     # 预配置的任务（dev/build）
├── package.json                       # 项目依赖库与脚本
├── pnpm-lock.yaml                     # 依赖库版本锁定文件
├── tsconfig.json                      # TypeScript 配置
├── oxfmt.config.ts                    # 代码格式化工具配置
├── README.md                          # 英文版 README
├── README_zh-CN.md                    # 中文版 README（你正在读的这个）
└── docs/                              # 文档源码（VitePress 根目录）
    ├── .vitepress/                    # VitePress 配置与主题
    │   ├── config.ts                  # 主站点配置
    │   ├── components/                # 自定义 Vue 组件
    │   ├── plugins/                   # 自定义 Markdown 与构建插件
    │   ├── theme/                     # 自定义主题覆盖
    │   └── use-i18n.ts                # 国际化辅助工具
    ├── assets/                        # 静态资源（图片、字体等）
    ├── img/                           # 文档图片
    ├── public/                        # 公共静态文件
    │   ├── favicon.svg                # 网站图标
    │   └── favicon_1.ico              # 备用图标（用于规避 RtD 图标替换）
    ├── index.md                       # 主页（英文）
    ├── introduction.md                # 介绍页面（单文件多语言）
    ├── installation.md                # 安装指南（单文件多语言）
    ├── usage.md                       # 使用指南（单文件多语言）
    ├── faq.md                         # 常见问题（单文件多语言）
    ├── audio.md, visual.md, ...       # 各功能页面（单文件多语言）
    ├── v4/                            # 旧版 v4 文档页面
    │   ├── introduction.md
    │   ├── installation.md
    │   └── ...
    └── zh-CN/                         # 中文专属页面
        ├── index.md                   # 主页（中文）
        └── v4/                        # 中文 v4 页面入口

构建与部署原理

1. 你编辑 Markdown 文件并推送到 GitHub 上的 docs 分支。
2. Read the Docs 自动检测到推送。
3. RtD 运行 npm run build（由 .readthedocs.yaml 配置），构建 VitePress 站点。
4. 生成的静态 HTML 文件被托管在 https://otomadhelper.readthedocs.io/zh-CN/。
5. 构建通常在推送后的 2-5分钟 内完成。

可用脚本

许可证

本文档基于 GPL 3.0 许可证 发布。

版权所有 © 2021~至今 兰音

从这里开始，使用Otomad Helper非常简单。以下是使用方法。

• 你可以导入并使用MIDI文件来配置和生成所需的剪辑。你应该使用你自己创建的MIDI，而不是其他人的。这太不礼貌了。不要做音MIDI或者不是你创造的任何形式的混音。
• 你需要在时间轴中选取一段剪辑，以便在Vegas Pro中生成MIDI中的任何内容。
  • 或者你可以使用电脑中的剪辑或素材用来生成MIDI。
• “︁音频”︁和“︁画面”︁页面将允许你编辑剪辑的生成设置，有各种设置，玩弄它们并对它们进行调整，以便在开始创建时对你的需求进行排序。
• 还有各种工具可以帮助你完成项目中最荒唐的任务，使编辑某些片段以应用不同效果的繁琐工作不再说起来容易做起来难。

该设置可开关。（如果你的片段有音频，那么它将默认开启。）
你可以右键或中键单击任意设置滑动条来重置它。

开关

循环

如果适用的话，使剪辑循环。

规范化音量

规范化音频的音量。

截断

修剪MIDI音符而不是拉伸。

复音多轨

为和弦生成多条音频轨道。

创建分组

将表示同一MIDI音符的视频和音频剪辑组合在一起。

堆叠

当MIDI包含多个轨道时，在单独的轨道上创建堆叠音频剪辑。

持续时间流

禁用剪辑的所有形式的时间重映射！起始时间不会重置，而是将从每个音符停止的位置继续。

自动声像。

使用包络线自动控制音频的声像。

拉伸

如果适用的话，使剪辑拉伸。

• 不拉伸
  • 不为剪辑应用拉伸。
• 可屈伸
  • 完全地拉伸剪辑。
• 仅伸展
  • 使剪辑拉伸得更长。

    IMPORTANT

    这对于MIDI音符比音频剪辑更长时效果最佳。

• 仅屈折
  • 使剪辑拉伸得更短。

    IMPORTANT

    这对于MIDI音符比音频剪辑更短时效果最佳。

填补间隙

以特定的长度将音频延伸到音符长度之外。

• 不填补
  • 不延长。
• 最长一拍
  • 延长到1拍。

    IMPORTANT

    仅当到下一个剪辑的间隔小于1拍时，此功能才有效。

• 最长一小节
  • 延长到1小节。

    IMPORTANT

    仅当到下一个剪辑的间隔小于1小节时，此功能才有效。

• 无限填补
  • 无限延长。

首选轨道

创建新轨道或使用所选轨道来生成。

力度

用于分配与MIDI音符相关的增益值的设置。

• 映射力度
  • 将音符分配给MIDI文件中的力度。
• 乘以当前增益
  • 开启后会倍增现有增益。
• 音符力度
  • 力度值从最小值到最大值。
• 音量增益
  • 音量值从最小值到最大值。

• 重置
  • 重置为默认设置。

映射力度解释

调音

调音方法

• 不调音
  • 无变调效果。
• 移调音效插件
  • 使用“︁移调”︁插件（Vegas 13~15的默认值）。
• 弹性音调更改
  • 使用弹性高效方法（默认值）。
• 古典音调更改
  • 使用古典拉伸方法。
• 无音阶调音
  • 锁定伸缩与音调。
• 粒子振荡器
  • 使采样变成超短并播放，产生与音高相对应的脉冲序列，同时利用快速脉冲的感知融合效应创建连续的音调。

如果音高超出了音域

• 切换到移调音效插件
  • 重复使用“︁移调”︁插件来超出限制。

    IMPORTANT

    超出音域的音符会减慢生成。

• 升 / 降八度
  • 平移八度以使音符保持在 ±24 个半音之内（最安全的选项）。
• 升 / 降八度（实验性）
  • 允许一个非常大的范围，约高达 $\pm\frac{12}{\lg{2}}\ \left(\approx\pm39.863137\right)$ 个半音。

    INFO

    如果“︁锁定伸缩与音调”︁已开启，则可低至 $-\frac{12}{\log_{20}{2}} \left(\approx-51.863137\right)$ 个半音（上限仍为 +24）。

    DANGER

    使用它需要你承担风险！此方法可能会使Vegas Pro崩溃。

• 停靠在边缘
  • 将音符强制调整至仍在正常范围内的最高或最低音高。
• 不发声
  • 将超出音域的音符静音。

锁定属性

• 锁定伸缩与音调
  • 调整伸缩以改变音调（重采样）。
• 保持共振峰
  • 锁定共振峰，仅限“︁单声道”︁和“︁专业”︁有效。

    INFO

    这锁定了共振峰因此你可以得到所谓的“︁单声道”︁效果。

• 气泡音
  • 强制采样1刻长度。

    INFO

    仅在粒子振荡器下使用。

原始音高

控制用于预览和调整音频轨道事件的基本音高。

• 音名
  • 控制基音所用的音名。
• 八度
  • 控制基音所用的八度。

预听

• 预听标准音高
  • 预听标准音高。
• 预听音频
  • 预听轨道事件音频。

预听属性

用于预听主音高的音调生成方法。

• 调整音频到主音高
  • 调整剪辑轨道事件的音频到主音高。

  INFO

  这适用于旧式调音。

参数

• 设定淡化为百分比
  • 将值度量设置为百分比值。
• 设定淡化为时间码
  • 将值度量设置为时间码值。

淡化

渐入

轨道事件中音频渐入的长度和渐入类型。

渐出

轨道事件中音频渐出的长度和渐出类型。

创建此索引的目的是帮助指导用户了解哪些功能、做什么以及如何使用它们。

基础问题

System.DivideByZeroException: Attempted to divide by zero.

System.FormatException: Got an off without an on 0 NoteOn

at ScriptPortal.Vegas.Fade.set_Gain(Single value)

安装相关

C:\Program Files\Sony\Vegas Pro 12.0\Script Menu\otomad_helper.cs(17): new 表达式要求在类型后有 () 或 []

public Dictionary<string, int> pitchMap = new Dictionary<string, int> {
    { "C0", 0 },
    { "C#0", 1 },
    // ...
    { "A#8", 106 },
    { "B8", 107 },
};

new Dictionary<string, int>

new Dictionary<string, int>()

C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu\otomad_helper.cs(11)：未能找到类型或命名空间名称“Sony”(是否缺少 using 指令或程序集引用?)
C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu\otomad_helper.cs(657)：未能找到类型或命名空间名称"Vegas”(是否缺少 using 指令或程序集引用?)

C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu\otomad_helper.cs: 未能找到元数据文件“C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu\DLL\NAudio.dll”

System.Reflection.TargetInvocationException: 调用的目标发生了异常。 ---> System.FormatException: Not a MIDI file - header chunk missing
  at NAudio.Midi.MidiFile ..ctor(Stream inputStream, Boolean strictChecking, Boolean ownInputStream)
  at EntryPoint.FromVegas(Vegas vegas)
 --- 内部异常堆栈跟踪的结尾 ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at ScriptPortal.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at ScriptPortal.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

System.Reflection. TargetInvocationException: Exception has been thrown by the target of an invocation. ---> System.NullReferenceException: Object reference not set to an instance of an object.
  at EntryPoint.FromVegas(Vegas vegas)
  --- End of inner exception stack trace ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at Sony.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at Sony.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

System.Reflection.TargetInvocationException: 调用的目标发生了异常。 --->
System.ArgumentNullException: 值不能为 null。
  at ScriptPortal.Vegas.Effect..ctor(PlugInNode plugIn)
  at EntryPoint.FromVegas(Vegas vegas)
 --- 内部异常堆栈跟踪的结尾 ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at ScriptPortal.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at ScriptPortal.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

vegas.AudioFX.FindChildByName("Pitch Shift");

vegas.AudioFX.FindChildByUniqueID("{ED1B4100-93BE-11D0-AEBC-00A0C9053912}");

System.Reflection.TargetInvocationException: 调用的目标发生了异常。 --->
System.Runtime.InteropServices.COMException: 对COM组件的调用返回了错误HRESULT E_FAIL。
  at ScriptPortal.Vegas.IEffectCOM.SetPreset(UInt32 sessionID, Int64 position, String presetName)
  at EntryPoint.FromVegas(Vegas vegas)
 --- 内部异常堆栈跟踪的结尾 ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at ScriptPortal.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at ScriptPortal.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

System.Reflection.TargetInvocationException: 调用的目标发生了异常。 --->
System.ArgumentException: Media stream not specified.
  at Sony.Vegas.Take.AddSelf(UInt32 trackID, Int64 eventID, MediaType mediaType)
  at Sony.Vegas.TrackEvent.AddTake(MediaStream mediaStream)
  at EntryPoint.FromVegas(Vegas vegas)
 --- 内部异常堆栈跟踪的结尾 ---
  at System.RuntimeMethodHandle.InvokeMethod(Object target, Object[] arguments, Signature sig, Boolean constructor)
  at System.Reflection.RuntimeMethodInfo.UnsafeInvokeInternal(Object obj, Object[] parameters, Object[] arguments)
  at System.Reflection.RuntimeMethodInfo.Invoke(Object obj, BindingFlags invokeAttr, Binder binder, Object[] parameters, CultureInfo culture)
  at Sony.Vegas.ScriptHost.ScriptManager.Run(Assembly asm, String className, String methodName)
  at Sony.Vegas.ScriptHost.RunScript(Boolean fCompileOnly)

深度探索

脚本本体

1. 下载最新版脚本

2. 将你刚刚下载到的zip文件中的所有文件解压缩到Vegas安装目录中的 Script Menu 文件夹，或 文档（原 我的文档）文件夹下的 Vegas Script Menu 文件夹中。具体来说：

仅在已安装的特定Vegas版本下安装

如果你想仅为已安装的特定Vegas版本下安装脚本，请安装到Vegas Pro目录下的 Script Menu 文件夹中。

C:\Program Files\BorisFX\Vegas Pro 2026\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 23.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 22.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 21.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 20.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 19.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 18.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 17.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 16.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 15.0\Script Menu

C:\Program Files\VEGAS\VEGAS Pro 14.0\Script Menu

C:\Program Files\Sony\Vegas Pro 13.0\Script Menu

为已安装的所有Vegas版本下安装

如果你想为已安装的所有Vegas版本下安装脚本，请安装到 文档 文件夹下的 Vegas Script Menu 文件夹中。

%UserProfile%\Documents\Vegas Script Menu

C:\Users\(你的用户名)\Documents\Vegas Script Menu

如果该文件夹并不存在，请按以下步骤操作：

3. 请确保DLL文件 (DLL\NAudio.dll) 未锁定。

此时你的文件夹看起来应该像是这样：

4. 打开 Vegas Pro 来启动。选择菜单 工具→脚本化→重新扫描脚本菜单文件夹。
5. 选择菜单 工具→脚本化→Otomad Helper 打开。

数据抹失扩展包

如果需要使用数据抹失的全部功能，需要安装数据抹失扩展包方可使用。

1. 下载数据抹失扩展包
2. 解压7z文件并将 _internal 文件夹移动到脚本 Otomad Helper.{cs,dll} 所在的相同目录下。

快速启动

你可以选择菜单 选项→自定义工具栏，将脚本添加到工具栏中以便快捷操作。从而无需麻烦地每次到 工具→脚本化 子菜单中单击。

兼容性

支持Vegas Pro 13及以上版本。

Vegas Pro 16及以上版本支持所有功能，Vegas Pro 13 ~ 15可以兼容运行（会缺失部分功能）。前提是必须安装对应的版本。

音MAD助手是Vegas Pro的音MAD/YTPMV/YTP脚本，旨在使Vegas能够接受MIDI序列文件作为输入并自动生成音MAD的轨道。

本脚本基于原作者 @Chaosinism 的开源代码二次开发，此外使用了NAudio库。

查看用法部分以了解更多信息，包括如何安装该脚本。

本说明文档最初由 @Evauation 编写。

子功能

它也可以用于制作YTP、声呐效果（动态图形生成功能）、数据抹失（幻术故障、資料狂舞）。

YTP 的相关功能参考自YTP+。

镜头摇晃功能参考自Vegas摇晃脚本。

姊妹项目

om midi — 适用于After Effects的音MAD辅助脚本。

语言

你也可以在任意页面点击右上角的语言按钮来切换语言。

翻译

• 越南语翻译由 @Cyahega 提供。
• 印尼语翻译由 @AdeGimank123 和 @JujunG 提供。

要了解关于Otomad Helper的更多功能，请继续往下看⋯⋯

Datamosh
也被称为：資料狂舞、毒蘑菇、幻术故障。

锘挎薮琚沬妷数据抹失是一种通过磨损素材以产生故障效果的技术，其中需要进展的帧却无法进展！
噢！数据抹失功能得益于delthas开发的Vegas-Datamosh工具。

数据抹失

使用确定的设置对视频进行datamosh。

• 帧计数
  • 要使用的帧数。
• 帧重复
  • 帧重复的次数。

这会重复N个P帧M次。N是帧计数，M是帧重复。

要使用，请使用 I 和 O 在时间轴中选区，然后它将被预渲染和datamosh，并添加到你的项目中，所有操作只需单击一次。如果Vegas看起来卡住了，那么可能需要较长的时间来处理。

选区的起始是第一个将被重复的P帧。这个P帧将是相对于前一帧的，而前一帧将被渲染I帧。因此为了获得最佳效果，选区的开始应该是一个运动幅度大的帧。

选区的末尾只是告诉脚本应该将datamosh文件渲染到哪一帧。所选时间越长，渲染时间就越长。

数据抹拭

datamosh选区的第一帧。

这将用另一个片段的一帧来替换一个片段的第一个I帧。

要使用，请使用 I 和 O 在时间轴中选区，然后它将被预渲染和datamix，并添加到你的项目中，所有操作只需单击一次。如果Vegas看起来卡住了，那么可能需要较长的时间来处理。

所选的开始是剪辑的I帧，它将被另一个I帧替换。用于新I帧的图像将是选择开始前的帧。所以请确保将你要datamix的图像放在选择开始之前。

如果你想在场景变化时进行datamix，通常可以在场景变化的那一帧分割剪辑，然后选择右边的剪辑。这会将右侧剪辑datamix到左侧剪辑的最后一帧。

选区的末尾只是告诉脚本应该将datamosh文件渲染到哪一帧。所选时间越长，渲染时间就越长。

多层叠化

将所选剪辑分层以进行mosh。

• 层数
  • 要生成的层数。
• 层叠偏移
  • 将图层偏移指定的帧数。
• 预渲染
  • 渲染生成图层后所选剪辑。

这将通过复制所选视频剪辑/事件N次来执行layering，每次将剪辑偏移M帧。N是层数，M是层叠偏移。你还可以通过选中预渲染复选框来选择自动渲染layering剪辑，否则复制的剪辑只会添加到时间轴上。

使用时，请选择单个视频剪辑/事件，然后它将自动多层叠化，并在指定的情况下进行透明渲染。

你可以使用一个负的偏移量（例如-2而不是2），在这种情况下，新的剪辑/事件将添加在后面，而不是在前面。

如果选择自动渲染，渲染后的文件将支持阿尔法/透明度，这意味着你不需要添加绿幕并在之后删除它，阿尔法将自动处理。

预渲染化

在时间轴选区内渲染剪辑⋯⋯（是的，就只是这样。）

简便地渲染时间轴的一部分，并一键将其放入时间轴中。

要使用，请使用 I 和 O 在时间轴中选区，然后它将被预渲染并添加到你的项目中，所有操作只需单击一次。

渲染后的文件将支持阿尔法/透明度，这意味着你不需要添加绿幕并在之后删除它，阿尔法将自动处理。

随机扰乱

根据大小使用随机时间位置对剪辑进行打乱。

• 扰乱大小
  • 要生成的剪辑的大小值。

简便地通过将多个剪辑/事件分割为长度为N的子剪辑，并对子剪辑进行扰乱，即可对其进行扰乱。N是扰乱大小，通常为1。

要使用，请选择几个剪辑/事件（它们必须被实际选中，而不仅仅是在所选组中），然后它们将被自动扰乱。

在同一时间开始和结束的剪辑将被一起扰乱，即它们的子剪辑将以同样的方式被扰乱。

自动乱调

自动化并随机化剪辑中视觉效果的值。

• 扰乱
  • 它会询问你是否希望为每个效果自动执行剪辑中的视觉效果。

这将通过为你所选的每个参数类型在每一帧添加随机关键帧，随机化选定剪辑/事件的视频效果。

要使用，请选择几个具有视频效果的剪辑/事件（它们必须被实际选中，而不仅仅是在所选组中），然后启动脚本。对于任何剪辑上的每种类型的视频效果参数，系统都会提示你是否希望脚本对参数进行扰乱（用随机关键帧替换参数的所有关键帧），或不扰乱（保持关键帧不变）。

仅支持OFX视频效果（新闻用纸、镜像⋯⋯）；它们都有相同的外观，很容易辨识哪些是OFX效果。其它效果将被忽略。

结巴演说

通过以随机间隔正放和倒放剪辑来使剪辑出现卡顿的现象。

• 长度（秒）
  • 要生成的剪辑的时长。
• 结巴窗口偏移
  • 剪辑随机化的结巴值。

镜头摇晃

摇晃剪辑。

• 速度
  • 摇晃效果的频率值。
• 水平/垂直同步系数
  • 相对垂直速度值。
• 数量
  • 相机从中心偏移的像素值。

    IMPORTANT

    这也控制放大的边距。

• 水平/垂直位移比
  • 水平距离的值相乘。

    IMPORTANT

    这控制放大。

• 在第一帧上重置平移/裁切
  • 若不勾选，可在当前视频缩放范围内摇晃。
• 在摇晃前重置所有帧
  • 若不勾选，则会应用摇晃效果并将其与之前的摇晃效果相乘。

Otomad Helper基于GPL 3.0许可发布.

项目开工日期：公元2021年9月5日 星期日，凌晨4:14:26 东八区时间

版权所有 © 2021~至今，兰音 - 根据GPLv3许可

使用条款

1. 若使用非自制MIDI / 素材进行创作，请尊重其作者的权益。
2. 使用此脚本需要用户具备一定的创作能力，此脚本应当且仅应当用于辅助进行创作。不得纯依靠此脚本生成作品，也不应作为初学者学习创作音MAD/YTPMV使用。听话，不要做音MIDI！
3. 使用此脚本制作视频并投稿到各大媒体平台后，请勿在任何地方（如视频简介和评论区）提及此脚本的名称或网址链接以声称使用此脚本参与了创作。

权限

使用脚本时，将会使用如下权限：

1. 文件读写。
   1. 脚本会在磁盘中创建一个ini文件用来保存你的用户配置设置。
      路径

      C:\Users\(你的用户名)\AppData\Roaming\VEGAS Pro\(你的Vegas版本)\Otomad Helper.ini

2. 注册表读写。
   1. 脚本需要读写注册表来安装或卸载移调插件预设。
      路径

       HKEY_CURRENT_USER\Software\DirectShow\Presets\{ED1B4100-93BE-11D0-AEBC-00A0C9053912}

   2. 数据抹失的相关配置保存在注册表中。
      路径

       HKEY_CURRENT_USER\SOFTWARE\VEGAS Creative Software\Custom Presets

开源软件许可

此项目参考了以下开源代码：
感谢作者和贡献者们对开源事业的贡献！

Vegas数据抹失依赖

Vegas数据抹失扩展包使用了这些依赖。

旧文档链接

欢迎修订音MAD助手（Otomad Helper）的说明文档⸺一个Vegas Pro的音MAD/YTPMV/YTP扩展程序。本站点同时涵盖了新版（v8，扩展程序）和旧版（v4，脚本）的说明文档内容。

项目概述

音MAD助手是一个使Vegas Pro能够接受乐谱（如MIDI序列文件）作为输入并自动生成音MAD/YTPMV/YTP轨道的工具。本仓库包含该项目的说明文档网站源代码。

文档涵盖两个主要版本：

技术架构

工作流程： 当代码推送到GitHub的docs分支后，Read the Docs服务器会自动重新构建项目，并生成静态HTML网页。用户可通过 https://otomadhelper.readthedocs.io/zh-CN/ 直接阅读最新文档内容。

单文件多语言文档格式

本项目采用了一种创新的单文件多语言格式。与传统的每种语言单独维护一个文件不同，所有语言的翻译都写在同一个文件中。这样当需要修改错误时，可以同时看到所有语言的对应内容，一次性全部修正。

为什么使用这种格式？

传统的多语言文档方式中，如果文档包含7种语言，修改一个错误需要：

1. 同时打开7个文件（每种语言一个）。
2. 在每个文件中找到错误内容所在的行。
3. 逐个文件修改同样的内容。

使用单文件多语言格式后，各语言的翻译紧挨在一起，可以在同一个位置一次性修改所有语言。

行多语言

以行为单位为其编写多语言翻译。格式以一个 @符号开头，后面紧跟着语言标签，空一格后填写该语言在本行的翻译内容：

﹫en This is English content.
﹫zh 这是中文内容。
﹫ja これは日本語の内容です。

目前支持的语言标签：en（英语）、zh（简体中文）。

块多语言

以块为单位为其编写多语言翻译。适用于大量内容差异或复杂格式的多语言翻译，例如整个表格、警告框等。格式以三个@符号开头，后面紧跟语言标签：

﹫﹫﹫en
This is a large block of English content.
It can span multiple lines and include **formatting**.
﹫﹫﹫zh
这是一大段中文内容。
它可以跨越多行并包含**格式**。
﹫﹫﹫

• 用 @@@ 加语言标签开始一个块。
• 用单独的 @@@（不跟标签）结束整个多语言块。

回退机制

如果在某一段行多语言或块多语言内容中缺少编写了某种语言的翻译内容，网站会自动回退显示为英文文档内容。这意味着你只需要为你会说的语言编写翻译，缺失的语言会自动安全地显示英文。

重要规则

• 不要将行多语言（@）和块多语言（@@@）语法混用于同一段内容⸺选择其中一种即可。
• @或@@@标记必须出现在一行的最开头。
• 对于行多语言翻译，语言的出现顺序可以任意，但保持统一的顺序（例如始终@en在前、@zh在后）有助于提高可读性。

如何编辑文档

以下步骤是为非程序员编写的。你不需要任何编程经验，只需一步步跟着操作即可。如果遇到困难，可以请熟悉电脑的朋友帮忙。

一次性准备工作

以下步骤仅需在第一次配置项目时做一次，以后无需重复。

第一步：安装 Node.js

Node.js 是运行文档工具链所需的运行时环境。

1. 打开浏览器，访问 https://nodejs.org/
2. 点击 LTS（长期支持版）下载按钮⸺这是推荐大多数用户使用的稳定版本。
3. 下载完毕后，双击安装文件（Windows上为 node-vXX.XX.X-x64.msi）。
4. 按照安装向导操作⸺可以全部使用默认设置。
5. 点击完成。

第二步：安装 pnpm

pnpm 是本项目使用的包管理器。

1. 打开命令提示符（开始菜单 → 输入 cmd → 按回车）。
2. 输入以下命令并按回车：
   bash

   npm install -g pnpm

3. 等待安装完成。

第三步：安装 GitHub Desktop

GitHub Desktop 提供了 Git 的图形化界面，这样你就不需要记忆和输入 Git 命令行指令了。

1. 访问 https://desktop.github.com/
2. 点击下载按钮。
3. 下载完成后，运行安装程序。
4. 首次打开 GitHub Desktop 时，会要求你登录 GitHub 账号。如果你还没有账号：
   • 访问 https://github.com/signup 创建一个免费账号。
   • 然后用新账号登录 GitHub Desktop。
5. 按照设置提示操作（对于Git配置相关的提示可以使用默认设置直接跳过）。

第四步：克隆仓库

“︁克隆”︁的意思是将项目的副本下载到你的电脑上。

1. 在 GitHub Desktop 中，点击 File（文件）→ Clone repository…（克隆仓库…）
2. 选择 URL 选项卡。
3. 在 “︁Repository URL（仓库链接）”︁ 字段中输入：

   https://github.com/otomad/OtomadHelper

4. 在 “︁Local path（本地路径）”︁ 中，点击 Choose…（选择…），选择你电脑上想要存放项目的文件夹（例如 D:\Documents\OtomadHelper）。
5. 点击 Clone（克隆）。
6. 重要： 克隆完成后，需要切换到 docs 分支：
   • 在 GitHub Desktop 顶部附近，你会看到一个标有 “︁Current branch（当前分支）”︁ 的按钮（可能显示为 main 或 master）。
   • 点击它，然后从列表中选择 docs 分支。
   • 如果在列表中找不到 docs，请点击分支列表顶部的 “︀Origin”︀ 选项卡⸺仅在GitHub上存在的分支会出现在这里。点击 docs 即可检出该分支。

第五步：安装项目依赖库

依赖库是项目运行所需的外部程序库。

1. 在 GitHub Desktop 中，确保仓库已打开，点击 Repository（仓库）→ Open in Terminal（在终端中打开）（或按 Ctrl + `）。
   • 这会打开一个已定位到项目文件夹的终端窗口。
2. 在终端中输入以下命令并按回车：
   bash

   pnpm i

3. 等待安装完成⸺可能需要一两分钟。你会看到进度指示，最终会显示类似于 “︀Done”︀ 的信息。

你只需要在初始配置时运行一次 pnpm i。以后通常不需要再次运行，除非有人告知你项目新增了依赖库。

第六步（不必要但是推荐）：安装 Visual Studio Code

虽然你可以直接使用记事本编辑文件，但 Visual Studio Code (VS Code) 是一款免费且功能强大的编辑器，具有语法高亮和文件浏览功能，能让编辑工作轻松很多。

1. 访问 https://code.visualstudio.com/
2. 点击下载并安装（可以全部使用默认设置）。
3. 安装完成后，在 GitHub Desktop 中，你可以右键点击仓库并选择 “︁Open in Visual Studio Code（在VS Code中打开）”︁ 直接开始编辑。

日常编辑流程

每次想要修改文档时，按照以下流程操作。

第一步：拉取最新更改

在编辑之前，务必先拉取最新版本，以避免与其他人可能已经做出的更改产生冲突。

1. 打开 GitHub Desktop。
2. 确认当前仓库为 OtomadHelper，当前分支为 docs。
3. 点击顶部工具栏的 “︁Fetch origin（拉取远端）”︁ 按钮。
4. 如果有新的更改，按钮会变为 “︁Pull origin（同步远端）”︁ ⸺点击它下载最新更新。

第二步：编辑文档文件

文档文件是位于 docs/ 文件夹中的 Markdown（.md）文件。

1. 在文件资源管理器中打开项目文件夹，或在 VS Code 中打开。
2. 进入 docs/ 文件夹。里面的内容包括：
   • .vitepress/ — 配置和主题文件（通常不需要修改这些）
   • zh-CN/**/*.md — 中文专属页面（主页等）
   • **/*.md 文件 — 新版 v8 扩展的文档页面（这些页面使用单文件多语言格式）
   • v4/**/*.md — 旧版 v4 脚本的文档页面（这些页面使用单文件多语言格式）
3. 打开你想要编辑的文件。大多数内容文件使用单文件多语言格式，因此英文和中文内容在一起编写。详细格式说明请参见上方的单文件多语言文档格式部分。
4. 进行修改并保存文件（Ctrl + S）。

第三步：本地预览修改

在推送之前，你可以在自己的电脑上预览网站，看看修改后的效果。

1. 如果你有 VS Code，请按 Ctrl + Shift + B，然后选择 npm: dev。

   如果你没有 VS Code，请：

   1. 在项目文件夹中打开终端：
      在 GitHub Desktop 中： 点击 Repository（仓库）→ Open in Terminal（在终端中打开）。
   2. 输入以下命令并按回车：
      bash

      pnpm run dev

2. 稍等片刻。你会看到类似以下输出：

   vitepress vX.X.X
   ➜  Local:   http://localhost:7000/

3. 3. 按住 Ctrl（也有可能是 Alt）键不放并单击链接 http://localhost:7000/。
4. 4. 导航到你编辑过的页面，检查所有内容是否正确显示。

第四步：提交并推送你的更改

“︁提交（Commit）”︁是将你的更改保存到本地仓库。“︁推送（Push）”︁是将更改上传到 GitHub。

1. 打开 GitHub Desktop。你会在左侧看到已更改的文件列表。
2. 在左下角找到 “︁Summary（摘要）”︁ 字段。用简短清晰的文字描述你改了什么。例如：
   • 修复安装指南中的错别字
   • 在音频页面添加新功能说明
   • 为FAQ页面补充中文翻译
3. （可选）在下面的 “︁Description（说明）”︁ 字段中添加更多细节。
4. 点击 “︁Commit to docs（提交到docs）”︁ 按钮。
5. 提交完成后，点击 “︁Push origin（推送远端）”︁ 按钮（右上角），将你的更改上传到 GitHub。

项目结构

OtomadHelper_docs/                     # 仓库根目录（docs 分支）
├── .gitignore                         # Git 忽略的文件
├── .readthedocs.yaml                  # Read the Docs 构建配置
├── .vscode/                           # VS Code 编辑器配置
│   ├── extensions.json                # 推荐安装的扩展
│   ├── settings.json                  # 编辑器设置（自动格式化等）
│   └── tasks.json                     # 预配置的任务（dev/build）
├── package.json                       # 项目依赖库与脚本
├── pnpm-lock.yaml                     # 依赖库版本锁定文件
├── tsconfig.json                      # TypeScript 配置
├── oxfmt.config.ts                    # 代码格式化工具配置
├── README.md                          # 英文版 README
├── README_zh-CN.md                    # 中文版 README（你正在读的这个）
└── docs/                              # 文档源码（VitePress 根目录）
    ├── .vitepress/                    # VitePress 配置与主题
    │   ├── config.ts                  # 主站点配置
    │   ├── components/                # 自定义 Vue 组件
    │   ├── plugins/                   # 自定义 Markdown 与构建插件
    │   ├── theme/                     # 自定义主题覆盖
    │   └── use-i18n.ts                # 国际化辅助工具
    ├── assets/                        # 静态资源（图片、字体等）
    ├── img/                           # 文档图片
    ├── public/                        # 公共静态文件
    │   ├── favicon.svg                # 网站图标
    │   └── favicon_1.ico              # 备用图标（用于规避 RtD 图标替换）
    ├── index.md                       # 主页（英文）
    ├── introduction.md                # 介绍页面（单文件多语言）
    ├── installation.md                # 安装指南（单文件多语言）
    ├── usage.md                       # 使用指南（单文件多语言）
    ├── faq.md                         # 常见问题（单文件多语言）
    ├── audio.md, visual.md, ...       # 各功能页面（单文件多语言）
    ├── v4/                            # 旧版 v4 文档页面
    │   ├── introduction.md
    │   ├── installation.md
    │   └── ...
    └── zh-CN/                         # 中文专属页面
        ├── index.md                   # 主页（中文）
        └── v4/                        # 中文 v4 页面入口

构建与部署原理

1. 你编辑 Markdown 文件并推送到 GitHub 上的 docs 分支。
2. Read the Docs 自动检测到推送。
3. RtD 运行 npm run build（由 .readthedocs.yaml 配置），构建 VitePress 站点。
4. 生成的静态 HTML 文件被托管在 https://otomadhelper.readthedocs.io/zh-CN/。
5. 构建通常在推送后的 2-5分钟 内完成。

可用脚本

许可证

本文档基于 GPL 3.0 许可证 发布。

版权所有 © 2021~至今 兰音

MIDI配置

（这很重要）

• 生成音MAD需要一个MIDI文件。
• 你必须要从计算机选择一个MIDI文件以使脚本生成。

起始和终止时间

控制MIDI生成开始到结尾的范围。

设定BPM速度为

控制MIDI生成的BPM（拍每分）。

• MIDI速度
  • 使用MIDI的速度。
• Project Tempo
  • 使用当前Vegas项目的速度。
• 自定义
  • 使用自定义设置。

如果MIDI的速度会发生变化，脚本将进行自适应并让你选择要对其执行的选项。

• 可变MIDI速度
  • 使用变化的速度。
  • 保持
    • 生成的音符将保持在其BPM中。
  • 线性
    • 生成的音符将线性地基于其BPM。
• MIDI速度
  • 使用固定的第一个速度。

自动更改项目标尺属性

根据MIDI调整项目的小节属性。

• 速度
  • 使用速度作为设置。
• 拍号
  • 使用拍号作为设置。

• 立即应用
  • 自动应用MIDI的速度和拍号，无需生成MIDI事件。

限制音符长度

控制MIDI的音符输出长度。

• 不限制
  • 没有音符改变输出。
• 最大长度
  • 音符将限制于所提供的长度。
• 固定长度
  • 音符将尝试生成所提供的长度。

使用MIDI音轨

这允许你选择要从 MIDI 文件生成的轨道。

命令

• 全选
  • 选中全部音轨。
• 反选
  • 反转你的选区。
• 单选
  • 切换选择单条音轨。
• 多选
  • 切换选择多条音轨。

自动布局轨道

参阅工具

声呐（动态图形生成功能）用于为鼓组创建节拍风格的视觉效果。

参阅：
『図形素材』、《图形练习》

该设置可开关。

开关

• 分离不同鼓声
  • 使鼓的视觉对象在多个图层上生成。
• 差值轨道合成模式
  • 通过差值合成（混合）生成图层。
• 阴影
  • 生成的视觉对象带有阴影。
• 阴影颜色
  • 改变阴影的颜色。

编辑器

• 重置
• 删除（选区）
• 上移（选区）
• 下移（选区）
• 新建

参数

• 匹配鼓声
  • 用于生成的鼓声的值。

    IMPORTANT

    这应该与你的MIDI中的单个鼓相匹配。

• 形状
  • 视觉对象的形状。
• 颜色
  • 控制视觉对象的颜色。
• 时长
  • 视觉对象的时长值。
• 曲线
  • 关键帧类型值。
• 起始边框
  • 边框的起始尺寸值。
• 终止边框
  • 边框的终止尺寸值。
• 起始大小
  • 起始总体大小值。
• 终止大小
  • 终止总体大小值。

• 水平中心
  • 水平中心位置的值。
• 垂直中心
  • 垂直中心位置的值。

• 起始水平偏移单数
  • 每个奇数视觉对象的水平起始位置的值。
• 起始垂直偏移单数
  • 每个奇数视觉对象的垂直起始位置的值。
• 起始水平偏移双数
  • 每个偶数视觉对象的水平起始位置的值。
• 起始垂直偏移双数
  • 每个偶数视觉对象的垂直起始位置的值。

• 预先水平偏移单数
  • 每个奇数视觉对象的水平起始位置的附加值。
• 预先垂直偏移单数
  • 每个奇数视觉对象的垂直起始位置的附加值。
• 预先水平偏移双数
  • 每个偶数视觉对象的水平起始位置的附加值。
• 预先垂直偏移双数
  • 每个偶数视觉对象的垂直起始位置的附加值。

• 起始旋转单数
  • 每个奇数视觉对象的起始旋转值。
• 起始旋转双数
  • 每个偶数视觉对象的起始旋转值。
• 渐入
  • 渐入值。
• 渐出
  • 渐出值。
• 渐入曲线
  • 渐入值的关键帧类型。
• 渐出曲线
  • 渐出值的关键帧类型。

素材属性

选择素材来源

允许选择要使用的媒体文件或轨道事件。

起始和终止时间

使用开始时间和结束时间来修剪剪辑。

设定生成开始位置

控制要生成MIDI的位置。

• 项目开始处
  • 在开始时生成MIDI。
• 光标处
  • 在光标位置生成MIDI。
• 自定义
  • 在所选的任何时间位置生成MIDI。

生成在顶层调整轨道的下方

将生成的轨道放置在调整轨道的下方。

生成完成后移除作为源素材的轨道事件

生成MIDI后删除源剪辑。

生成完成后选中生成的所有事件

MIDI生成后选中生成的所有事件。

生成完成后将光标移动到

将光标定位到时间线中的指定位置。

• 原位置
  • 将时间线光标保留在运行脚本之前的原始位置。
• 生成开始位置
  • 将光标移动到MIDI文件的开头。
• 第一个事件之前
  • 将光标移动到时间线中第一个生成的事件之前。
• 最后一个事件之后
  • 将光标移动到时间线中最后一个生成的事件之后。

轨道组

为轨道创建分组。

• 不分组
  • 禁用轨道组。
• 按MIDI音轨分组
  • 根据使用的MIDI音轨对轨道进行分组并使用MIDI音轨名称。
• 按任务会话分组
  • 每当生成完成时就会创建一个新分组。

• 默认情况下折叠轨道组
  • 折叠轨道组列表。
• 重用非空同名轨道组
  • 生成时新添加的轨道，将添加到具有相同名称的现有轨道组中。

音频总线轨道

将音轨路由到音频总线（混音控制台）。

• 不路由
  • 禁用路由到音频总线。
• 按MIDI音轨路由
  • 根据使用的MIDI轨道将音轨路由到同一总线。
• 按任务会话路由
  • 每当生成完成时就会路由音轨到新建总线。

• 重用非空同名音频总线轨道
  • 生成时新添加的轨道，将添加到具有相同音频总线的现有轨道组中。

多素材梳子

关

禁用多素材功能。

素材盲盒

以不可预测的方式自动从多个选定素材中选挑选。

限制在所选素材

仅使用在时间线/项目媒体中的所选素材。

使每条音轨不同

各音轨会使用一个不同的剪辑来生成。

每处标记切换一次

到达MIDI标记时更换素材。

每小节或每拍切换一次

通过拍或小节时更换素材。

润肤浴战法（ローション風呂戦法）

强制素材在指定的持续时间内顺序更改。

踩点

以音乐模式应用素材。

次序

• 顺序
  • 按所选顺序使用剪辑。
• 逆序
  • 以相反的顺序使用剪辑。
• 乱序
  • 以打乱的顺序生成。

每段重复次数

指定在切换到下一个剪辑之前可以使用素材的次数。

每轮重复总数

指定循环的次数。

按轮次应用视觉效果

按周期而不是各剪辑应用视频视觉效果。

素材盲盒

将素材盲盒的行为与生成相结合。

对和弦的泛音列独立累加

生成和弦时使用多个素材。

相同音高时保持素材

下一个音高相同的音符将使用相同的素材。

音高缓存容量

指定它将重用素材的数量

素材乐团

将素材剪辑分配给MIDI音轨，就像将乐器分配给管弦乐队一样。

挑取模式

• 素材盲盒
  • 使用素材盲盒的行为
• 踩点
  • 使用踩点的行为

递减次序

反转各音轨上使用的素材的顺序。

允许重用

允许在不同的MIDI多轨道中使用相同的剪辑。

辅音时间

即将到来（要有耐心）

原音系战法和鞑靼战法

即将到来（要有耐心）

五线谱可视化用于以与钢琴乐谱类似的方式创建乐谱风格的视觉效果。

该设置可开关。（默认关闭。）

音符参数

• 使用相对值
  • 使用相对于1920×1080尺寸的值。

    IMPORTANT

    关闭后，将基于你项目尺寸的值。

• 旧版定位方式
  • 使用旧方法放置画面，使用轨道运动表示音符和谱线。
• 冻结在音符结尾处
  • 冻结MIDI音符末尾的音符。
• 持续到小节结尾
  • 将剪辑延伸到小节的末尾。

• 谱号
  • 控制使用什么谱号。
• 谱线间距
  • 控制画面和谱表之间的像素间隙。
• 谱左边距
  • 控制与左侧的间隙距离的值。
• 谱右边距
  • 控制与右侧的间隙距离的值。
• 谱面位置
  • 控制距中线的间隙距离的值。
• 音符偏移
  • 根据音调更改的值平移谱线中的音符。

谱线参数

• 生成谱线
  • 生成五线谱的线条。

• 谱线粗细
  • 控制五线谱表中线宽的大小。
• 谱线颜色
  • 控制线条的颜色。

谱号参数

• 生成谱号
  • 在乐谱的开头生成谱号符号。

• 谱号缩放
  • 控制生成谱号符号的缩放。
• 谱号颜色
  • 控制谱号符号的颜色。

脚本中的这些效率工具可略微简化音MAD的创作流程及相关设置，且无需对原先参数进行任何调整。

• 操作完成之后关闭本对话框

  不言自明。

自动布局轨道

画面的布局控制。

网格布局

阵列

• 方阵
  • 创建标准布局。

    INFO

    这会创建 2×2、3×3 等布局。

• 自定义
  • 自定义布局格式。

参数

• 列数
  • 列的数量。
• 行数
  • 行的数量。

取景

• 裁切
  • 调整框的大小以适应布局。

    IMPORTANT

    如果适用的话，这将拉伸它们。

• 遮幅
  • 保持盒子的原始尺寸并使其适应布局。
• 叠加
  • 将画面的窗口裁剪到列和行规定。

镜像边缘

以奇偶校验模式镜像轨道。

• 水平翻转
  • 以所选模式翻转列。
• 垂直翻转
  • 以所选模式翻转行。

递减次序

反转布局排序方法（勾选时）。

边距

调整轨道框，使其与其它框不那么杂乱。

3D方盒布局

这将使用你所选的轨道创建一个立方体。

删除原轨道

布局生成时删除原始轨道。

使用视频的长边作为立方体的棱长

这可能使得立方体更加自然。

渐变轨道

这使得视频轨道在布局中具有渐变样式的颜色效果。

• 渐变效果
  • 效果预设。
• 递减次序
  • 反转渐变次序。

清除轨道运动

重置轨道运动盒。

清除轨道效果

移除所有轨道效果。

填补轨道间隙

• 堆积剪辑（应用于当前轨道）
  • 将选定轨道中的所有剪辑堆叠在一起。
• 堆积剪辑（应用于所有轨道）
  • 将每个轨道上的所有剪辑堆叠在一起。
• 拉伸剪辑（限制在拉伸极限范围之内）
  • 拉伸剪辑而不延长剪辑的长度。
• 拉伸剪辑（超出拉伸极限范围之后再延长剪辑）
  • 拉伸剪辑并延长剪辑。
• 延长剪辑（改变剪辑时长）
  • 延长剪辑。
• 增加间隙（应用于当前轨道）
  • 划分轨道中每个剪辑的间距。
• 增加间隙（应用于所有轨道）
  • 划分所有轨道的每个剪辑的间距。
• 仅应用于所选轨道剪辑
  • 允许将填补轨道间隙仅应用于所选轨道事件。
• 也应用于同分组内的其它轨道剪辑
  • 允许将填补轨道间隙应用于分组剪辑。
• 反转方向
  • 向后应用填补间隙效果。

快速间隔选择

这可以选择所选轨道中的特定剪辑。

• 每几段选择一段
  • 根据间隔值选择每隔一个剪辑。
• 选择每组第几段
  • 选择所选内容中轨道剪辑的顺序。
• 每次要选取几段
  • 选择每组一次有多少个剪辑。
• 重置选择
  • 重置回运行脚本前的选择。

快速配置属性

设置所选事件剪辑的属性。

视频剪辑

• 隐藏
  • 开关视频。
• 锁定
  • 开关视频锁定。
• 循环
  • 开关视频循环。
• 保持宽高比
  • 锁定纵横比。
• 减少隔行扫描闪烁
  • 开关隔行闪烁。
• 重新采样模式
  • 设置视频的重采样模式。
• 播放速率设置
  • 设置视频的播放速率。
• 设置欠采样率
  • 设置视频的欠采样率。
• 不透明度设置。
  • 设置视频的不透明度。

音频剪辑

• 静音。
  • 开关音频。
• 锁定
  • 开关音频锁定。
• 循环
  • 开关音频循环。
• 反相
  • 反转音频相位。
• 规范化音量
  • 设置音频的规范化增益设置。
• 播放速率设置
  • 设置音频的播放速率。
• 音量设置
  • 设置音频的音量。

替换轨道剪辑

用特定首选项替换所选轨道事件。

同时指定

• 所选轨道事件可以替换为你在选择结束时所选的任何内容，你可以从另一个轨道中选择一个剪辑并将其用作替换，并且你之前设置的所有轨道剪辑都将被该剪辑替换。

分别指定

• 将轨道中的特定剪辑替换为你按所需顺序所选的任何剪辑。
• 额外信息中的解释

选项

• 同时替换分组内的其它剪辑
  • 替换同一轨道事件组中的其它剪辑。

    IMPORTANT

    若剪辑不在组中则不应用。

• 保留原剪辑名称
  • 保留替换后原始剪辑的原始剪辑名称。
• 保留原剪辑偏移量
  • 保留时间线中使用的剪辑的原始偏移量。

更改调音算法

更改所选轨道事件的调音方法。

有关音频调音方法的详细信息，请参阅“︁音频”︁部分。

音调更改

• 锁定以拉伸
  • 锁定音高值。
• 锁定音高而不是速度
  • 锁定音高而不是拉伸速度。

共振峰移位

• 保持共振峰
  • 锁定共振峰。

批量生成字幕

使用标题媒体生成器创建任意持续时间的批量文本。

• 从文件中导入
  • 导入用于字幕的文本文件。

• 预设
  • 控制预设选择。
• 输入
  • 逐行输入文本。

    IMPORTANT

    空行将被忽略。

• 时长
  • 每条的时长。

查找轨道剪辑

查找并选择与指定匹配的所有轨道事件。

选项

• 匹配与选中轨道剪辑相同的所有剪辑
• 匹配与选中轨道剪辑相同且开始偏移量相等的所有剪辑
• 匹配与指定名称相匹配的剪辑

搜索文本框

搜索项目中的任何视频、音频或全部轨道事件。

• 全部
  • 搜索视频和音频事件。
• 仅视频
  • 仅搜索视频事件。
• 仅音频
  • 仅搜索音频事件。

应用视觉效果

将视觉效果应用于所选轨道事件。

有关你可以使用的视觉效果的详细信息，请参阅“︁画面”︁部分。

转换音乐节拍

将音乐节拍转换为不同的拍号。

自定淡化增益

调整所选轨道事件的增益/音量范围。

• 从
  • 起始渐入或渐出效果的值。
• 至
  • 终止渐入或渐出效果的值。

导出MIDI文件

将轨道或轨道事件导出到乐谱序列文件。

设置

• 所有轨道
  • 选择所有轨道。
• 视频轨道
  • 仅选择视频轨道。
• 音频轨道
  • 仅选择音频轨道。
• 原始音高
  • 设置默认原始音高 (C5)。
• 仅导出循环区域
  • 仅导出包含选定循环片段轨道事件的MIDI。

Vegas轨道列表

选择要添加到MIDI文件的轨道。

选项

• 添加到各自新轨道
  • 将所选轨道添加到不同的新MIDI音轨及MIDI通道。
• 添加到同一新轨道
  • 将所选轨道添加到1个新MIDI音轨及不同的MIDI通道。
• 添加到当前轨道
  • 将所选轨道添加到所选的MIDI轨道及不同的MIDI通道。
• 预览
  • 预览所选轨道。

MIDI音轨列表

管理正备用的MIDI音轨列表。显示备用列表中有多少个已创建的音轨以及每个MIDI音轨中有多少个Vegas轨道和音符。

选项

• 上移
  • 将所选音轨向上移动。
• 下移
  • 将所选音轨向下移动。
• 移除
  • 从列表中删除所选音轨。
• 添加新的空音轨
  • 创建一条新的MIDI音轨。
• 插入新的空音轨
  • 在所选音轨上插入新的MIDI音轨。

• 名称
  • 输入音轨的名称。

MIDI通道列表

从轨道列表中所选轨道管理通道列表。显示在所选MIDI轨道中创建的Vegas轨道和音符的数量。

选项

• 移除
  • 从列表中删除所选通道。
• 通道
  • 设置所选轨道所在的通道。

• 乐器
  • 显示通道使用的MIDI乐器。

MIDI乐器列表

已选择乐器并分配到相应MIDI通道的列表，这些通道可以更改。

选项

• 为通道指派乐器
  • 为所选MIDI通道更改并设置乐器。

脚注

要借助Otomad Helper快速制作视觉效果

• 你需要一个Vegas Pro (13+)；

  WARNING

  如果你有任何其它用于剪辑的编辑器，那么你就不那么走运了。

• 你需要Otomad Helper脚本；
• 你需要FL Studio（或用于混音的任何其它DAW）。

从这里开始，使用Otomad Helper非常简单。以下是使用方法。

• 你可以导入并使用MIDI文件来配置和生成所需的剪辑。你应该使用你自己创建的MIDI，而不是其他人的。这太不礼貌了。不要做音MIDI或者不是你创造的任何形式的混音。
• 你需要在时间轴或媒体柜中挑取一段剪辑，以便在Vegas Pro中生成MIDI中的任何内容。
  • 或者你可以使用电脑中的剪辑或素材来进行MIDI生成。
• “︁音频”︁和“︁画面”︁页面将允许你编辑剪辑的生成设置，有各种设置，玩弄它们并对它们进行调整，以便在开始创建时对你的需求进行排序。
• 还有各种工具可以帮助你完成项目中最荒唐的任务，使编辑某些片段以应用不同效果的繁琐工作不再说起来容易做起来难。

要开始（与FL Studio协作）

现在有一个功能，你可以立即加载上次使用的配置。

• 运行脚本时按住 Ctrl 键，脚本将加载最后一次使用的配置并生成。

脚注

也被称为：视频、视觉、映像、PV。

该设置可开关。（如果你的片段有画面，那么它将默认开启。）
你可以右键或中键单击任意设置滑动条来重置它。

开关

循环

如果适用的话，使剪辑循环。

静态画面

使剪辑冻结在剪辑的开始处。

截断

使剪辑冻结在简介的末尾处。

复音多轨

为画面生成多条视频轨道。

创建分组

将视频剪辑及其关联的音频剪辑组合在一起。

滑音效果

当音符音高弯音或滑音时产生漩涡效果。

堆叠

当MIDI包含多个轨道时，在单独的轨道上创建堆叠视频剪辑。

持续时间流

禁用剪辑的所有形式的时间重映射！起始时间不会重置，而是将从每个音符停止的位置继续。

拉伸

Makes the clip stretch if applicable

• 不拉伸
  • 不为剪辑应用拉伸。
• 可屈伸
  • 完全地拉伸剪辑。
• 仅伸展
  • 使剪辑拉伸得更长。

    IMPORTANT

    这对于MIDI音符比画面剪辑更长时效果最佳。

• 仅屈折
  • 使剪辑拉伸得更短。

    IMPORTANT

    这对于MIDI音符比画面剪辑更短时效果最佳。

填补间隙

将剪辑延长到音符持续时间之外。

• 不填补
  • 不延长。
• 最长一拍
  • 延长到1拍。

    IMPORTANT

    仅当到下一个剪辑的间隔小于1拍时，此功能才有效。

• 最长一小节
  • 延长到1小节。

    IMPORTANT

    仅当到下一个剪辑的间隔小于1小节时，此功能才有效。

• 无限填补
  • 无限延长。

首选轨道

创建新轨道或使用所选轨道来生成。

力度

用于分配与MIDI音符相关的不透明度值的设置。

• 映射力度
  • 将音符分配给MIDI文件中的力度。
• 乘以当前增益
  • 开启后会倍增现有增益。
• 音符力度
  • 力度值从最小值到最大值。
• 不透明度
  • 不透明度值从最小值到最大值。

• 重置
  • 重置为默认设置。

映射力度解释

效果

视觉效果

做出你想要的视觉效果。默认值是水平翻转。

初始步

视觉效果的值设置。

高级 - 画面节奏韵律动感跳动视觉效果

• 翻转类
  • 从翻转类中选择视觉效果类型。
• 旋转类
  • 从旋转类中选择视觉效果类型。
• 缩放类
  • 从缩放类中选择视觉效果类型。
• 镜像类
  • 从镜像类中选择视觉效果类型。
• 反转类
  • 从反转类中选择视觉效果类型。
• 色相类
  • 从色相类中选择视觉效果类型。
• 单色类
  • 从单色类中选择视觉效果类型。
• 时间类
  • 从时间类中选择视觉效果类型。
• 时间类2
  • 从时间类2中选择视觉效果类型。
• 扩缩类
  • 从扩缩类中选择视觉效果类型。
• 摇摆类
  • 从摇摆类中选择视觉效果类型。
• 模糊类
  • 从模糊类中选择视觉效果类型。
• 擦除类
  • 从擦除类中选择视觉效果类型。

参数

画面生成的各种效果。

预设

为方便使用而预定制的视觉效果。

• 设定淡化为百分比
  • 将值度量设置为百分比值。
• 设定淡化为时间码
  • 将值度量设置为时间码值。

淡化

渐入

轨道事件中视频渐入的长度。

渐出

轨道事件中视频渐出的长度。

发光

发光

“︁发光”︁效果的值可为你的画面增添光彩！

发光亮度

画面中发光亮度的值。

限制关键帧长度

指定为以下属性生成的关键帧的长度。

• 不限制
  • 关键帧将从MIDI音符的开始到结束正常生成。
• 最小长度
  • 关键帧永远不会短于设置的长度。如果音符较短，它们会被截断。
• 固定长度
  • 关键帧被强制设为设定的长度。

变换

起始尺寸

平移/裁切的起始尺寸值。

终止尺寸

平移/裁切的终止尺寸值。

起始旋转

平移/裁切的起始旋转值。

终止旋转

平移/裁切的终止旋转值。

起始平移

平移/裁切的起始水平位置值。

终止平移

平移/裁切的终止水平位置值。

起始直移

平移/裁切的起始垂直位置值。

终止直移

平移/裁切的终止垂直位置值。

调色

起始色相

起始色相的值。

终止色相

终止色相的值。

起始饱和

起始饱和度的值。

终止饱和

终止饱和度的值。

起始对比

起始对比度的值。

终止对比

终止对比度的值。

起始阈值

起始对比度阈值的值。

终止阈值

终止对比度阈值的值。

YTP用于使用YTP中典型的各种效果来创建YTP。
（YTP支持多素材）

效果

• 合唱
  • 合唱摇摆效果。
• 更改音调
  • 更改音调为随机值。
• 颤音
  • 音调怪异效果。
• 倒放
  • 倒放剪辑。
• 延迟
  • 延迟回声。
• 更改速度
  • 拉伸视频。
• 更改色相
  • 更改颜色。
• 旋转色相
  • 动态更改颜色。
• 黑白
  • 单色。
• 颜色反转
  • 负片。
• 高频重复
  • 快速重复剪辑。
• 随机调音
  • 随机生成的音高乐句。
• 放大
  • 随机放大视频。

    IMPORTANT

    也会增大音量。

• 球面化
  • 鱼眼效果。
• 镜像
  • 镜像剪辑。
• 高对比
  • 增加对比度。

    IMPORTANT

    也会最大化音量。

• 过饱和
  • 最大饱和度。

    IMPORTANT

    也会有升调效果。

• 重要的事情说三遍
  • 升调并以零星的动作重复。

参数

• 最小长度
  • 控制要生成剪辑的最小长度。
• 最大长度
  • 控制要生成剪辑的最大长度。
• 剪辑数目
  • 生成剪辑的数目。

    IMPORTANT

    生成的剪辑的最大数量为300个。