このコマンドは、KarmaでレンダリングされたEXRファイルを指定することで、そのEXRファイルに保存されているレンダリング統計情報を表示したHTMLレポートを生成することができます。

レンダリング統計情報を確認する方法の詳細は、レンダリング統計情報を参照してください。

このコマンドには、出力を生成するモードが2つあります:

--single(デフォルト)は、スタイルシート、スクリプト、すべてのサムネイル画像がインラインで含まれた単一の自己完結型HTMLファイルを生成します。 どこでも見れるように単一ファイルを作成するのでこのモードの方が便利ですが、各レポートに独自のリソースのコピーが追加され、画像がBase64でエンコードされるので容量が若干増えます。

--multiは、HTMLファイルとサムネイル画像のディレクトリを生成し、スタイルシートとスクリプトを別ファイルとしてコピーします。これは、レポートをたくさん生成し、すべて同じ共有リソースを参照するようにしたい場合に役立ちます。 --multiを使用する場合、さらに--prefixオプションを使用することで、レポートがセントラルの場所からリソースを参照するようにすることができます。

• Karma XPUで生成された画像は、Karma CPUと比べていくつかの統計情報が欠落しています。

• このコマンドにAOV名を渡す場合、番号を使用することでAOVインデックスを指定することができます。例えば、1番目のAOVを指定する場合は0を使用します。

• --titleと--subtitleのオプションを使用することで、レポートのタイトルとサブタイトルをカスタマイズすることができます。これは、サイト特有の情報を表示するのに役立ちます。

• このコマンドがHTMLの生成に使用するテンプレートは、Karmaで保存されたレンダリング統計情報に特化していて、(--titleと--subtitleのオプション以外は)カスタマイズできるようになっていません。将来のバージョンでは、おそらくテンプレートをモジュール化して、修正と再利用がしやすくなる予定です。

renderstatsreport [options] infile.exr [ outfile.html ]

• 出力ファイルを指定しなかった場合、このコマンドは、入力ファイルと同じ名前で同じディレクトリ内にHTMLファイルを作成します。

• 2番目の引数が既存ディレクトリの場合、このコマンドは、そのディレクトリ内に入力ファイルと同じ名前のHTMLファイルを作成します。

• --multiモードでは、このコマンドはサムネイル画像のディレクトリを作成します。

renderstatsreport example.exr ~/reports/example_report.html