输出文件重命名

1. 介绍

2. 标签参考

3. 编号规则

4. 规则与限制

5. 示例

*本文档中的GUI指Waifu2x-Extension-GUI

介绍

Waifu2x-Extension-GUI会自动为输出文件命名. 通过输出文件重命名对话框(点击重命名按钮打开), 您可以自定义输出文件名.

该对话框提供三种模式:

默认 - 保留引擎内置命名约定; 不应用自定义重命名.
简单组合 - 选取元素(序号, 引擎, 放大倍率, 降噪等级, 画质, 源扩展名)放到文件名之前和/或之后, 用连接符(_, 空格或-)连接.
高级自定义 - 用标签构建文件名, 有两条独立的格式字符串: 一条用于使用输出文件夹时, 一条用于就地保存(文件保存在源文件旁边, 包括输出文件夹被禁用的情况).

重命名在文件保存并移动到输出位置之后应用. 它只改变文件名(基本名), 绝不改动扩展名.

当启用了保留原文件名且正在使用输出文件夹时, 或启用了替换原文件时, 重命名不会生效.

标签参考

标签	说明
`<name>`	源文件的基本名(不含扩展名). 示例: `CatPic.png` → `CatPic`.
`<ext>`	源文件的扩展名(不含点). 示例: `CatPic.png` → `png`.
`<outext>`	输出文件的扩展名(不含点).
`<scale>`	放大倍率, 如`2x`; 应用自定义分辨率时为自定义分辨率, 如`1920x1080`. 在无放大的流程(仅格式转换, 仅插帧, 仅移除重复帧)中展开为空字符串.
`<denoise>`	降噪等级. 对没有降噪选项的引擎(RealESRGAN, RealSR, PyTorch, Maxine)以及无放大的流程, 展开为空字符串.
`<engine>`	放大引擎的短名称: `Waifu2xNcnn`, `Waifu2xCaffe`, `Waifu2xConverter`, `SrmdNcnn`, `SrmdCuda`, `RealSR`, `RealESRGAN`, `RealCUGAN`, `Anime4K`, `Maxine`, `PyTorch`. 在无放大引擎的流程(仅格式转换, 仅插帧, 仅移除重复帧)中展开为空字符串.
`<number-pad>`	源文件夹内的序号, 自动补零. 宽度随组内文件数量自适应: 77个文件 → 宽度2 → `07`. 见编号规则.
`<number-pad3>`	显式指定宽度的序号. 示例: `<number-pad3>` → `007`.
`<number-pad3:date:desc>`	带内联排序依据的序号. 允许的参数: `name`, `date`, `asc`, `desc`; 默认为`name asc`.
`<date:yyyy-MM-dd>`	源文件的修改日期, 用Qt原生格式标记(`QDateTime::toString`的格式字符串)格式化. 常用示例: `yyyy-MM-dd` → `2024-01-15`, `yyyyMMdd-hhmmss` → `20240115-103000`.
`<ImgQuality:separator>`	输出图片的画质. 仅限图片文件, 且自带连接符: `cat<ImgQuality:_>` → `cat_Q95.jpg`. 对非图片文件(GIF, 视频)展开为空字符串.

标签名不区分大小写: <NAME>与<name>等价.

编号规则

序号按源文件夹分配, 从1开始编号.
序号在开始处理时分配, 因此不依赖文件完成的先后顺序. 之后失败或被跳过的文件不会改变其他文件的序号.
被基于分辨率的自动跳过功能跳过的文件, 在分配序号时无法区分, 因此仍会被计数, 序号中可能出现空缺.
简单组合模式: 排序依据来自下拉框(文件名 / 修改日期, 仅升序).
高级自定义模式: 排序依据在序号标签内联设置, 如<number-pad:date>, <number-pad3:name:asc>, <number-pad3:date:desc>. 同一格式字符串中出现多个排序依据不同的序号标签时, 第一个生效.
用于日期排序和<date:...>的修改时间是开始处理时拍摄的快照 - 处理过程中修改源文件不会改变展开结果.

规则与限制

标签名不区分大小写.
分隔符合并. 当标签展开为空字符串时, 其两侧各一个紧邻的分隔符(_, 空格或-)会被合并去掉. 示例: a_<empty>_b → a_b. 您自己书写的连续分隔符会被保留: img_<name>__v2 → img_CatPic__v2.
非法字符. 展开后的文件名不得包含\ / : * ? " < > |. 该检查同样适用于展开结果, 例如<date:hh:mm:ss>会展开为10:30:00, 含有:, 因此会被拒绝.
不要在日期格式字符串内使用>, 即使在Qt单引号字面量内也不行 - 标签在第一个>处结束, 格式字符串会被截断.
重命名只改变文件名, 绝不改变扩展名.
如果目标文件名已存在, 会自动追加_1, _2, ...
当启用了保留原文件名且正在使用输出文件夹时, 或启用了替换原文件时, 不应用重命名.
如果运行时无法应用重命名(例如整个格式在当前流程中展开为空文件名, 或文件被占用), 则保留原输出文件名, 在日志中显示警告, 且文件不会被标记为失败.

示例

源文件: CatPic.png, Waifu2xNcnn引擎, 2x, 降噪等级1, 输出png.

<engine>_<name>_<scale>_<denoise> → Waifu2xNcnn_CatPic_2x_1.png
相同格式, 使用RealESRGAN引擎(无降噪选项), 4x: <engine>_<name>_<scale>_<denoise> → RealESRGAN_CatPic_4x.png(空的<denoise>使相邻的_被合并).
仅格式转换(无引擎, 无倍率, 无降噪): <engine>_<name>_<scale>_<denoise> → CatPic.png(三个标签均为空, 所有分隔符被合并).
cat<ImgQuality:_> → 对图片为cat_Q95.jpg; 对GIF或视频展开为cat.jpg.
<name>_<date:yyyy-MM-dd> → CatPic_2024-01-15.png(开始处理时源文件的修改日期).
<number-pad>_<name>, 文件夹内有77个文件: 第7个文件 → 07_CatPic.png.
<number-pad3:date:desc>_<name> → 按修改日期降序排序, 宽度3: 003_CatPic.png.