バッチモード

バッチモードでは、フレームのシーケンスをKatana一度にすべてのシーン。ファイルパス、フレーム範囲、およびその他の必要なオプションを指定するコマンドラインから開始します。

注意:  バッチモードを含むターミナルモードにアクセスできるのは、 Katanaライセンスのレンダリング(katana_r)。学生の場合、無料でアクセスできます。

バッチモードは、個々のファイルをバックグラウンドでレンダリングするため、レンダリングするフレームの数が多い場合に便利です。作業を続けることができますKatanaコマンドが最後に保存されたバージョンを使用するので、シーンファイルをバッチレンダリングします。

バッチレンダーを開始する前に、レンダー設定とレンダーフラグがすべて正しく設定されていることを確認しますKatana。レンダーフラグを設定するには、レンダー元のノードを選択してを押しますVキーボードで。レンダーフラグはコマンドラインから決定できますが、事前に設定しておくと、バッチモードの実行に必要な文字列が簡素化され、エラーの余地が最小限に抑えられます。

注意:  出力レンダーのイメージファイル名を指定するときは、レンダーしたファイル名のフレーム番号に置き換えられるため、1つ以上のハッシュを使用するようにしてください。例:fileName_ <aov> _ ###。<ext>

バッチレンダーを開始する

Windows

  1. コマンドプロンプトを開きます。
  2. あるディレクトリに移動しますKatanaを使用してインストールcdコマンド、例:

    cd C:\Program Files\Katana3.2v1\bin

  3. 次のコマンドを入力して、バッチレンダーを開始します。

    katanaBin.exe --batch --katana-file=C:\yourDirectory\yourScene.katana -t 1-1000

    どこ:

  4. 押すEnterレンダリングを開始します。

コマンドにさらに引数を追加できます。たとえば、 --render-nodeでレンダーフラグを設定していない場合にレンダー元のノードを指定するにはKatanaシーンまたは変更したい場合:

katanaBin.exe --batch --katana-file=C:\yourDirectory\yourScene.katana --render-node=renderHere -t 1-1000

Linux

  1. ターミナルを開きます。
  2. あるディレクトリに移動しますKatanaを使用してインストールcdコマンド、例:

    cd /opt/foundry/katana

  3. 次のコマンドを入力して、バッチレンダーを開始します。

    ./katana --batch --katana-file=/yourDirectory/yourScene.katana -t 1-1000

    どこ:

  4. 押すEnterレンダリングを開始します。

コマンドにさらに引数を追加できます。たとえば、 --render-nodeでレンダーフラグを設定していない場合にレンダー元のノードを指定するにはKatanaシーンまたは変更したい場合:

./katana --batch --katana-file=/yourDirectory/yourScene.katana --render-node=renderHere -t 1-1000

バッチモードのコマンドラインオプションの完全なリストは次のとおりです。

オプション

使用法

-刀ファイル

を指定しますKatanaロードするレシピ。

構文:

--katana-file=<filename>

例:

./katana --batch --katana-file=/tmp/test.katana --t=1-1000

--render-node=beauty

- 資産

解決するアセットIDを指定します。

構文:

--asset=<asset ID>

例:

./katana --asset=mock:///show/shot/name/version

-tまたは--t

レンダリングするフレーム範囲を指定します。

構文:

-t <frame range>

または

--t=<frame range>

<frame range>は、範囲(1〜5など)またはコンマ区切りリスト(1、2、3、4、5など)の形式を取ることができます。これらは、たとえば1〜3、5のように組み合わせることができ、フレーム1、2、3、および5をレンダリングします。

例:

./katana --batch --katana-file=/tmp/test.katana

--t=1-5,8 --render-node=beauty

--var

既存のグラフ状態変数の値を設定します。このコマンドラインオプションを複数回指定して、複数のグラフ状態変数の値をオーバーライドできます。

構文:

--var <GSV name>=<GSV value>

例:

./katana --batch --katana-file=/tmp/test.katana --t=1 --var Shot=Sh1 --var timeOfDay=night --var variant=B --render-node=beauty

--threads2d

アプリケーション内の追加のプロセッサの数を指定します。追加のプロセッサも使用されますKatana'sメインスレッド。

この意味はKatana 3つのプロセッサを使用する場合--threads2d=2

構文:

--threads2d=<num threads>

例:

./katana --batch --katana-file=/tmp/test.katana

--t=1-1000 --threads2d=2 --render-node=beauty

--threads3d

レンダラーが使用する同時スレッドの数を指定します。

構文:

--threads3d=<num threads>

例:

./katana --batch --katana-file=/tmp/test.katana

--t=1-1000 --threads3d=8 --render-node=beauty

-レンダーノード

レシピをレンダーするレンダーノードを指定します。

構文:

--render-node=<node name>

例:

./katana --batch --katana-file=/tmp/test.katana

--t=1-1000 --render-node=beauty

--render-internal-dependencies

生成しないレンダーノードを許可しますasset単一の刀内でレンダリングされる出力--batch処理する。アセット出力は、出力場所がassetIdであるかどうかを現在のアセットプラグインに尋ねることによって決定されます。 isAssetId()。デフォルトfile付属のアセットプラグインKatanaすべてを資産として分類します。そのため、現時点では、1つの刀内で依存関係をレンダリングすることはできません。 --batchアセットプラグインをカスタマイズせずにコマンドを実行します。

-クロップ-rect

画像のどの部分をトリミングするかを指定します。同じトリミング領域がすべてのレンダリングに使用されます。

構文:

--crop-rect="(<left>,<bottom>,<width>,<height>)"

例:

./katana --batch --katana-file=/tmp/test.katana --t=1-1000

--render-node=beauty --crop-rect="(0,0,256,256)"

--setDisplayWindowToCropRect

表示イメージを、次によって設定された切り取り長方形と同じサイズに設定します--crop-rect

-タイルレンダリング

水平および垂直にタイルに分割された画像の1つのタイルをレンダリングするために使用されます。たとえば、
--tile-render=1,1,3,3画像を3x3の正方形の9つの小さな画像(またはタイル)に分割し、タイルレンダリングのインデックスが左下隅の0,0から始まるように中央のタイルをレンダリングします。3x3タイルの場合、インデックスは次のとおりです。

0,2 1,2 2,2

0,1 1,1 2,1

0,0 1,0 2,0

結果は、RenderOutputDefineノードで指定された場所と同じ場所に保存されますが、タイルサフィックスが付きます。例:tile_1_1.beauty.001.exr

構文:

--tile-render=<left_tile_index>, <bottom_tile_index>, <total_tiles_width>, <total_tiles_height>

例:

./katana --batch --katana-file=/tmp/test.katana --t=1-1000

--render-node=beauty --tile-render=0,0,2,2

./katana --batch --katana-file=/tmp/test.katana --t=1-1000

--render-node=beauty --tile-render=0,1,2,2

./katana --batch --katana-file=/tmp/test.katana --t=1-1000

--render-node=beauty --tile-render=1,0,2,2

./katana --batch --katana-file=/tmp/test.katana --t=1-1000

--render-node=beauty --tile-render=1,1,2,2

-タイルステッチ

でレンダリングされたタイルを組み立てるために使用されます--tile-render完全な画像にフラグを立てます。

ステッチするとき、あなたはまだパスする必要があります--tile-render引数、xおよびyタイルの数。これにより、ステッチは予想されるタイルの数とその構成を認識します。

構文:

--tile-render=<left_tile_index>, <bottom_tile_index>, <total_tiles_width>, <total_tiles_height> --tile-stitch

例:

./katana --batch --katana-file=/tmp/test.katana --t=1-1000 --render-node=beauty --tile-render=0,0,2,2 --tile-stitch

-タイルクリーンアップ

一時的なタイル画像をクリーンアップするために使用されます。と組み合わせて使用できます--tile-stitch完全な画像を組み立て、1回の操作で一時的なタイルを削除します。

使用するとき--tile-cleanupあなたはまだ合格しなければなりません--tile-render引数にxおよびyタイルの数を指定します。これにより、クリーンアップは削除するタイルの数を認識します。

構文:

--tile-render=0,0,<total_tiles_width>,<total_tiles_height> --tile-cleanup

例:

./katana --batch --katana-file=/tmp/test.katana --t=1-1000 --render-node=beauty --tile-render=0,0,2,2 --tile-stitch --tile-cleanup

--prerender-publish

バッチモードでは、 Pre-Render Publish Asset出力に対するアクションですが、画像はレンダリングしません。

この値は、レンダーパス情報をダンプするためのファイル名を指定します。

注意:  これは以下と一緒に使用できます--versionup

構文:

--prerender-publish=<pass info>

例:

./katana --batch --katana-file=/tmp/test.katana --t=1-1000 --render-node=beauty --prerender-publish=/tmp/pass_info.xml

--make-lookfilebake-scripts

Lookファイルを書き込むためにバッチモードで実行できる多くのPythonファイルを書き出すために使用されます。

構文:

--make-lookfilebake-scripts=<script directory>

例:

./katana --batch --katana-file=/tmp/bake.katana --t=1

--make-lookfilebake-scripts=/tmp/bake_scripts

./katana --script /tmp/bake_scripts/preprocess.py

./katana --script /tmp/bake_scripts/lf_bake_default.py

./katana --script /tmp/bake_scripts/postprocess.py

--postrender-publish

バッチモードでは、 Post-Render Publish Asset出力に対するアクションですが、画像はレンダリングしません。

この値は、レンダーパス情報をダンプするためのファイル名を指定します。

注意:  これは以下と一緒に使用できます--versionup

構文:

--postrender-publish=<pass info>

例:

./katana --batch --katana-file=/tmp/test.katana --t=1-1000 --render-node=beauty --postrender-publish=/tmp/pass_info.xml

--versionup

資産管理システムに公開するときに資産をバージョンアップすることを指定するために使用されます。

構文:

--versionup

例:

./katana --batch --katana-file=/tmp/test.katana --t=1-1000 --render-node=beauty --versionup

-再利用レンダリングプロセス

フレームのシーケンスを反復してレンダリングし、すべてのフレームのOp Treeファイルをエクスポートし、エクスポートされたOp Treeファイルのシーケンスでレンダラー(/ renderbootプロセス)を1回だけ開始します。

構文:

--reuse-render-process

例:

./katana --batch --katana-file=/tmp/test.katana --t=1-1000 --render-node=beauty --reuse-render-process

注意:  設定threads3dまたはthreads2dバッチモードを介してinteractiveRenderThreads3D、そしてinteractiveRenderThreads2Dの設定KatanaEdit > Preferences > applicationメニュー。

論文:  バッチモードで複数のタイルで画像をレンダリングする方法