wowit / waifu2x-caffe Goto Github PK

 ファイルの入出力に関する設定項目群です。

 変換したいファイルのパスを指定します。
 フォルダを指定した場合は、サブフォルダ内も含めた「フォルダ内の変換する拡張子」が付くファイルを変換対象とします。
 複数のファイル、フォルダをドラッグで指定することが出来ます。
 その場合は新しいフォルダの中にファイル、フォルダ構造を維持したまま出力されます。
（入力パス欄には「(Multi Files)」と表示されます。出力フォルダ名はマウスで掴んでいたファイル、フォルダ名から生成されます）
 参照ボタンを押してファイルを選択する場合、単体のファイル、フォルダか、複数のファイルが選択できます。

 変換後の画像を保存するパスを指定します。
「入力パス」で フォルダを指定した場合は、指定したフォルダの中に変換したファイルを(フォルダ構造をそのままで)保存します。指定したフォルダがない場合は自動で作成します。

 「入力パス」がフォルダの場合の、フォルダ内の変換する画像の拡張子を指定します。
 デフォルト値は`png:jpg:jpeg:tif:tiff:bmp:tga`です。
 また、区切り文字は`:`です。
 大文字小文字は区別しません。
 例. png:jpg:jpeg:tif:tiff:bmp:tga

 変換後の画像の形式を指定します。
「出力画質設定」と「出力深度ビット数」に設定できる値はここで指定する形式により異なります。

 変換後の画像の画質を指定します。
 設定できる値は整数です。
 指定できる値の範囲と意味は「出力拡張子」で設定した形式により異なります。

  * .jpg : 値の範囲(0～100) 数字が高いほど高画質
  * .webp : 値の範囲(1～100) 数字が高いほど高画質 100だと可逆圧縮
  * .tga : 値の範囲(0～1) 0なら圧縮なし、1ならRLE圧縮

 変換後の画像の1チャンネルあたりのビット数を指定します。
 指定できる値は「出力拡張子」で設定した形式により異なります。

 ファイル変換の処理方法、画質に関する設定項目群です。

 変換モードを指定します。
  * ノイズ除去と拡大 : ノイズ除去と拡大を行います 
  * 拡大 : 拡大を行います
  * ノイズ除去 : ノイズ除去を行います
  * ノイズ除去(自動判別)と拡大 : 拡大を行います。入力がJPEG画像の場合のみノイズ除去も行います

ノイズ除去レベルを指定します。レベルの高いほうがより強力にノイズを除去しますが、のっぺりとした絵になる可能性もあります。

拡大後のサイズの設定を行います。
  * 拡大率で指定 : 画像を指定の拡大率で拡大します
  * 変換後の横幅で指定 : 画像の縦横比を維持したまま、指定された横幅になるように拡大します(単位はピクセル)
  * 変換後の縦幅で指定 : 画像の縦横比を維持したまま、指定された縦幅になるように拡大します(単位はピクセル)
  * 変換後の縦横幅で指定 : 指定された縦横幅になるように拡大します。「1920x1080」のように指定します(単位はピクセル)
2倍を超える拡大率の場合、(ノイズを除去する場合は最初の1回だけ行い)指定された拡大率を超えるまで2倍ずつ拡大し、2の累乗倍でない拡大率の場合は最後に縮小するという処理を行います。そのため変換結果がのっぺりとした絵になる可能性があります。

使用するモデルを指定します。
変換対象の画像によって最適なモデルは異なるので、様々なモデルを試してみることをおすすめします。
  * 2次元イラスト(RGBモデル) : 画像のRGBすべてを変換する2次元イラスト用モデル
  * 写真・アニメ(Photoモデル) : 写真・アニメ用のモデル
  * 2次元イラスト(UpRGBモデル) : 2次元イラスト(RGBモデル)より高速かつ同等以上の画質で変換するモデル。ただしRGBモデルより消費するメモリ(VRAM)の量が多いので、変換中に強制終了する場合は分割サイズを調節すること
  * 写真・アニメ(UpPhotoモデル) : 写真・アニメ(Photoモデル)より高速かつ同等以上の画質で変換するモデル。ただしPhotoモデルより消費するメモリ(VRAM)の量が多いので、変換中に強制終了する場合は分割サイズを調節すること
  * 2次元イラスト(Yモデル) : 画像の輝度のみを変換する2次元イラスト用モデル
  * 2次元イラスト(UpResNet10モデル) : 2次元イラスト(UpRGBモデル)より高画質で変換するモデル。このモデルは分割サイズが違うと出力結果が変わるので注意すること
  * 2次元イラスト(CUnetモデル) : 2次元イラストを同梱のモデルで一番高画質で変換できるモデル。このモデルは分割サイズが違うと出力結果が変わるので注意すること

TTA(Test-Time Augmentation)モードを使うかどうかを指定します。
TTAモードを使うと変換が8倍遅くなる代わりに、PSNR(画像の評価指数の一つ)が0.15くらい上がるそうです。

 画像変換の処理速度に影響する設定項目群です。

内部で分割して処理を行う際の幅（ピクセル単位）を指定します。
最適な(処理が最速で終わる)数値の決め方は「分割サイズ」の項で説明します。
「-------」で区切られている上の方は入力された画像の縦横サイズの約数、
下の方は「crop_size_list.txt」から読み出した汎用的な分割サイズです。
分割サイズが大きすぎる場合、要求されるメモリの量(GPUを使う場合はVRAMの量)がPCで使用できるメモリを超えてソフトが強制終了するので気をつけてください。
処理速度にそれなりに影響するので、同じ画像サイズの画像をフォルダ指定で大量に変換するときは、最適な分割サイズを調べてから変換することをおすすめします。
ただし、モデルによっては分割サイズを変更すると出力結果が変わるものがあるので気を付けてください。
(その場合は分割サイズはデフォルトを使用し、バッチサイズを調整することで処理速度を上げることができます)

内部でまとめて処理を行う際のサイズを指定します。
バッチサイズを大きくすると処理速度が速くなることがあります。
分割サイズと同様に要求されるメモリの量がPCで使用できるメモリを超えないように気を付けてください。

 あまり変更する機会がないと思われる動作設定をまとめた設定群です。

 参照ボタンやドラッグアンドドロップで入力ファイルを指定した際に自動で変換を開始するのか設定を行います。
 exeに入力ファイルを引数で与えた場合ではこの項目の設定内容は影響しません。
  * 自動で開始しない : ファイルを入力しても自動で変換を開始しません
  * ファイルを1つでも入力したら開始 : ファイルを1つでも入力したら自動で変換を開始します
  * フォルダあるいは複数ファイルを入力したら開始 : フォルダ、複数ファイルを入力したら自動で変換を開始します。単体の画像ファイルを変換するのは変換設定の調節を行うときだけだ、という時にどうぞ

変換を行うプロセッサーを指定します。
  * CUDA(使えたらcuDNN) : CUDA(GPU)を使って変換を行います(cuDNNが使える場合はcuDNNが使われます)
  * CPU : CPUのみを使って変換を行います

 この設定がONの場合、画像の書き込み先に同名のファイルが存在する場合は変換を行いません。

 exeに入力ファイルを引数で与えた場合での動作を設定します。
  * 起動時に変換する : 起動時に自動で変換を開始します
  * 成功時に終了する : 変換終了時に失敗していなければ自動で終了します

 GPUが複数枚ある場合に使用するデバイス番号を指定できます。CPUモード時や無効なデバイス番号を指定した場合は無視されます。

 入力の参照ボタンを押した際に最初に表示されるフォルダをここで設定したフォルダに固定します。

 変換した画像の出力先フォルダをここで設定したフォルダに固定します。
 また、出力の参照ボタンを押した際に最初に表示されるフォルダをここで設定したフォルダに固定します。

 その他の設定項目群です。

UIの言語を設定します。
初回起動時はPCの言語設定と同じ言語が選ばれます。(存在しない場合は英語になります)

「cuDNNチェック」ボタンを押すとcuDNNが使えるか調べることが出来ます。
cuDNNが使えない場合は理由が表示されます。

waifu2x-caffe-cui.exe --help

waifu2x-caffe-cui.exe -i mywaifu.png -m noise_scale --scale_ratio 1.6 --noise_level 2

 input_fileがフォルダの場合の、フォルダ内の変換する画像の拡張子を指定します。
 デフォルト値は`png:jpg:jpeg:tif:tiff:bmp:tga`です。
 また、区切り文字は`:`です。
 例. png:jpg:jpeg:tif:tiff:bmp:tga

 input_fileがフォルダの場合の、出力画像の拡張子を指定します。
 デフォルト値は`png`です。

 変換モードを指定します。指定しなかった場合は`noise_scale`が選択されます。
  * noise : ノイズ除去を行います (正確には、ノイズ除去用のモデルを用いて画像変換を行います)
  * scale : 拡大を行います (正確には、既存アルゴリズムで拡大した後に、拡大画像補完用のモデルを用いて画像変換を行います)
  * noise_scale : ノイズ除去と拡大を行います (ノイズ除去を行った後に、引き続き拡大処理を行います)
  * auto_scale : 拡大を行います。入力がJPEG画像の場合のみノイズ除去も行います

 画像を何倍に拡大するかを指定します。デフォルト値は`2.0`ですが、2.0倍以外も指定できます。
 scale_widthかscale_heightが指定された場合、そちらが優先されます。
 2.0以外の数値を指定すると、次のような処理を行います。
  * まず、指定された倍率を必要十分にカバーするように、2倍拡大を繰り返し行います。
  * 2の累乗以外の数値が指定されている場合は、指定倍率になるように拡大した画像を線形フィルタで縮小します。

 画像の縦横比を維持したまま、指定された横幅になるように拡大します(単位はピクセル)。
 scale_heightと同時に指定すると、指定された縦横幅になるように画像を拡大します。

 画像の縦横比を維持したまま、指定された縦幅になるように拡大します(単位はピクセル)。
 scale_widthと同時に指定すると、指定された縦横幅になるように画像を拡大します。

 ノイズ除去レベルを指定します。ノイズ除去用のモデルはレベル0～3のみ用意されているので、
 0 か 1 か 2 か 3 を指定して下さい。
 デフォルト値は`0`です。

 処理に使うプロセッサーを指定します。デフォルト値は`gpu`です。
  * cpu : CPUを使って変換を行います。
  * gpu : CUDA(GPU)を使って変換を行います。Windows版でのみ、cuDNNが使えるならcuDNNを使います。
  * cudnn : cuDNNを使って変換を行います。

 分割サイズを指定します。デフォルト値は`128`です。

 変換後の画像の画質を設定します。デフォルト値は`-1`です
 指定できる値と意味は「出力拡張子」で設定した形式により異なります。
 -1の場合は、各画像形式のデフォルト値が使われます。

 変換後の画像の1チャンネルあたりのビット数を指定します。デフォルト値は`8`です。
 指定できる値は「出力拡張子」で設定した形式により異なります。

 mini-batchサイズを指定します。デフォルト値は`1`です。
 mini-batchサイズは画像を「分割サイズ」で分割したブロックを同時に処理する数のことです。例えば`2`を指定した場合、2ブロックずつ変換していきます。
 mini-batchサイズを大きくすると分割サイズを大きくするとの同様にGPUの使用率が高くなりますが、計測した感じだと分割サイズを大きくした方が効果が高いです。
 (例えば分割サイズを`64`、mini-batchサイズを`4`にするより、分割サイズを`128`、mini-batchサイズを`1`にした方が処理が速く終わる)

 処理に使うGPUデバイス番号を指定します。デフォルト値は`0`です。
 GPUデバイス番号は0から始まることに注意してください。
 処理にGPUを使わない場合は無視されます。
 また、存在しないGPUデバイス番号を指定した場合はデフォルトのGPUで実行されます。

 `1`を指定するとTTAモードを使用します。デフォルト値は`0`です。

 このオプションが指定された後の全てのオプションを無視します。
 スクリプト・バッチファイル用です。

 変換された画像を保存するフォルダへのパスを設定します。
 指定されたフォルダの中に変換後のファイルを保存します。
 変換後のファイルの命名規則はGUIで入力ファイルを設定した時に自動で決定される出力ファイル名と同じです。
 指定されなかった場合、ひとつ目の入力ファイルと同じフォルダに保存されます。

 `1`を指定すると起動時に自動で変換を開始します。

 `1`を指定すると、起動時に自動で変換した場合に変換が成功すると自動で終了します。

 `1`を指定すると、画像の書き込み先に同名のファイルが存在する場合は変換を行いません。

 使用するモデルを指定します。
 GUIでの設定項目「モデル」と以下のように対応しています。
  * upconv_7_anime_style_art_rgb : 2次元イラスト(UpRGBモデル)
  * upconv_7_photo : 写真・アニメ(UpPhotoモデル)
  * anime_style_art_rgb : 2次元イラスト(RGBモデル)
  * photo : 写真・アニメ(Photoモデル)
  * anime_style_art_y : 2次元イラスト(Yモデル)
  * upresnet10 : 2次元イラスト(UpResNet10モデル)
  * cunet : 2次元イラスト(CUnetモデル)

 バージョン情報を出力し、終了します。

 使い方を表示し、終了します。
 手軽に使い方を確認したい時などにどうぞ。

 (必須)  変換する画像へのパス
 フォルダを指定した場合、そのフォルダ以下の画像ファイルを全て変換してoutput_fileで指定したフォルダへ出力します。

 変換された画像を保存するファイルへのパス
 (input_fileがフォルダの場合)変換された画像を保存するフォルダへのパス
 (input_fileが画像ファイルの場合)拡張子(最後の.pngなど)は必ず入力するようにして下さい。
 指定しなかった場合は自動でファイル名を決定し、そのファイルに保存します。
 ファイル名の決定ルールは、
 `[元の画像ファイル名]``(モデル名)``(モード名)``(ノイズ除去レベル(ノイズ除去モードの場合))``(拡大率(拡大モードの場合))``(出力ビット数(8ビット以外の場合))``.出力拡張子`
 のようになっています。
 保存される場所は、基本的には入力画像と同じディレクトリになります。

 モデルが格納されているディレクトリへのパスを指定します。デフォルト値は`models/cunet`です。
 標準では以下のモデルが付属しています。
  * `models/anime_style_art_rgb` : 2次元イラスト(RGBモデル)
  * `models/anime_style_art` : 2次元イラスト(Yモデル)
  * `models/photo` : 写真・アニメ(Photoモデル)
  * `models/upconv_7_anime_style_art_rgb` : 2次元イラスト(UpRGBモデル)
  * `models/upconv_7_photo` : 写真・アニメ(UpPhotoモデル)
  * `models/upresnet10` : 2次元イラスト(UpResNet10モデル)
  * `models/cunet` : 2次元イラスト(CUnetモデル)
  * `models/ukbench` : 旧式の写真用モデル(拡大するモデルのみ付属しています。ノイズ除去は出来ません)
 基本的には指定しなくても大丈夫です。デフォルト以外のモデルや自作のモデルを使用する時などに指定して下さい。

 分割サイズ(横幅)を指定します。設定しなかった場合はcrop_sizeの値が使用されます。
 入力する画像の横幅の約数を指定するとより高速に変換できる可能性があります。

 分割サイズ(縦幅)を指定します。設定しなかった場合はcrop_sizeの値が使用されます。
 入力する画像の縦幅の約数を指定するとより高速に変換できま可能性があります。