輸出文件重命名

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.