Houdini 21.0 ネットワークとパラメータ

レシピの保存方法と使用方法

パラメータ設定とノードグループを保存して、それらを必要な時に再現する方法。

On this page

概要

Houdiniでは、パラメータ値のセット、ネットワークアイテム(ノード、ドット、ステッキーノート、ネットワークボックス)のセットを、名前が付いた レシピ として保存することができます。 レシピに保存すれば、必要な時にいつでもそれらのパラメータ値を適用したり、それらのノードを再現することができます。

4種類のレシピを作成することができます: パラメータプリセット、ノードプリセット、デコレーション、ツール。

各レシピは、Data Node Type Categoryとして作成されます。 レシピを保存すると、Houdiniはそのレシピを.hda拡張子のデジタルアセットライブラリファイルに保存します。 これによって、デジタルアセットと一緒にレシピを保存することができるので、そのデジタルアセットファイブラリファイルをインストールすれば、その中に含まれているレシピもインストールされます。

Tip

Houdiniをアップデートした後、recipe.hdaファイルがまだ存在しなかった場合、以前のrecipe.hdaファイルを新しいバージョンのHoudiniのotlsディレクトリにコピーしてください。 そのotlsディレクトリに既にrecipe.hdaファイルが存在した場合、コピーした古いファイルがその既存ファイルを上書きします。

ネットワークエディタ内で既存のノードから直接レシピを作成したり、その内容をレシピとして保存するRecipe Builderを作成することもできます。

パラメータプリセットの保存

パラメータプリセットは、単一パラメータの値をレシピとして保存します。 これは、大量または複雑なマルチパラメータインスタンスセットを保存してから、それらを様々なパラメータに適用したい場合に役立ちます。

To...Do this

パラメータプリセットを作成する

  1. 保存したいパラメータ値をセットアップします。

  2. パラメータエディタ内で、そのパラメータラベルをクリックして、 Recipes ▸ Save Parameter Preset を選択します。

  3. Preset Title を入力します。

  4. Parm Type Pattern 、 Parm Name Pattern 、 Node Type Pattern を使用して、レシピが表示されるパラメータを設定します。 チェックされたすべてのパターンにマッチしたパラメータにのみそのレシピが表示されます。

    例えば、パラメータの内部名がseedで終わるパラメータに対してレシピを表示するには、 Node Type Pattern と Parm Type Pattern をオフにして、 Parm Name Pattern を*seedに設定します。

    詳細は、パターンを参照してください。

  5. (オプション) Scripts タブでは、 Before Data Applied または After Data Applied をオンにして、そのレシピの作成前または作成後に実行されるPythonスクリプトを保存することができます。 詳細は、レシピのスクリプトを書く方法を参照してください。

  6. Save to メニューのデフォルト( User Preferences )は、ユーザプリファレンスディレクトリ内のアセットライブラリにすべてのレシピが保存されます。通常はこれで十分です。 しかし、既存のアセットにレシピを埋め込みたい場合、または、レシピを共有して使いたい場合(大規模スタジオの場合)、プリセットの保存先と内部名を変更することができます。 Internal Name を高度なオプションとして編集することができます。

    User Preferences

    レシピアセットを$HOUDINI_USER_PREF_DIR/otls/Recipes.hdaに保存します。

    Store In Same Library as ‹name›

    レシピをソースノードタイプと同じアセットライブラリに保存します。 このオプションは、Houdiniにインストールされている“ファクトリー”ノードタイプでは利用不可です。

    $HIP/otls Directory

    アセットを現行シーンファイルと同じディレクトリのotlsサブディレクトリに保存します。

    $JOB/otls Directory

    アセットを$JOB環境変数で設定されたパス内のotlsサブディレクトリに保存します。

    Embed in Current HIP File

    アセットを現行シーンファイルの一部として埋め込みます。 これは、自己完結した作業シーンファイルを共有する時に役立つ場合があります。

    Note

    これはシーンファイルのサイズを増やしてしまいます。

    Custom File Path

    このオプションを選択してから、そのポップアップメニューの隣のフィールドに保存先のアセットライブラリのパスを入力するか、 または 、ファイル選択アイコンをクリックして、ファイルダイアログから保存先のファイルを選択します。

    Tip

    Houdiniをアップデートした後、recipe.hdaファイルがまだ存在しなかった場合、以前のrecipe.hdaファイルを新しいバージョンのHoudiniのotlsディレクトリにコピーしてください。 そのotlsディレクトリに既にrecipe.hdaファイルが存在した場合、コピーした古いファイルがその既存ファイルを上書きします。

  7. Save をクリックします。

マルチパラメータインスタンスを置換ではなく追加するレシピを作成する

  1. 保存したいマルチパラメータの内容をセットアップします。

  2. パラメータエディタ内で、マルチパラメータの親(マルチパラメータのインスタンス数を制御する行)をクリックして、 Recipes ▸ Save Parameter Preset を選択します。

  3. Preset Title を入力します。

  4. Data タブで、 Multiparm Operations を Append に設定します。

  5. Save をクリックします。

パラメータプリセットを適用する

パラメータエディタ内で、パラメータをクリックして、 Recipes サブメニューをクリックします。そこから適用したいレシピを選択します。

ノードプリセットを保存する方法

ノードのパラメータ値のセット、さらには、Spareパラメータ値までもレシピとして保存することができ、そして、その保存されたパラメータ値を他のノードに適用することができます。 後でそれらの値すべてを一度に設定したいとなった時に、既存のノードにそのプリセットを適用することができます。

オプションで、ノードの 内容 をレシピの一部として保存することもできます。 これは、例えば、Pyro Solver SOPのDive Targetコンテキスト内の内容をレシピとして保存してそのレシピを適用すれば、ノードに特定のパラメータが設定され、さらにDOPネットワークも入力されるようになるので便利です。

Note

このタイプのレシピは、 既存ノード のパラメータ値と可能であればその内容までを 変更 するためのものです。 特定のパラメータ値と内容を持つ特定のタイプのノードを配置するだけの手段が必要な場合、代わりにツールレシピを使用します(以下参照)。

Spareパラメータをプリセットの一部として保存した場合、そのプリセットを適用すると、それらのSpareパラメータがまだ存在していなければ、ターゲットノード上にそれらのパラメータが作成されます。

To...Do this

パラメータ値をプリセットとして保存する

  1. パラメータエディタで、保存したいパラメータをセットアップします。

  2. パラメータエディタの右上にある Recipeメニューから Save Node Preset を選択します。

    または

    ネットワークエディタ内で、ノードを右クリックして Recipes ▸ Save Node Preset を選択します。

  3. 表示されたダイアログ内で、チェックボックスを使用して、プリセットに取り込みたいパラメータを選択します。

    このダイアログの最初の状態では、デフォルト値でないすべてのパラメータと、すべてのSpareパラメータにチェックが付いています。

    • 一部のノードタイプでは、ノードの初期状態でオリジナル値になっている“非デフォルト”のパラメータもデフォルトでチェックが付いて表示される場合があります。 例えば、Sphereサーフェスノード生成スクリプトがPrimitive Typeを実際のデフォルト値から Polygon Mesh に変更するようになったしょうもない歴史的理由により、そのパラメータが常に最初から“非デフォルト”になっています。 これは残念なことですが、プリセットの一部として保存したくない場合は、ただチェックマックをオフにすれば良いだけです。

    • Spareパラメータはデフォルトでチェックが付き、オブジェクトノードのMantraレンダープロパティは技術的にはSpareパラメータなので、オブジェクトノードのプリセットを保存する場合、すべてのレンダープロパティが最初からチェックが付きます。 Render フォルダのチェックを外せば、すべての子のチェックが外れるので、その後に実際に保存したいパラメータのチェックを付け直すと良いです。

  4. デフォルトでは、プリセットには、選択したパラメータのキーフレームアニメーションとエクスプレッションが含まれます。代わりに現行値だけを保存したいのであれば、 Capture Keyframes and Expressions のチェックを外してください。

  5. Preset Options セクション内の Preset Title にプリセットタイトルを入力します。

  6. Show for ポップアップメニューを使用して、そのプリセットを適用できるようにしたいノードタイプを選択します。 デフォルトでは、ソースノードタイプにのみそのプリセットが表示されます。 現在のノードタイプカテゴリに属するすべてのノード、または、パターンにマッチしたすべてのノードタイプでプリセットが表示されるように選択することができます。 詳細は、パターンを参照してください。

  7. Save to メニューのデフォルト( User Preferences )は、ユーザプリファレンスディレクトリ内のアセットライブラリにすべてのレシピが保存されます。通常はこれで十分です。 しかし、既存のアセットにレシピを埋め込みたい場合、または、レシピを共有して使いたい場合(大規模スタジオの場合)、プリセットの保存先と内部名を変更することができます。 Internal Name を高度なオプションとして編集することができます。

    User Preferences

    レシピアセットを$HOUDINI_USER_PREF_DIR/otls/Recipes.hdaに保存します。

    Store In Same Library as ‹name›

    レシピをソースノードタイプと同じアセットライブラリに保存します。 このオプションは、Houdiniにインストールされている“ファクトリー”ノードタイプでは利用不可です。

    $HIP/otls Directory

    アセットを現行シーンファイルと同じディレクトリのotlsサブディレクトリに保存します。

    $JOB/otls Directory

    アセットを$JOB環境変数で設定されたパス内のotlsサブディレクトリに保存します。

    Embed in Current HIP File

    アセットを現行シーンファイルの一部として埋め込みます。 これは、自己完結した作業シーンファイルを共有する時に役立つ場合があります。

    Note

    これはシーンファイルのサイズを増やしてしまいます。

    Custom File Path

    このオプションを選択してから、そのポップアップメニューの隣のフィールドに保存先のアセットライブラリのパスを入力するか、 または 、ファイル選択アイコンをクリックして、ファイルダイアログから保存先のファイルを選択します。

    Tip

    Houdiniをアップデートした後、recipe.hdaファイルがまだ存在しなかった場合、以前のrecipe.hdaファイルを新しいバージョンのHoudiniのotlsディレクトリにコピーしてください。 そのotlsディレクトリに既にrecipe.hdaファイルが存在した場合、コピーした古いファイルがその既存ファイルを上書きします。

Tip

パラメータエディタペイン内でパラメータを編集した場合、 Reload Values をクリックすることで、ダイアログをその新しい値で更新することができます。

パラメータプリセットをノードに適用する

  • ノードを選択してから、パラメータエディタ内の Recipesメニューから、適用したいプリセットを選択します。

    または

  • ネットワークエディタ内で、ノードを右クリックして Recipes サブメニューを開き、そのノードに適用したいプリセットを選択します。

既存のパラメータプリセットを編集する

  1. メインメニューから Windows ▸ Recipe Manager を選択します。

  2. 編集したいレシピを選択して、 Edit Contents ボタンをクリックします。

    Houdiniは、パラメータを取り込んだ元のノードタイプのインスタンスを作成し、そのインスタンスにプリセットを適用し、そのインスタンスに対してプリセットエディタを開きます。 その後に、パラメータ値を編集したり、ダイアログ内で設定(プリセットのタイトルなど)を変更することができます。

  3. Save ボタンをクリックすると、新しい値でプリセットが保存されます。

以下のプリセットを編集する方法を参照してください。

デコレーションレシピを保存する方法

デコレーション はツールレシピに似ていますが、レシピ内の1つのノードを“セントラル”ノードとして指定します。 このセントラルノードとは、ユーザがデコレーションを適用するノードの プレースホルダー のようなものです。デコレーションをネットワークエディタ内の“ターゲット”ノードに適用する時、Houdiniは以下の操作を行ないます:

  • レピシ作成者が保存したパラメータをセントラルノードに適用します。

  • ターゲットノードの周囲にレシピ内のその他のノードを生成します。

  • ターゲットノード上のコネクションを、レシピ作成者が設定したとおりに、新しいノードセットアップ内の適切なノードに接続し直します。

例えば、通常ではPyro Solverの後にボリュームをシャープ化するノードを追加する場合、Pyro Solverとシャープ化ノードで事前作成されたセットアップを配置するツールレシピを作成するか、または、既存のPyro Solverにシャープ化ノードを追加するデコレーションレシピを作成することになると思います。 あるいは、ツールレシピとデコレーションレシピの両方を作成して、ツールレシピを使って新しいセットアップを作成でき、デコレーションレシピを使って既存のセットアップに追加できるようにするのも良いでしょう。

To...Do this

ノードセットアップをデコレーションとして保存する

  1. デコレーションに変換したいノード(s)を選択します。

  2. 選択したノードを右クリックして、 Recipes ▸ Save Selected Items as Decoration を選択します。

    右クリックしたノードがレシピの“セントラル”ノードになります。 セントラルノードは、レシピが適用されるノードを意味します。 ダイアログ内でこの“セントラル”となるノードを編集することができますが、右クリックしたノードをセントラルとして指定できるのは便利です。

  3. そのツールがTabメニューで表示されるサブメニューを選択することができます。 Tab Submenu フィールドの右側にあるドロップダウンメニューから既存のサブメニューを選択するか、または、そのフィールドに新しい名前を入力して新しいサブメニューを作成します。

    複数のメニューラベルをカンマ(,)区切りで入力することで、そのツールを複数のサブメニューに表示させることができます。 例えば、File IO, Recipesは、Tabメニューの File IO と Recipes のサブメニューの両方にそのツールが表示されます。

  4. ノードが正しく“セントラル”ノードとしてマークされていることを確認します。

    • 現在のセントラルノードは、レシピダイアログ内の概略ビューで黄色いアウトラインが付きます。

    • セントラルノードを変更するには、その概略ビュー内でノードをクリックして、 Set as Central Node を選択するか、 または 、 Central Node ポップアップメニューからノードを選択します。

  5. デコレーションレシピは、そのレシピが生成する非セントラルノード上のすべてのパラメータ(非デフォルトのパラメータとSpareパラメータ)値を保存します。 セントラルノード上のパラメータ値を保存するかどうか選択することができ、保存した場合はデコレーションが適用された時にターゲットノードにそれらのパラメータ値が再適用されます。 これは、ターゲットノードの周囲に生成されるデコレーションノードで必要となるそのターゲットノード上のパラメータ値を設定(例えば、チャンネル参照)するのに役立ちます。

    • デフォルトでは、 Capture Parameters on the Central Node がオンになっています。セントラルノードのパラメータを保存しなくないのであれば、それをオフにすると良いでしょう。

    • ダイアログの右側のペインのパラメータビューを使用して、取り込まれるセントラルノード上のパラメータを選択することができます。

  6. ユーザがデコレーションをノードに適用すると、Houdiniは、そのターゲットノードの既存コネクションを接続し直します。このような場合のために、レシピ内で“入力”や“出力”として使用されるノードを設定することができます。

  7. Recipe Options セクションの Recipe Title にレシピのタイトルを入力します。

  8. Show for ポップアップメニューを使用して、このデコレーションが適用可能なノードタイプを選択します。 デフォルトでは、セントラルノードタイプにのみそのデコレーションが表示されます。 現在のノードタイプカテゴリに属するすべてのノード、または、パターンにマッチしたすべてのノードタイプでプリセットが表示されるように選択することができます。 詳細は、パターンを参照してください。

  9. Save to メニューのデフォルト( User Preferences )は、ユーザプリファレンスディレクトリ内のアセットライブラリにすべてのレシピが保存されます。通常はこれで十分です。 しかし、既存のアセットにレシピを埋め込みたい場合、または、レシピを共有して使いたい場合(大規模スタジオの場合)、プリセットの保存先と内部名を変更することができます。 Internal Name を高度なオプションとして編集することができます。

    User Preferences

    レシピアセットを$HOUDINI_USER_PREF_DIR/otls/Recipes.hdaに保存します。

    Store In Same Library as ‹name›

    レシピをソースノードタイプと同じアセットライブラリに保存します。 このオプションは、Houdiniにインストールされている“ファクトリー”ノードタイプでは利用不可です。

    $HIP/otls Directory

    アセットを現行シーンファイルと同じディレクトリのotlsサブディレクトリに保存します。

    $JOB/otls Directory

    アセットを$JOB環境変数で設定されたパス内のotlsサブディレクトリに保存します。

    Embed in Current HIP File

    アセットを現行シーンファイルの一部として埋め込みます。 これは、自己完結した作業シーンファイルを共有する時に役立つ場合があります。

    Note

    これはシーンファイルのサイズを増やしてしまいます。

    Custom File Path

    このオプションを選択してから、そのポップアップメニューの隣のフィールドに保存先のアセットライブラリのパスを入力するか、 または 、ファイル選択アイコンをクリックして、ファイルダイアログから保存先のファイルを選択します。

    Tip

    Houdiniをアップデートした後、recipe.hdaファイルがまだ存在しなかった場合、以前のrecipe.hdaファイルを新しいバージョンのHoudiniのotlsディレクトリにコピーしてください。 そのotlsディレクトリに既にrecipe.hdaファイルが存在した場合、コピーした古いファイルがその既存ファイルを上書きします。

  10. Save ボタンをクリックします。

デコレーションをノードに適用する

ネットワークエディタ内でノードを右クリックして Recipes サブメニューを開き、適用したいデコレーションを選択します。

以下のデコレーションを編集する方法を参照してください。

ツールレシピを保存する方法

ツールレシピ は、ノードまたはノードセット(接続と現行パラメータ値を含む)を、Tabメニューの新しいツールとして保存します。 保存した後は、Tabメニューからそのツールを選択することで、その保存されたノードセットアップを再現することができます。

To...Do this

ノードまたはノードセットをツールとして保存する

  1. ツールにしたいノード(s)を選択します。

  2. 選択したノードのどれかを右クリックして、 Recipes ▸ Save Selected Items as Tool を選択します。

    右クリックしたノードがレシピの“アンカー”ノードになります。 そのレシピをネットワークに“配置”すると、他のノードは、このアンカーノードを基準に配置されます。 ダイアログ内でこの“アンカー”となるノードを編集することができますが、右クリックしたノードをアンカーとして指定できるのは便利です。

  3. 単一ノードを配置する通常のTabメニューツールと同様に、ユーザはTabメニューからレシピを選択して、それを既存のワイヤー上に配置したり、新しいワイヤーで始めてTabメニューを使用してレシピツールを選択してそのツールを接続することができます。 レシピ内に“入力”や“出力”として使用したいノードを設定することができます。

  4. そのツールがTabメニューで表示されるサブメニューを選択することができます。 Tab Submenu フィールドの右側にあるドロップダウンメニューから既存のサブメニューを選択するか、または、そのフィールドに新しい名前を入力して新しいサブメニューを作成します。

    複数のメニューラベルをカンマ(,)区切りで入力することで、そのツールを複数のサブメニューに表示させることができます。 例えば、File IO, Recipesは、Tabメニューの File IO と Recipes のサブメニューの両方にそのツールが表示されます。

  5. Tabメニューのツール名の横に表示されるアイコンを選択することができます。これは、デジタルアセットのアイコンを設定する方法と同じです: ファイルパス、opdef:参照、ビルトインHoudiniアイコンの名前のどれかを指定することができます。

  6. レシピに2個以上のノードを含めた場合、 Anchor Node ポップアップメニューから“アンカー”ノードにしたいノードを選択することができます(ユーザがネットワークエディタ内をクリックしてツールを配置した時に、他のノードはこのノードを基準に配置されます)。

  7. Recipe Options セクションの Recipe Title にレシピのタイトルを入力します。

  8. Save to メニューのデフォルト( User Preferences )は、ユーザプリファレンスディレクトリ内のアセットライブラリにすべてのレシピが保存されます。通常はこれで十分です。 しかし、既存のアセットにレシピを埋め込みたい場合、または、レシピを共有して使いたい場合(大規模スタジオの場合)、プリセットの保存先と内部名を変更することができます。 Internal Name を高度なオプションとして編集することができます。

    User Preferences

    レシピアセットを$HOUDINI_USER_PREF_DIR/otls/Recipes.hdaに保存します。

    Store In Same Library as ‹name›

    レシピをソースノードタイプと同じアセットライブラリに保存します。 このオプションは、Houdiniにインストールされている“ファクトリー”ノードタイプでは利用不可です。

    $HIP/otls Directory

    アセットを現行シーンファイルと同じディレクトリのotlsサブディレクトリに保存します。

    $JOB/otls Directory

    アセットを$JOB環境変数で設定されたパス内のotlsサブディレクトリに保存します。

    Embed in Current HIP File

    アセットを現行シーンファイルの一部として埋め込みます。 これは、自己完結した作業シーンファイルを共有する時に役立つ場合があります。

    Note

    これはシーンファイルのサイズを増やしてしまいます。

    Custom File Path

    このオプションを選択してから、そのポップアップメニューの隣のフィールドに保存先のアセットライブラリのパスを入力するか、 または 、ファイル選択アイコンをクリックして、ファイルダイアログから保存先のファイルを選択します。

    Tip

    Houdiniをアップデートした後、recipe.hdaファイルがまだ存在しなかった場合、以前のrecipe.hdaファイルを新しいバージョンのHoudiniのotlsディレクトリにコピーしてください。 そのotlsディレクトリに既にrecipe.hdaファイルが存在した場合、コピーした古いファイルがその既存ファイルを上書きします。

  9. Save ボタンをクリックします。

ツールレシピの内容を配置する

ツールレシピの配置の挙動は、単一ノードを生成する他のツールと同様ですが、ツールレシピは複数のノードを一括で生成することができます。

  1. ネットワークエディタ内で⇥ Tabを押して、Tabメニューからレシピを選択します。

  2. クリックして、レシピの内容を配置します。

ツールの内容をノードの入力または出力に接続する

ワイヤーを開始してツールレシピを選択する挙動は、単一ノードを生成する他のツールと同様ですが、ツールレシピは複数のノードを一括で生成することができます。

  1. ネットワークエディタ内で、ワイヤーを開始するために、ノードの入力コネクタまたは出力コネクタをクリックします。

  2. 新しいワイヤーがマウスポインタに付着している間に⇥ Tabを押して、そのTabメニューからレシピを選択します。

  3. クリックして、レシピの内容を配置します。その新しいワイヤーは、レシピ作成者がレシピの“入力”や“出力”として設定したレシピノードに接続されます。

以下のツールを編集する方法を参照してください。

パターン

プリセットやデコレーションでは、レシピが表示されるノードタイプまたはパラメータをレシピメニューから選択することができます。

Node Type Pattern

  • これは、パラメータプリセット、ノードプリセット、デコレーションに適用されます。 これは、 Pattern パラメータ( Show for がNodes Matching a Custom Patternの場合)または Node Type Pattern パラメータのどちらかです。

  • レシピメニュー内でこのレシピが表示されるノードタイプ。デフォルトでは、元のノード(プリセットの場合)またはセントラルノード(デコレーションの場合)と同じノードタイプに対してレシピが表示されます。

  • パターンには、hou.text.patternMatch関数と同様に標準のHoudiniパターンマッチングを使用します。*ワイルドカードは、どの文字列にもマッチします。

  • パターンには、パターンをスペースで区切ったリストを指定することができます。名前がそのリスト内の どれか にマッチしたノードタイプに対してレシピが表示されます。

  • Houdiniは、ノードの カテゴリを含んだ内部名 (例えば、acme::Sop/foobar::2.0)とパターンのマッチングを試みます。

  • 例えば、acmeネームスペース内のすべてのノードとマッチさせるには、acme::*を使用します。

  • 複数のカテゴリにマッチさせたい場合(例えば、すべてのSOPとすべてのDOPにマッチさせたい場合)、可能性のあるケースにマッチするように複数のパターンをスペースで区切ったリストを記述する必要があります。例えば、ネームスペースのないSOP、ネームスペースのあるSOP、ネームスペースのないDOP、ネームスペースのあるDOPにマッチさせる場合は、 Sop/* *:Sop/* Dop/* *:Dop/*と記述します。

  • パターンにはワイルドカードを使用する必要はありません。レシピを特定のノードタイプのみに表示させたい場合、単にそれらのノードの内部名をスペース区切りのリストで記述すれば良いだけです。

Tip

レシピを作成した後でも、そのパターンで適切にマッチしないことが分かったなら、そのパターンを編集することができます。

ノードがそのパターンにマッチするかどうかをチェックしたいのであれば、hou.text.patternMatchとhou.Node.nameWithCategoryを使用すると良いでしょう:

>>> my_pattern = "acme::*"
>>> # このノードがそのパターンにマッチしますか?
>>> hou.text.patternMatches(my_pattern, hou.node("/obj/geo1/my_node").type().nameWithCategory())
True

Parm Name Pattern

  • これは、パラメータプリセットに適用されます。

  • レシピメニュー内でこのレシピが表示されるパラメータ名。デフォルトでは、レシピが取得を試みるパラメータと同じパラメータに対して表示されます。

  • 末尾がseedで終わるHoudini内のすべてのパラメータにマッチさせるには、これを*seedに設定し、 Node Type Pattern をオフにします。 例えば、これは、末尾がseedで終わるすべてのパラメータに対してレシピを表示したい場合に役立ちます。

Parm Type Pattern

  • これは、パラメータプリセットに適用されます。

  • レシピメニュー内でこのレシピが表示されるパラメータタイプ。デフォルトでは、レシピが取得を試みるパラメータと同じパラメータに対して表示されます。

  • 例えば、float integerを使用することで、浮動小数点パラメータと整数パラメータに対してのみレシピが表示されます。

Tip

パラメータタイプがパターンにマッチするかどうか確認する方法:

>>> my_pattern = "float"
>>> # Does this node match the pattern?
>>> hou.text.patternMatches(my_pattern, hou.parmTuple('/obj/geo1/scale').parmTemplate().interfaceType())
True

保存先を選択する方法(上級者向け)

レシピダイアログの Save to メニューのデフォルトは User Preferences です。 これは、すべてのレシピをユーザプリファレンスディレクトリ内のアセットライブラリに保存します。通常はこれで十分です。 しかし、既存のアセットにレシピを埋め込みたい場合、または、レシピを共有して使いたい場合(大規模スタジオの場合)、レシピの保存先を変更したり、レシピアセットの内部名を編集することができます。

例えば、スタジオで共有できるようにツールを作成する場合、ツールを共有ネットワークドライブに保存し、そのツールの内部名には、スタジオ固有のネームスペースとバージョン番号(例えば、acme::vellum_cloth_tool::2.0)を使用したいことでしょう。

保存場所

To...Do this

レシピの保存先を選択する

レシピダイアログの Save to ポップアップメニューをクリックして、以下のどれかを選択します:

User Preferences

レシピアセットを$HOUDINI_USER_PREF_DIR/otls/Recipes.hdaに保存します。

Store In Same Library as ‹name›

レシピをソースノードタイプと同じアセットライブラリに保存します。 このオプションは、Houdiniにインストールされている“ファクトリー”ノードタイプでは利用不可です。

$HIP/otls Directory

アセットを現行シーンファイルと同じディレクトリのotlsサブディレクトリに保存します。

$JOB/otls Directory

アセットを$JOB環境変数で設定されたパス内のotlsサブディレクトリに保存します。

Embed in Current HIP File

アセットを現行シーンファイルの一部として埋め込みます。 これは、自己完結した作業シーンファイルを共有する時に役立つ場合があります。

Note

これはシーンファイルのサイズを増やしてしまいます。

Custom File Path

このオプションを選択してから、そのポップアップメニューの隣のフィールドに保存先のアセットライブラリのパスを入力するか、 または 、ファイル選択アイコンをクリックして、ファイルダイアログから保存先のファイルを選択します。

Tip

Houdiniをアップデートした後、recipe.hdaファイルがまだ存在しなかった場合、以前のrecipe.hdaファイルを新しいバージョンのHoudiniのotlsディレクトリにコピーしてください。 そのotlsディレクトリに既にrecipe.hdaファイルが存在した場合、コピーした古いファイルがその既存ファイルを上書きします。

内部名

各レシピアセットは、名前の干渉が起きないようにデフォルトの内部名が指定されています。 この内部名には、 そのアセットを作成したノードのタイプ をスコープとして、 あなたの名前 ($HOUDINI_AUTHORを設定した場合は、その値)をネームスペースとして、レシピタイトルをエンコードしたバージョンをベース名として使用します。

To...Do this

レシピを作成する時に内部名を変更する

  1. レシピダイアログで、 Show Advanced Options ボタンをクリックします。

  2. Internal name フィールドを編集します。

レシピを編集する方法

To...Do this

Recipe Managerを開く

メインメニューから Windows ▸ Recipe Manager を選択します。

レシピを削除する

Recipe Managerで、削除したいレシピを選択して、 Delete ボタンをクリックします。

レシピの名前を変更する

  1. Recipe Managerで、名前を変更したいレシピを選択します。

  2. Edit Contents ボタンをクリックします。

  3. Recipe Title フィールドに新しい名前を入力します。

  4. Save ボタンをクリックします。

または

  1. Recipe Managerで、名前を変更したいレシピを選択します。

  2. 右上コーナーにある Show Panelアイコンをクリックします。

  3. Title フィールドに新しい名前を入力します。

レシピを非表示にする

  1. Recipe Managerで、非表示にしたいレシピを選択します。

  2. 右上コーナーにある Show Panelアイコンをクリックします。

  3. Infoパネル内の Visible トグルをオフにします。

Recipe Managerからレシピを編集する

  1. Recipe Managerで、編集したいレシピを選択して、 Edit Contents ボタンをクリックします。

    Houdiniは、一時的なサブネットワーク内にそのレシピの内容を生成し、その内容を選択して、それに対してレシピエディタを開きます。 そのサブネットワーク内でパラメータ値を編集したり、ダイアログ内で設定(タイトルなど)を変更することができます。

    ノードをツールレシピやデコレーションレシピに追加するには、その一時的なサブネットワーク内にノードを作成し、そのノードを選択し、レシピエディタダイアログ内の Reload Selection ボタンをクリックします。

    ツールレシピやデコレーションレシピからノードを削除するには、その一時的なサブネットワークからそのノードを削除し、レシピエディタダイアログ内の Reload Selection ボタンをクリックします。

  2. Save ボタンをクリックすると、新しい値でプリセットが保存されます。

Note

レシピを頻繁に編集する場合、編集と再保存をより迅速に行なうことができるRecipe Builderを使用してレシピを作成する方が良いでしょう。

Tip

レシピはデジタルアセット内に格納されるので、Asset Manager、Type Properties Editor、ノードタイプとアセット定義を制御するHOM関数を使用して、レシピを管理することもできます。

上級者向けオプション

通常ではこれらの設定を変更する必要はありません。 これらの設定をレシピダイアログに表示するには、 Show Advanced Options ボタンをクリックします。

Recursively Save Node Contents

これをオフにすると、ツールまたはデコレーションは、トップレベルのノードのみを持つようになり、サブネットワークまたはロック解除されたアセットの内容は保存されなくなります。

Save Editable Dive Targets

アセットは、定義内のサブネットを編集可能なDive Targetとして指定することができます。 そのアセットインスタンスを作成したユーザは、そのDive Target内で独自のノードを配置して、そのアセットの挙動に影響を与えることができます。 通常では、Houdiniはサブネットワークの内容をレシピの一部として保存します。 このオプションをオフにすると、サブネットワークの内容が無視されます。

セントラル/アンカーノードの編集可能な内容を保存するコントロールと他のすべてのノードの内容を保存するコントロール(Non-Anchor Nodeオプション)が別々に存在します。

Save View Flags (at Top Level)

通常ではビューフラグを変更するようなレシピを適用することはないので、Houdiniはビューフラグ(Output、Display、Render)をレシピの一部として 保存しません 。 非ビューフラグ(“Frozen”や“Bypass”など)が常に保存されます。 このオプションをオンにすると、ビューフラグをレシピの一部として保存することができます。

Only Save Nodes

通常では、Houdiniはステッキーノート、ネットワークボックス、ドットをレシピの一部として保存します。 このオプションをオンにすると、レシピはノードだけを保存し、他のタイプのネットワークオブジェクトを無視します。

最後に呼び出されたレシピ

Houdiniは、パラメータプリセットおよびノードプリセットのレシピをノードに適用する度に、最後に呼び出されたレシピを記録に残します。 サブメニューを使用してレシピを保存すると、そのサブメニューエントリーと共に最後に呼び出されたレシピの名前が Recipeメニューに表示されます。

カスタムプリセットメニューにも、最後に呼び出されたレシピを表示することができます。 詳細は、プリセットメニューサンプルの作成を参照してください。

Recipe Builder

レシピを生成するもう1つの方法は、Recipe Builderを使用することです。 Recipe Builderは、レシピを自動で生成します。 これによって、レシピの内容をサブネットワーク内に配置して、その内容とキャプチャ設定をHIPファイルに保存することができます。

詳細は、Recipe Builderを参照してください。

スクリプト

スクリプトを使用してレシピを作成、適用、実行する方法は、レシピのスクリプトを書く方法を参照してください。

レシピのデータフォーマット

レシピのデータフォーマットの詳細は、レシピのデータ形式を参照してください。

ネットワークとパラメータ

ネットワーク

パラメータの編集

次のステップ

エクスプレッション

レシピ

リファレンス

導師レベル