HDAの Tool Type は、インスタンス化時に、選択したアセットおよび/またはアクターをHDAの入力に接続する方法を決定します。

Selection Type は、 Tool Type に応じてHDAの入力を追加する際、 選択されたアクター のみ、 選択されたアセット のみ、またはその 両方 のいずれを使用するかを決定します。

HoudiniToolsパネルは、 Houdini Tools Search Path プロジェクト設定を利用して、HoudiniToolsパッケージの検索を試みます。デフォルトでは、パッケージ検索パスは、 /Game/HoudiniEngine/Tools のみでパッケージを検索するように設定されています。このパッケージ検索パスは、HoudiniEngine Pluginプロジェクト設定で設定することができます。

HoudiniToolsPackageアセットは、以下のように検索パスのルートに格納(検索パスにパッケージが1つだけの場合)される場合:

/Game/HoudiniEngine/Tools/
    HoudiniToolsPackage
    he_tool1
    he_tool2
    ...

または、 中間サブディレクトリ に複数のパッケージが格納される場合があります:

/Game/HoudiniEngine/Tools/
    Package1/
        HoudiniToolsPackage
        he_tool1
        he_tool2
        ...
    Package2/
        HoudiniToolsPackage
        he_tool3
        he_tool4
        ...
    ...

HoudiniToolsパネルは、指定した検索パスの2つ以上深いディレクトリではHoudiniToolsPackageアセットを検索しません。サブディレクトリにHoudiniToolsPackageアセットがない場合、HoudiniToolsパネルはそれを無視します。

HoudiniTools Packageは、必須のHoudiniToolsPackageアセットと、同じフォルダ(またはサブフォルダ)にある1つまたは複数のHDAで構成されています。HoudiniToolsPackageアセットには、カテゴリと、そのパッケージ内のどのHDAが各カテゴリに含まれ(または各カテゴリから除外され)ているかが記述されています。パッケージディレクトリ内部に配置されているHDAのみが、HoudiniToolsパネルに表示されます。HDAは、必要に応じてサブディレクトリに整理されます。

/Game/HoudiniEngine/Tools/
    StudioTools/
        HoudiniToolsPackage
        PyroTools/
            he_pyrotool1
            he_pyrotool2
        DestructionTools/
                Explode/
                    he_destructiontool1
                Deform/
                    he_destructiontool2
        ...

カテゴリは、パッケージ全体または特定のサブフォルダと一致するように設定されます。同じHDAが複数のカテゴリに表示される場合もあります。

以下は、HoudiniToolsPackageアセットに設定することができるプロパティのリストです:

HoudiniAssetsがカテゴリに分類されるとき、includeルールが最初に処理されます。特定のカテゴリについて候補となるHoudiniAssetsのリストが収集された後、excludeルールが適用され、一致するHoudiniAssetsがカテゴリから除外されます。

ユーザは、HoudiniAssetPackagesの外部に存在する、独自のカテゴリを作成することができます。HoudiniToolsパネルから新規ユーザカテゴリを作成するには(または、既存のユーザカテゴリにツールを追加するには)、HoudiniToolsユーザカテゴリセクションを参照してください。

単一のユーザカテゴリに、複数のパッケージに存在するHDAが含まれている場合があります。ユーザカテゴリに含まれているHDA(またはHDAのセット)毎に、HoudiniToolsPackageアセットを選択する必要があります。HoudiniToolsパネルは、ユーザカテゴリにincludeおよびexcludeルールを適用する際、どのパッケージを使用するかの情報が必要になります。

HoudiniToolsの永続的なエディタ設定は、 Saved\Config\<PLATFORM>\HoudiniEngine.ini ファイルのUnrealプロジェクトに格納されています。

外部記述データ(JSONファイルとアイコン)は、HoudiniアセットとHoudiniパッケージの両方のオプションです。

{
    "categories": [
        {
            "name": "(Geo) Deform",
            "include": [
                "deform/*"
            ],
            "exclude": []
        },
        {
            "name": "(Geo) Scatter",
            "include": [
                "scatter/*"
            ],
            "exclude": [
                "Scatter/he_geo_fill_scatter"
            ]
        }
    ],
    "export_package_description": true,
    "reimport_package_description": false,
    "reimport_tools_description": true,
    "export_tools_description": false
}

C:/Project/StudioTools/
    HoudiniToolsPackage.json
        PyroTools/
            he_pyrotool1.hda
            he_pyrotool1.json
            he_pyrotool1.png
            he_pyrotool2.hda
            he_pyrotool2.json
            he_pyrotool2.png
        DestructionTools/
                Explode/
                    he_destructiontool1.hda
                    he_destructiontool1.json
                    he_destructiontool1.png
                Deform/
                    he_destructiontool2.hda
                    he_destructiontool2.json
                    he_destructiontool2.png
        ...

{
    "target": [
        "unreal"
    ],
    "name": "Bend and Twist",
    "toolType": "GENERATOR",
    "toolTip": "he_geo_bend",
    "UE_SelectionType": "All",
    "helpURL": "",
    "iconPath": "C:/Users/User/Downloads/thrust-bend.png"
}