primpathパラメータがデフォルトの/$OSになっている新しいLOPノードでデフォルトで使用されるUSD Primパスを返します。

primpathパラメータがデフォルトの/$OSになっている新しいLOPノードでデフォルトで使用されるUSD Primパスを設定します。 これは、新しいUSD Primの作成で使用されるパラメータを特定します。 このデフォルトを制御することができることで、Primパスをスタジオ標準の命名規則に準拠させるのが簡単になります。

新しいコレクションの作成時にデフォルトロケーションとして使用されるUSD Primパスを返します。 設定されていなければ、そのデフォルト値は/collectionsです。

新しいコレクションの作成時にデフォルトロケーションとして使用されるUSD Primパスを設定します。 このデフォルトを制御することができることで、Primパスをスタジオ全体の標準命名規則に準拠させるのが簡単になります。

Destination Primitiveがまだ存在しない時にコレクションを格納するために作成されるUSDプリミティブタイプを返します。 そのUSDプリミティブタイプが設定されていない場合、このデフォルト値は空っぽの文字列で、タイプなしのPrimが作成されることを意味します。

Destination Primitiveがまだ存在しない時にコレクションを格納するために作成されるUSDプリミティブタイプを設定します。 このデフォルトを制御することができることで、使用するUSDプリミティブタイプをスタジオ標準の規則に準拠させるのが簡単になります。

新しいライトの作成時にデフォルトロケーションとして使用されるUSD Primパスを返します。 設定されていなければ、そのデフォルト値は/lightsです。

新しいライトの作成時にデフォルトロケーションとして使用されるUSD Primパスを設定します。 このデフォルトを制御することができることで、Primパスをスタジオ全体の標準命名規則に準拠させるのが簡単になります。

新しいカメラの作成時にデフォルトロケーションとして使用されるUSD Primパスを返します。 設定されていなければ、そのデフォルト値は/camerasです。

新しいカメラの作成時にデフォルトロケーションとして使用されるUSD Primパスを設定します。 このデフォルトを制御することができることで、Primパスをスタジオ全体の標準命名規則に準拠させるのが簡単になります。

トランスフォームアトリビュート名のデフォルトの接尾辞として使用される文字列を返します。

トランスフォームアトリビュート名のデフォルトの接尾辞として使用される文字列を設定します。 USDトランスフォームは常にxformOp:で始まり、続いてトランスフォームタイプ(translate, rotate, transform)、そしてオプションでトランスフォームを表現した接尾辞が付きます。 この文字列は、この接尾辞を指定できる状況でHoudiniが使用するデフォルト値で、 LOPsで編集されたUSDレイヤーをスタジオ全体の標準命名規則に準拠させるのに役立ちます。

解決済みレイヤーファイルパスを表示するオプションが有効になっていればTrueを返します。

レイヤーファイルパスを表示するパネルがそのレイヤー上に設定されているそのままのパスを表示するのか、または、USD Path Resolverを介させた後のパスを表示するのかを制御するためのオプションを設定します。 解決済みパスは、通常ではディスク上のファイルのフルパスです。 一方で解決前のパスは、相対パス、検索パス、カスタムResolverで指定したパスフォーマットのどれかです。

Scene Graph TreeペインやScene Graph DetailsペインなどのLOPペインがネットワークエディタで選択された現行ノードに追従するようになっていればTrueを返します。

Scene Graph TreeペインやScene Graph DetailsペインなどのLOPペインがネットワークエディタで選択された現行ノードに追従するように設定します。 Falseに設定すると、代わりにこれらのペインは、ディスプレイフラグが設定されたLOPノードの情報を表示します。

Scene Graph TreeやScene Graph DetailsなどのLOPペインが、Scene Graph Tree内で設定されたビューポートオーバーライドを適用することで生成されたUSDステージに関する情報を表示するようになっていればTrueを返します。

Scene Graph TreeやScene Graph DetailsなどのLOPペインに対して、Scene Graph Tree内で設定されたビューポートオーバーライドを適用することで生成されたUSDステージに関する情報を表示するオプションを設定します。

このオプションを無効にすると、ビューポートオーバーライドがシーンに適用されている時のそれらのペインのパフォーマンスが向上します。 その代償として、Scene Graph TreeやScene Graph Details内に表示されている可視性とアクティベーションの値がビューポート内に表示されているものと一致しなくなる可能性があります。 とはいえ、ビューポートオーバーライドは最終レンダリングに送信されるUSDには含まれないので、最終レンダリングに使用されるシーン記述に合わせる方が良いでしょう。

Scene Graph TreeやScene Graph DetailsなどのLOPペインが、何かしらのポストレイヤーを親のLOP Networkに適用することで生成されたUSDステージに関する情報を表示するようになっていればTrueを返します。

Scene Graph TreeやScene Graph DetailsなどのLOPペインに対して、何かしらのポストレイヤーを親のLOP Networkに適用することで生成されたUSDステージに関する情報を表示するオプションを設定します。

Sublayer LOPやReference LOPがディスクから読み込まれた1番目のUSDレイヤーを、USDステージに渡されるResolverコンテキストアセットパスとして使用してそのAsset Resolverコンテキストを自動的に定義するようになっていればTrueを返します。

Sublayer LOPやReference LOPがディスクから読み込まれた1番目のUSDレイヤーを、USDステージに渡されるResolverコンテキストアセットパスとして使用してそのAsset Resolverコンテキストを自動的に定義するようする場合はTrueの値を渡します。 このResolverコンテキストは、特定のステージのコンテキスト内でレイヤーファイルを開く時に正しいファイルが見つけられるようにUSD Asset Resolverで使用されます。 たいていの場合、このResolverコンテキストは、ステージの“ルート”レイヤーを見ることで決めることができます。 LOPsの場合では、Sublayer LOPやReference LOPで読み込まれた1番目のレイヤーがその“ルート”レイヤーに一番近いものです。 このプリファレンスは、このワークフローの実装を簡単にします。 別の方法では、Configure Stage LOPをLOPネットワーク内の1番目のノードとして使用して、明示的にResolverコンテキストアセットパスを設定する必要があります。 同様に、このオプションは、Sublayer LOPまたはReference LOPがノードチェーンの1番目のノードだった場合にそれらのLOPにのみ影響します。

LOPビューポートがバックグラウンドで更新タスクを実行するように設定されていればTrueを返します。

LOPビューポートがバックグラウンドで更新タスクを実行するようにさせる場合はTrueの値を渡します。 これによってインタラクティブ性が良くなりますが、ビューポート表示が現行クックされているLOPステージと一時的に同期しません。

ビューポート内ですべてのペイロードを読み込むオプションを有効にして新しいLOPネットワークが作成されるようになっていればTrueを返します。

ビューポート内ですべてのペイロードを読み込むオプションを有効にして新しいLOPネットワークが作成されるようにする場合はTrueの値を渡します。 新しいLOPネットワークに対してビューポート内でのペイロードの読み込みを無効にする場合はFalseの値を渡します。 既存のLOPネットワークは、このメソッドから何も影響を受けません。 このプリファレンスのデフォルト値はTrueです。

Configure Stageノードによってビューポートにロードされないように設定されているペイロードを、Scene Graph Treeがユーザ側で強制的にそのペイロードをビューポートにロードすることを許可していればTrueを返します。 Scene Graph Treeがそのようなペイロードの明示的なロードを許可していなければFalseを返します。 False値ならば、ビューポートはLOPネットワークで処理されたペイロードのみが表示されることが保証されていることを意味するので、そのビューポートに表示されているシーンとLOPネットワークで処理されたペイロードを使ってUSD Render ROPがレンダリングするシーンとの間でロードされたペイロードが異なるというミスマッチの発生がありません。

Configure Stageノードでアンロードとして指定されたペイロードをビューポートにロードすることを許可するかどうかを示したフラグを設定します。

USD Primitive Pathパラメータが構文ハイライトとプリミティブパス補間ヒントを提供するようになっている場合はTrueを返します。 これが有効になっていることが原因で、非常に大きなUSDステージでPrimitive Pathパラメータを編集する時に一時停止する可能性があります。

USD Primitive Pathパラメータがパス補間ヒントを提供するかどうかを指示したフラグを設定します。

この値を明示的に設定していないUSDレイヤーに保存されるユニットメートルあたりのデフォルトのメートルを返します。 0の値は、Houdiniの“Unit Length”オプションを使用してそれと等価のユニット値あたりのメートルが生成されることを意味します。

この値を明示的に設定していないUSDレイヤーに保存されるユニットメートルあたりのデフォルトのメートルを設定します。 0の値は、Houdiniの“Unit Length”オプションを使用してそれと等価のユニット値あたりのメートルが生成されることを意味します。

この値を明示的に設定していないUSDレイヤーに保存されるデフォルトのUp軸の値を返します。 空っぽの文字列は、USD Up軸の代替値(pxr.UsdGeom.GetFallbackUpAxis)が使用されることを意味します。

この値を明示的に設定していないUSDレイヤーに保存されるデフォルトのUp軸の値を設定します。 空っぽの文字列は、USD Up軸の代替値(pxr.UsdGeom.GetFallbackUpAxis)が使用されることを意味します。 他に対応している値は、YとZです。 それ以外の他の値を設定すると、hou.ValueError例外が引き起こされます。

現在のLOPプリファレンスを$HOME/houdiniX.Y/solaris.prefに保存します。 これは、それらのプリファレンスがPreferencesダイアログで変更された時、または、Houdiniを終了した時に自動的に行なわれます。 しかし、バッチスクリプト環境では、それらのプリファレンスに変更を加えても自動的に保存されないので、このメソッドを使用する必要があります。 プリファレンスファイルの保存に成功すればTrueを返します。

これらのプリファレンスのどれかが変更される度に呼び出されるコールバック関数を登録します。

以前にaddPreferenceChangeCallbackコールで登録されたコールバック関数の登録を解除します。

指定したノードのシェーダトランスレータのIDを返します。 このIDはHoudiniセッションに固有の値で、セッション間で変わります。

指定したノードと出力のレンダーコンテキスト名を返します。 この名前は、USD Material Prim出力名で使用され、接続されたシェーダを指定したレンダラーに関連付けます。

新しいシェーダPrimを作成し、そのシェーダPrim出力のパスを返します。

既知のシェーダ変換のテーブルにエントリーを追加します。 これによって、LOPsは、シェーダの増分の再変換に必要となるシェーダVOPが与えられたUSDシェーダPrimを見つけることができます。

指定したシェーダ名のシェーダのhou.NodeTypeを返します。

シェーダ名は、抽象シェーダエンティティの汎用識別子であり、返されるノードタイプは、そのタイプのノード形式でのシェーダ表現です。

例えば、fooシェーダは、my_namespace::FooShader::2.0タイプのVOPノードに呼応します。

USDステージ上のプロパティを指定すると、このメソッドは、そのUSDプロパティを制御するEdit Properties LOPノード上に配置可能なパラメータを表現したhou.ParmTemplateGroupオブジェクトを返します。

ソースノードパラメータを与えると、このメソッドは、そのパラメータに呼応したUSDプロパティの値を制御するEdit Properties LOPノードに配置可能なパラメータを表現したhou.ParmTemplateGroupオブジェクトを返します。

返されたグループには、USDプロパティの変更方法と値パラメータを表現したコントロールパラメータが含まれています。 このコントロールパラメータは、disable-when条件用であることとその他のいくつかの小さな違いを除いて、指定されたパラメータと非常に似ています。

Given a property on a USD stage, this method returns a hou.ParmTemplateGroup object that describes the parameters that can be placed on an Edit Properties LOP node to modify the connection of that USD (destination) property to a source attribute.

source: Either a hou.LopNode object or a string. If a hou.LopNode, the property is extracted from the USD stage owned by that LOP node. If a string, the USD file on disk at the specified path will be loaded, and the property extracted from there.

primpath: Path to the USD primitive where the property lives.

propertyname: The name of the USD property for which parameters will be created.

parametername: The name of the parameter to generate. This value can be a string or None, in which case the parameter name will be based on the property

prepend_control_parm: Set to True if the returned parameter template group should include a menu for choosing whether the property connection should be set,

USD Prim上のプロパティの値からノードパラメータタプルの値を設定します。 パラメータのデータタイプとUSDプロパティのデータタイプに互換性がないことが原因でそのパラメータを設定することができない場合、または、そのUSDプロパティが見つからない場合は、hou.OperationFailedの例外が引き起こされます。

This helper method makes it easier to author stage variable expressions for use in USD files. Stage variable expressions are evaluated by USD at stage composition time. They contain a limited set of functions, and allow accessing stage variables which can be set using a Configure Layer node. The full capabilities and syntax of such stage variable expressions is described in the USD documentation, but it is enough to know that the format closely resembles Houdini’s hscript expression language. As such, it can be difficult to specify a stage variable expression in a Houdini parameter without using complex sequences of escape characters.

Take for example the case where you want to reference in a texture map using the following very simple stage variable expression:

`"/project/car/${textureLOD}/decal.exr"`

Note that the backticks around the expression are required to let USD identify this as a stage variable expression. The double quotes indicate that the value of the stage variable expression is a simple string constant, not using any expression functions. Further suppose that your hip file is in /project/car, and you'd like to use the Houdini $HIP variable to express this part of the path. To get this stage variable expression into your USD file, the texture path parameter on a VOP node would need to be:

\`"$HIP/\${textureLOD}/decal.exr"\`

The escape characters make this string somewhat difficult to read, and it may be hard to remember the all the required formatting. The stageVariableExpression python function allows you to set the parameter to evaluate as the following python expression:

hou.lop.stageVariableExpression('"`$HIP`/${textureLOD}/decal.exr"')

The final expression will be identical but note that there are no escape characters, and no need to remember the surrounding back ticks. Instead, the back ticks are used to tell the stageVariableExpression method which parts of the string should be evaluated as hscript expressions.

The sve method also exists as an alias for this funciton, making the resulting python expression much more compact.

This method is simply a shorter alias for the stageVariableExpression method. See help on that method for a full description of its operation.

登録されているレンダラープラグインのメタデータを含んだ辞書のリストを返します。

登録されているレンダラープラグインの表示ラベルを含んだタプルを返します。

登録されているレンダラープラグインの内部名を含んだタプルを返します。

nameパラメータに合致した内部名を持つ出力プロセッサを設定する際に使用可能なパラメータを返します。 出力プロセッサに関する情報は、USD ROPを参照してください。

レジストリ内の各出力プロセッサプラグインの内部名とユーザーから見えるラベルを含んだタプルを返します。 出力プロセッサに関する情報は、USD ROPを参照してください。

この関数は、指定した文字列が有効なプリミティブパスの一部として使用できるように有効なUSDプリミティブ名の要件を満たすことを保証します。 スペースやたいていの句読点などの無効な文字はアンダースコアに変換されます。そのため、変換後の文字列は元の文字列に戻すことができないことに注意してください。 元の文字列が既に有効なプリミティブ名だった場合、その名前がそのまま返されます。

この関数は、指定したパスがpsx.Sdf.Pathオブジェクトに変換できる有効なUSDプリミティブパスの要件を満たすことを保証します。 スペースやたいていの句読点などの無効な文字はアンダースコアに変換されます。そのため、変換後のパスは元のパスに戻すことができないことに注意してください。 元のパスが既に有効なプリミティブパスだった場合、そのパスがそのまま返されます。

allow_relative値がTrueの場合、そのパスには相対プリミティブパスが許可されます。 相対プリミティブパスとは、./とか../から始まるパスのことです。 この引数がFalseの場合、(/から始まる)絶対パスのみが許可されます。 Falseの場合、単にそのパスから相対パス接頭辞が除去され、常に/から始まるパスが返されます。

このメソッドは、指定したレイヤーパスに対してUSD Reloadメソッドをコールします。 さらに、Houdiniのリロードの内部データ構造更新します。 Houdiniでリロードを実行する時は、このメソッドをpxr.Sdf.Layer.Reloadまたは同様のメソッドの代わりに使用してください。

recursive パラメータをTrueに設定すると、Houdiniは、指定したレイヤーで参照されている他のレイヤーを再帰的に検索して、それらのレイヤーもリロードします。

Houdiniに搭載されているUSDライブラリに関する情報を含んだ辞書を返します。

packageurlとpackagerevisionの値は、Houdiniに同梱されているUSDライブラリが独自のUSDビルドに置換されている場合には、空っぽの文字列を返します。

標準出力に出力される最低USDメッセージ重要度を返します。 USDライブラリは、エラー状態、警告状態、または、単にステータスメッセージを示した色々なメッセージを生成することができます。 LOPノードをクック中にそのようなメッセージが生成された場合では、この設定に関係なく、そのメッセージはコンソールに決して出力されません。

標準出力に書き出されるUSDライブラリが生成する最低メッセージ重要度を設定します。 このメソッドは、LOPノードがクックしていない時に生成されたメッセージの出力のみを制御します。

USDリファレンスまたはサブレイヤーとして使用できるようにhou.Geometryのロックされたコピーをレジストリに追加します。

返される文字列は、コンポジションアークを追加する時に使用可能なUSDレイヤー識別子です。

args辞書を指定する場合、その内容を事前に文字列に変換しておく必要があります。 例えば、{ 't': '1.0' }は有効ですが、{ 't': 1.0 }は無効です。

例:

from pxr import Usd
geo = hou.Geometry()
geo.loadFromFile('shaderteapot.bgeo')
stage = Usd.Stage.CreateInMemory()
layer_id = hou.lop.addLockedGeometry('teapot', geo)
stage.GetRootLayer().subLayerPaths.append(layer_id)

hou.LopNode.addLockedGeometryも参照してください。

レジストリからロックされたhou.Geometryを削除し、成功または失敗を示したboolを返します。

例:

geo = hou.Geometry()
geo.loadFromFile('shaderteapot.bgeo')
layer_id = hou.lop.addLockedGeometry('teapot', geo)
hou.lop.removeLockedGeometry(layer_id)

Reload系パラメータを持つすべてのLOPノードの“Reload”ボタンを押します。 reload_viewportsパラメータがTrueの場合、このメソッドは、シーンビューアペインが所有しているすべてのUSDステージもクリアします。 これによって、Houdini内のすべてのUSDステージが実質的にゼロから再構築されます。 これは非常に処理のかかる操作になる可能性がありますが、Asset Resolverの構成が変更された時などの一部のケースにおいて、USDを強制的にリロードして、ディスク上のアセットのパスを再解決する必要があります。