パスに指定したOTLを読み込みます。これにより、OTL内のアセットを適切にMantraで参照することができます。

オブジェクトの定義を開始します。‹object_type›は次のどれかを指定します:

各オブジェクトには、レンダリングの動作に関係するプロパティがあります。

Mantraでジオメトリを指定する方法が2通りあります。

オブジェクトの終わりの宣言。

グローバルまたはオブジェクトプロパティを設定します。各オブジェクトには、このコマンドを使って設定できる別々のプロパティがあります。

単一フレームのレンダリングで出力する画像を定義します。画像平面は、ray_defplaneとray_planepropertyのコマンドを使って定義します。特別な画像名のnull:はフレームをレンダリングしますが、なにも画像に保存されません。これはマップ(ディープシャドウマップ、フォトンマップ、Irradianceキャッシュ)をレンダリングする時にたまに役に立ちます。

このコマンドはHoudini 9.1からray_start planeに置き換わりました。ray_defplaneの引数は今では画像平面の設定に使います:

Hodini9.1以前のバージョンでは、ray_defplaneコマンドは ray_imageで定義した画像用の出力画像平面を定義します。任意の数の平面を設定します。出力フォーマットが複数平面をサポートしていないなら、各平面は個々のファイルに書き出されます(ファイル名にplane_nameを使用)。

任意のグローバルまたはエクスポートしたVEX変数は、vex_variableタイプとして使うことができます。また、特別な2つの変数を使うことができます:

• Cf+Af (vector4) – CfとAfの変数の組み合わで、RGBA画像を出力します。

• Z-Far (float) – Pz変数は単一チャンネルの画像を出力します。

ray_property plane pfilter "sinc 3 3"
ray_property plane gamma 1.7

Houdini9.1以前のバージョンでは、ray_defplaneで定義される画像平面の値を設定します。知られている平面のプロパティは以下を参照してください。

変換行列を指定します。

このステートメントの後に、任意の数のray_mtransformが続きます。各ray_mtransformステートメントでは追加モーションセグメントのトランスフォームを指定します。

インスタンスオブジェクトのジオメトリを指定します。これはインスタンスでレンダリングするジオメトリのことです。geometry_objectパラメータはIFDで既に定義されているはずのジオメトリオブジェクトを参照します。

ray_geometryやray_proceduralのどれか1つのみをインスタンスの定義で指定するべきです。

ジオメトリの生成に使うプロシージャル関数を定義します。-m/-Mオプションはプロシージャルジオメトリの境界ボックスを定義するのに使い、レンダリングを最適化するために使う場合もあります(境界ボックスをレンダリングしないならば、Mantraはまったくプロシージャルジオメトリを生成する必要はありません)。プロシージャルはHDKを使ってユーザが記述することができます。

ユーザ定義プロパティを宣言します。

style引数はプロパティのタイプを定義し、object、global、light、geometry、planeのどれかにします。

typeはfloat、bool、int、vector2、vector3、vector4、matrix3、matrix4、stringのどれかにします。

nameはプロパティの名前です。この名前を使って値を照会することができます。

例:

ray_declare object int my_property 42

my_propertyはrenderstate()VEX関数またはPythonフィルタリングで照会することができます。

このフレームの時間を秒で指定します。これはimage:samplelockがfalseの時、乱数のシードに使います。

レンダリングを実行します。

オブジェクト定義をクリアします。現在では、:

• -l – ライト

• -o – インスタンスオブジェクト

• -f – フォグオブジェクト

のみがクリアされます。フレームをレンダリングした後は、ray_resetは通常は全オプショをコールするべきです。

平面設定で出力デバイスのオプションを設定します。

ray_deviceoption int JPEG.quality 75

このコマンドは、事前定義済のimage output propertiesを使った時の出力結果です。またIFDの中にこのコマンドを使えば、カスタムデバイス上のオプションのように任意のオプションを設定することができます:

ray_deviceoption float MYFORMAT.Option value

コマンドラインからiconvertユーティリティを実行すると、TIFFとJPEGのような組み込みフォーマットデバイスで利用可能なオプションのリストを見ることができます。

画像のガンマ補正を指定します(デフォルトが1)。

量子化する前に各カラーの値がゲインによって乗算されます。

適用されるディザ量。ディザは量子化ステップの割合として指定します(例えば、0.5は量子化ステップの半分になります)。オプションは、浮動小数点出力では無視されます。

量子化中に使われる画像のホワイトポイント。

出力する保存タイプ。値は以下のどれかです:

浮動小数点を非正規化すると、0.4999999や0.5000001のような浮動小数点の最小値を丸めることができます。

サブピクセルサンプルを合成するのに使うサンプリングフィルターを指定します。これは、どのような方法で個々のサーフェスサンプルを合成して単一のサブピクセルサンプルを生成するのか決めます。利用可能なタイプは以下の通り:

• alpha – Ofを使って合成の不透明度を決めます。

• closest – 近接サーフェスから値を取得します。

• min – 任意のサンプルから最小値を取得します。

• max – 任意のサンプルから最大値を取得します。

サブピクセルサンプルを合成して単一ピクセルの値を生成するのに使うピクセルフィルターを指定します。利用可能なピクセルフィルターがいくつかあります。

この出力変数の値は、指定したライトのilluminance Loopの評価中に生成されるはずです。これは、個々のライトで作成した特定の範囲のキャプチャーが可能です(これがサポートできるようにシェーダをセットアップしている場合)。