インターフェース定義が保存されるファイルパスです。 変更を正確に保存するために、ファイルは、Houdiniにより書き込みができるようにする必要があります。 パスが書き込み可能でない場合は、インターフェースに変更を適用しようとするとエラーメッセージが表示されます。 ファイルパスは手動で入力できます。または、フィールドの右側にあるファイルブラウザにより選択できます。

インターフェースの固有の名前です。 これは、ロードされたすべてのPythonインターフェースにわたって一意である必要があります。 つまり、最大でも1つのインターフェースが指定された固有の名前でロードされます。 名前は文字から始まる必要があり、文字、数字および/または下線を使用することができます。

人間が判読できるインターフェースの名前です。 ラベルは、Python Panelペインタブおよびインターフェースメニューで使用されます。 複数のインターフェースは同じラベルを共有できます。

インターフェースに使用するアイコンの固有名、ファイルパスまたはURLです。

フィールドの右端にある選択ボタンをクリックしてファイルを選択します。 なお、デジタルアセットに含まれるファイルを選択できます(ファイル選択の左側にあるopdef:をクリックします)。

絶対パスやURLを指定しない場合、Houdiniは、$HOUDINI_UI_ICON_PATH 環境変数のパスを使用してアイコンを探します。

SVGファイルやHoudiniがサポートしている画像フォーマット(PNGや.pic)を使用できます。アイコン画像は四角形になります。

Houdiniには、多数のストックSVGアイコンが搭載されています。$HFS/houdini/help/icons/largeでこれらのアイコンのビットマップ画像を確認できます。 ストックアイコンを指定するには、dirname_filenameのフォームを使用します。ここで、

• dirnameは$HFS/houdini/help/icons/large内のディレクトリ名で、OBJ、SHELF、MISCなどです。

• filenameはアイコンのファイル名から拡張子を除いたものです。例えば、OBJ_stickyはStickyオブジェクトの標準アイコンを指定します。

チェックを付けると、Python Panelインターフェースを含んだペインタブに、Houdiniネットワークを行き来するためのコントロールが表示されます。

ディスクからメニュー定義が読み込まれなかった時、このインターフェースメニューのヒントを使って、メニュー内にインターフェースを含めるのか、メニューにインターフェースを挿入するのかどうかをHoudiniに指示します。

Pythonインターフェースのスクリプト定義。 ここは、インターフェースを構築するためにPySide2やPyQt5のコードを書き込む場所です。 インターフェースがPython Panelにロードされると、スクリプトが実行され、onCreateInterface()関数により返されたルートウィジェットがパネルに組み込まれます。

Python Panelsは、特定のイベントが発生した時に以下の関数を認識して実行します:

• onCreateInterface() → PySide2.QWidget or PyQt5.QWidget

  Python PanelがQtインターフェースを作成した時に実行されます。 この関数は、インターフェースのルートQtウィジェットを返さなければなりません。

• onDestroyInterface()

  Python PanelがQtインターフェースを破棄しようとした時に実行されます。 これは、Python Panelペインタブを閉じたり、インターフェースを再読み込みした時に実行することができます。

• onActivateInterface()

  インターフェースがアクティブで可視になった時に実行されます。

• onDeactivateInterface()

  インターフェースが非アクティブで不可視になった時に実行されます。

• onHipFileBeforeClear()

  hipファイルのクリア処理が実施される前に実行されます。

• onHipFileAfterClear()

  hipファイルのクリア処理が実施された後に実行されます。

• onHipFileBeforeLoad()

  hipファイルの読み込み処理が実施される前に実行されます。

• onHipFileAfterLoad()

  hipファイルの読み込み処理が実施された後に実行されます。

• onHipFileBeforeMerge()

  hipファイルの結合処理が実施される前に実行されます。

• onHipFileAfterMerge()

  hipファイルの結合処理が実施された後に実行されます。

• onHipFileBeforeSave()

  hipファイルの保存処理が実施される前に実行されます。

• onHipFileAfterSave()

  hipファイルの保存処理が実施された後に実行されます。

• onNodePathChanged(node)

  Houdiniが現行ノードを変更した時に実行されます。 この関数フックは、Python PanelインターフェースをHoudiniノードネットワークの行き来に追従させたい時に役立ちます。

  nodeは現行ノードで、hou.OpNodeオブジェクトです。 現行ノードがない場合は、nodeはNoneに設定されます。

  Python Panelインターフェースが最初に読み込まれると、この関数フックもコールされることに注意してください。

onCreateInterface()関数のみがインターフェースで必須です。 他の関数は任意です。

from PySide2 import QtWidgets

def onCreateInterface():
    panetab = kwargs["paneTab"]

    label = QtWidgets.QLabel()
    label.setText("Running in pane tab '%s'" % panetab.name())
    return label