このモジュールには、hou.Galleryとhou.GalleryEntryのアクセスと管理をするためのいくつかの基本的な関数が備わっています。
関数 ¶
createGalleryEntry(gallery_path, entry_name, node)
→ hou.GalleryEntry or None
新しいギャラリーエントリーを作成して返します。
gallery_path
新しいエレメントの保存先となるギャラリーファイルのパス。
entry_name
新しいギャラリーエントリーの名前。
node
新しいギャラリーエントリーが設定をコピーする元のオペレータノード。 この設定には、パラメータ値、チャンネル、Spareパラメータなどが含まれ、ノードがサブネットワークであれば、その子ノードも含まれます。
galleries()
→ tuple of hou.Gallery
Houdiniセッションに現在インストールされているすべてのギャラリーを含んだタプルを返します。
galleryEntries(name_pattern=None, label_pattern=None, keyword_pattern=None, category=None, node_type=None)
→ tuple of hou.GalleryEntry
検索基準に一致したhou.GalleryEntryオブジェクトのタプルを返します。 その結果は、すべてのパラメータに対して一致したエントリーとの共通部分です。 この関数をパラメータなしでコールすると、すべてのギャラリーエントリーが返されます。 hou.Gallery.galleryEntriesも参照してください。
パラメータが None でない限りは、その結果は以下のオプションでフィルタリングされます:
name_pattern
このパターンに一致させるギャラリーエントリー名
label_pattern
このパターンに一致させるギャラリーエントリーラベル名
keyword_pattern
このパターンに一致させるキーワードを持ったギャラリーエントリー
category
このパターンに一致させるカテゴリ内のギャラリーエントリー
node_type
このノードタイプに適用可能なギャラリーエントリー
このサンプルは、Materialキーワードを持った“b”から始まるギャラリーエントリーすべてをプリントします。
>>> hou.galleries.galleryEntries("b*", keyword_pattern="Material") (<hou.GalleryEntry "basic_surface">, <hou.GalleryEntry "bumpy_glass">, ...)
このサンプルは、Metalsカテゴリ内のすべてのエントリーの名前と説明をプリントします:
>>> for entry in hou.galleries.galleryEntries(category="Metals"): ... print "%s: %s" % (entry.name(), entry.description()) chrome: Very bright metal with mirror reflections aged_metal: Aged metal material with ray traced or environment mapped reflections ...
このサンプルは、
Lsystem SOPに対するギャラリーエントリー名をプリントします。
>>> node_type = hou.nodeType(hou.sopNodeTypeCategory(), "lsystem") >>> for entry in hou.galleries.galleryEntries(node_type=node_type): ... print entry.name() planta plantb plantc ... sympodial_tree ternary_tree wheel
installGallery(gallery_path)
→ hou.Gallery or None
ギャラリーを現行Houdiniセッションに読み込みます。
gallery_path
インストールするギャラリーのファイルパス。
removeGallery(gallery_path)
→ bool
現行Houdiniセッションからギャラリーを削除します。指定したギャラリーがインストールされていなかった場合はFalseを返します。
gallery_path
削除するギャラリーのファイルパス。