Python Mapper TOP node

Pythonスクリプトを使ってワークアイテムをマップします。

This node type is deprecated. It is scheduled to be deleted in an upcoming revision of Houdini.

Use partitioner nodes instead of mappers

(Since version 18.6.)

On this page	パラメータ Examples
Since	17.5

このノードを使用することで、Python APIによる独自のマッパーロジックを記述することができます。

PythonまたはHScriptエクスプレッションでコードを1行で記述できる場合であれば、代わりにMap by Expressionを使用した方がシンプルです。

パラメータ ¶

Save to Python Script

このノードで定義したコールバックをPythonスクリプトに保存します。このPythonスクリプトは、PDGによってインポートして登録することができます。このノードに関連付けられたパラメータテンプレートもPythonスクリプトに保存して埋め込まれます。保存した後は、そのスクリプトが自動的にインポートされ、そのノードタイプがTabメニューで利用可能になります。

Save to Digital Asset

このノードで定義されたコールバックをスタンドアローンのHoudiniデジタルアセットに保存します。このコールバックは、.hdaの中に格納され、PDGによって埋め込みPDGノードタイプとして登録されます。

onMapStatic Callback

このスクリプトは、上流の静的なワークアイテムを下流の静的なワークアイテムにマップする時に実行されます。このスクリプトは、静的なクック工程において常に1回だけ実行されます。

このスクリプトで利用可能な変数がいくつかあります:

self

TOPノードと関連付けられた大元のPDGノードを参照します。このPDGノードはTOPノード自体とは異なり、標準のHoudiniオペレータであることに注意してください。

TOPノードのパラメータインターフェースに追加したSpareパラメータは、自動的にPDGノードに追加されます。

upstream_items

上流の静的なワークアイテムのリスト。要するに、下流のワークアイテムの依存関係として追加可能なワークアイテムです。

downstream_items

下流の静的なワークアイテムのリスト。要するに、一部の上流の静的なワークアイテムに依存するマッパーより下流のワークアイテムです。

dependency_holder

依存関係の構築に使用するオブジェクト。例えば、上流の1番目のワークアイテムと下流の1番目のワークアイテム間に依存関係を追加したいのであれば、 dependency_holder.addDependency(upstream_items[0], downstream_items[0])のように記述することができます。依存側/依存される側の順番の指定は関係なくて、PDGでは、その依存関係を判定することができます。

onMapDynamic Callback

このスクリプトは、上流の動的なワークアイテムを下流の静的なワークアイテムにマップする時に実行されます。マッパーノードによって動的なワークアイテムが生成される際には、このスクリプトがクック時に何回も実行されます。

渡された動的なワークアイテムは、このスクリプトで選択された静的なワークアイテムより下流の動的なワークアイテムのみが考慮されるように、 onMapStatic スクリプトの結果によって事前にフィルタリングされます。