読み込まれたプログラムを使って実行するOpenCLカーネルの名前。

外部ディスクファイルではなく、Kernel Codeパラメータに用意されているコードを使用します。これは、より迅速に編集して、OpenCLマイクロソルバを作成することができます。

コンパイルするOpenCLプログラムファイルのパス。これは、ディスクファイルまたはアセットのパスを含めることができます。

Code Snippetモードでは、カーネルの生成とそのカーネルのジオメトリ操作を簡単にできるようにした@接頭辞マクロの利用が有効になります。

カーネルで必要なコンパイルフラグを指定します。 よくある使い方は、-Dフラグを使ってプリプロセッサ用の#defineディレクティブを定義することです。

カーネルのコンパイルフラグとして追加される文字列Detailアトリビュートを指定します。 これは、入力ジオメトリ内からこの名前のDetailアトリビュートを取得します。 そのDetailアトリビュートが文字列だった場合、その文字列がカーネルオプションとして注入されます。 例えばdefineを指定する場合は、この文字列に-Dオプションを入れてください。

ディスクからカーネルを読み込む時に、そのカーネルを、ソルブ毎に再生成されないようにキャッシュ化します。 これをオンにすると、強制的にカーネルの再読み込みと再コンパイルをします。 これは、#includeファイルが、変更されたコードを参照する時や、カーネルファイルを外部テキストエディタで変更した場合に役立ちます。

プロトタイプが完了している時は、これを常に無効にするべきです。

指定したOpenCLカーネルを一度だけ呼び出します。とはいえ、グローバルidの数は、この設定で制御されます。 最初のWriteableアトリビュートは、書き込み可にマークされた最初のバインドされたアトリビュートのサイズに設定されます。 すべてのフィールドは、フィールドの合計のボクセル数に設定されます。

Worksetsメソッドは、指定したDetailアトリビュートを使って、begin値とlength値のリストを指定します。 カーネルは、ゼロ以外のlength毎に一回呼び出されます。 グローバルidは、呼び出し毎に0からlength-1まで変化し、begin値を使用することで、バインドされたアトリビュート内のオフセットを調べることができます。

指定したフィールドの整列を強制的に出力グリッドに合わせます。このオプションを選択することで、各グリッドの値が出力グリッドの整列に合うように補間され、 フィールド整列とは無関係にカーネルを実行することができます。

入力/出力のグリッドの原点を含めます。

入力/出力のグリッドのサイズを含みます。

ボクセルのサイズを含めます。

アトリビュートに書き込んだ後は、他のソルバがジオメトリアトリビュートを要求するまで、その新しい値はGPU上に残ります。 アトリビュートをそこに残すことで効率性を上げることができます。 Flush Attributesを有効にすると、それらのアトリビュートを強制的にGPUからジオメトリメモリに明示的にコピーします。 これが必要となることはないでしょう。

Finish Kernelsが無効な時、OpenCLカーネルが次のソルバを続ける前に完了を待とうとしません。 これは、ソルバの結果が実際に必要になるまでOpenCLカーネルをバックグラウンドで走らせることができます。 単にデバッグするだけなら、エラーを正しい箇所で検出できるように、カーネルを必ず終了するようにするのに役立ちます。

バインドされたアトリビュートが存在しない、且つ、任意としてマークしていない場合、計算は行なわれません。 通常では、これは予期しない時に警告を生成します。 しかし、静かに何もしない事が正しいアクションであるなら、このフラグを無効にすることで誤った警告を回避することができます。

バインドされたジオメトリのポイント数が異なる場合、エラーを引き起こして、カーネルを実行しません。 これによって、カーネルコードは、バインドされたすべてのジオメトリのポイント数が同じであることを前提にすることができるので、範囲外のチェックが回避されます。

バインドされたジオメトリのプリミティブ数が異なる場合、エラーを引き起こして、カーネルを実行しません。 これによって、カーネルコードは、バインドされたすべてのジオメトリのプリミティブ数が同じであることを前提にすることができるので、範囲外のチェックが回避されます。

現行シミュレーション時間をパラメータとして含めます。

現行シミュレーションフレームをパラメータとして含めます。

現行タイムステップをパラメータとして含めます。これは、OpenCLノードをGas Substepからトリガーした時にフルタイムステップ未満に指定できるので役立ちます。

いくつかの処理では、タイムステップの累乗を知りたいことがあります。 カーネル内で再計算するのではなく、e^Timestepに設定して、指数を事前計算させることができます。

<xnoise.h>のSimplexノイズ関数に渡すことができるOpaque Pointerを含めます。これによって、OpenCLカーネルからSimplexノイズとCurlノイズを生成できるようになります。

このノードの精度を制御します。 fprealタイプとexintタイプは、ここで指定した精度に合うように、生成されるコード内で定義されます。 ベクトルバリアント(例えば、fpreal3、fpreal4など)も定義されます。 さらにFPREAL_PRECシンボルは、halfには16、floatには32、doubleには64として定義されます。

Autoは、1番目の書き込み可能ジオメトリの優先精度を使用します。 これは、Attribute Cast SOPで設定することができます。 Run Over Fieldモードでは、現在のところ、優先精度は常に32ビットです。

worksetDetailアトリビュートを検索するDOP Geometryデータ。

各worksetのstart値を格納する整数配列Detailアトリビュート。

各worksetのlength値を格納する整数配列Detailアトリビュート。 lengthがゼロのworksetは呼び出されません。

Detailアトリビュートで指定されたworksetのlengthとbeginの値が、バインドしたアトリビュートに対して正しいオフセットであるかどうかを確認するのは、あなたの役目であることに注意してください。 これらの値があなたの制御下から発生したものでない場合、デリファレンス(参照が指している値を取得)する前にそれらの値が正しいのか確認してください。

GPU上でworksetを実行する時、別々のworkset毎にカーネルを実行するよりも、1回のカーネルコール内でGPU上でたくさんの小さいworksetを実行して、各worksetの後にそのカーネル内で同期をさせた方が高速です。 このオプションを有効にすると、一番大きいworksetがOpenCL GPUデバイス上の1ワークグループ内に収まれば、SINGLE_WORKGROUPプリプロセッサフラグが定義され、 Worksets Begin と Worksets Length の配列全体がカーネルに渡されます。 各worksetの後での同期はカーネルに依存し、通常ではbarrier(CLK_MEM_GLOBAL_FENCE)を使用します。 Generate Kernel ボタンで生成されるコードには、この同期を制御する方法が表示されます。

これ用のメソッドが3つ用意されています。 1つ目のメソッドは、すべてのworksetがワークグループ内に収まれば単一パスのみを呼び出します。 2つ目のメソッドは、有効な範囲内に収まっているworksetをまとめて交互にコールします。 このメソッドは、カーネル内にSINGLE_WORKGROUP_SPANS定義を設定し、さらに、その関数を処理する開始ワークオフセットも用意されます。 3つ目のメソッドは、常に単一ワークグループの手法を用いて、カーネル内にSINGLE_WORKGROUP_ALWAYS定義を設定します。 つまり、get_global_id(0)はどれかのワークグループサイズよりも小さくなるので、カーネル側でそのような場合の制御を行なう必要があります。

通常では Span Method が最も効率性が良いです。

OpenCLカーネル内の追加パラメータの数。

各パラメータを、固定の定数値にしたり、DOPネットワークを通して評価したり、フィールドまたはジオメトリアトリビュートから読み/書きすることができます。

パラメータの名前。これは、Generate Kernelボタンで使用されますが、 そこで使用しない場合は、コメントとしてのみ存在します。実際のOpenCLカーネルへのバインドは、名前ではなくパラメータ順で行なわれます。

作成してバインドするパラメータのタイプ。

フィールドとしてバインドするDOPデータの名前。

フィールド用にあります。

ジオメトリとしてバインドするDOPデータの名前。

アトリビュート用にあります。

バインドするアトリビュート。オプションのフラグが設定されていない限りは、アトリビュートが見つからなかった時にエラーになります。

アトリビュート用にあります。

アトリビュートのタイプ。最初の書き込み可のアトリビュートが反復順を決定することができるので、これは、OpenCLソルバで処理されるグローバルidの数を決定することができます。

バインドされたアトリビュートすべてが、同じタイプまたは同じジオメトリデータからのものである必要はありません。

アトリビュート用にあります。

バインドするアトリビュートの種類。floatとintegerのアトリビュートが、すべてのエレメント値を順番に含んだ単一の配列としてバインドされます。 タプルは交互に配置されます。つまり、Pはxyzxyzxyzとしてバインドされます。

配列アトリビュートは2つの配列としてバインドされます。その1つの配列には、各エレメントの配列データのオフセットを含んでいます。そのため、オフセットのペアの差分が、そのエレメント配列長さになります。 2つ目の配列は、単一配列に連結されたすべてのエレメントの配列のデータです。

アトリビュート用にあります。

バインドするアトリビュートのタプルサイズ。ゼロより大きい場合、そのアトリビュートは、このタプルサイズにしなければなりません。ゼロなら、自動的にバインドし、追加パラメータが生成されて、そのタプルサイズを保存します。

アトリビュート用にあります。

バインドするボリュームまたはVDBのプリミティブの名前または番号。

ボリュームの解像度をパラメータとして追加します。

ボリュームのサイズをSOP空間でパラメータとして追加します。

ボリュームのボクセル座標からSOP座標に変換する行列トランスフォームを追加します。

SOP座標からボリュームのボクセル座標に変換する行列トランスフォームを追加します。

オプション値がカーネル引数として送信されるシミュレーションデータの名前。

読み込むシミュレーションデータのオプション値の名前。

オプション値のバインドタイプ。これは、OpenCLカーネル内の引数のタイプを制御します。

バインドした引数のタプルサイズ。 これは、最低でもオプション値のタプルサイズでなければなりません。

このパラメータのデータと紐付ける精度を制御します。 Nodeオプションは、このノードの精度を使用するので、その設定に応じて変わり、それに相当するカーネルコードは、 fprealまたはexintの定義を使用します。

これは、ビデオカード上に格納されるデータの精度なので、低い精度を使用することでGPUメモリを節約することができます。 しかし、halfに相当する16ビットは、たいていの場合では計算に使用することができません。 vload_halfを使用することで、それを計算用にfloatにプロモートさせることができます。

同じアトリビュートが異なる精度にバインドされると、そのバインドが失敗します。

現在のところ、ボリュームは32ビットデータ精度にのみバインドすることができます。

OpenCLカーネルが、このアトリビュートから読み込むかどうか決めます。設定しなかった場合は、それらのアトリビュート値がGPUにコピーされません。 これは、書き込み専用のアトリビュートが不要なコピーをしないようにするのに役立ちますが、初期化されていないデータが存在するのに注意が必要です。

アトリビュート用にあります。

OpenCLカーネルが、このアトリビュートやフィールドに書き込むかどうか決めます。今度必要になる時にGPUからコピーされるように、GPUバージョンのアトリビュートやフィールドを、最新ではないとマークします。

フィールドとアトリビュート用にあります。

アトリビュートを不要としてマークします。そのアトリビュートがジオメトリ内に存在しなかった場合、エラーが起こるのではなく、#defineをカーネルオプションに設定して、そのアトリビュートを無効にします。 これはパラメータシグネチャも変更するので、構文を確認するには、 Generate Code ボタンを使用してください。

アトリビュート用、ボリューム用、VDB用、オプション用にあります。

オプションのアトリビュートやボリュームが見つからない場合でも、パラメータ値をカーネルにバインドするべきであることをマークします。 #defineがカーネルオプションで設定され、そのアトリビュートが無効になり、単一値に切り替わります。

バインドされたパラメータの値は、このパラメータの整数値または浮動小数点値から取得されます。

ランプを評価する浮動小数点値の数。

Enable @-Binding が有効になっている場合、実際のコンパイラーに送信されるコードには、完全に展開されたコードが生成されます。 これによって、コンパイラが#lineディレクティブを評価しなくてもエラーの行番号を解決することができ、さらに、@マクロの挙動を理解するのにも役立ちます。

Enable @-Binding が無効になっている場合、必須のカーネル関数のプロトタイプを作成して、現在選択されているパラメータすべてが考慮されます。 これは、関数を書き始める時のスタートポイントとして使用したり、新しいパラメータを追加/削除した時にインターフェースを更新することができます。

すべての@バインドが展開されたコードスニペット。