“category”タグによって包含/除外するライトを指定します。 これによって決まる包含/除外するライトは、lightmaskキーワード引数でパターンマッチングしたライト名よりも優先度が高いです。

例:

diff = diffuse(nml, "lightmask", "hero | fill");

詳細は、ライトカテゴリを参照してください。

lightとshadowのシェーダを評価する時、オブジェクトはライトマスクを事前定義します。 このマスクは、通常ではジオメトリオブジェクトで指定し、surfaceやfogのシェーダを照明するために使用するライトのリストを指定します。 “lightmask”引数を指定することで、デフォルトのライトマスクを上書きすることができます。

例:

diff = diffuse(nml, "lightmask", "light*,^light2");

…これは、名前が“light”で始まる“light2”以外のライトすべてが拡散反射光の照明で考慮されます。

すべてのHoudiniスコープのパターン(グループ展開を除く)がサポートされています:

• * - ワイルドカードに一致。

• ? - 任意の1文字に一致。

• ^ - 一致するものを排除。

• [list] - 文字リストに一致。

光線に当たることができるオブジェクトのリスト。これを指定すると、scopeは、指定したraystyleが選択されるようになっていたデフォルトのスコープを上書きします。 scope:default値は、scope引数が現在のコンテキストのデフォルトのスコープを使用するようにします。つまり、この引数を指定しなかった時の挙動になります。

光線の交差に対してスコープの上書きが可能になります。 特別なスコープ引数のscope:selfは、現在シェーディングされているオブジェクトにマッチします。

現行シェーディングオブジェクトがどれなのかを指定するために使用します。例えば、scope引数を使ったscope:selfは、この引数によって渡されたオブジェクトと同じ意味になります。

オブジェクトを検索する最大距離。これは、オブジェクトの検索を、その近くにあるオブジェクトだけに制限するために使います。指定したmaxdistがマイナスなら、最大距離が指定されていないと見なされます。

交差をテストする時に光線が移動できる最大距離を上書きすることができます。 いくつかの関数(例えばfastshadow)には、(光線の長さによって)暗黙的に最大距離が定義されているものがあり、おそらくこのオプションを使用することができません。 しかし、反射、グローバルイルミネーション、屈折などの計算をする時には、このオプションを効果的に使用することができます。

分散アンチエイリアスで使用するVEXエクスポート変数の名前。レンダラーは、マイクロポリゴンレンダリングでこの値と隣接するマイクロポリゴンを比較し、さらにサンプルを必要とするシェーディングポイントを判断します(閾値としてvm_variance propertyを使用)。もっとサンプルが必要なら、アルゴリズムは指定した最大光線サンプル数までサンプルを引き上げます。

この変数は、ヒットサーフェスからインポートされなければならないので、この変数はインポートする名前のリストになければなりません(以下の“光線から情報をインポートする”を参照)。名前を付けた変数がインポートされなければ、このオプションは無視されます。

分散アンチエイリアスは、高い分散値を持つ画像の領域内(例えば、シャープなシャドウエッジ)により多くのサンプルを配置します。これはvm_dorayvarianceが有効な時だけに使われます。そうでない場合は、最小光線サンプル(または明示的に指定したsamplesの値)のみがgatherループのアンチエイリアスで使われます。

グローバルのVarianceコントロール(Mantraの-vオプション)を上書きします。 このコントロールは、レイトレーシングのアンチエイリアス品質の決定に使用されます。 詳細は、Mantraのドキュメントを参照してください。

分布角度(ラジアンで指定)。gather()に関しては、光線はこのアングル内で分布します。trace()に関しては、この角度は、交差距離が長くなるにつれてフィルタ幅が広がる速さを示すために使用されます。 角度が大きいほど、より遠くにあるヒットサーフェスほど、より大きい微分を使用するので、テクスチャリングとディスプレイスメントのパフォーマンスが良くなります。

効果を出すには、samplesパラメータも指定してください。

フィルタ光線に送信されるサンプル数。イラディアンスとオクルージョンの関数に関しては、samplesパラメータを指定することで、デフォルトのイラディアンスサンプリングが上書きされます。

シーンに送信された光線がどこにも当たらなかった場合に評価される環境マップを指定することができます。

光線の方向を使用すると、指定した環境マップが評価されて、その結果のカラーが返されます。 ほとんどの場合、環境マップを評価するには、トランスフォーム空間を指定する必要があります。

refractlightとtraceの場合では、指定した背景カラーに関係なくOfとAfの変数に0が設定されます。

環境マップを指定する時、texture()のフィルタオプションにも対応しています。

環境/反射マップを作成する方法を参照してください。

環境マップが使用されている場合、光線をシーン内の他のオブジェクト、ライトオブジェクト、フォグオブジェクトの空間に変換することで、その環境マップの向きを指定することができます。 Houdiniでは、Nullオブジェクトを使用して、その向きを指定することができます。例:

Cf = R*reflectlight(bias, max(R), "environment", "map.rat", "envobject", "null_object_name");

環境マップが使用されている場合、光線をシーン内のライトの空間に変換することで、その環境マップの向きを指定することができます。

環境マップが使用されている場合、このカラーを使って環境マップに色味を付けます。

光線がどのオブジェクトにも当たらなかった場合、これをシーンの背景カラーとして使用します。 refractlightとtraceの場合では、指定した背景カラーに関係なくOfとAfの変数に0が設定されます。

関数: irradiance, occlusion

イラディアンスの計算をするための分布。デフォルトでは、コサイン分布(ディフューズ照明)を使用します。 スタイルに指定可能な値は、均一なサンプリングをするnonweighted、コサインウェイトのサンプリングをするcosineです。

光線のソースのフィルター幅を指定します。angleも指定すれば、フィルターは光線に沿って距離が長くなるほど大きくなります。 デフォルトでは、フィルター幅は現在のシェーディングコンテキストから初期化されるので、通常では直接widthを指定する必要はありません。 マイナスの値は無視され、フィルター幅も現在のシェーディングコンテキストから初期化されます。

サンプリング分布を決めます。

gatherの場合:

• cosine – 光線がcosine(diffuse)関数によって半球上に分布します。

• uniform – 光線が均一に半球上に分布します。

sample_geometryの場合:

• area – サンプルがプリミティブの面積によって分布します。

• parametric – サンプルがプリミティブのID、サブディビジョンのID、パラメトリックサーフェス座標(s,t)によって分布します。

• solidangle – サンプルがプリミティブの面積とプリミティブの立体角によって分布します。

Bias Along Normal が有効な時にバイアス方向を上書きします。 biasdirを指定しなかった時は、ジオメトリの法線Ngが使われます。 Bias Along Normal が無効な時は、このオプションは何の効果もありません。

コールされたシェーダに渡すサンプルのID。 コールしているシェーダがサンプルの生成にSIDを使っていれば、指定したオフセットでサンプリングを始めることができるように、変更されたサンプルIDをコールされたシェーダに渡すことができるので役に立ちます。 この値はヒットサーフェスのSIDグループを初期化するために使われます。

Mantraに最終的なシェーディングに対するこの光線の相対的な寄与度を示すためのヒント。 この値は光線の送信を制限するためのray clip閾値で使われます(ray bounceと同様)。

送信している光線のタイプ。 Mantraはraystyleを使って、光線を終了させるためのデフォルトのレイトレーシングマスクとバウンス制限の両方を決めます。

• reflect – 反射光線を送信します。Mantraは反射マスクと反射制限を使ってレイトレーシングを終了します。

• refract – (デフォルト)屈折光線を送信します。Mantraは屈折マスクと屈折制限を使ってレイトレーシングを終了します。

• diffuse – ディフューズ光線を送信します。Mantraはディフューズ光線に対してディフューズ制限を使います。

• shadow – シャドウ光線を送信します。Mantraはレイトレーシングレベルを変更せず、shadow/lightシェーダ内にshadowmaskがあれば、それに対してトレースします。

• primary – プリマリ光線を送信します。この形式は、直接可視オブジェクトにだけ適用するレンダー設定の動作に影響を与えずに、シェーダがプライマリ光線の方向を変更する必要がある時(例えば、matteとphantom)に使うことができます。Mantraはプライマリ光線を送信する時のレイトレーシングレベルを上げます。

• nolimit – 反射光線をレイトレーシングバウンスの数に制限なく送信します。Mantraはnolimit光線を送信する時にレイトレーシングレベルを上げます。

光線が当たるオブジェクトを選択するために使用するカテゴリのエクスプレッション。 オブジェクトを指定すると、これは既存の Reflection Selection (reflectcategories)と Refraction Selection (refractcategories)パラメータを上書きします。

例えば、^hiddenは、hiddenカテゴリを持たないオブジェクトすべてに光線が当たります。shiny|happyは、shinyまたはhappyのどちらかのカテゴリを持つオブジェクトすべてに光線が当たります。

光線が当たるオブジェクトは、scopeとcategoriesパラメータに共通するオブジェクトが選択されます。

通常では、光線はシェーディングされるマイクロポリゴンのサーフェス上に分布します。 この引数は、領域を制御するために使われます。0の値は、強制的にすべての光線が同じポイントから送信されます。1の値は、全体のマイクロポリゴンを網羅します(Gatherのみ)。

配列出力を持つ確率的透明度に対して取得する透明サンプルの数。通常では、配列変数内のエクスポートを要求しない限りは、この値には1を設定します。要求した場合、レイトレーサーは、光線に沿って各サンプルに対して配列にエントリーを挿入します。

光線の原点(else文節でも定義します)。

光線の方向(else文節でも定義します)。

光線が最初に当たったサーフェスまでの距離。

レイトレーシングスコープ内のジオメトリすべての合計のサーフェス面積。

レイトレーシングスコープ内のジオメトリすべてに対して評価された立体角。 光線の原点に近い、またはその原点を囲んだ大きいオブジェクトに対しては、非常に悪い評価になります。 個々のプリミティブに対しては、評価は非常に良くなります。

samplefilterキーワードが引数のリスト内にあると、以下の すべての インポート変数が指定したフィルタリングモードを使います。 単一のgatherステートメント内に複数のsamplefilter引数を指定すれば、別々の変数を別々の方法でフィルタリングすることができます。

samplefilterで可能な現行タイプ

変数を指定する時、変数の間にpipelineキーワードオプションを挟むことで、読み/書き変数に値を満たすパイプラインの場所を制御することができます。 その値は、surface、atmosphere、displacementのどれかを指定することができます。pipelineオプションは何回も指定することができます。 このオプションを使用する度に、そのオプションの後に指定した変数(次のpipelineまでの変数)が影響を受けます。

gather(p, d, "pipeline", "surface", "Cf", surfCf,
             "pipeline", "atmosphere" "Cf", fogCf, "P", hitP)