このノードの特定の出力のデータを可視化するためのノードを作成します。 現行ネットワーク内に既にビジュアライザノードが存在する場合には、そのビジュアライザノードが、ここで指定したoutput_indexに移動して接続されます。 このメソッドは、SOPとVOPのノードに対してのみ実行されます。 他のノードタイプに対しては、このメソッドをコールしても何も実行されません。

このノードをノード階層内の新しい場所にコピーします。destination_nodeの中に新しいノードが配置されます。 このメソッドは、その新しいノードを返します。

destination_nodeに新しいノードを配置することができなかった場合はhou.OperationFailedを引き起こします。 ロックされたアセットの中にdestination_nodeがあった場合はhou.PermissionErrorを引き起こします。

指定したパスのパラメータを返します。そのパラメータが存在しなかった場合はNoneを返します。

パターンに一致したパラメータのタプルを返します。

パターンには、スペース区切りで複数のピースを含めることができます。 パターンピース内のアスタリスク(*)は、どの文字にも合致します。 デフォルトでは、Houdiniは、各パターンピースで既に合致したパラメータを追加します。 しかし、そのパターンピースがキャレット(^)で始まっていれば、Houdiniは、その結果からそのピースの合致を排除します。

デフォルトのパターンマッチは、大文字小文字を区別します。 大文字小文字を区別せずにパターンマッチングを行なうには、ignore_caseをTrueに設定します。 この設定は、ノード名のマッチングの時にだけ大文字小文字の区別をしない事に注意してください。 グループ、ネットワークボックス、バンドル名のマッチングでは、大文字小文字の区別がされます。

デフォルトでは、パターンに合致した名前のパラメータのみが返されます。search_labelをTrueに設定すれば、パターンに合致したラベルのパラメータも返されます。

single_patternがTrueの場合、パターンをスペースで区切っても、そのパターンは1パターンとして扱われます。

このメソッドは、空っぽのパターンを指定した場合に空っぽのタプルを返します。

指定したパラメータを評価し、その結果を返します。

このノード上のパラメータのリストを返します。

このノードを参照しているパラメータのリストを返します。

このノード内に含まれたすべてのノード(このノードを含む)のパラメータすべてのシーケンスを再帰的に返します。

このメソッドはジェネレータであり、タプルを返しません。

以下は、/obj下のすべてのノードのパラメータパスを出力した例です:

root_node = hou.node("/obj")
for parm in root_node.allParms():
    print parm.path()

Parm名と値をマッピングした辞書を指定すると、このノード上のそれに相当する各Parmを、その辞書で指定された値に設定します。

以下のサンプルは、一度にtxとsyのパラメータを設定します:

>>> node = hou.node("/obj").createNode("geo")
>>> node.setParms({"tx": 1, "sy": 3})

Parm名はパラメータとパラメータタプルのどちらにも試されるので、ベース名も使用することができます:

>>> node = hou.node("/obj").createNode("geo")
>>> node.setParms({"t": (1, 2, 3), "s": (3, 3, 3)})

パラメータ名のどれかが無効の場合、hou.OperationFailedを引き起こします。

setParmExpressionsメソッドも参照してください。

Parm名と値をマッピングした辞書を指定すると、このノード上のそれに相当する各Parmの保留値を設定します。 パラメータとパラメータタプルのどちらにも対応しています。

パラメータ名のどれかが有効でなかった場合は、hou.OperationFailedを引き起こします。

setPendingメソッドも参照してください。

Parm名とエクスプレッション文字列をマッピングした辞書を指定すると、このノード上のそれに相当する各Parmを、その辞書で指定されたエクスプレッション文字列に設定します。

languageとreplace_expressionsのParmに関しては、hou.Parm.setExpressionを参照してください。

以下のサンプルのエクスプレッションは、一度にtxとsyのパラメータを設定します:

>>> node = hou.node("/obj").createNode("geo")
>>> node.setParmExpressions({"tx": 'ch("ty")', "sy": "sin($F)"})

パラメータ名のどれかが無効の場合、hou.OperationFailedを引き起こします。

setParmsメソッドも参照してください。

指定したパスでのパラメータタプルを返し、それがなければNoneを返します。

このメソッドはparm()と同様ですが、hou.Parmの代わりにhou.ParmTupleを返します。

指定したパラメータタプルを評価し、その結果を返します。

このノード上のパラメータタプルすべてのリストを返します。

このメソッドはparms()と同様ですが、hou.Parmの代わりにhou.ParmTupleを返します。

このノード上のフォルダ内のパラメータのリストを返します。 フォルダと(あれば)そのサブフォルダ内のパラメータすべてを返します。

folder_namesで指定したフォルダが存在しなかった場合は、hou.OperationFailedを引き起こします。

例えば、ノードのRenderフォルダにShadingサブフォルダが含まれていると仮定します。 以下のコードの行は、そのRenderフォルダ内のパラメータを返します:

# "Render"の後のカンマは、その"Render"が括弧で閉じた単一文字列としてではなく、
# タプル/シーケンスの中に"Render"が含まれていることをPythonに伝えている
# ことに注意してください。
>>> node.parmsInFolder(("Render", ))

以下のコードの行は、Shadingサブフォルダ内のパラメータを返します。

>>> node.parmsInFolder(("Render", "Shading"))

hou.Parm.containingFoldersとhou.Parm.containingFolderSetParmTuplesも参照してください。

このノード上のフォルダ内のパラメータタプルのリストを返します。 このメソッドは、parmsInFolder()と同様ですが、hou.Parmの代わりにhou.ParmTupleのリストを返します。 引数に関する情報は、上記のparmsInFolder()を参照してください。

hou.Parm.containingFoldersとhou.Parm.containingFolderSetParmTuplesも参照してください。

ノードのデフォルトのエクスプレッション言語を返します。

エクスプレッションをまだ含んでいないパラメータにエクスプレッションを入力すると、ノードのエクスプレッション言語を使用して、そのエクスプレッションの評価方法が決められます。 GUIのパラメータダイアログ内でノードのエクスプレッション言語を変更することができます。

ノードのエクスプレッション言語を変更しても、既にエクスプレッションを含んだパラメータ(つまり、キーフレーム突きのパラメータ)の言語は変わりません。

パラメータに既にエクスプレッションが入っていて、GUIでそのエクスプレッションを変更しても、ノードのエクスプレッション言語の値に関係なくエクスプレッション言語が変わらないことに注意してください。 Pythonからパラメータ内の既存エクスプレッションの言語を変更するには、parm.setExpression(parm.expression(), language)のようにhou.Parm.setExpressionを使用してください。

ノードのデフォルトエクスプレッション言語を設定します。 詳細は、expressionLanguage()を参照してください。

ノードのパラメータ上のパラメータエイリアスの辞書を返します。 辞書内のキーは、エイリアスを持つパラメータで、その値はエイリアス名です。

ノードのパラメータからエイリアス名すべてを削除します。

このノードのSpareパラメータ(ユーザ定義パラメータ)のリストを返します。

このノードからすべてのSpareパラメータを削除します。

このノードの現在のパラメータレイアウトに相当するparmテンプレートのグループを返します。

現行パラメータグループを取得したり、それを修正したり、それを使ってhou.Node.setParmTemplateGroupをコールすることで、 このノードのパラメータレイアウトの編集(Spareパラメータの追加削除、ビルトインパラメータの並べ替えや非表示など)をすることができます。

以下のサンプルは、ジオメトリオブジェクトを作成し、そこにMy Parmsフォルダを追加し、そのフォルダにMy Parm floatパラメータを追加します。 パラメータは、作成されたジオメトリオブジェクトにのみ追加されます。つまり他のジオメトリオブジェクトは影響を受けません。

>>> node = hou.node("/obj").createNode("geo")
>>> group = node.parmTemplateGroup()
>>> folder = hou.FolderParmTemplate("folder", "My Parms")
>>> folder.addParmTemplate(hou.FloatParmTemplate("myparm", "My Parm", 1))
>>> group.append(folder)
>>> node.setParmTemplateGroup(group)

詳細とサンプルは、hou.ParmTemplateGroupとsetParmTemplateGroupメソッドを参照してください。

このノードのSpareパラメータを変更します。

各ノードタイプは、必ず存在するパラメータのセットを持っていて、特定のタイプでなければならないことに注意してください。 パラメータテンプレートグループにノードタイプで必要なパラメータがなかった場合、そのパラメータが下に追加され、不可視に設定されます。 同様に、パラメータテンプレートグループが、必要なパラメータのタイプ、範囲、ラベル、他のプロパティを修正しようと試みる場合、そのパラメータの可視設定以外の変更すべてが無視されます。

このメソッドは、このクラスの他のパラメータ関連メソッド(addSpareParmTuple, removeSpareParmTuple, replaceSpareParmTuple, addSpareParmFolder, removeSpareParmFolder)よりも優先度が高いです。 その理由は、簡単にパラメータを制御することができるからです。

デジタルアセットのパラメータインターフェースを変更するには、hou.HDADefinition.setParmTemplateGroupを参照してください。

Spareパラメータタプルをノードのパラメータの最後に追加します。 in_folderが空っぽのシーケンスでない場合は、このメソッドは、それらのパラメータを特定のフォルダのパラメータの最後に追加します。

このメソッドは、parm_templateに対してhou.FolderParmTemplateを渡すことで単一フォルダを追加することができることを覚えておいてください。

removeSpareParmTuple()とaddSpareParmFolder()のメソッドも参照してください。

このメソッドは廃止され、代わりにsetParmTemplateGroupを使用してください。

指定したSpareパラメータタプルを削除します。

addSpareParmTuple()も参照してください。

このメソッドは廃止され、代わりにsetParmTemplateGroupを使用してください。

コントロールパラメータフォルダをトップレベルの最前面フォルダとして追加します。 これは、カスタマイズしたコントロールパラメータの可視性を良くするために使用します。 同じ名前のフォルダが既に存在していれば、新しいフォルダは作成されません。 folder_nameがNoneの場合、そのフォルダ名前は'Controls'に設定されます。 parm_nameがNoneの場合、そのパラメータ名は'folder'に設定されます。

現行フォルダが存在しない場合、既存パラメータはグループ化されて'Parameters'という名前の新しいフォルダに格納され、新しいコントロールパラメータフォルダの後に配置されます。

フォルダをSpareパラメータに追加します。

セット内のフォルダすべてが1個のパラメータに相当することを覚えておいてください。 これがセットに入る最初のフォルダの場合、parm_nameがパラメータ名として使用されます。 そうでない場合、parm_nameは無視され、セット内の最初のフォルダのパラメータ名が使用されます。

これがセット内の最初のフォルダでparm_nameがNoneの場合、デフォルトが’sparefolder0'です。 parm_nameが既に使用されていれば、固有の名前が自動的に生成されます。

create_missing_foldersがTrueの場合、このメソッドは、in_folder内に存在しないフォルダを作成します。 そのため、このメソッドを使用すれば、SpareフォルダとSpareパラメータを同時に追加することができます。

addSpareParmTupleメソッドにhou.FolderParmTemplateを渡すことで、フォルダを追加することができるので、このメソッドは廃止されました また、addSpareParmTupleも廃止され、代わりにsetParmTemplateGroupを使用してください。

removeSpareParmFolderとaddSpareParmTupleのメソッドも参照してください。

このメソッドは廃止され、代わりにsetParmTemplateGroupを使用してください。

Spareパラメータから空っぽのフォルダを削除します。

folderはフォルダ名のシーケンスです。 そのため、Outputフォルダを削除するには、"Output"の代わりに("Output",)を使用してください。

addSpareParmFolder(), hou.ParmTemplateGroup.remove, hou.ParmTemplateGroup.findFolderも参照してください。

既存のSpareパラメータタプルを新しいタプルに置換します。古いパラメータタプルが削除され、新しいパラメータタプルがそこに追加されます。

新しいパラメータタプルは、古いパラメータタプルと同じ名前であっても、そうでなくても構いません。 同じ名前のパラメータタプルを用意することで、既存のSpareパラメータタプルを修正することができます。

非Spareパラメータタプルを置換することができないことに注意してください。 とはいえ、hou.ParmTuple.hideを使用すれば、非Spareパラメータの可視性を変更することができます。

デジタルアセットのすべてのインスタンスのパラメータを変更するには、hou.HDADefinition.replaceParmTupleを使用します。

このメソッドは廃止され、代わりにsetParmTemplateGroupを使用してください。

このノードのパラメータエクスプレッション内で$接頭辞を使って参照可能なローカル変数のリストを返します。

このノードのパラメータエクスプレッション内で@接頭辞を使って参照可能なローカル変数のリストを返します。 このリストには、このノード内でアトリビュートとして定義されているローカル変数と、このノードが最後にクックされた時に利用可能だったコンテキストオプションが含まれます。

このノードのパラメータに関連のあるアニメーションを、file_nameで指定したClipファイルに保存します。 file_nameの拡張子によって、保存されるファイルのフォーマットが決まります。

以下の拡張子のどれかを使用することができます:

• .clip: アニメーションをプレーンテキスト(ASCII)のclipファイルとして保存します。

• .bclip: アニメーションをbclip(バイナリclip)ファイルとして保存します。

• .bclip.sc: アニメーションをBlosc圧縮のbclipファイルとして保存します。

Clipファイルに使用するサンプルレートを指定するには、sample_rateにゼロ以外のプラスの値を設定します。 例えば、現行フレームレートが24(hou.fps())で、sample_rateを12に設定すると、そのsample_rateが現行フレームレートの半分なので、そのアニメーションが2フレームおきにサンプリングされます。

startがNoneでない場合は、その指定したフレーム(この番号を含む)からアニメーションの保存を開始します。 Noneの場合、グローバルの開始フレーム(この番号を含む)からアニメーションが保存されます。

同様にendがNoneでない場合は、その指定したフレーム(この番号を含む)でアニメーションの保存を終了します。 Noneの場合、グローバルの終了フレーム(この番号を含む)までアニメーションが保存されます。

グローバルの開始/終了フレームは、Global Animation Optionsウィンドウで指定します。

scoped_onlyがTrueの場合、スコープされたパラメータに関連のあるアニメーションのみが保存されます。 スコープされたパラメータがなかった場合、自動スコープのパラメータに関連のあるアニメーションが保存されます。

scoped_onlyがFalseの場合、このノードのパラメータに関連のあるアニメーションが保存されます。

このノードのパラメータに何もアニメーションがなければ、hou.OperationFailed例外を引き起こします。 scoped_onlyがTrueの場合、スコープされたパラメータに何もアニメーションがない、または、(このノードにスコープされたパラメータがない場合では)自動スコープのパラメータにアニメーションがなければ、この例外が引き起こされます。

アニメーションをファイルに保存した際にエラーが起きれば、hou.OperationFailed例外を引き起こします。

start >= endの場合はhou.InvalidInput例外を引き起こします。 startのみを指定する場合には、必ずグローバルの終了フレーム未満の値を指定してください。 endのみを指定する場合には、必ずグローバルの開始フレームより大きい値を指定してください。

file_nameで指定したClipファイルを、このノードのパラメータのアニメーションとして読み込みます。 対応しているClipファイルフォーマットのリストは、hou.Node.saveParmClipを参照してください。

このノードのパラメータの名前に合致しないClipファイルのトラックは無視されます。

sample_rateには、ゼロ以外のプラスの値を設定します。そこで指定した値がアニメーションを読み込む時に使用されます。 例えば、現行フレームレートが24(hou.fps())で、sample_rateを12に設定すると、そのsample_rateが現行フレームレートの半分なので、そのアニメーションが2フレームおきにキーフレーム付きで読み込まれます。

startには、読み込んだアニメーションを開始させるフレームを指定します。 デフォルトでは、Clipファイルで指定されたフレームからアニメーションが開始します。

ファイルからアニメーションデータを読み込んだ際にエラーが起きれば、この関数は、hou.OperationFailed例外を引き起こします。

このノードのパラメータのClipデータを返します。 このメソッドはhou.Node.saveParmClipと同様ですが、アニメーションをClipファイルに保存するのではなくて、Clipデータ(ファイルの内容)を返します。

start, end, sample_rate, scoped_onlyは、hou.Node.saveParmClipと同じ挙動です。

binaryがTrueの場合はバイナリClipデータを返し、Falseの場合はプレーンテキスト(ASCII)Clipデータを返します。

use_blosc_compressionがTrueの場合はBlosc圧縮のバイナリClipデータを返します。 これはプレーンテキスト(ASCII)Clipデータには使用することができません。

返されるクリップデータは、Python3だとbytesオブジェクト、Python2だとstrオブジェクトです。 詳細は、HOMバイナリデータを参照してください。

このタプルのパラメータに何もアニメーションがなければhou.OperationFailed例外を引き起こします。

start >= endの場合はhou.InvalidInput例外を引き起こします。 startのみを指定する場合には、必ずグローバルの終了フレーム未満の値を指定してください。 endのみを指定する場合には、必ずグローバルの開始フレームより大きい値を指定してください。

binary = False且つuse_blosc_compression = Trueの場合はhou.InvalidInput例外を引き起こします。

dataで指定したClipを、このノードのパラメータのアニメーションとして読み込みます。 このメソッドはhou.Node.loadParmClipと同様ですが、Clipファイルの代わりにClipデータからアニメーションを読み込みます。

このクリップデータは、Python3だとbytesオブジェクト、Python2だとstrオブジェクトでなければなりません。 詳細は、HOMバイナリデータを参照してください。

sample_rateとstartはhou.Node.loadParmClipと同じ挙動です。

binaryとblosc_compressedには入力データのタイプを指定します。

binaryがTrueの場合、指定するデータはバイナリClipデータです。 Falseの場合、指定するデータはプレーンテキスト(ASCII)Clipデータです。

blosc_compressedがTrueの場合、指定するデータはBlosc圧縮バイナリデータです。 これはプレーンテキスト(ASCII)Clipデータには使用することができません。

指定したデータが無効であれば、hou.OperationFailed例外を引き起こします。

binary = False且つblosc_compressed = Trueの場合はhou.InvalidInput例外を引き起こします。

パラメータエクスプレッション、nameによるノード参照、他のノードで生成されたデータに依存したエクスプレッションのどれかによって、 このノードが参照しているノードのタプルを返します。この返されるタプルは、あるノードが他のノードに影響を与えるすべての方法(入力の接続を除く)を反映しています。

この結果は、ノードの最後のクックによって異なる可能性があることに注意してください。まず最初にノードに対してcook()をコールすることを推奨します。

パラメータエクスプレッション、nameによるノード参照、他のノードで生成されたデータに依存したエクスプレッションのどれかによって、 このノードを参照しているノードのタプルを返します。この返されるタプルは、あるノードが他のノードに影響を与えるすべての方法(入力の接続を除く)を反映しています。

この結果は、ノードの最後のクックによって異なる可能性があることに注意してください。

このノードからの(テクスチャ、ジオメトリファイル、アセットライブラリなどの)外部ファイル参照を表現したタプルのシーケンスを返します。 recurseがTrueの場合、このノードのすべての子ノードに適用されます。

hou.fileReferences()も参照してください。

このノードからデジタルアセットを作成します。通常では、このメソッドはサブネットノードに対してコールします。

このノードから、コンパイルしたデジタルアセットを作成します。 通常では、このメソッドはVOPネットワークノード(例えば、Material Shader Builder SHOP, Surface Shader Builder SHOP, VEX Surface SHOP Type VOPNET)に対してコールします。 デジタルアセットはコンテンツセクションを持ちません。つまり、内部にVOPネットワークを持ちませんが、代わりに、シェーダコードを用意するには、保存したVEXコードセクションに依存します。

コンパイルしたHDAを作成した後、そのVEXコードセクションが今まで手動で変更していれば、それに該当するVEXオブジェクトコードセクションは、hou.HDADefinition.compileCodeSectionを使用して再コンパイルすることができます。

ノードを(同じコンテキスト内で)新しいタイプに変更します。 new_node_typeは、変更したいタイプの内部文字列名です。

Keep_name, keep_parms, keep_network_contentsは、ノードのタイプが変わった後に、 それぞれノードを同じ名前、同じパラメータ値、同じ内容に保持することを意味します。 force_change_on_node_type_matchは、ノードのタイプが既に指定したタイプの時でも、その変更を実行するべきかどうかを指示します。

デジタルアセットの内容を編集できるように、そのデジタルアセットのロックを解除します。

この関数を使用するには、必ずHDAを修正する権限がなければなりません。

このノードがロック解除されたデジタルアセットの場合、そのデジタルアセットの内容を、その定義に保存されている内容に戻してロックします。 パラメータ値は変更されません。

このノードがロックされていたり、デジタルアセットでない場合は、このメソッドは何の効果もありません。

hou.Node.matchesCurrentDefinitionとhou.Node.isLockedも参照してください。

ノードの内容がそのタイプ定義にロックされているかどうか返します。

このノードがデジタルアセットで、その内容が現在Delay-Sync(遅延同期)状態である場合、その内容が同期されます。 既に同期されていたり、同期可能なアセットでない場合は、何も起きません。

このノードがデジタルアセットで、その内容が現在Delay-Sync(遅延同期)状態である場合、Trueを返します。 それ以外の場合、Falseを返し、同期できないノードが含まれていることを意味します。

このノードがデジタルアセットのインスタンスの場合、それがロックされているかどうか返します。 それ以外の場合はFalseを返します。

ロック解除されたデジタルアセットとデジタルアセットのインスタンスではないノードとを区別するには、ノードのタイプが定義を持っているかチェックします:

def isUnlockedAsset(node):
    return not node.isLockedHDA() and node.type().definition() is not None

ロック解除されたデジタルアセットインスタンスすべてを保存してロックする方法のサンプルは、hou.HDADefinition.updateFromNodeを参照してください。

このノードはロック解除されたデジタルアセットの内にあるかどうか返します。このノードがロックされたHDA内になければ、そのノードをHDA定義から除外することができます。

ロックされたHDAノード内にノードが含まれている場合で、そのロックされたHDA内で編集可能としてマークされていなければFalseを返します。 編集可能としてマークされていればTrueを返します。 特に、この関数はロックされたHDA内にノードが含まれていなければ(または、そもそもHDA内に含まれていなければ)Trueを返します。

ノードにマテリアルが含まれていればTrueを返します。

このメソッドは、self.type().hdaModule()のショートカットで、Pythonパラメータとボタンコールバックでのエクスプレッションの長さを短くすることができます。 詳細は、hou.NodeType.hdaModuleを参照してください。

hmメソッドとhou.phm()も参照してください。

このメソッドは、self.hdaModule()のショートカットです。

hou.phm()も参照してください。

このメソッドは、大元のNodeに関係のあるhou.HDAViewerStateModuleのインスタンスを作成します。

hou.NodeType.hdaViewerStateModuleも参照してください。

このメソッドは、大元のNodeに関連付けられているhou.HDAViewerHandleModuleのインスタンスを作成します。

hou.NodeType.hdaViewerHandleModuleも参照してください。

指定したバージョンのHDA定義から現行バージョンのHDA定義へノードを同期化します。 hou.HDADefinition.versionも参照してください。

表示目的で使用されるノードの出力を示した整数を返します。

このノードの表示目的で使用する出力を設定します。

ノードが作成された時の日付と時間を返します。

ノードが最後に修正された時の日付と時間を返します。

これは、作成に使用されたビューポートツールの名前を返します。 この名前はデフォルトでは設定されず、通常では空っぽの文字列です。

これは、このノードを作成したツールの名前を設定します。ノードタイプ名とは違う名前でこれをコールする場合、setBuiltExplicitly(False)もコールしてください。

このノードが明示的に構築されたかどうか返します(デフォルトはTrue)。 ほとんどのノードは明示的に構築されていますが、いくつかのノードはHoudiniで暗黙的に作成されています。 例えば、複数のSOPからジオメトリを選択して、オペレーションを実行した場合、Houdiniは、そのオペレーションを実行する前に暗黙的にmerge SOPを配置します。 SOPでジオメトリを再選択した時、Houdiniは暗黙的に作成されたSOPを自動的に削除します。

このノードが明示的に構築されたかどうか設定します(デフォルト値はTrue)。 Falseに設定すると、このノードが色々なメニューとNetwork Viewペインのリストモードで表示されなくなります。 このフラグは、通常では、パラメータを変更しそうにない中間ユーティリティノードのために使用されます。

ノードが時間依存かどうか返します。時間依存ノードは、フレームが変わる度に再評価されます。

ノードを再クックするように頼んだり、強制させます。

ノードを再クックする必要があるかどうか尋ねます。

現行セッションで、このノードがクックされた回数を返します。

例えば、ノード内の各パラメータに対して非表示や無効化といったUI状態を更新します。

UI状態は、評価を必要とする条件文(つまり、Disable When)として表現することができます。 通常のGUIのHoudiniでは、ノードが選択された時にParameter Paneがその評価を実行して、それらのノードパラメータをペイン内でどのように表示させるのか決定します。 しかし、CUIのHoudiniまたはParameter Paneがそのノードをまだ読み込んでいない時は、その評価は発生せず、UI状態はデフォルトのままになり、 hou.Parm.isDisabledやhou.Parm.isHiddenなどのメソッドが正しい値を返さなくなります。 そのような場合には、hou.Node.updateParmStatesをコールすることを推奨します。

ノードとその直近のクックデータに関する情報を含んだツリー構造体を返します。 このツリーの内容は、ノードタイプやクックデータの性質によって大きく変わります。 このデータのツリーは、ノード情報ウィンドウの内容を生成するために使用します。

このノードが属しているネットワークの最後のクックで使用された(サブネット内のノードを含む)ノードのリストを返します。

ノードが、コンパイルされたクックコードを生成することができればTrue、できなければFalseを返します。

check_parentがTrueなら、その先祖の階層内の親もコードを生成することができるかテストされます。

ノードがクックコードを明示的に生成することができなくても、Auto-Shaderでラップすることができれば、暗黙的にそのようなコードが用意できる場合があります。 例えば、Anti-Aliased NoiseなどのビルディングブロックVOPsは完全なクックコードを生成します。 これらのVOPsには、フルクック機能に寄与するコードフラグメントが備わっています。 しかし、場合によっては、そのような機能で自動的にラップされてクックコードとして動作することがあります。 check_auto_shaderがTrueなら、暗黙的なクックコードがノードに備わっているのかテストされます。

コンパイルされたクックコードを生成することができるノード自体またはこのノードを含んだネットワークノードを返します。 例えば、VOPノードに対するジェネレータノードは、SHOPノードだったり、それを含んだSOPノードがそれです。

このノードがコードを生成できなかったり、コードを生成するノード内にそのノードが含まれていない場合はNoneを返します。

生成されるクックコードの言語(つまり、VEX, RSL)を返します。

このノードが、コンパイルされたコードを生成できなかった場合は、hou.OperationFailedを引き起こします。

このノードが複数コンテキスト(つまり、サーフェスコンテキスト、ディスプレイスメントコンテキストなど)に対して、コンパイルされたクックコードを生成できればTrue、できなければFalseを返します。

このノードが、コンパイルされたコードを生成できなかった場合は、hou.OperationFailedを引き起こします。

コンパイルしたVEXコードを(これをサポートしているノードに対して)ディスクファイルに保存します。 引数の説明は、hou.Node.saveCookCodeToFileを参照してください。

VEX/RSLソースコードを(これをサポートしているノードに対して)ディスクファイルに保存します。

node("/shop/vopmaterial1").saveCookCodeToFile("myfile.vfl", context_name="surface")

ノードグループをノードに追加し、その新しいグループを返します。

指定した名前のグループが既に存在した場合、この関数は、新しいグループを追加せずに既存のグループを返します。 グループの名前がNoneまたは空っぽの文字列の場合、固有のデフォルト名が自動的に選択されます。

この関数は、ネットワークであるノードに対してのみコールすることができます。ネットワークでないノードに対してコールした場合、hou.OperationFailedを引き起こします。

ノードグループを削除するには、hou.NodeGroup.destroyを使用します。

指定した名前のノードで格納されているノードグループを返します。そのグループが存在しなかった場合は、Noneを返します。

このノード内のノードグループのリストを返します。

このノードのタイプに関連した初期化スクリプトを実行します。

このノードが削除された時に実行されるスクリプトを返します。

このノードが削除された時に実行されるスクリプトを設定します。

クリップを保存する場所を意味するノードパスを返します。この場所は存在してもしなくても構いません。 そのようなネットワークを見つけたり作成するには、hou.Node.findOrCreateMotionEffectsNetworkを使用します。

Motion Effectsの格納に適したCHOPネットワークノードを返します。デフォルトでは、そのノードが存在しなかった場合は、そのノードが作成されます。

hou.Parm.storeAsClipとhou.Node.motionEffectsNetworkPathも参照してください。

コピースタンプの浮動小数点または文字列の値を返します。 このノードは必ず下流のスタンプオペレータ(例えば、Copy SOP, Cache SOP, LSystem SOP, Copy CHOP)でなければなりません。

Pythonパラメータに以下のエクスプレッションを置くことができます:

node("../copy1").stampValue("sides", 5)

子アイテム(ノード、ネットワークボックス、スティッキーノートなど)のシーケンスを指定して、それらのアイテムを含んだファイルを保存します。 hou.Node.loadItemsFromFileを使用することで、このファイルを読み込むことができます。

ファイルが書き出せなかった場合は、hou.OperationFailedを引き起こします。 このノードの内容を読み込む許可がなかった場合は、hou.PermissionErrorを引き起こします。

ノードのリストとネットワークボックスのリストを単一シーケンスに組み合わせて、hou.Node.saveItemsToFileをコールします。 このメソッドは、上位互換のために用意されています。 新しいコードでは、直接saveItemsToFileをコールしてください。

(hou.Node.saveItemsToFileで保存された)ファイルの内容をこのノードの内容へ読み込みます。

ファイルが存在しない、または正しいタイプのファイルでなかった場合は、hou.OperationFailedを引き起こします。 このノードがロックされたデジタルアセットのインスタンスだった場合は、hou.PermissionErrorを引き起こします。 警告ありで読み込みに成功して、ignore_load_warningsがFalseだった場合は、hou.LoadWarningを引き起こします。

hou.Node.loadItemsFromFileをコールします。これは、上位互換のために用意されています。 新しいコードでは、直接loadItemsFromFileをコールしてください。

ノードの再作成に必要なPythonコードをプリントします。

特定のアクション、イベントが この特定のノードインスタンス で起きた時にHoudiniがコールするPythonコールバックを登録します。

コールバックは、現行セッションでのみ維持されます。例えば、これらのコールバックは.hipファイルに保存されません。 すべてのセッションでコールバックを維持させたい場合には、これらのコールバックを(ユーザが.hipファイルを開いた時に実行される)456.pyに追加します。 詳細は、Pythonスクリプトの追加先を参照してください。

def event_callback(event_type, **kwargs):
    ...

event_typesリスト引数が空っぽの場合は、hou.OperationFailedを引き起こします。

以下の例では、特定のノードの名前が変更された時にコールされる関数をセットアップする方法を説明しています:

def name_changed(node, event_type, **kwargs):
    print("The geometry object is now named", node.name())

hou.node("/obj/geo1").addEventCallback((hou.nodeEventType.NameChanged, ), name_changed)

hou.Node.removeEventCallbackとhou.Node.removeAllEventCallbacksも参照してください。

以前にこのノードに追加したコールバックとhou.nodeEventType列挙値のシーケンスを指定すると、コールバックに対してイベントタイプのセットからそれらのイベントタイプを削除します。 残りのイベントタイプのセットが空っぽの場合、コールバックは、このノードから完全に削除されます。

コールバックが以前に追加されていなかった場合、hou.OperationFailedを引き起こします。

詳細は、hou.Node.addEventCallbackを参照してください。

この特定のノードインスタンス 上のparm_namesのパラメータが変更される度にHoudiniがコールするPythonコールバックを登録します。 いくつかのパラメータのみを考慮する場合、または、このノードにパラメータがたくさんある場合、hou.Node.addEventCallbackを使って追加されたコールバック内でパラメータ名をフィルタリングするよりもこのメソッドの方が高速です。

詳細は、hou.Node.addEventCallbackを参照してください。

このノードからすべてのイベントタイプに対するイベントコールバックすべてを削除します。

詳細は、hou.Node.addEventCallbackを参照してください。

hou.Node.addEventCallbackコールを持つこのノードによって登録されたすべてPythonコールバックのタプルを返します。

このノードインスタンス上に名前付き値を追加/設定します。 setUserDataとは違い、このメソッドを使用した値セットは、HIPファイルと一緒に保存されません。

この名前/値のペアは、HIPファイルと一緒に保存されません。 クック間で一時的な値を保存するPythonで実装されたノードは、その後のクックに対してそれらを再計算しないようにするのに役に立ちます。

以下のサンプルは、キャッシュされたユーザ定義データを設定、アクセス、削除する方法について説明しています:

>>> n = hou.node("/obj").createNode("geo")
>>> n.setCachedUserData("my data", [1, 2, {"a": "b", "c": "d"}])
>>> n.cachedUserData("my data")
[1, 2, {'a': 'b', 'c': 'd'}]
>>> n.cachedUserDataDict()
{'my data': [1, 2, {'a': 'b', 'c': 'd'}]}
>>> n.destroyCachedUserData("my data")
>>> n.cachedUserDataDict()
{}
>>> print n.cachedUserData("my data")
None

詳細とサンプルは、ノード毎のユーザ定義データを参照してください。

このノードに対してユーザ定義の名前/文字列のペアすべてを含んだ辞書を返します。

詳細は、hou.Node.setCachedUserDataを参照してください。

この名前のユーザ定義のキャッシュデータを返します。この名前のデータが存在しなかった場合は、Noneを返します。

詳細は、hou.Node.setCachedUserDataを参照してください。

このメソッドは、以下のように実装されています:

def cachedUserData(self, name):
    return self.cachedUserDataDict().get(name)

Noneはキーに対して有効な値なので、キーが有効なのかチェックする最も信頼できる方法は、それがcachedUserDataDictの結果の中にあるかどうかチェックすることです:

>>> n = hou.node("/obj").createNode("geo")
>>> n.cachedUserDataDict()
{}
>>> print n.cachedUserData("foo")
None
>>> "foo" in n.cachedUserDataDict()
False
>>> n.setCachedUserData("foo", None)
>>> n.cachedUserDataDict()
{'foo': None}
>>> print n.cachedUserData("foo")
None
>>> "foo" in n.cachedUserDataDict()
True

この名前のユーザ定義のキャッシュデータを削除します。

詳細は、hou.Node.setCachedUserDataを参照してください。

この名前のユーザデータが存在しない且つmust_existがTrueの場合は、hou.OperationFailedを引き起こします。

すべてのユーザ定義キャッシュデータを削除します。

詳細は、hou.Node.setCachedUserDataを参照してください。

blocktypeパラメータで指定したデータタイプのこのノードに格納されているすべてのデータブロックの名前を返します。

データブロックには特定のノードに取り付けるのに役立つ追加データを含めることができるという点ではユーザデータと同様です。 データブロックがユーザデータと異なる点は、データブロックは大規模なデータのブロックを効率的に制御できるように設計されています。 さらにデータブロックにはバイナリデータを格納することができ、各ブロックに関連のあるデータタイプを持たせることができます。

keyパラメータで指定したブロックのデータタイプを返します。

指定したキーがこのノードのデータブロックと関係がなかった場合は、hou.ValueErrorを引き起こします。

指定したキーに格納されているデータブロックをバイナリ文字列として返します。 このメソッドは、指定したデータブロックがPythonオブジェクトで表現可能なタイプである場合にのみ動作します。 そうでない場合は、Noneが返されます。

返されるバイナリ文字列は、Python3ではbytesオブジェクト、Python2ではstrオブジェクトです。 詳細は、HOMバイナリデータを参照してください。

指定したキーがこのノードのデータブロックと関係がなかった場合は、hou.ValueErrorを引き起こします。

指定したキー名のノードに対して、指定したデータブロックを格納し、指定したデータタイプでそれをマークします。

blockに空っぽの文字列を渡すと、指定したキーを持ったデータブロックが削除されます。 removeDataBlock()メソッドを使用してデータブロックを削除することもできます。

blocktype文字列引数は、C++/HDKプラグインがデータブロックを解釈してそのデータブロックをC++オブジェクトに変換するのに必要です。 Pythonを使用してデータブロックの取得や設定をしている場合、このblocktypeは空っぽのままにしてください。

指定したキーを持った既存のデータブロックをノードから削除します。 このキーを持ったデータブロックがなければ、このメソッドは何もしません。

このDOPネットワークノードによって定義されたシミュレーションを返します。これは、DOPネットワークでない場合には例外を引き起こします。

hou.DopObjectを指定すると、そのオブジェクトを処理したDOPノードのタプルが返されます。 これは、DOPネットワークでない場合には例外を引き起こします。

ワークアイテムが選択されている場合、次の可視ワークアイテムを選択します。

ワークアイテムが選択されている場合、前の可視ワークアイテムを選択します。

このノードが現在選択されているワークアイテムを含んだTOPネットワークの中に存在するか、または、そのTOPネットワークを含んでいる場合に、アクティブなワークアイテムの選択を解除します。

TOPノードがすべてのワークアイテムを表示できない場合に表示させるワークアイテムサブセット(ページ)を設定します。