Q100391: Katana のレンダリング問題のトラブルシューティング

まとめ

Katanaで初めてレンダリングを始めようとすると、レンダリングが期待どおりの結果にならない一般的な問題に遭遇することがあります。この記事では、以下のような問題の診断と解決方法について説明します。

  • レンダリング開始直後に失敗する

  • レンダリングされた画像は完全に黒です

  • Katanaコマンドラインモードではレンダリングが開始されません

  • UI セッションでレンダリングするときには表示されないエラーが、コマンドライン モードでレンダリングするときに表示されます。

詳細情報

レンダリング開始直後に失敗する

レンダリング開始直後に失敗する場合は、シーン内にカメラが存在しないか、レンダラーのライセンスが見つからないことが原因である可能性があります(これは特にRenderMan使用時に発生する可能性があります)。トラブルシューティングを行うには、 Katana「レンダリングログ」タブでレンダリングログを調べ、エラーメッセージがないか確認してください。エラーメッセージがある場合は、適切な手順で問題を解決してください。たとえば、シーン内にカメラを作成するか、レンダラーベンダーのドキュメントを参照してレンダラープラグインのライセンスを取得してください。

以下は、カメラが見つからない場合のレンダリング ログ出力の例です。

キャプチャ.PNG

以下は、RenderMan ライセンスが見つからない場合のレンダリング ログ出力の例です。

無題.png

レンダリングされた画像は完全に黒です

レンダリングは完了したのに、最終画像に黒いピクセルしか表示されない場合は、まず画像のアルファチャンネルをチェックして、オブジェクトが実際にレンダリングされているのにカラーチャンネルに表示されていないかどうかを確認することをお勧めします。これを行うには、 「モニター」タブにマウスを移動してAを押します。

キャプチャ.PNG

上の画像のようにオブジェクトがアルファ チャネルに表示される場合、カラー チャネルに表示されない理由はいくつか考えられます。

  • レンダリングされたオブジェクトにはマテリアルが割り当てられていません。レンダラーによっては、この場合にレンダリングされる標準マテリアルを割り当てますが、レンダリングされたオブジェクトの表面特性を定義できるマテリアルがないため、黒い画像としてレンダリングされるレンダラーもあります。

    これを解決するには、 Network Material Createノードを使用してマテリアルを作成し、 MaterialAssignノードを使用してレンダリングするオブジェクトに割り当てます。ネットワークマテリアルの詳細については、ユーザーガイド「NetworkMaterialCreateを使用したビルディングマテリアル」を参照してください。

  • シーンにはライトがありません。オブジェクトにマテリアルが割り当てられている場合、使用するレンダラーによっては、オブジェクトに作用するライトがないため、最終画像にピクセルデータが表示されないことがあります。

    これを修正するには、 GafferThreeノードを使用してライトを作成し、そのライトがオブジェクトを照らすように向いていることを確認してください。ライトの作成方法の詳細については、ユーザーガイド「GafferThreeノードを使用したライトの作成」をご覧ください。

  • シーン内の照明が暗すぎます。シーン内に照明がある場合でも、照明の強度が低すぎてオブジェクトを実際に照らすことができないと、レンダリングされた画像が黒のままになることがあります。

    シーンがこのような状態である場合は、レンダリングするオブジェクトにライトが向いていることを再確認し、ライトの強度または露出を上げてシーンを明るくしてみてください。

オブジェクトがアルファ チャネルに表示されない場合は、使用しているレンダラーがレンダラー ベンダーのドキュメントに従って正しく設定されているかどうかを確認してください。

Katanaバッチまたはスクリプトモードではレンダリングが開始されません

たとえば次のようなコマンドを使用して、 Katanaコマンドライン インターフェイス(バッチ、スクリプト、またはシェル モード) でレンダリングを開始することもできます。

katana --batch --katana-file=/tmp/clean.katana --render-node=Render -t 1

この場合、次のようなエラーが発生し、レンダリングの開始に失敗することがあります。

[INFO MAIN]: Crash handling is disabled.
[INFO LicenseCheck]: Render License failed.
[INFO LicenseCheck]: FOUNDRY LICENSE ERROR REPORT
----------------------------
Timestamp: Tue Jan 17 11:52:36 2023
License(s) Requested:
katana 2022.0818 render only with options all
Extended Info: None Provided
Host : <hostname>
System ID(s) : <systemID>
RLM Environment Info: <RLMEnvironmentInfo>


Reason for failure: A suitable license does not exist.

RLM LICENSE DIAGNOSTICS
---------------------------
katana _r : No license for product (-1)
License Path: <pathToLicense>

[ERROR MAIN]: No 'Render' license available.

これは、 Katanaのコマンドラインモードでは、対話型セッションとは異なる種類のライセンスが必要となるためです。詳細については、 Katanaユーザーガイドのこちらの記事をご覧ください: 起動モードにおけるKatanaライセンス要件

コマンドライン モードでレンダリングする必要があり、現在Katanaレンダリング ライセンスをお持ちでない場合は、 sales@foundry.com の営業チームに連絡して、購入オプションについてご相談ください。

UI セッションでレンダリングするときには表示されないエラーが、コマンドライン モードでレンダリングするときに表示されます。

Katanaの有効なレンダリングライセンスをお持ちの場合でも、UIモードでは問題なくレンダリングされるシーンが、コマンドラインモードではレンダリングに失敗するという問題が発生する可能性があります。次のようなエラーメッセージが表示される場合があります。

[ERROR python.Nodes3DAPI.Node3D]: Error in incoming connection of node 'ground_mat1': Node "mat1" is not compatible with shading nodes.

または

[ERROR python.root]: An AttributeError occurred in "RenderNodeUtil.py": Renderer 'prman' not supported.
    Traceback (most recent call last):
      File "python/Main\Main.py", line 367, in 
      File "python/Main\Main.py", line 313, in __main
      File "bin\python\Main\MainBatch.py", line 96, in Main
      File "bin\python\Main\MainBatch.py", line 450, in __setupOutputs
      File "bin\python\Main\MainBatch.py", line 666, in PrepareOrDisconnectDependencies
      File "bin\python\Main\MainBatch.py", line 618, in __prepareOrDisconnectDependencies
      File "bin\python\Nodes3DAPI\RenderNodeUtil.py", line 142, in SyncOutputPorts
      File "bin\python\Nodes3DAPI\RenderNodeUtil.py", line 1225, in GetRenderNodeInfo
      File "bin\python\Nodes3DAPI\RenderNodeUtil.py", line 1254, in __init__
      File "bin\python\Nodes3DAPI\RenderNodeUtil.py", line 1262, in __get_producer_data
    AttributeError: Renderer 'prman' not supported.

この問題が発生した場合は、コマンドライン環境が、インタラクティブセッションを起動している環境と同じように設定されていることを確認してください。これには、 Katanaレンダラープラグインとシェーダーなどの関連コンポーネントをロードするために必要なすべての環境変数が設定されていることも含まれています。

Katana起動と環境変数の設定の詳細については、次の記事を参照してください。

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

 

さらに詳しく

ナレッジ ベースにあるKatanaレンダリングに関連する次のコンテンツも興味深いかもしれません。

Q100091: Katanaで複数のフレームをレンダリングする方法
Q100356: インタラクティブレンダリングフィルタを使用してプレビューの効率を高める方法
Q100341: Katanaでタイルレンダリングを設定してレンダリングコストを複数のジョブに分散する方法
Q100370: RenderOutputDefineノードを使用してカスタムレンダリングパスを作成し、レンダリングからより多くのデータを取得する方法

さらなる支援

この記事に記載されている手順で問題が発生した場合、またはここに記載されていない問題についてサポートが必要な場合は、サポート チケットを開いて、発生している問題とこれまでに行ったトラブルシューティング手順をお知らせください。

サポート チケットを開く方法の詳細については、 「Q100064: サポート チケットの発行方法」の記事を参照してください。

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

    理由をお聞かせください