Infoウィンドウは、ノードに関する情報を表示します。 例えば、ジオメトリ(SOP)ノードのInfoウィンドウは、そのノードによって生成されたジオメトリ上のアトリビュート、グループ、その他の情報を表示します。 ノードのInfoウィンドウを表示するには、ノード上にマウスカーソルを置いた時に表示されるノードリング内の“i”ボタンをクリックするか、または、ノードをクリックしたままにします。

特定のノードタイプやすべてのノードのInfoウィンドウにカスタム情報を追加すると便利になる場合があります。例:

• デジタルアセットの作成者は、ユーザがそのデジタルアセットのインスタンスのInfoウィンドウを表示した時に、そのデジタルアセット固有の情報を表示したい場合があります。

• 複雑なアセット管理パイプラインを持つスタジオでは、ワークフロー固有の各アセットに関する情報を表示できるようにしたいです。

Infoウィンドウ内でカスタム情報を表示できる場所がいくつかあります:

• Infoウィンドウの上部で、ノードの見出しのすぐ下に“タグ”を追加することができます。 これは、角丸四角形状のテキストボックスです。 例えば、アセットが“古い”かどうかといったちょっとした情報を表示するのに役立ちます。

  

• ウィンドウ上部(ノードの見出しの下)、中央(一般Infoグリッドの上)、下部(ノードコメントエディタの上)付近にも情報を追加することができます。

  

1. $HOUDINI_USER_PREFS/config/CustomNodeInfoディレクトリを作成します。

2. CustomNodeInfoディレクトリ内に、以下の内容のindex.jsonファイルを作成します:

   index.json

   {
       "node_scripts": {
           "Sop/sphere": "test.py"
       }
   }
   

3. 次に、同じディレクトリ内に以下の内容のtest.pyファイルを作成します:

   test.py

   addLabeledText("Custom Message", "This is some custom text for the info window.")
   

4. Houdiniを起動します。Geoオブジェクトを作成して中に入ります。次に、Sphereノードを作成します。

5. ノード上にマウスカーソルを置いて表示されるノードリング内の“i”ボタンをクリックするか、または、ノードをクリックしたままにします。

   Infoウィンドウにカスタムメッセージが表示されるはずです。

詳細は、下記のカスタマイズスクリプトの書き方を参照してください。

カスタマイズスクリプトは、アセット内部のセクション(“Extra File”)に保存することができます。 アセットにcustom_node_info.pyセクションがあれば、ユーザがそのアセットインスタンスのInfoウィンドウを表示した時にHoudiniが自動的にそのスクリプトを実行してカスタム情報を追加します。

1. ネットワークエディタ内でアセットをクリックして、 Edit Type Properties を選択します。

2. Type Propertiesダイアログで Extra Files タブをクリックします。

3. Section Name フィールドにcustom_node_info.pyと入力して、 Add Empty Section をクリックします。

4. 右側にあるエディタを使用して、スクリプトを入力(またはペースト)します。詳細は、下記のカスタマイズスクリプトの書き方を参照してください。

Houdiniは、Houdiniパスからconfig/CustomNodeInfo/index.jsonファイルを検索します。 このファイル内で、特定のノードタイプまたはすべてのノードに対して実行するカスタマイズスクリプトを指定することができます。

以下は、index.jsonファイルの例です:

{
    "node_scripts": {
        "Sop/lsystem": "lsystem.py"
    },
    "general_scripts": [
        "every_node.py"
    ]
}

このJSONには、以下の2つのオプションキーを含めることができます:

>>> hou.node('/obj/copnet1/custom_test1').type().nameWithCategory()
'matt::Cop/custom_test::1.0'

• node_scriptsは、パターンに対応していません。 代わりに、general_scriptを作成して、特定のノードのみに情報を追加するようにしてください。 例えば、acmeネームスペース内のノードにカスタム情報を追加するには、general_scriptを作成して、namespace == "acme"の場合にのみ情報を追加するスクリプトを記述します。

• 通常、node_scriptsオブジェクトの値はパス文字列です。 しかし、特定のノードタイプに対して複数のスクリプトを実行したい場合など何かしらの理由がある場合には、パス文字列の 配列 を使用することもできます。

  {
      "node_scripts": {
          "Sop/lsystem": "lsystem.py",
          "Sop/sphere": ["sphere.py", "shape.py"]
      }
  }
  

• 相対パスは、index.jsonファイルが含まれているディレクトリを基準に解決されます。

カラーを受け取る引数には、以下のいずれかの値を使用することができます:

• 16進数カラー文字列(例えば、"#ffcc00" )またはCSSカラー名(例えば、"rebeccapurple")。

• 何も描画しない"transparent"文字列。

*QtCore.QColorオブジェクト。

• 以下のUIカラー値のいずれか(例えば、addTag("Oops!", color=theme.error)):

  • theme.success (緑系の色)

  • theme.warning (黄色系の色)

  • theme.error (赤系の色)

  • theme.primary (UIアクセントカラー)

  • theme.secondary (アクセントカラーの彩度を落とした色)

  • theme.red, theme.orange, theme.amber, theme.yellow, theme.lime, theme.green, theme.emerald, theme.teal, theme.cyan, theme.sky, theme.blue, theme.indigo, theme.violet, theme.purple, theme.fuchsia, theme.pink, theme.rose, theme.stone, theme.gray, theme.zinc, theme.steel, theme.slate, theme.heather

Houdiniは、Infoウィンドウが利用可能になる前に、すべてのカスタマイズスクリプトを順次実行します。 ユーザがInfoウィンドウを待つ必要がないよう、スクリプトを可能な限り高速に実行されるよう心がけてください。 表示する情報の収集に時間がかかる可能性がある場合(例えば、ネットワーク経由での情報取得)、処理を高速化するための対策がいくつかあります。

import requests
import threading

# テキスト項目を作成し、初期テキストをプレースホルダに設定します。
status_item = addLabeledText("Status", "--")

# スレッド内でHTTPリクエストを介して情報を取得します。
def threaded_fn():
    response = requests.get("api.example.com/status")
    # Once the information is available, update the item with the new text
    status_item.update(text=response.text)
threading.Thread(target=fn).start()

def get_status_callback(button):
    response = requests.get("api.example.com/status")
    # ボタンとテキストの参照をIDで取得します。
    button = findByID("status_button")
    text_item = findByID("status_text")
    # ボタンを非表示にします。
    button.update(visible=False)
    # 新しいテキストを設定して表示します。
    text_item.update(text=response)("status_button")
    text_item = findByID("status_text")
    # ボタンを非表示にします。
    button.update(visible=False)
    # 新しいテキストを設定し、表示します。
    text_item.update(text=response.text, visible=True)

# ボタンとステータス表示を保持するラベル付きカラムを作成します。
column = addLabeledColumn("Status")
# ボタンと表示をカラムに追加します。
column.addButton("取得", get_status_callback, id="status_button")
# テキスト表示は、ユーザがボタンをクリックしコールバック関数が情報を読み込むまで非表示にします。
column.addText("", id="status_text", visible=False)

複数のカスタマイズスクリプト(例えば、スタジオ全体用スクリプト、ノードタイプ固有スクリプト、ユーザプリファレンス内の汎用スクリプト)が情報を追加する場合、異なるスクリプトが同じコンテナに項目を追加できるようにしたい場合があります。

スクリプト間でコンテナを共有するには、新しいコンテナを作成するメソッド(例えば、addGrid()やaddLabeledColumn())にid引数を追加します。 異なるスクリプトで同じIDを使用することで、同一のコンテナを取得することができます。

例えば、2つのスクリプトに以下のコードがある場合:

c1 = addLabeledColumn("Comments", id="comments")
c1.addText("Comment from script1")

c2 = addLabeledColumn("Comments", id="comments")
c2.addText("Comment from script2")

…この結果は、2つの項目(Comment from script1とComment from script2)を含んだ単一のCommentsカラムになります。

id引数がない場合、この2つのスクリプトはそれぞれ個別のカラムを作成し、両方にCommentsというラベルが付けられ、各カラムに1つの項目が含まれます。

コンテナを操作する必要がある場合、カスタマイズスクリプトでは以下のユーティリティ関数も使用することができます。

• スクリプト内でnodeオブジェクトを使用することで、ノードに保存されているパラメータ値やユーザデータにアクセスすることができます。詳細は、hou.Nodeオブジェクトリファレンスを参照してください。

• Infoウィンドウは、インデックスファイルとスクリプトの変更時刻をチェックして、変更があればリロードを行ないます。 ファイルの変更を反映させるためにHoudiniを再起動する必要はありません。

• Infoウィンドウを開いてもスクリプトの結果が表示されない場合は、以下の手順を試してください:

  • コンソールにエラーメッセージが表示されていないかチェックしてください。

  • スクリプトがディスク上のファイルにある場合、Houdiniパス上のconfig/CustomNodeInfo/index.jsonファイルにそのファイルが登録されているか再度ご確認ください。

  • ノード固有のスクリプトの場合は、index.jsonファイル内のキーがノードタイプの“カテゴリ付き内部名”と完全に一致していることを確認してください。

• カスタマイズスクリプトは、Infoウィンドウが開くのが遅くならないよう、迅速に実行されるべきです。 ネットワークから情報を取得してInfoウィンドウに表示したい場合は、非同期処理やスレッド処理といった対策を施したり、または、バックグラウンドで情報を取得して、ユーザがInfoウィンドウを表示するまでキャッシュしておくことを検討してください。

• HTMLを表示するだけの場合、addText()を使用することで、HTML文字列を“テキスト”として渡すことができます。 Qtの“リッチテキスト”ウィジェットが使用されており、HTML4やCSS2のサブセットをサポートしていますが、実際のブラウザほどの機能はありません。

• カラー のみ による情報表示(例えば、常に“Status”と表示されるタグが、正常時は緑、エラー時は赤になる)は避けてください。 カラーは、テキストやシンボルで表示される情報を 補強 するために使用してください。

• Infoウィンドウに多くの操作機能を組み込むことは控えてください。 Infoウィンドウは、ノードに関する情報を素早く確認するためのものであって、“コマンドインターフェース”として機能するものではありません。 ユーザがを押したままInfoウィンドウを表示した状態では、そのInfoウィンドウ自体に一切操作ができない点を忘れないでください。