LOPノードを使って表現するのが難しい技術的タスクまたは統合タスクには、このノードを使用してUSD APIのフルパワーを使ってシーングラフツリーを読み込んで修正したり、HOMのパワーを使って残りのHoudiniにアクセスしてコントロールすることができます。もちろん、Pythonとそのライブラリのフルパワーを使って外部データにアクセスしてパイプラインや他のシステムに統合することもできます。

このノードは、独自のパイプライン固有のタスクをスクリプト化するのに役立つ事が多いです。

APIのヘルプはPixarのPython APIチュートリアルを参照してください。

• hou.pwd()をコールすることで、このノードの参照をhou.Nodeとして取得することができます。 この参照を介して現行ステージ も 取得することができます(以下参照)。 さらには、この参照を使ってこのノードに追加されているSpareパラメータにアクセスすることができます。

• hou.pwd().editableStage()をコールすることで、編集可能なpxr.Usd.Stageオブジェクトを取得することができます。 このオブジェクトは、このノードの出力(APIによって加えられた変更を含みます)を表現しています。

  (USD Edit Targetは自動的にアクティブレイヤーに設定されます。 このEdit Targetを変更しないでください 。変更してしまうと予期しない間違った結果を招いてしまいます。)

• hou.pwd().inputs()[0].stage()をコールして入力ステージを読み込み、次に、評価されたプリミティブパターンまたは他の値をスタッシュ(保存)した **後に** hou.pwd().editablestage()をコールしてください。順番を誤ってこの処理が行なわれても、通常ではHoudiniはそのコードを実行しますが、効率が低下します。

• Usd APIsを使ってステージを制御する 代わりに 、ローレベルのSdf APIsを使ってアクティブレイヤーを編集することができます。 同じスクリプト内で両方の処理を制御することはできません。

• ローレベルAPIsの方を好む理由があれば、おそらくアクティブレイヤーだけをスクリプト化したいことでしょう。 pxr.Usdメソッドは、非常に使い勝手の良いハイレベルメソッドです。 pxr.Usdメソッドは、エラーチェックやデータの有効性を実行する処理が多いです。 しかし、pxr.Sdf APIsは劇的に高速で、特に新しいUSD Primsを作成する時がそうです。

• アクティブレイヤーの編集可能なpxr.Sdf.Layer参照を取得したいのであれば、hou.pwd().editableLayer()をコールします。 これをコールした場合、同じスクリプト内でhou.pwd().editableStage()をコール しないでください (コールした場合は単にNoneが返されます)。

• The returned editable layer is not on any USD stage while the python LOP is cooking, so there is no need to use Sdf.ChangeBlock objects to batch change notifications when making edits.

• After calling editableLayer, you may call hou.pwd().uneditableStage() to get access to a read-only Usd.Stage. This stage will be the output of the node connected to this node’s input. But unlike calling hou.pwd().stage() or hou.pwd().input(0).stage(), this approach will not trigger recursion errors or warnings about getting a read lock for an already locked stage. The returned stage can be used to access information about the current state of the stage to inform the edits being made to the editable layer. Because the editable layer is not composed onto this uneditable stage, changes made to the layer will not affect the content of this stage.

• コードを編集する時、このノードは、エディタ外をクリックまたはAlt + Enterを押した時にクックします。

• このノード上にSpareパラメータを追加することで、このノードにグラフィカルインターフェースを追加することができます。 例えば、Primパスを受け取るprimpathという名前のテキストボックスを追加することができます。 これによって、スクリプト内でそのパラメータ値にアクセスすることができます:

  node = hou.pwd()
  primpath = node.evalParm("primpath")
  

• 作成した便利なPython Scriptノードを共有したい場合、そのノードインスタンスをLOPデジタルアセットに変換することができます。 ネットワークエディタ内でそのノードを右クリックして、 Create Digital Asset を選択します。 このスクリプトがデジタルアセットの一部として格納され、このノードも同じように動作しますが、共有とバージョン管理が可能なアセットとして機能します。

• エディタの右側にあるポップアップメニューボタンは、Houdiniパス内のPythonScripts.txtファイルからスニペットを取り込みます。 $HOUDINI_USER_PREFS_DIR/PythonScripts.txtファイルを作成し、そのテキストにスニペットを追加すれば、このメニューにそれらのスニペットが表示されます。 $HFS/houdini/PythonScripts.txtを読んで、必要なファイル形式を確認してください。

• スクリプトで“何とかのPrimsすべてを検索”する必要がある場合、USDの走査系メソッドを使用するよりも、hou.LopSelectionRuleを使用することを考慮してください。 hou.LopSelectionRuleオブジェクトは、HoudiniのUSDプリミティブパターンマッチを実装しています。 このオブジェクトはSdf.Pathオブジェクトのリストを生成します。 stage.GetPrimAtPath(pathstring)を使用することで、Sdf.PathをUsd.Primオブジェクトに変換することができます。 この手法を使用すると、入力ノード上の選択ルールを評価したり、pwd().editableStage()が返すUsd.Stage上の選択ルールを直接評価することができます。 入力ノードを使用する場合、入力ステージの重い複製を回避するために、このノードの編集可能ステージを取得する前に選択ルールを評価してください。

• It is almost always a bad idea to call hou.setContextOption() from within the script of a Python LOP. This causes a global context option to be created. Global context options are accessible anywhere in the hip file, which means cooking this LOP and running its script can potentially cause nodes anywhere else in the hip file to become dirty, if they use this context option. Further, the global context option will only be set when the node cooks, but changing the global context option value in the context option editor or using Python code (in a python shell or in another Python LOP) will not dirty this node, and so it will not recook and reset the option value as might be expected. Instead, setting context options locally within a LOP network should be done using the Edit Context Options LOP.

• ステージのルートレイヤーを編集しないでください。このルートレイヤーはPython APIからアクセスできますが、このLOPクックの構造上、どの単一LOPノードからも干渉されないようにそのルートレイヤーを自由に管理できる必要があります。この間違いを招いてしまうよくある使い方は、サブレイヤーをルートレイヤーに追加したい時です。サブレイヤーをルートレイヤーに追加したいのであれば、代わりにhou.LopNode.addSubLayerメソッドを使用すると良いでしょう。