PDG検索パスからファイルを検索し、そのファイルの絶対パスを返します。 ファイルが見つからなかった場合、このメソッドはNoneを返します。

PDG検索パスから、subdirectory内にある指定したextensionの拡張子を持つすべてのファイルを検索します。 full_pathがTrueの場合、この関数は絶対パスのリストを返し、Falseの場合はファイル名のみのリストを返します。

ファイルが見つからなければ、リストは空っぽです。

PDGカスタムタイプ検索パス上のすべてのPythonモジュールを検索し、そのモジュール名のリストを返します。 これらのPythonモジュールは、$HOUDINI_PDG_DIR/typesにあります。

uniqueをTrueに設定すると、同じ名前のモジュールが検索パス上の別々の場所で複数見つかったとしても、固有のモジュール名のみが返されます。 Pythonは、同じ名前の複数のモジュールの中で検索パス順で最初に見つかったモジュールしかインポートすることができません。 uniqueをFalseに設定することで、そのような問題のデバッグをすることができます。

full_pathがTrueの場合、結果は絶対パスのリストで返されます。

PDG Pythonモジュールをインポートする時にスキップするファイルとディレクトリの名前のリストを返します。 このリストは、HOUDINI_PDG_TYPE_SKIPLIST環境変数を使用して定義します。

PDGノードタイプとPDGノードテンプレートの検索パスを返します。

グローバルタイプレジストリのインスタンスを返します。

ファイル拡張子からマッピングをファイルタグに追加します。

指定したtypeを親/互換ありとマークします。 typeにはpdg.BaseTypeインスタンスを、type_nameには既存タイプのstr名を指定してください。

指定したタイプを、指定したtypeの親/互換としてマークします。 typeにはpdg.BaseTypeインスタンスを、type_namesにはstrタイプ名のリストを指定してください。

該当するファイルの拡張子を外したタグを追加します。 このタグは、ファイルタグのグローバルリストに追加され、ファイル拡張子 → タグのマッピングには追加されません。

指定したファイルタグとビューアアプリケーション名(例えば、“mplay”や“gplay”)のマッピングを作成します。 このアプリケーションは、ワークアイテムInfoパネルからタグ付き出力ファイルを開いた時に使用されます。 multiviewerをTrueに設定すると、PDGは、アプリケーションにはファイル名のリストが渡されるものと想定し、同じアプリケーションインスタンス内で複数のファイルを開くようになります。

指定したファイル拡張子のファイルタグを返します。

指定した接頭辞のタグのリストを返します。例えば、file/geoやfile/image。

指定したタグのビューアアプリケーションが複数のファイルを開くことができる場合はTrueを返します。

指定したファイルタグがビューアに関連付けられていればTrueを返します。

例えば、デフォルトでfile/imageタグはHoudiniに同梱されているmplayアプリケーションを使ってビューイング可能なので、isViewable("file/image")はTrueを返します。 その一方で、isViewable("file/customfile")は、そのファイルタグ向けのカスタムビューアがインストールされていない限りFalseを返します。

指定したtype_nameのpdg.NodeCallbackTypeを返し、なければNoneを返します。

指定したファイルパスのファイルタグを返します。

指定したファイルパスのビューアアプリケーション名を返します。

指定したパスに対して既知のアーカイブ接尾辞(例えば、bgeo.sc)を付けることができれば、そのフル拡張子を返します。

シリアライズの過程でPDG Python Objectアトリビュートを読み込んで保存する際に使用されるモジュールの名前。 デフォルト値は空っぽの文字列です。これは、単純なreprとevalをベースにしたシリアライズスキームを使ってオブジェクトが保存されることを意味します。

指定したファイルタグのビューアアプリケーション名を返します。

指定したタグを使ってカスタムキャッシュハンドラーを登録します。 必要な出力ファイルがディスク上に存在するのかをワークアイテムがチェックする時、これは、ビルトインのキャッシュファイルチェックを呼び出す前にカスタムハンドラーをコールします。 ハンドラーは、指定したタグにより多くマッチしたものから優先してコールされます。

例えば、file/geo/collision出力タグを持ったファイルは、まず最初にfile/geo/collisionハンドラーをチェックし、次にfile/geoハンドラーをチェックします。 どれかのハンドラーがpdg.cacheResult.Hitまたはpdg.cacheResult.Missを返すと、評価が停止し、その結果が使用されます。 どのハンドラーもそれらの結果のどれかを返さなかった場合またはカスタムハンドラーが見つからなかった場合、PDGは、単にそのファイルがディスク上に存在するかどうかをチェックしてそのファイルをキャッシュ化するかどうかを決めます。

もっと例を知りたいのであれば、独自のファイルタグとハンドラーを参照してください。

カスタムワークアイテムをDirty handlerに登録します。 このハンドラーには関数またはコール可能オブジェクトを指定します。 この関数は、指定したhandler_typeに基づいてワークアイテムがDirty(変更あり)または削除される度にコールされます。 このhandler_typeにはpdg.dirtyHandlerTypeの値を指定します。 scheduler_filterとnode_filterの引数を使用することで、ハンドラーを、指定したタイプのノードまたはスケジューラが所有しているワークアイテムに制限することができます。 handler_typeにpdg.dirtyHandlerType.Filesを設定し、requires_outputsをTrueにすると、ワークアイテムの1つ以上のファイルが削除された場合にのみハンドラーがコールされます。 is_globalフラグをTrueにすると、ワークアイテム毎ではなく、ワークアイテムの数に関係なく、Dirtyオペレーションの度に1回だけハンドラーが呼び出されます。

例えば、以下のハンドラーは、ropfetchノードのワークアイテムが削除される度にコールされます:

def func(work_item, file_list):
    print(work_item)

type_registry.registerDirtyHandler(func, handler_type=pdg.dirtyHandlerType.Delete, node_filter=['ropfetch'])

#deprecated

この関数は廃止されました。代わりにpdg.TypeRegistry.registerStatHandlerを使用してください。

グラフがクックされる度に呼び出されるカスタム関数を登録します。 この関数は、グラフクック内の他のオペレーションが実行される前にコールされます。 generate_graphがTrueの場合、静的なワークアイテムが生成された後に、このハンドラー関数がコールされます。 この関数がFalseを返した場合、または、例外を引き起こした場合、グラフはクックを続けません。

例えば、以下のpreflightハンドラーは、グラフに関する基本的な情報をプリントした後にクックを開始します:

import pdg

def preflight(context, options):
    print("Preflight for context {}".format(context.name))
    print(options)

    for node in context.graph.nodes():
        print("Node: {} ".format(node.name))
        print("Work Items: {}".format(node.workItems))

return True

type_registry.registerPreflightHandler(preflight, True)

Houdiniを起動した時に独自ハンドラーをインストールする方法の例は、独自のファイルタグとハンドラーを参照してください。

指定したタグを使ってカスタムファイル統計用関数を登録します。 ハッシュ値もファイルサイズ値もないファイルがワークアイテムに追加されると、PDGは、そのファイルのハッシュ値/ファイルサイズ値を決めるために、指定したタグにマッチしたカスタム統計用関数を呼び出します。 ハンドラーは、指定したタグにより多くマッチしたものから優先してコールされます。 統計用関数が追加されていない場合、または、どもカスタム統計用関数もファイルタグにマッチしなかった場合、ファイルの更新時刻とディスク上のファイルサイズを使用するビルドインメソッドが代わりに使用されます。

例えば、file/geo/collision出力タグを持ったファイルは、まず最初にfile/geo/collisionハンドラーをチェックし、次にfile/geoハンドラーをチェックします。 マッチした統計用関数がハッシュ/サイズのどちらかでゼロ以外の値を返せば、その値が使用され、他のカスタム関数はコールされません。 カスタム統計用関数がどちらもゼロを返せば、PDGはゼロ以外の値を返す関数が見つかるまでマッチした関数のリストを掘り下げ続け、最終的にはビルドインの更新時刻の実装を使用します。

統計関数がハッシュ/サイズの片方で値を返しもう片方で値を返さない場合、PDGはビルトインのロジックを使用してその足りないフィールドを計算します。

たくさんのサンプルは、独自のファイルタグとハンドラーを参照してください。

指定したモジュールからカスタムタイプを登録します。

指定した共有ライブラリパスからC++タイプを読み込みます。

カスタムノードタイプを登録します。 type_objectにはPythonクラスオブジェクトを、node_typeにはpdg.nodeTypeを指定してください。

デフォルトでは、nameとlabelには小文字でそのPythonクラス名が設定され、categoryは空っぽのままになります。 static_genフラグは、このノードの Generate When パラメータをAutomaticに設定した時に静的ワークアイテムの生成を優先させるのかどうかを指定します。

指定したパスのPythonモジュールから、登録されたタイプを読み込みます。

カスタムスケジューラタイプを登録します。 type_objectにはPythonクラスオブジェクトを指定してください。 デフォルトでは、nameとlabelとcategoryには小文字でそのPythonクラス名が設定されます。 categoryは、スケジューラのプロパティ(Job Parms)の配置先を決めるのに使用され、それらのプロパティのspare_categoryに相当します。 node_categoryは、HoudiniのTabメニュー内でこのノードが見つかる場所です。

ノードがワークアイテムの再生成をする必要がある時に呼び出されるカスタムハンドラーを登録します。 このハンドラーによって、PDGはワークアイテムの再生成プロセスを完全にスキップしたり、または、再生成を有効にしつつアトリビュートの変更が原因のキャッシュファイルの無効化をスキップすることができます。

このハンドラーには、2つの引数(ノードとワークアイテムのリスト)を受け取る関数を指定してください。 その関数は必ずpdg.regenerateResultで定義された列挙エントリーのどれかを返してください。

ワークアイテムまたはスケジューラがファイルをリモートディレクトリにコピーする必要がある時に呼び出されるカスタムハンドラーを登録します。 そのカスタムハンドラーは、必要に応じてファイルをコピーするのか、それとも、デフォルトのファイルコピーロジックに依存するのか選択することができます。 そのカスタムハンドラーは、指定したtagで始まるファイルに対してのみコールされます。

use_mod_timeがTrueの場合、そのカスタムハンドラーはさらにPDGが内部で使用している変更時刻キャッシュ化ロジックを使用します。 Falseの場合、そのカスタムハンドラー関数は、ファイルを再度コピーする必要があるのか判断するための独自のキャッシュ化ロジックを組む必要があります。

指定したpdg.registeredTypeとタイプ名のPDGタイプオブジェクトを返します。

カスタムワークアイテムタイプを登録します。 type_objectにはPythonクラスオブジェクトを指定してください。 デフォルトでは、nameとlabelには小文字でそのPythonクラス名が設定されます。

カスタムサービスタイプを登録します。 type_nameは、そのサービスタイプの識別子で、固有な名前にしてください。 type_labelは、そのサービスに関して人に分かりやすい名前を指定してください。 commandは、PDGサービスマネージャがクライアントインスタンスを起動するのに必要なコマンドライン引数を指定した文字列を指定してください。

Pythonを介して登録済みのすべてのカスタムハンドラー(例えば、キャッシュハンドラー、ファイル統計ハンドラー、事前点検ハンドラー)をリロードします。 それらのハンドラーが定義されているモジュール(s)もリロードされるので、ディスク上のスクリプトファイルへの変更もPDGで反映されます。 existingがTrueに設定されていれば、PDGは、以前に登録されていて且つ最低でも1個のカスタムハンドラーを含んでいるモジュールのみをリロードします。 existingがFalseに設定されていれば、PDGは、検索パス上のすべてのモジュールをリロードし、それらのモジュール内で見つかったすべてのハンドラーを再登録します。

指定したtype_nameのpdg.SchedulerTypeを返し、なければNoneを返します。

指定したtype_nameのpdg.ServiceTypeを返し、なければNoneを返します。

デフォルトのワークアイテムタイプを、指定したpdg.WorkItemTypeオブジェクトに設定します。

Pythonオブジェクトアトリビュートをシリアライズ/デシリアライズする際に使用するモジュールの名前を設定します。 ファームに送信するワークアイテムデータを保存する時、デフォルトでは、オブジェクトのreprが使用されます。 カスタムモジュール名を指定すると、代わりにそのモジュール内のdumps関数とloads関数を使用して、それぞれオブジェクトの保存と読み込みを行ないます。 例えば、このモジュールにpickleを設定することで、Pythonのビルトインのシリアライゼーションを利用することができます。 別の方法として、モジュール内に独自のシリアライゼーションを記述して、HoudiniのPythonパスからそのモジュールにアクセスすることもできます。

すべてのファイルタグのグローバルリスト。

指定したpdg.registeredTypeのタイプ名のリスト。 include_aliasesがTrueの場合、他の具体的なタイプのエイリアスであるタイプ名までもが出力リストに含まれます。

指定したtype_nameのpdg.WorkItemDataTypeを返し、なければNoneを返します。