この記事はHoudini Advent Calendar 2016の二日目の記事です。
#パラメータに入るのは値だけではない
パラメータって値を入れるだけじゃないの？値が入らなかったり緑になったり訳がわからん！
#Expression
緑はパラメータがExpressionで制御されている状態です。
▼例として$F
Expressionを入力した直後はLabel(上の図での"Size")の後ろに白っぽいグレーの色が付きます。
これは、計算された値→Expressionの表示に切り替わった事を示しています。Expression→計算された値にする場合はLabelをクリックします(右クリックからToggle Expressionでも可)
▼ 左：計算された値 右：Expression
▼補足として…式や変数じゃなくともToggle Expression可能です。浮動小数点の誤差には気を付けましょう。
▼Houdini15ぐらいから@もパラメータで利用できます
(ただし、ノードによって利用できるattributeのタイプが異なります。例えばtransformノードではDetailのattributeしか利用できません。対してpointノードのように各point毎に実行されるものについては、@P.xのようなpointのattributeが利用できます)
デフォルトではHScript(緑)です、Pythonに変更することもできます。
ギアマーク横のHマークをPythonに変更すると緑でなく赤色になります。
なるほど、Pythonは赤色なんだな！と思ってはいけません。まだ変わってません。
パラメータを右クリックしてChange Language Pythonを行って初めてPythonになります。
そう、緑と赤は右上で表示されているHScriptマーク、もしくはPythonマークに該当するものを見つけるための色付けだったのです。
▼pythonではローカル変数はlvar("TX2")のように利用できます。（例外的にhou.接頭辞は略せます）
#Edit Expressionで複数行を
パラメータに複数行入れる場合は、ctrl+Eもしくは右クリックからEdit Expressionで入力しましょう。
しかし、何も考えず、
以下のように入れるとエラーが起こります。
▼たとえば、1フレーム時のみ値1を与えたい場合
if($F==1){
return 1;
}
なぜエラーになるかというと、全体を括る{}がないからです。
よって
{
if($F==1){
return 1;
}
}
これで上手くいきます。
#Edit String
パラメータ全体に括弧をつける必要のないものもあります。
それがStringパラメータです。よく利用するStringパラメータとしては
例えばgroupやfile、Wrangleなどです。
しかし、StringでもExpressionを利用したい場合があります。その場合は `{}` を利用します。
String型であっても `(バッククォート)で囲った部分はExpressionとして機能します。
▼ファイル出力時のゼロパディング
$HIP/file_`padzero(4, $F)`.bgeo
▼1フレーム時のみgroup(Hello)を生成したい場合
`{
if($F==1){
string foo = "Hello";
return foo;
}
}`
最後に１つ。いつ使うねん！って感じですがExpressionのパラメータにバッククォート無理やり使って値を入れるためにはもう一変換必要となります。
atof("`{return 1;}`")
#よく使うExpression Function
http://www.andynicholas.com/?p=1344
を参考にしています。
| 関数 | 説明 |
|---|---|
| ch(parameter path) | パラメータの現在の値を取得 |
| chf(parameter path,フレーム) | 特定のフレームでパラメータの値を取得します |
| stamp(copySOP path,スタンプ変数,デフォルト値) | スタンプ変数の現在の値を取得 |
| point(SOP path,ポイント番号,attribute,index) | point attributeを取得 |
| prim(SOP path,ポイント番号,attribute,index) | primitive attributeを取得 |
| clamp(value,min,max) | 値を最小値と最大値の範囲内に |
| fit(value,min,max,newmin,newmax) | 古い範囲の値を新しい範囲に再マップしクランプ |
| fit01(value,newmin,newmax) | fit()と同じ、valueは0から1 |
| smooth(value,min,max) | 最小値から最大値まで0から1の間でスムージングされた値 |
| noise(x,y,z) | ノイズ |
| rand(seed) | 乱数 |
| length(x,y,z) | ベクトルの長さ |
| distance(x1,y1,z1,x2,y2,z2) | 2点間の距離 |
| bbox(SOP path,dimension type) | バウンディングボックス(dimension type：D_XMIN, D_YMIN, D_ZMIN, D_XMAX, D_YMAX, D_ZMAX, D_XSIZE, D_YSIZE, D_ZSIZE) |
その他
sin, cos, tan, asin, acos, atan, atan2, abs, pow, sqrt, ceil, floor, atof, dot, cross, deg, rad, exp, frac, hsv, rgb, min, max, log, log10, round, substr, strreplace
が利用できます。
#よく使うExpression Local Variables
| 変数 | 説明 |
|---|---|
| $PT | ポイント番号 |
| $PR | プリミティブ番号 |
| $CY | 現在のコピー番号 |
| $TX,$TY,$TZ | ポイントの位置 |
| $NX,$NY,$NZ | ポイント/プリミティブの法線 |
| $CR,$CG,$CB,$CA | ポイント/プリミティブの色 |
| $VX,$VY,$VZ | ポイントの速度 |
| $BBX,$BBY,$BBZ | バウンディングボックス内の点の正規化された（0～1）位置 |
| $CEX,$CEY,$CEZ | ジオメトリの重心 |
| $AGE | パーティクルが生存している秒数 |
| $LIFE | パーティクルの正規化された年齢（0～1） |
| $XMIN,$XMAX,$YMIN,$YMAX,$ZMIN,$ZMAX | バウンディングボックスの範囲 |
| $SIZEX,$SIZEY,$SIZEZ | バウンディングボックスのサイズ |
| $TX2,$TY2,$TZ2 | 2番目の入力から来るポイントの位置 |
Expressionは便利ですが、ローカル変数は速度的に難があるので可能ならVEXを利用したほうが良いでしょう。
以上