Skip to content

Latest commit

 

History

History
147 lines (94 loc) · 6.01 KB

README.md

File metadata and controls

147 lines (94 loc) · 6.01 KB

Mobsub

库 类型 主要功能
SubtitleParse 类库 读取和写入字幕文件
Ikkoku 控制台应用程序 字幕相关的处理工具
ZhConvert 类库 中文繁体化
Test 控制台应用程序 测试用

SubtitleParse

命名空间：Mobsub.SubtitleParse、Mobsub.AssTypes

目前支持的字幕类型：ass

Ass

  1. 读取、解析、写入常规 4.00+ 样式版本的 ass 文件，支持的部分：
    • Script Info
    • V4+ Styles（旧版本需要确认，还有个别 format 可能有兼容性问题）
    • Events
    • Fonts
    • Graphics
    • Aegisub Project Garbage
    • Aegisub Extradata
  2. 提取 ass 中使用的字体和字形
  3. 提取 ass 中使用的特效标签（overide tags）
  4. 解析并转化 ass 中的内嵌字体和图片
    • 目前不支持转化字体为 ass 中的内嵌字体，因为还没搞懂使用的name和bold/italic/encoding判断依据

Ikkoku

CommandLine

目前支持的字幕类型：ass

clean（字幕清理）

  1. 移除无用部分：目前是移除 Fonts、Graphics、Aegisub Project Garbage、Aegisub Extradata，暂时不支持自定义
  2. Script Info 移除 ; 起始的行，可以通过 --keep-comments 保留
  3. Script Info 中的 Tilte 值改为 ass 的文件名，不含后缀，暂时不支持自定义
  4. Script Info 添加 LayoutResX/Y，默认与 PlayResX/Y 值相同，需要指定 --add-layoutres 开启
  5. 检查并记录 Events 中使用但 Styles 中未定义的样式
  6. Events 中移除 U+200E、U+200F、U+200B，将 U+00A0 替换为 U+0020
  7. Events 中清理 aegisub-motion 产生的多余字符
  8. 注释并打印 Events 中开始时间大于结束时间的行
  9. 如果使用 --drop-unused-styles 可以删除没有使用的样式，默认不开启
  10. 如果使用 --extract-binaries 可以将 Fonts、Graphics 中的数据转回二进制文件，与 ass 输出路径同级目录
  11. preset 可以指定预设，可以被其他选项覆盖
    • Basic: 启用 1，但不会移除 Aegisub Extradata
    • More：启用 1-8

check（字幕检查）

  1. 通过 --tag 指定 mod 检查 VSFilterMod 标签，weird 检查可能有问题的标签，both 同时检查这两种
  2. 通过 --style 检查使用却未定义的样式，与 clean 的 5 检查范围相同
  3. 默认检查是否有错误的时间戳、无用的字符，与 clean 的 6、8 检查范围相同

tpp（字幕时间处理）

多种模式不能同时使用

平移

--shift-by 指定要平移的跨度，通过后缀分别，如果平移为帧时需要指定 --fps

--shift-styles 指定要平移的样式，默认只处理指定的样式，若第一个元素为 ! 则不处理指定的样式

  • 计划支持分时间段（结合章节文件）的平移（分样式的平移考虑功能优化）
转换

根据 --tcfile 指定的符合 mkv timestamp v2 的 timecode 文件，将 vfr 字幕转为 cfr 字幕

merge（字幕混合拼接）

--section 指定要拼接的部分，只支持 Styles、Events

直接拼接

需要指定 --base（基础文件）、--merge（要拼接的文件）

根据配置拼接

可以在平移后再进行拼接，配置文件见下文的「merge 配置文件」

需要指定 --config（配置文件）、--config-var（配置文件的变量）

  • --config-var 可以配置两个变量，第一个为集数（连续多集用 : 分割起止集），第二个为语言后缀

cjkpp（中日韩字形处理）

构建二进制字典可以使用子命令 build-dict。

目前实现的：

  1. 基于 OpenCCSharp 类似于 OpenCC 的中文字形词汇转换

    • 忽略 ass style 中包含 JP（不区分大小写）的行（目前不支持处理 \r 指定的部分）
    • 转换后字符数量与转换前不同时，ovrride block 会插在原位置，且在控制台打印在文件中的行号和前后文字便于检查

  2. 简易配置文件（与 OpenCCSharp 的相同）

    • 配置中的相对路径基于配置文件的路径
    • 计划增加一个包含多处理步骤的配置文件，可以针对不同的样式采用不同的处理

计划实现的：

  1. 日文假名的全半角转换（基于 nkf？）
  2. 修正常用错字，包括且不限于中文中误用的日文汉字

Others

Mkv timestamp

目前只支持解析 v2 格式

merge 配置文件

toml 文件，有 v1、v2 两种格式

v1 示范样例：Nekomoekissaten-Storage/Danseur/Subs /danseur_op.yml

v2 示范样例：Nekomoekissaten-Storage/Summertime/Subs /str_effect.yml

v2

  1. namef、tpl_fr和 shift_fr 集数下的同一 key 表示同一文件

  2. shift_fr 下的 key 代表集数，集数 key 下文件 key 的 value 是一个 int 数组，根据位置具有不同含义：

    1. 相对 tpl_fr 的偏移量（必有）
    2. 在视频中 tpl_fr 帧的帧号，如果这一帧不存在可以根据其他参考点计算偏移量，并记录该点（一般有，值为 -1 跳过解析）
    3. 如果不需要完整的文件合并进去，则填入一个开始需要合并的帧号，前面的部分会被截断（需要时有，值为 -1 跳过解析）

ZhConvert

未定未来是否会支持繁化姬

OpenCCSharpUtils

基于受 OpenCC 启发由 CXuesong 开发的 OpenCCSharp（License: Apache-2.0）。

  1. 文本字典需要转换为二进制格式 tris，文本格式与 OpenCC 的文本相同，二进制与 OpenCC 的 ocd / ocd2 不兼容
  2. 配置文件 json 定义转换使用的字典，每组 Dictionaries 有先后之分，内部顺序无区别
    • 与 OpenCC 的 json 不兼容，暂未支持 json 的转换