指定したオプションを使って、新しいhou.Shelfオブジェクトを返します。 新しいシェルフタブを作成するには、この関数を使用しなければなりません。 直接Shelfクラスをインスタンス化することはできません。

指定したオプションを使って、新しいhou.ShelfSetオブジェクトを返します。 新しいシェルフセットを作成するには、この関数を使用しなければなりません。 直接ShelfSetクラスをインスタンス化することはできません。

指定したオプションを使って、新しいhou.Toolオブジェクトを返します。 新しいツールを作成するには、この関数を使用しなければなりません。 直接Toolクラスをインスタンス化することはできません。

シェルフファイルを読み込み、そのファイルに定義されているシェルフとツールをHoudiniに追加します。

検索パスで見つかったシェルフファイルを再読み込みして、その変更された情報でそのシェルフUIを更新します。

既知のすべてのシェルフセットの内部名をそれに相当するhou.ShelfSetオブジェクトにマッピングした辞書を返します。

既知のすべてのシェルフタブの内部名をそれに相当するhou.Shelfオブジェクトにマッピングした辞書を返します。

既知のすべてのツールの内部名をそれに相当するhou.Toolオブジェクトにマッピングした辞書を返します。

hou.Toolの参照をその内部名によって取得します。

>>> hou.shelves.tool("geometry_sphere")
<hou.Tool 'geometry_sphere'>

endChangeBlockがコールされるまで、Houdiniがシェルフ情報ファイルを自動的に書き換えないようにします。

通常では、シェルフを編集するほとんどの関数とメソッドは、Houdiniにシェルフ定義ファイルを新しい情報で書き換えさせます。 一度に多くのシェルフ/ツールを変更した場合、それぞれの変更が別々に書き出されるので、非常に遅くなります。

“一括”変更を高速化するには、まず最初にbeginChangeBlock()をコールしてから、編集を行ない、そしてendChangeBlock()をコールします。 これは、一度にすべての変更を書き出すまで、シェルフファイルの書き換えを遅らせます。

# MISC_angry_fruit_saladのすべてのツールのアイコンを変更します。
# 実際にこれを実行してはいけません!

# 最初に、変更の書き込みを無効にします。
hou.shelves.beginChangeBlock()

for shelf in hou.shelves.shelves().values():
    for tool in shelf.tools():
        tool.setIcon("MISC/angry_fruit_salad")

# Change Blockを終わらせて、すべての変更をディスクに書き出します。
hou.shelves.endChangeBlock()

beginChangeBlockをコールする度に、それに合わせてendChangeBlockをコールしなければなりません。 そうしないと、Houdiniが実際にその変更をディスクに書き出さなくなります。

上記のbeginChangeBlockを参照してください。