説明

mat2 transpose2(const mat2 a)

転置されたaを返します。

mat3 transpose3(const mat3 a)

転置されたaを返します。

mat2 mat2mul(const mat2 a, const mat2 b)

a * bを返します。

fpreal2 mat2vecmul(const mat2 a, const fpreal2 b)

b * Aを返します。

fpreal squaredNorm2(const mat2 a)

2×2マトリックスのL2ノルムの2乗を返します。

fpreal squaredNorm3(const mat3 a)

3×3マトリックスのL2ノルムの2乗を返します。

void mat3add(const mat3 a, const mat3 b, mat3 c)

c = a + b

void mat3sub(const mat3 a, const mat3 b, mat3 c)

c = a - b

mat3zero(mat3 a)

a = 0

mat3identity(mat3 a)

a = identity

mat3copy(const mat3 a, mat3 b)

b = a

mat3load(size_t idx, const global float *a, mat3 m)

a[idx*9]で始まる9個のfloatをmに読み込んで格納します。行優先(row-major)で読み込みます。

mat3store(mat3 in, size_t idx, const global float *data)

9個のfloatを行優先で、順にdata[idx*9]に格納します。

void mat3fromcols(const fpreal3 c0, const fpreal3 c1, const fpreal3 c2, mat3 m)

指定したベクトルの列で3×3マトリックスを作成します。

mat3 mat3mul(const mat3 a, const mat3 b)

a * bを返します。

fpreal3 mat3vecmul(const mat3 a, const fpreal3 b)

b * Aを返します。

fpreal3 mat3Tvecmul(const mat3 a, const fpreal3 b)

b * A^Tを返します。

fpreal2 mat3vecmul(const mat3 a, const fpreal3 b)

b * Aを返します。3番目のコンポーネントは破棄されます。

fpreal2 mat3Tvecmul(const mat3 a, const fpreal3 b)

b * A^Tを返します。3番目のコンポーネントは破棄されます。

void outerprod3(const fpreal3 a, const fpreal3 b, mat3 c)

cをaとbの外積に設定します。

void mat3lcombine(const fpreal s, const mat3 a, const fpreal t, const mat3 b, mat3 c)

c = s * a + t * b

fpreal det3(const mat3 a)

aの行列式を返します。

fpreal3 diag3(const mat3 a)

aの対角ベクトルを返します。

fpreal2 mat4vec2mul(const mat4 a, const fpreal2 b)

b * Aを返します。

fpreal3 mat43vec3mul(const mat4 a, const fpreal3 b)

b * Aを返します(bの4番目のコンポーネントは0であると仮定)。

fpreal3 mat4vec3mul(const mat4 a, const fpreal3 b)

b * Aを返します(bの4番目のコンポーネントは1であると仮定)。

fpreal4 mat4vecmul(const mat4 a, const fpreal4 b)

b * Aを返します。

int mat4invert(fpreal16 *m)

mをその逆行列で更新します。成功した場合は0、特異行列なら1を返します。

fpreal mat2det(const mat2 m)

mの行列式。

fpreal mat2inv(const mat2 m, mat2 *minvvout)

minvoutをmの逆行列に設定します。行列式を返します。

fpreal mat3inv(const mat3 m, mat3 minvout)

minvoutをmの逆行列に設定します。行列式を返します。

void mat3scale(mat3 mout, const mat3 m, fpreal scale)

mout = m * scale

void mat3lincomb2(mat3 mout, const mat3 m1, fpreal scale1, const mat3 m2, fpreal scale2)

mout = m1 * scale1 + m2 * scale2

暗黙的に設定されるフラグ

&

write

?

opt

!

noread

タイプ

parm

整数、浮動小数点、浮動小数点ベクトルスタイルのバインドとマッチします。 float、float3、intなどのフラグで型を指定します。 スニペットを制御するために使用され、すべてのワークアイテムで一定のパラメータを使用します。

point/prim/primitive/global/detail/vertex

このクラスのジオメトリアトリビュートをバインドします。

ramp

ランプをバインドします。スカラーランプまたはベクトルランプの場合、floatまたはfloat3のフラグで制御します。

volume

ジオメトリ内のボリュームプリミティブをバインドします。

vdb

ジオメトリ内のVDBプリミティブをバインドします。

option

DOP内のDOP Optionをバインドします。

sfield/vfield/mfield/scalarfield/vectorfield/matrixfield

指定されたタイプのDOPフィールドにバインドします。

意味

read / noread

デフォルトはreadです。

バインドが読み込み可能な場合、そのOpenCLバッファは元の値から初期化されます。 バインドを読み込み可能としてマークしなかった場合には、値を上書きすることが重要になります。 上書きしなかった場合、任意のデータが存在することになります。

write / nowrite

デフォルトはnowriteです。

書き込み可能としてマークされていないバインドは、変更なしとみなされるため、CPUには書き出されません。 無理に行おうとすれば、書き出すことも可能ですが、未定義の挙動が発生します。

opt / noopt

デフォルトはnooptです。

オプションのバインドは、元のジオメトリに存在する必要はありません。 バインドが存在する場合はマクロdefine HAS_nameが定義され、異なるコードパスを持つことができます。 または、defフラグが存在する場合、欠けているバインドが単一のデフォルト値に置き換えられます。

def / nodef

デフォルトはdefです。

オプションのバインドが存在しない場合、代わりに同じ場所でパラメータがバインドされます。 例えば、オプションでPointアトリビュートmassをバインドする場合にmassがなければ、floatパラメータmassがその場でバインドされます。 これにより、コードを変更したり、HAS_mass #ifdefsを使用することなく、コードで@massを使用して値を参照したり、デフォルト値とジオメトリ値を切り替えることができます。

意味

val=#

デフォルトは0です。

パラメータ、ボリューム、VDBにデフォルト値を設定します。 ベクトルバインドで単一スカラーが指定されている場合、それが繰り返されるため、ベクトル上val=1はデフォルト値の(1, 1, 1)を使用します。 ベクトル値は中括弧を使用して指定できるため、val={1, 2, 3}は対応するデフォルト値を使用します。

name=SSS

デフォルトはバインド名です。

バインド先のアトリビュート、ボリューム、VDBの名前。

input=#

デフォルトは0です。

SOPでは、バインド先の入力です。1番目の入力のみ書き出すことができます。

geo=SSS

デフォルトはジオメトリです。

DOPでは、現在のシミュレーションオブジェクトのルートを基準とした、バインド先のシミュレーションジオメトリです。

意味

fieldoffsets / nofieldoffsets

デフォルトはfieldoffsetsです。

DOPのField Bindingsで、このフィールドのオフセットパラメータを有効にします。

forcealign / noforcealign

デフォルトはforcealignです。

すべてのフィールドまたはボリュームが同じ解像度である必要があります。 これにより、コードがシンプルになるうえ、サンプルが揃っていると想定することが可能になります。

最初の書き込み可能なフィールドまたはボリューム(イテレートが行なわれるもの)はforcealignedであるべきではないので、デフォルトはnoforcealignです。

resolution / noresolution

デフォルトはnoresolutionです。

フィールドまたはボリュームの解像度を含めます。 これは境界チェックに必要ですが、その他が揃っている場合は、通常最初のボリュームのみに必要です。

最初の書き込み可能なボリュームでは、デフォルトはresolutionです。

voxelsize / novoxelsize

デフォルトはnovoxelsizeです。

ボリュームのボクセルのサイズを含めます。

xformtoworld / noxformtoworld

デフォルトはnoxformtoworldです。

インデックス空間からジオメトリ(SOP)空間へのトランスフォームを含めます。

xformtovoxel / noxformtovoxel

デフォルトはnoxformtovoxelです。

ジオメトリ(SOP)空間からインデックス空間へのトランスフォームを含めます。

意味

@name.data

実際のランプデータのfloat配列。

@name.len

ランプのサイズ。

@name(float), @name.getAt(float)

要求した0..1の位置でランプの値を調べ、サンプル間を補間します。

意味

@name.data

フィールドのそのままのfloatデータ。

@name.stride_x/y/z/offset

データのX、Y、Z軸のステップのストライド。オフセットは、データから0,0,0ボクセルへのオフセットです。

@name.x/y/zres

フィールドのX、Y、Zの解像度。

@name, @name.get

現行の処理済みの値。揃っている場合、有効です。

@name.getAt(x,y,z)

インデックス位置X、Y、Zにおけるボクセル。

@name.set(val)

現行の処理済みのボクセルをvalに設定します。揃っている場合、有効です。

@name.setAt(x, y, z, val)

(x, y, z)におけるボクセルをvalに設定します。

@name.sample(xyz)

float3 xyzでのインデックス空間のフィールドを評価します。

意味

@name.data

そのままのアトリビュートデータ。すべてのエレメントデータが、穴やページのない単一の配列に平坦化されます。配列アトリビュートでは、配列データは連続的に格納されます。

通常、これに直接アクセスすることはなく、境界チェックメソッドを提供する他のメソッドが使用されます。

@name.len

アトリビュートの長さ。これは、アトリビュートが持つポイント、プリミティブ、頂点の数です。

@name, @name.get

現行インデックスのアトリビュート値。

読み込み可能な場合、有効です。配列でない場合、有効です。マッチするインデックスの場合、有効です。

@name(idx), @name.getAt(idx)

特定のインデックスでアトリビュートを取得します。

読み込み可能な場合、有効です。配列でない場合、有効です。

@name.set(val)

現行インデックスでアトリビュート値を設定します。

書き込み可能な場合、有効です。配列でない場合、有効です。マッチするインデックスの場合、有効です。

@name.setAt(idx, val)

指定したインデックスにおけるアトリビュートを値に設定します。

書き込み可能な場合、有効です。配列でない場合、有効です。

@name.tuplesize

アトリビュートの各エレメントのサイズ。float型のアトリビュートのサイズは1、vector型のアトリビュートのサイズは3です。

@name.tuple

現行の処理済みのアイテムの配列へのポインタ。OpenCLのネイティブの型にマッピングしないアトリビュートサイズを使用する場合、これが便利ですエレメントにアクセスするには、[]を使用(@name.tuple[2]のように)して現行アトリビュートの3番目の部分を取得します。この場合、アトリビュートのタプルサイズを超えて読み取らないように、境界チェックを行なう必要があります。

マッチするインデックスの場合、有効です。

@name.tupleAt(idx)

インデックスidxにおける特定のアイテムの配列へのポインタ。tupleと同様、これを使用する際には注意が必要です。

@name.bound

アトリビュートがバインドされるかどうか。オプションのアトリビュートでは、バインドされる場合は1、されない場合は0にします。オプションでないアトリビュートは常にバインドされます。存在しない場合はカーネルが実行されないためです。

@name.comp(compidx)

配列アトリビュートでは、現行インデックスのデータの特定のコンポーネントを抽出します。

配列の場合、有効です。マッチするインデックスの場合、有効です。

@name.entries

現行インデックスの配列の長さ。

配列の場合、有効です。マッチするインデックスの場合、有効です。

@name.compAt(idx, compidx)

配列アトリビュートでは、特定のインデックスのデータの特定のコンポーネントを抽出します。idxは、アトリビュートのエレメント番号です(ポイント番号やプリミティブ番号など)。compidxは、そのエレメントの配列内のアクセスする場所です。

配列の場合、有効です。

@name.entriesAt(idx)

インデックスidxの配列の長さ。

配列の場合、有効です。

意味

@name.data

ボリュームのそのままのデータ。stride_値を使用してインデックス化されたボリュームの値の平坦な配列です。境界チェックがあるため、直接dataを使用するのではなく、getAtまたは類似のメソッドを使用することをお勧めします。

@name.stride_x/y/z/offset

X、Y、Z軸のステップサイズと、data配列の開始から0,0,0ボクセルのオフセット。

@name.x/y/zres

ボリュームの解像度。パディングされることが多いため、インデックスにストライドを使用する必要があることに注意してください。

@name.voxelsize_x/y/z

各軸に沿った0,0,0ボクセルのサイズ。

voxelsizeフラグが必要です。

@name.xformtoworld

ボクセルインデックスをモデル/SOP空間にマッピングするfpreal16。

xformtoworldフラグが必要です。

@name.xformtovoxel

モデル/SOP空間をインデックス空間にマッピングするfpreal16。

xformtovoxelフラグが必要です。

@name, @name.get

現行ボクセルインデックスにおけるボリュームの値。

読み込み可能な場合、有効です。マッチするインデックスの場合、有効です。

@name.valid(x,y,z)

ボクセルのx、y、zがボリュームの境界内にある場合はTrueです。

@name.getAt(x,y,z)

ボクセル(x, y, z)での値を返します。ボリュームの範囲外の場合、インデックスはボリュームの範囲にクランプされます。

読み込み可能な場合、有効です。

@name.set(val)

現行の処理済みのボクセルをvalに設定します。

書き込み可能な場合、有効です。マッチするインデックスの場合、有効です。

@name.setAt(x, y, z, val)

(x, y, z)におけるボクセルをvalに設定します。これは境界チェックされ、範囲外の場合はそのままです。

書き込み可能な場合、有効です。

@name.sample(xyz)

インデックス空間fpreal3の位置xyzにおいて、ボリュームにトリリニア補間を行ないます。有効な範囲内にクランプします。

読み込み可能な場合、有効です。

@name.sample2d(xy)

インデックス空間fpreal2の位置xyzにおいて、ボリューム対してバイリニア補間を行ないます。有効な範囲内にクランプします。

読み込み可能な場合、有効です。

意味

@name.data

そのままのNanoVDBデータ。CNanoVDBヘッダを使用してこれを直接検査できますが、CNanoVDBは非常に詳細なため、メソッドを使用する方法が望ましいです。

@name.voxelsize_x/y/z

X、Y、Z軸でのVDB(0,0,0)ボクセルのサイズ。

voxelsizeフラグが必要です。

@name.xformtoworld

インデックス空間からモデル/SOP空間へのfpreal16トランスフォーム。

xformtoworldフラグが必要です。

@name.xformtovoxel

モデル/SOP空間からインデックス空間へのfpreal16トランスフォーム。

xformtovoxelフラグが必要です。

@name, @name.get

現行の処理済みのインデックスでの値を返します。

読み込み可能な場合、有効です。マッチするインデックスの場合、有効です。

@name.pos

現行の処理済みインデックスのモデル/SOP位置を返します。

マッチするインデックスの場合、有効です。

@name.active

現行の処理済みVDBインデックスがこのVDB上でアクティブかどうか。

vectorまたはfloatバインドが必要です。マッチするインデックスが必要です。

@name.activeAt(x, y, z)

指定されたX、Y、Zインデックス座標がアクティブかどうか。

vectorまたはfloatバインドの場合、有効です。

@name.valid(x, y, z)

指定されたX、Y、Zインデックス座標がアクティブかどうか。

vectorまたはfloatバインドの場合、有効です。マッチするインデックスの場合、有効です。

@name.getAt(x, y, z)

インデックス(x, y, z)での値を返します。VDBは、非アクティブな領域に背景値を所有しているため、任意のインデックス上で実行することができます。

vectorまたはfloatバインドの場合、有効です。読み込み可能な場合、有効です。

@name.set(val)

現行の処理済みのボクセルを値valに設定します。

vectorまたはfloatバインドの場合、有効です。書き込み可能な場合、有効です。マッチするインデックスの場合、有効です。

@name.setAt(x, y, z, val)

インデックス(x, y, z)におけるボクセルを値valに設定します。インデックスがVDBトポロジーにない場合、書き込みは何もしません。

vectorまたはfloatバインドの場合、有効です。書き込み可能な場合、有効です。

@name.sample(xyz)

指定されたインデックス空間の位置において、VDBにトリリニア補間を行ないます。

vectorまたはfloatバインドの場合、有効です。読み込み可能な場合、有効です。

@name.worldSample(xyz)

指定されたモデル/SOP空間の位置において、VDBにトリリニア補間を行ないます。

vectorまたはfloatバインドの場合、有効です。読み込み可能な場合、有効です。

@name.worldGradient(xyz)

指定されたモデル/SOP空間におけるVDBの勾配を計算し、モデル/SOP空間で勾配を返します。

floatバインドの場合、有効です。読み込み可能な場合、有効です。

意味

@name, @name.get

指定したデータのオプションの値。