Q100242: Windows用ランチャースクリプトを使用してサードパーティのレンダラープラグインで Katana 起動する方法

まとめ

Katana起動し、利用可能な様々なレンダラープラグインを使用するには、いくつかの環境変数が正しく設定されていることを確認する必要があります。これらの環境変数を管理する最も簡単な方法は、 Katana起動するためのランチャーバッチスクリプトを作成することです。

この記事では、様々なレンダラープラグインに対応したサンプルスクリプトをいくつか紹介します。これらのスクリプトはすぐに使用でき、各レンダラープラグインのデフォルトのインストールパスを使用して設定されています。

Windows にKatanaまだインストールしてライセンスを取得していない場合は、 「Windows へのインストールユーザー ガイド」を参照してください。

KATANAランチャースクリプト用語

Katana正常に起動するには、すべてのランチャースクリプトで以下の環境変数が必要です。以下に、変数とその主な機能を示します。

環境変数

関数

KATANA _ルート Katanaのルートインストールの場所。デフォルトの場所はC:\Program Files\Katana7.0v1です。
パス コマンドとして使用されるさまざまなモジュールを検索するディレクトリを指定するオペレーティング システム変数。
KATANA _リソース プラグインやその他のカスタマイズを見つけるためのパスのリストです。例えば、シェーダー、マクロ、SuperToolsなどです。詳細については、 KatanaドキュメントのKatanaリソースページを参照してください。

以下に、ランチャー バッチ スクリプトで使用される一般的なバッチ コマンドとその説明をいくつか示します。

指示 関数
レム 現在の行をコメントとしてマークします。このコマンドで始まる行は、スクリプトの実行時に無視されます。
@エコーオフ コマンド プロンプト ウィンドウに実行されたコマンドの表示を無効にします。
セット 指定された環境変数を、指定された値またはパスに設定します。複数の値またはパスはセミコロン(;)で区切ることができます。
"%KATANA_ROOT%\bin\katanaBin.exe" 指定されたKatana実行ファイルを実行します。バッチファイルがこの行に達すると、 Katanaによって実行されたコマンドを表示するコマンドプロンプトが表示されます。

ランチャースクリプトの設定

このスクリプトを変更して使用する方法については、次の手順に従ってください。

  1. 以下のいずれかのスクリプト (ランチャー バッチ スクリプトの例) の内容をコピーして、メモ帳などのテキスト エディターに貼り付けます。
    サンプルファイルも添付されていますので、代わりに添付のバッチスクリプトをダウンロードしてください。.batファイルを編集するには、ファイルを右クリックして「編集」を選択してください。
  2. スクリプトをよく読んで、指定されたパスがあなたのマシン上で同じかどうかを確認してください。異なる場合は、正しい場所を指すように更新してください。
  3. レンダラーやカスタム スクリプトなど、使用しないツールに固有のセクションを削除します。
  4. ファイルをKatana 7.0v1.batとして保存し、閉じます。
  5. ここで、.bat ファイルをダブルクリックするか、右クリック > [開く] を選択すると、コマンドが実行され、必要な環境変数がすべて設定された状態でKatana起動します。

    たとえば、Python タブで次のコマンドを実行して、正しく設定されているかどうかを確認できます。

    import os
    print(os.environ['KATANA_RESOURCES'])

    これにより、ランチャー スクリプトのKATANA _RESOURCES に追加したパスが出力されます。
  6. デスクトップ アイコンをクリックしてKatanaを起動したい場合は、次の方法で追加できます。
  • .bat ファイルを右クリックし、ショートカットを作成します。
  • 作成されたショートカットをデスクトップに配置します。
  • ショートカットを右クリック >プロパティ > ショートカットタブ > アイコンの変更…
  • .batファイルにアイコンが含まれていないという警告が表示される場合があります。「OK」をクリックすると、別の場所からアイコンを選択するオプションが表示されます。
  • 「参照…」をクリックし、 Katanaインストールディレクトリ(KATANA_ROOT)を参照します。WindowsIcon.icoファイルを選択し、 「開く」をクリックします。 「OK」をクリックして「アイコンの変更」ダイアログを閉じ、 「OK」をクリックして「プロパティ」ウィンドウを閉じます。

    これで、デスクトップにKatanaアイコンを表示するKatanaランチャー スクリプトのショートカットが表示されるはずです。

サンプルスクリプト

以下のドロップダウンセクションでは、最もよく使用されるレンダリングプラグインごとにサンプルスクリプトを紹介します。これらのスクリプトはすぐに使用でき、各レンダリングプラグインのデフォルトのインストールパスを使用して設定されています。また、この記事の下部にある添付ファイルセクションからサンプルをダウンロードすることもできます。

レンダーマン

以下は、RenderMan for Katanaレンダラープラグインのランチャーバッチスクリプトの例です。RenderMan 固有の環境変数の詳細については、ドキュメントページKatanaの環境変数」を参照してください。

@echo off
rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana7.0v1"

rem -- select which renderer Katana expects by default when rendering --
set "DEFAULT_RENDERER=prman"

rem -- Location of the RenderMan Pro Server installation --
set "RMANTREE=C:\Program Files\Pixar\RenderManProServer-26.3"

rem -- Location of the PRman plugin for KATANA --
set "RFKTREE=C:\Program Files\Pixar\RenderManForKatana-26.3\plugins\katana7.0"

rem -- This is what is required to load the RfK plugin --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%RFKTREE%"

rem -- These are required for the hdPrman Render Delegate
set "FNPXR_PLUGINPATH=%RFKTREE%\usd"
set "RMAN_SHADERPATH=%RMAN_SHADERPATH%;%RFKTREE%\usd\resources\shaders"
set "RMAN_RIXPLUGINPATH=%RMAN_RIXPLUGINPATH%;%RFKTREE%\usd"
rem -- Start Katana -- "%KATANA_ROOT%\bin\katanaBin.exe"

注意:このスクリプトで使用されるさまざまなコンポーネントのパスが異なる場合は、それらのパスをシステム上の正しい場所に更新する必要があります。

アーノルド

以下は、Arnold for Katanaレンダラープラグインのランチャーバッチスクリプトの例です。Arnold 固有の環境変数とインストールに関する詳細は、ドキュメントページ「インストール - Arnold for Katanaを参照してください。

@echo off
rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana7.0v1"

rem -- select which renderer Katana expects by default when rendering --
set "DEFAULT_RENDERER=arnold"

rem -- Where you have installed the KtoA plug-in --
set "KTOA_HOME=C:\Program Files\ktoa\ktoa-4.3.2.1-kat7.0-windows"

rem -- The KtoA bin folder is needed in PATH --
set "PATH=%PATH%;%KTOA_HOME%\bin"

rem -- This is how to load the KtoA plug-in --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%KTOA_HOME%"

rem -- Start Katana --
"%KATANA_ROOT%\bin\katanaBin.exe"

注意:このスクリプトで使用されるさまざまなコンポーネントのパスが異なる場合は、それらのパスをシステム上の正しい場所に更新する必要があります。

3喜び

3DelightはKatanaインストールと設定に使われるレンダラーで、 Katanaインストールフォルダにあるデフォルトの実行ファイルを使ってアクセスできます。3Delightのインストール先を変更した場合、または別のバージョンを使用したい場合は、以下のサンプルランチャーバッチスクリプトで必要な環境変数を確認してください。詳細については、 3Delight for Katana Installation のドキュメントページをご覧ください。

@echo off
rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana7.0v1"

rem -- select which renderer Katana expects by default when rendering --
set "DEFAULT_RENDERER=dl"

rem -- Location of where the main 3Delight package is installed --
set "DELIGHT=C:\Program Files\3Delight"

rem -- The 3Delight bin folder is needed in PATH  --
set "PATH=%PATH%;%DELIGHT%\bin"

rem -- Location of the 3Delight for KATANA plug-in --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%DELIGHT%\3DelightForKatana"

"%KATANA_ROOT%\bin\katanaBin.exe"

注意:このスクリプトで使用されるさまざまなコンポーネントのパスが異なる場合は、それらのパスをシステム上の正しい場所に更新する必要があります。

赤方偏移

以下は、Redshift for Katanaレンダラープラグインのランチャーバッチスクリプトの例です。Redshift 固有の環境変数の詳細については、ドキュメントページKatanaプラグイン設定を参照してください。

@echo off
rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana7.0v1"

rem -- select which renderer Katana expects by default when rendering --
set "DEFAULT_RENDERER=redshift"

rem -- Location of the RedShift bin folder --
set "REDSHIFT_HOME=C:\ProgramData\Redshift\bin"

rem -- Location of the RedShift plugin for KATANA --
set "REDSHIFT4KATANA_HOME=C:\ProgramData\Redshift\Plugins\Katana\7.0v1"

rem -- This is what is required to load the RedshiftForKatana plugin --
set "PATH=%PATH%;%REDSHIFT_HOME%"
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%REDSHIFT4KATANA_HOME%"

"%KATANA_ROOT%\bin\katanaBin.exe"

注意:このスクリプトで使用されるさまざまなコンポーネントのパスが異なる場合は、それらのパスをシステム上の正しい場所に更新する必要があります。

高度なヒントとコツ

複数のレンダラープラグイン

Katana複数のレンダラープラグインを同時に起動できます。各プラグインに必要な環境変数をすべて1つのバッチファイルにまとめると、 Katanaで両方のプラグインにアクセスできるようになります。ただし、 DEFAULT_RENDERER変数には1つのレンダラーしか指定できません。

カスタム環境変数

独自のカスタム環境変数を作成することも可能です。これは、 Katanaの複数のバージョンや特定のレンダラープラグインを素早く切り替えたい場合に非常に便利です。以下は、 OPTIONSヘッダー以下に3つのカスタム変数を作成したRenderManスクリプトの例です。パスの一部がパーセント記号で囲まれた環境変数名に置き換えられていることにご注意ください。これにより、その名前がスクリプトで以前に設定した値に置き換えられます。

@echo off
rem **  OPTIONS  **
set "KAT_VER=7.0v1"
set "REN_VER=26.3"
set "KAT_LINE=7.0"

rem -- Define the install location for KATANA --
set "KATANA_ROOT=C:\Program Files\Katana%KAT_VER%"

set "DEFAULT_RENDERER=prman"

rem -- Location of the RenderMan Pro Server installation --
set "RMANTREE=C:\Program Files\Pixar\RenderManProServer-%REN_VER%"

rem -- Location of the PRman plugin for KATANA --
set "RFKTREE=C:\Program Files\Pixar\RenderManForKatana-%REN_VER%\plugins\katana%KAT_LINE%"

rem -- This is what is required to load the RfK plugin --
set "KATANA_RESOURCES=%KATANA_RESOURCES%;%RFKTREE%"

"%KATANA_ROOT%\bin\katanaBin.exe"

さらに詳しく

Katana起動と利用可能なさまざまな起動モードの詳細については、 Katanaドキュメントの「Windows での起動」セクションを参照してください。

添付ファイル

私たちはそれを聞いて申し訳ございません

理由をお聞かせください