パラメータ内に数式のような短いコードを入力して、数学や、現行フレーム番号、ポイント番号、乱数などの変数を使用して値を計算することができます。 例えば、手動でキーフレームを打つことなく時間軸で球を上昇させるには、その球のY座標にフレーム番号を5で割った式を設定することで可能です。

1. 新しくGeometryオブジェクトを作成して、中に入ります。

2. Gridノードを作成します。

3. パラメータエディタで、Gridノードの Size フィールドを以下に設定します:

   $F / 10
   

   これは、現行フレーム番号を基準にグリッドのサイズを決めます。メインウィンドウの下にあるプレイバーを使ってアニメーションを再生してみてください。

• 数値パラメータ (例えば、位置、回転、スケール)では、そのパラメータ内のテキストはエクスプレッションとして評価されます。

• 文字列パラメータ (例えば、ファイル名やFontノードで作成するテキスト)では、そのパラメータ内のテキストはテキストとして扱われます。変数は展開されますが、数学やエクスプレッションを使用してテキストの部分を生成するには、バッククォートでエクスプレッションを閉じなければなりません。例:

  frame`padzero(5, $F)`.pic
  

  …これは、ファイル名がframe00001.pic、frame00002.picなどになります。

(ファイル名パラメータに変数とエクスプレッションを使用する方法の詳細は、ファイル名のエクスプレッションを参照してください。)

エクスプレッションには、Houdiniで用意された変数を使用することができます:

• $F(現行フレーム番号)や$T(単位が秒の現行時間)などの グローバル変数 。以下のグローバル変数のリストを参照してください。

• ジオメトリアトリビュート 。ジオメトリに対するHScriptエクスプレッションでは、@attributenameを使ってアトリビュートの値を参照することができます。例えば、@pscaleを使えば、現行ポイントに対するpscale(point scale)アトリビュートの値を取得することができます。

  P(ポジション)などのベクトルアトリビュートに関しては、ドット表記(例えば、@P.x)を使用することでコンポーネントを取得することができます。これには.x/.y/.z、.1/.2/.3、.r/.g/.bを使用することができ、どれもデータのタイプで理にかなった表記になっております。

• ローカル変数 。ノードには、そのタイプのノードのエクスプレッションで役に立つ変数が用意されていることが多いです。例えば、ジオメトリ内のポイントに対して処理をするノードには、現行ポイントのポイント番号を意味する@ptnum変数があります。ノードのヘルプには、そのタイプのノードのエクスプレッションで使用可能なローカル変数のリストが載っています。

• $HIP(シーンファイルを含んだディレクトリ)などの 環境変数 がエクスプレッションで利用可能です。

HScriptエクスプレッションでは、ch関数を使用することで、ノードのパラメータの値を参照することができます。これは、あるノードが追従する数値を作成したり、他のノードの数値を基準にした数値を作成するのに役立ちます。

ch("tz")

ch("/obj/lamp/tx")

ch("../grid1/ry")

通常では、エクスプレッション言語は、パラメータ値と他の値との関係性を表現した短い1行の式(例えば、X位置に$T * 2を設定してボールを動かすことができます)を記述するのに使用します。 パラメータエクスプレッション内に複雑なスクリプトを組みたい場合、パラメータが従来のエクスプレッション言語の代わりにPythonを使用できるようにしたいことがあります。

とはいえ、従来のエクスプレッション言語を使って複雑なことをしたい場合、ブロック、ifステートメント、forループを使用して、複数行にわたるエクスプレッションを記述することができます。

• ブロックとは、波括弧({と})の中に一連のサブステートメントを記述したものです。

• サブステートメントはセミコロン(;)で区切る必要があります。

• サブステートメントは以下のように構成することができます:

  • 割り当て。割り当ての右辺には、エクスプレッション構文と関数を使用することができます。変数名の前にその変数の型(floatまたはstring)を指定しますが、 floatの場合は任意 で、 stringの場合は必須 です。

    例:

    size = 0;
    float frame = ch("outputframe");
    string name = ch("name");
    

    {}ブロック内で割り当てられた変数は、ローカル変数となります。

  • j += 5;やi -= 1;といったその場の修正、i++;やj--;といったCスタイルのその場の増分/減分をステートメントとして使用することもできます。

  • if...then...elseステートメント。以下のifステートメントを参照してください。

  • forループとwhileループ。以下のforループを参照してください。

  • returnステートメント。returnの右側には、エクスプレッション構文と関数を使用することができます。returnステートメントが実行されると、そのエクスプレッションが評価され、{}ブロックの最終値として使用されます。

    returnステートメントは最後でなくても複数箇所に記述することができ、例えば、ifブロック内に記述することができます:

    {
        # ...
        if (evalmode == 4) {
            float slope = (ch("../inputrangey") - miniframe)
                        / (ch("../outputrangey") - minoframe);
            return miniframe + ($FF - minoframe) * slope;
        }
        # ...
    }
    

    (returnステートメントが実行されなかった場合、外側{}ブロックは0と評価します。)

  • #文字は1行コメントを開始します。#文字以降の1行は無視されます。

{ 
    size = 0;
    if ($F > 10) {
        size = 23;
    } else if ($F > 20) {
        size = 47;
    } else {
        size = 50;
    }
    return size;
}

{
    float out = 0;
    for (i = 0; i < 10; i++) {
        out += i;
    }
    return out;
}

{
    float k = ch("parm");
    float i = 0;

    while (i < k) {
        i++;
        if (i % 2 == 0) continue;
    }

    return i;
}

• HScriptエクスプレッションとローカル変数をパラメータに使用することで、ジオメトリノードのジオメトリを修正するのは簡単です。とはいえ、Point WrangleやAttribute WrangleなどのノードでVEXスニペットを使用してジオメトリを修正する方が非常に効率的です。

  将来のバージョンのHoudiniは、ジオメトリを修正するのに、パラメータエクスプレッションよりもおそらくVEXの利用を推進していきます。

• Window ▸ HScript Textport を選択して、以下をタイプすることでエクスプレッションの値をチェックすることができます:

  echo `expression`
  

• Houdiniは、ネットワークの“レシピ”を使って常に“ゼロから”各フレームを作成します。エクスプレッションは、前のフレームから ではなく 、ノードの初期セットアップから取得する値に対して常に作用します。

  例えば、ランダムなオフセットをグリッド内の各ポイントのY位置に追加するPointジオメトリノードをセットアップします:

  Position Y	@P.y + rand(@Frame * @ptnum)

  …アニメーションを再生すると、それらのポイントは上下に滑らかに移動せずにランダムに飛び回ります。これは、各フレームでネットワークが平坦なグリッドから開始して、ランダムな移動量がそこに適用されるからです。 このエクスプレッションは、前のフレームのジオメトリに対して実行されません。