float xyzdist(<geometry>geometry, vector origin)
originからジオメトリ上の一番近いポイントまでの距離を調べます。
float xyzdist(<geometry>geometry, vector origin, int &prim, vector &uv)
float xyzdist(<geometry>geometry, vector origin, int &prim, vector &uv, float maxdist)
originからジオメトリ上の一番近いポイントまでの距離を調べて、さらに一番近いポイントにおけるプリミティブ番号とUV座標を出力します。
float xyzdist(<geometry>geometry, string primgroup, vector origin)
float xyzdist(<geometry>geometry, string primgroup, vector origin, int &prim, vector &uv)
float xyzdist(<geometry>geometry, string primgroup, vector origin, int &prim, vector &uv, float maxdist)
originから、指定したプリミティブグループ内のジオメトリ上の一番近いポイントまでの距離を調べます。
ジオメトリ上の一番近いポイントまでの距離を返します。 この関数は、ポイントポジションではなく、ジオメトリのサーフェス上のポジションを見つけます。
<geometry>
ノード(例えばWrangle SOP)のコンテキスト内で実行する時は、この引数にジオメトリの読み込み元の入力番号(0から始まります)を意味する整数を指定することができます。
別の方法として、読み込み元のジオメトリファイル(例えば、.bgeo
)を示した文字列を指定することができます。
Houdini内で実行する時は、この引数にop:/path/to/sop
参照を指定することができます。
primgroup
プリミティブグループを生成するためのプリミティブグループの名前またはパターン。
SOPグループと同じ構文を使用するので、空っぽの文字列は、すべてのプリミティブに一致します。
@Cd.x>0
などのアトリビュートグループも使用することができますが、
Snippet VOPでは、@
にバックスラッシュを付けてエスケープさせる必要があることに注意してください。
origin
ジオメトリ上の一番近い位置を見つけるための空間内のポジション。
&prim
この関数は、一番近いプリミティブのプリミティブ番号でこの変数を上書きします。プリミティブが見つからなかった場合は-1
です。
&uv
この関数は、一番近いプリミティブ上の一番近いポイントのUV座標でこの変数を上書きします。 primuvを使用することで、この位置におけるアトリビュート値をサンプリングすることができます。
maxdist
検索する最大距離。これを指定することで早期終了が可能になるので、この関数を高速化することができます。
Returns
起点からジオメトリ上の一番近いポイントまでの距離。
measure |
|
proximity |