Houdini 20.5 リファレンス ウィンドウ

Package Browserウィンドウ

Package Browserウィンドウは、Houdiniパッケージをリスト、作成、管理することができます。

On this page

概要

Package Browserウィンドウには以下の機能が備わっています:

  • ロード済のすべてのパッケージをリストする。

  • パッケージの内容を検査する。

  • パッケージの、編集、作成、ロード、リロード、アンロード、アクティブ化、非アクティブ化。

  • パッケージアーカイブの作成とインストール。

  • ロードしてエラーや警告があったパッケージを特定する。

  • コンソール領域にメッセージを表示する。

Package Browserウィンドウにアクセスするには、Pane Tabビュー内のをクリックして、 New Pane Tab Type ▸ Inspectors ▸ Package Browser を選択します。

パッケージに関する詳細は、このドキュメントを参照してください。

パッケージアーカイブ

Package Browserウィンドウは、パッケージアーカイブ(zipファイル)を使用して、Houdiniでのプラグインをパッケージ化、インストールを自動化することができます。 パッケージアーカイブは、スクリプト、デジタルアセット、Viewerステート、ライブラリファイルなどのプラグインリソースを埋め込んだコンテンツフォルダ、さらにオプションで、Houdiniにプラグインをロードするパッケージファイルと一緒に作成されます。

以下のHoudiniリソースタイプがサポートされていて、プラグインコンテンツフォルダの中に格納することができます:

リソースタイプ

フォルダ

デスクトップ

desktop

.deskファイル(s)を格納します。

デジタルアセット

otls

OPlibrariesファイルと一緒にHDAファイルを格納します。

Pythonモジュール

pythonX.Ylibs

.pyファイルを格納します。 正しいプラットフォームフォルダ内にPythonモジュールを用意する必要があります。 システムのPythonパスは、このフォルダパスで更新されます。 レガシーのscripts/pythonフォルダもサポートされています。

Pythonパネル

python_panels

.pypanelファイル(s)を格納します。

シェルフツール

toolbar

.shelfファイル(s)を格納します。 シェルフツールはロードされますが、シェルフセット内ではアクティブになりません。

Viewerステート

viewer_states

Pythonステート実装ファイルを格納します。

Viewerハンドル

viewer_handles

Pythonハンドル実装ファイルを格納します。

パッケージアーカイブは、 New Package Archive… メニューから作成し、 Install Package Archive … メニューからインストールします。

Note

  • パッケージアーカイブがインストールされると、すべてのHoudiniリソースが使用可能になります。リソースにアクセスするためにHoudiniを終了して再起動する必要はありません。

  • パッケージアーカイブを使用してインストールされたプラグインをアンインストールするには、ブラウザツリービューにリストされているプラグインインストールパッケージファイルをアンロードする必要があります。 インストールパッケージをアンロードすると、プラグインHoudiniリソースが自動的にアンインストールされます。

  • プラグインインストールパッケージファイルを非アクティブにすることで、プラグインを一時的にアンインストールすることもでき、非アクティブなプラグインはアンインストールされますが、ブラウザツリー内に残ります。

  • hou.ui.loadPackageArchive APIを使用してアーカイブをインストールすることもできます。

パッケージアーカイブの構造

パッケージアーカイブは、以下の構造で作成されます:

./{content folder name}/
./{content folder name}/{resource files}
./{content folder name}/{resource folders}/{resource files}
./{package file name}.json  
  • 内容:

    • content folder name : リソースを含んだプラグインフォルダ。

    • resource folders: Houdiniリソースのサブフォルダ。

    • resource files: Houdiniリソースファイルまたは他のプラグインファイル。

    • package file name: プラグインインストールパッケージ。

Note

  • オプションでプラグインコンテンツフォルダ名は、アーカイブ内にルートフォルダとして含めることができます。

  • パッケージファイルはオプションで、パッケージファイルを用意しなかった場合、Houdiniがアーカイブをインストールする時にそれを作成します。

  • パッケージファイルはアーカイブのルートレベルに追加しなければなりません。packagesフォルダの中にパッケージファイルを 置かないでください

  • リソースファイルは、上記で説明しているとおり、プラグインコンテンツフォルダの中に追加しなければなりません。

  • ファイルリンクまたはフォルダリンクはサポートされていません。

  • プラグインコンテンツフォルダ構造は、パッケージアーカイブ内で維持されます。

  • デフォルトでは、Houdiniはアーカイブが配置されているフォルダ内にパッケージアーカイブをインストールし、コンテンツフォルダは同じディレクトリにインストールされます。

  • サポートされているアーカイブフォーマットはZIPで、他のフォーマットは今後のバージョンで追加される予定です。

プラグインフォルダのサンプル

以下のサンプルは、プラグインコンテンツフォルダとインストールパッケージファイルをセットアップする方法を示しています。

viewer handle demoフォルダのレイアウト:

$HFS/packages/viewer_handle_demo/
    pythonX.Ylibs/
        move_tool_demo/
            utils.py
    scenes/
        move_tool_demo.hip
        viewer_handle_demo.hip
    toolbar/
        viewer_handle_demo.shelf
    viewer_handles/
        move_tool_handle.py
        viewer_handle_intro1.py
        viewer_handle_intro2.py
        viewer_handle_intro3.py

インストールパッケージファイルには、HOUDINI_PATHにそのフォルダパスを追加します:

. cat $HFS/houdini/viewer_handles/viewer_handle_demo.json    
{
    "path" : "$HFS/packages/viewer_handle_demo"
}

ツリービュー

ロード済みのすべてのパッケージがツリービュー内にリストされ、各ノードは、パッケージを表現していて、それをexpandすると、プロパティと設定を検査することができます。

右側の2つの項目は様々なパッケージの状態を示します:

  • パッケージは、走査可能なフォルダの中に配置されていて、起動時に自動的にロードされます。

  • パッケージは、走査可能なフォルダの中に配置されていなくて、チェックマークが有効な時に起動時にリロードされるように設定されています。このチェックマークが無効な時、そのパッケージは起動時にロードされません。

  • パッケージはロックされていて編集不可です。例えば、 $HFS/packages に配置されているパッケージはロックされています。

ツリーノード

ツリービュー内のパッケージノードは、アイコンをクリックすると展開され、そのプロパティと設定を検査することができます。 SHIFT + クリックすると、ノードブランチが全開で展開/折り畳まれます。 デフォルトではパッケージはアクティブで、そのノードのアイコンをクリックすると、パッケージが非アクティブになります。 パッケージを非アクティブにすると、そのパッケージがアンロードされますが、ツリーからは削除されません。 アイコンをクリックすると、そのパッケージが再びアクティブになります。 ロックされたパッケージは非アクティブにすることはできません。

パッケージノードは通常では(必ずしもそうでは限りませんが)以下の情報が含まれています:

  • File path: パッケージのファイルパス。

  • enable: Trueならばパッケージが有効として設定されています。

  • load_package_once: パッケージが複数回ロードされないようにします。

  • process_order: Houdiniがパッケージディレクトリ内で処理するパッケージの順序の調整に使用可能な整数値を指定します。

  • package_path: パッケージパスを動的に走査します。

  • recommends: ディペンデンシーを強制せずに、特定のパッケージ(s)が利用可能かどうかをチェックします。

  • requires: 特定のパッケージ(s)が利用可能かどうかをチェックし、ディペンデンシーを強制します。

  • show: パッケージがPackage Browserウィンドウでリストされるように設定します。

  • Environment variables: パッケージ内で設定されている環境変数のリスト。

  • Resources: パッケージでロードされるスクリプト、デスクトップ、デジタルアセットなどのHoudiniリソースのリスト。

メニュー

ツールバーメニュー

  • File

    • New Package…

      新しいパッケージを作成/編集するダイアログが開きます。 デフォルトでは、この新しいパッケージはユーザパッケージフォルダに追加されます。 作成が成功すれば、ツリービューにそのパッケージがリストされます。

    • New Package Archive…

      新しいパッケージアーカイブを作成/編集するダイアログが開きます。 このダイアログでは、新しいパッケージと一緒にHoudiniにプラグインをインストールするプラグインコンテンツフォルダを選択することができます。 コンテンツフォルダとパッケージファイルは、上記で説明した新しいアーカイブに格納され、そのアーカイブはユーザフォルダの packages/archives のディスクに保存されます。 オプションで、このコンテンツフォルダはアーカイブ内でルートフォルダとして含めることができます。 つまり、アーカイブをインストールすると、そのフォルダ自体がトップレベルに出現し、その中にすべてのサブフォルダとファイルが含まれています。 また、このコンテンツフォルダをアーカイブのルートとして除外することもできます。 その場合、そのフォルダの内容(サブフォルダとファイル)のみがアーカイブされます。 そのアーカイブをインストールすると、このコンテンツフォルダなしでその中のファイルとサブフォルダがトップレベルに直接出現します。

      Note

      アーカイブは、作成後にインストールされません。

    • Load Package…

      パッケージファイルを選択してロードするダイアログが開きます。 この操作が成功すれば、ロードされたパッケージがツリービューにリストされます。

    • Install Package Archive…

      パッケージアーカイブを選択してインストールするダイアログが開きます。 デフォルトでは、選択したパッケージアーカイブは、そのアーカイブが配置されている現行フォルダ下にインストールされますが、別のインストールフォルダを選択することもできます。 この操作が成功すれば、インストールしたパッケージファイルがツリービューにリストされます。

    • Reload Selected Package

      ツリービューで選択したパッケージをリロードします。 この操作が成功すれば、リロードしたパッケージがツリービューにリストされます。

    • Remove Selected Package

      ツリービューで選択したパッケージをアンロードし、ツリービューからそのパッケージを除去します。

    • Delete Selected Package

      ツリービューで選択したパッケージをアンロードし、そのパッケージファイルを削除します。

  • Edit

    • Edit Package File…

      ディスクからパッケージファイルを選択するダイアログが開き、そのパッケージのエディタが開きます。 エディタが一度閉じると、編集されたパッケージはブラウザにロードされません。

    • Edit Selected Package…

      ツリービューで選択されたパッケージを編集するエディタが開きます。 エディタが一度閉じると、編集されたパッケージはその新しい変更を反映してブラウザにロードされます。

ツリーノードメニュー

ポップアップメニューは、ツリービュー内のパッケージノード毎に利用可能で、以下のアクションが含まれています:

  • Edit: 大元のパッケージファイルを編集するエディタが開きます。

  • Expand All: ツリーノードとそのサブノードすべてを展開します。

  • Reload: 大元のパッケージをリロードします。

  • Remove: 大元のパッケージをアンロードし、ブラウザから除去します。

  • Delete: 大元のパッケージをブラウザから除去し、削除します。

ドラッグアンドドロップ

ブラウザ上へのドラッグアンドドロップがサポートされています。 以下は、パッケージとパッケージアーカイブのロードをドラッグアンドドロップで行なう方法を説明しています。

ファイル

メソッド

メモ

パッケージ(.json)

パッケージファイルをブラウザ上にドラッグしてマウスボタンを離すと、そのパッケージがロードされます。

アーカイブ(.zip)

アーカイブファイルをブラウザ上にドラッグしてマウスボタンを離すと、Installation Package Archiveダイアログが開き、そこでインストールフォルダを選択してAcceptボタンを押して、そのアーカイブをインストールします。

アーカイブ(.zip)

ALT +

ALTキーを押しながらアーカイブファイルをブラウザ上にドラッグしてマウスボタンを離すと、そのファイルの親フォルダ直下にそのアーカイブがインストールされます。

コンソール

コンソールウィンドウは、ランタイムエラー、警告、ユーザメッセージなどのメッセージのログに使用されます。

ウィンドウ