LyricsRoller

功能：为已经打好轴的歌词字幕自动生成类似 Apple Music / 网易云音乐的滚动歌词

✔ 支持卡拉OK效果（需要将参数字体颜色设置为主要颜色）

✔ 支持非英文字符的自动换行（但是会把单个英文单词分割到两行中）

✔ 支持自定义歌词的对齐方式（详见更多用法）
效果对比

| 原歌词 | 现歌词 | | --------------------------------------------------- | -------------------------------------------------- | | <img src="img/result_prev.png" style="zoom:70%;" /> | <img src="img/result_now.png" style="zoom:70%;" /> |
视频效果演示

（可见示例文件 二度寝_lyrics_roller.mp4）

https://github.com/user-attachments/assets/d689d208-b66d-488e-a678-5682f5c63efe
示例位于 /example 文件夹下，其包含以下文件：
- 二度寝.ass（已生成滚动歌词的字幕文件，可自行复原）
- 二度寝.mp4（字幕用到的视频文件）
- 二度寝_lyrics_roller.mp4（使用上述两个文件压制成的最终视频文件）
- 二度寝-karaok.ass（卡拉OK示例的字幕文件）
- 二度寝-karaok_lyrics_roller.mp4（卡拉OK字幕文件生成的最终视频文件）

❗ 所有图片和视频演示均为v1.0版本，新增功能请在更新历史查看

更新历史

v1.2.3
- 修改缩放参数 \fsc 为 \fscx\fscy
v1.2.2
- 增加透明度渐变与否的选项
  - 勾选此选项，对应着之前版本中默认的情况：显示范围内第一组和最后一组字幕呈现逐渐清晰/逐渐透明效果
  - 不勾选此选项，则直接在显示范围边界截断字幕
- 修改透明度渐变的计算方式为余弦函数而非线性
- 修复某些情况下生成滚动字幕会使得Aegisub爆内存的bug
v1.2.1
- 新增卡拉OK模式型字体颜色选项
  - 勾选此选项后，强调组和普通组的字体颜色配置会覆盖对话框中单独指定的字体颜色，且配置如下：
    - 强调组为次要颜色转主要颜色
    - 强调组上方普通组使用主要颜色
    - 强调组下方普通组使用次要颜色
- 新增普通组-字体颜色选项，作用类似强调组-字体颜色
- 修复卡拉OK模式下出现的这些问题：
  - 单行字幕换行后的第一个字符没有颜色切换动画
  - 没有强调组的时间段中所有行会同时进行颜色切换动画
v1.1.1
- 修复缩小强调行时没有动画的问题
- 修复复原功能无效的问题
- 增加生成 & 复原后的消息提示
v1.1
- 新增保存输入参数的功能
 - 在对话框中勾选 记忆本次输入的参数 即可
 - 点击 reset to default 可恢复最初的默认参数
- 现在可以通过Enter键和Esc键快捷选择对话框按钮的ok和cancel了
 <img src="img/update-v11.png" style="zoom:60%;" />
v1.0

使用方法

载入插件

在Release列表中下载最新的文件 LyricsRoller.lua
在Aegisub中载入插件
- 方法一（推荐）：打开Aegisub的本地文件夹目录，进入子目录Aegisub/automation/autoload，将下载的文件 LyricsRoller.lua 放入此文件夹中
 <details> <summary>图片示例</summary> 比如我安装的Aegisub是在D盘的tool文件夹下，那么我应该将插件放在图示位置中： <img src="img/load-1.png" style="zoom:70%;" /> </details>
- 方法二：（菜单）自动化 → 自动化 → 载入 → 选择LyricsRoller.lua
 <details> <summary>图片演示</summary> <img src="img/use_step-1-1.png" style="zoom:70%;" /> <img src="img/use_step-1-2.png" style="zoom:70%;" /> </details>

基本使用方式

在标准模式找出想要显示滚动歌词的矩形范围的左上角和右下角的点的坐标
<img src="img/use_step-2.png" style="zoom:70%;" />
1. 将所有需要用于滚动歌词的行设置一个相同的特效名
 <img src="img/use_step-3-1.png" style="zoom:70%;" />
 ❗ 建议在第一句歌词前增加一个从音乐开始时间到第一句歌词开始时间的空行（如上图的第四行）、并在最后一句歌词后增加一歌空行持续到音乐结尾，从而让歌词显示效果更加完整（目的：延长插件所生成的歌词的显示时间至整首歌的时长）
2. （菜单）自动化 → LyricsRoller - 歌词滚动生成器 → 生成
 <img src="img/use_step-4.png" style="zoom:50%;" />
在特效名中填写你在2中设置的特效名、在显示范围中填写你在1记录的矩阵范围的坐标点，并根据自己的需要设置更多参数
<img src="img/use_step-5.png" style="zoom:70%;" />
❗ 更多参数的解释及效果见参数解释部分
点击ok，会生成滚动歌词，并自动覆盖之前使用相同特效名所生成的滚动歌词，生成结果可见一开始的对比图
若要手动删除所有使用此特效名生成的滚动歌词，点击（菜单）自动化 → LyricsRoller - 歌词滚动生成器 → 复原，输入使用的特效名，并点击ok
<img src="img/use_step-6-1.png" style="zoom:50%;" /> <img src="img/use_step-6-2.png" style="zoom:70%;" />

你需要注意的

LyricsRoller会自动将具有相同开始时间的字幕行视作同一组，因此请为需要在同一时间内显示的歌词（如原文+译文+注释）设置相同的开始时间
对于同一组的字幕行，LyricsRoller会按照原来的字幕顺序将其放在一起
- 例如，如果你想在最终的滚动歌词中，让译文显示在原文上方，那么你应该在使用插件前将译文对应的行放在原文的行的上方
- 一个简单的方法是按照样式名将所有行进行排序，并把所有译文样式的行剪切放在原文样式的行的上方
- | 译文在原文上方 | 译文在原文下方 | | ------------------------------------------------------------ | ------------------------------------------------------------ | | 生成结果 | 生成结果 |
请在使用LyricsRoller前，尽量确保字幕已经正常打好了轴，否则你应当清楚LyricsRoller对不同开始时间、结束时间的统一方式：
- LyricsRoller会自动统一同一组字幕的结束时间，此时间来自于此组的字幕里最晚的结束时间
- 若某组的结束时间晚于下一组的开始时间，则修改此结束时间为下一组的开始时间
- 若两个组之间的间隔时间小于强调组的动画时长（见参数解释），则会将上一组的结束时间修改为下一组的开始时间
请尽量不要在行中手动修改字体大小或进行其他有可能影响到字体大小的操作（比如修改字体），因为自动换行功能会忽略行内的所有特效
请尽量不要在行中使用换行符 \n 或 \N 或手动空格等字符，因为自动换行功能不会解析这些代码，且会视为一个个独立的字符，从而导致自动换行可能出现错误
LyricsRoller理论上不支持Aegisub的注音（furi）功能，因为其生成的注音的位置是固定的，但LyricsRoller在生成滚动字幕时不会去计算同一组内不同行字幕之间的相对位置
- 本人目前没有注音滚动字幕的需求，因此暂不考虑增加此功能，不过也欢迎各位进行改进

名词解释

组：所有开始时间相同的字幕行的集合
强调组：当前的音频时间处于某一组的开始时间与结束时间之内，则此组称为强调组
- 对应音乐歌词中当前唱到的那一句
普通组：强调组以外的其他组

参数解释

| 参数名 | 参数名 | 数据类型 | 数据范围 | 作用 | | -------------------- | -------- | -------- | -------------------------- | ------------------------------------------------------------ | | 特效名 | | 字符串 | - | 指定用于生成的字幕行 | | 显示范围 | (x,y) | 整数 | - | 指定生成歌词的显示范围 | | 强调组 | 字体颜色 | - | 主要颜色 / 次要颜色 | 指定强调组中字幕行的字体颜色为其对应样式中的主要颜色还是次要颜色 ❗ 改变样式中的字体颜色后需要重新生成才能应用颜色的修改 | | | 位置比例 | 整数 | 0 - 100 | 指定强调行在显示范围内的位置 此数值表示强调组顶部的y轴位置在整个显示范围内的比例（最上面是0，最下面是1） | | | 缩放 | 整数 | 0 ~ | 指定强调行相对普通行的字体大小的比例 100即为相同大小 ❗ 若要使此特效有效，需要用到插件VSFilterMod，使用方式和用于压制的方式请自行搜索 | | | 动画时长 | 整数 | 0 ~ | 指定普通行变为强调行、强调行变为普通行时的动画的时长(毫秒) 动画包括：颜色变化、位置移动、缩放 动画所占用的时间均为强调行的时间 | | 普通组 | 字体颜色 | - | 主要颜色 / 次要颜色 | 指定普通组中字幕行的字体颜色为其对应样式中的主要颜色还是次要颜色 ❗ 改变样式中的字体颜色后需要重新生成才能应用颜色的修改 | | | 不透明度 | 整数 | 0 - 100 | 指定普通行字体的透明度 100即为完全不透明 与之对应的，强调行的不透明度为100% | | 组内间距 | | 整数 | 0 ~ | 组内不同字幕行之间的距离 | | 组间距 | | 整数 | 0 ~ | 两组之间的距离 | | 默认字幕对齐 | | - | 左对齐 / 中间对齐 / 右对齐 | 字幕在整个显示范围中的x轴对齐方式，单独指定方式见更多用法 | | 淡入时长 | | 整数 | 0 ~ | 最早的开始时间时，淡入显示整个滚动歌词的时长(毫秒) | | 淡出时长 | | 整数 | 0 ~ | 最晚的结束时间时，淡出显示整个滚动歌词的时长(毫秒) | | 首末组字幕透明度渐变 | | 布尔型 | 勾选 / 未勾选 | 显示范围内的第一组和最后一组字幕会有透明度渐变效果 取消后只做硬裁剪 | | 卡拉OK模式型字体颜色 | | 布尔型 | 勾选 / 未勾选 | 勾选此选项后，强调组和普通组的字体颜色配置会覆盖对话框中单独指定的字体颜色，且配置如下： 强调组为次要颜色转主要颜色 强调组上方普通组使用主要颜色 强调组下方普通组使用次要颜色 | | 记忆本次输入的参数 | | 布尔型 | 勾选 / 未勾选 | 勾选会在插件目录下生成 LyricsRoller_config.txt 以保存参数信息 点击 reset to default 可恢复最初的默认参数 |

LyricsRoller

Install / Use

README

LyricsRoller

目录

更新历史

使用方法

载入插件

基本使用方式

你需要注意的

名词解释

参数解释

更多用法

卡拉OK效果

单独指定对齐方式

修改插件对话框中的默认值