指定したパスのノードを返します。ノードが見つからなければNoneを返します。 相対パス(つまり、/で始まらないパス)を指定した場合、このノードを基準に検索が実行されます。

例えば、変数n内のノードの親ノードを取得するには、n.node("..")を使用します。 geo5という名前の子ノードを取得するには、n.node("geo5")を使用します。 light3という名前の兄弟ノードを取得するには、n.node("../light3")を使用します。

戻り値は、Nodeのサブクラスのインスタンスであることに注意してください。 例えば、見つかったノードがオブジェクトノードであれば、戻り値は、hou.ObjNodeインスタンスになります。

パスが絶対パス(つまり、/で始まるパス)なら、このメソッドは、hou.node(node_path)のショートカットです。 相対パスなら、hou.node(self.path() + "/" + node_path)のショートカットです。 hou.node()も参照してください。

これは、node()と同様ですが、複数のパスを受け取り、複数のNodeオブジェクトを返します。これは以下と等価です:

nodes = [self.node(path) for path in paths]

指定したパスのネットワークアイテムを返します。そのアイテムが存在しなかった場合はNoneを返します。 相対パス(つまり、/で始まらないパス)を指定すると、このノードを基準に検索が実行されます。

そのパスが絶対パス(つまり、/で始まる)の場合、このメソッドは、hou.item(node_path)のショートカットです。 それ以外の場合、hou.item(self.path() + "/" + item_path)のショートカットです。 hou.item()も参照してください。

戻り値がNetworkMovableItemのサブクラスのインスタンスである場合があることに注意してください。 例えば、見つかったアイテムがオブジェクトノードであれば、その戻り値はhou.ObjNodeインスタンスです。 そのアイテムがネットワークボックスであれば、その戻り値はhou.NetworkBoxインスタンスです。

これは、item()と同様ですが、複数のパスを受け取り、複数のNetworkMovableItemオブジェクトを返します。これは以下と等価です:

items = [self.item(path) for path in paths]

このノードがネットワークの場合、つまり、子ノードを含むことができるノードの場合はTrueを返します。 それ以外の場合はFalseを返します。 これは、hou.Node.createNodeなどのいくつかの他のメソッドをコールすると、そのメソッドはhou.OperationFailedを引き起こすことを意味します。

このノードがHDAでない、且つ、HDA内部にない場合、このメソッドはTrueを返します。

このノードがHDAノードだった場合、そのノードがロック解除されていればTrueを返し、ロックされていればFalseを返します(これは、not node.matchesCurrentDefinition()と等価です)。

このノードがロックされたHDAノード内部にある場合、このメソッドは、このノードがそのロックされたHDA内の編集可能サブネットまたはそのサブネット内部にある場合はTrueを返します。 それ以外はFalseを返します。

このメソッドは、このノードの子に特定のタイプの変更を加えることができるかどうかを反映します。 ノード間のワイヤー接続やフラグの設定といった変更は、子ノードへの編集であり、親ノードまたは周辺ノードの動作にも影響を与えます。 例えば、ノードにディスプレイフラグを有効にできるかどうかを判断するには、node.parent().isEditable()をテストすることになります。 パタメータ値の変更など、ノード自体の単なる内部的なノードの変更に関しては、node.isEditableInsideLockedHDA()をテストすれば良いです。

このノードの子であるノードのリストを返します。 ファイルシステムと同じように、ノードの子はフォルダ/ディレクトリのような構成になっています。

子ノードの数を調べるには、len(node.children())を使用します。

その結果の子の順番は、Houdiniでのユーザ定義の順番と同じです。 この順番を確認するには、Network Viewペインをリストモードに切り替え、そのリスト順を user defined に設定します。 ノードの順番を変更するには、そのリスト内でノードをドラッグアンドドロップします。

def pc(node):
    '''特定のノードの子の名前をプリントします。
       この関数は、Pythonシェルでインタラクティヴに動作させる時に役に立ちます。'''
    for child in node.children():
        print child.name()

def ls():
    '''現行ノード下のノードの名前をプリントします。'''
    pc(hou.pwd())

以下のエクスプレッションは特定のノードタイプの子のリストを評価します:

[c for c in node.children() if c.type() == node_type]

このノードのすべての子を含んだタプルを返します。 childrenとは違い、このメソッドはhou.NetworkBox, hou.SubnetIndirectInput, hou.StickyNote, hou.NetworkDotのオブジェクトも返します。

このノードのサブチルドレンすべてを再帰的に返します。 例えば、hou.node("/").allSubChildren()は、HIPファイル内のノードすべてを返します。

返されるのはタプルであって、ジェネレータではないことに注意してください。 つまり、戻り値を通じてループしている間にノードを削除したり作成しても安全であることを意味します。

以下の関数は、指定したノード内の特定のタイプの子すべてを削除します:

def removeSubChildrenOfType(node, node_type):
    '''特定のタイプの子すべてを再帰的に削除します。'''
    for child in node.allSubChildren():
        if child.type() == node_type:
            child.destroy()

このコードは、例えば、/obj下にあるVisibility SOPすべてを削除します:

>>> removeSubChildrenOfType(hou.node("/obj"), hou.sopNodeTypeCategory().nodeTypes()['visibility'])

このノード内のすべてのサブアイテム(ノード、ネットワークボックス、ステッキーノートなど)を再帰的に返します。 例えば、hou.node("/").allSubItems()は、hipファイル内のすべてのノードネットワークアイテムを返します。

このメソッドのパラメータの詳細は、hou.Node.allSubChildrenを参照してください。

このノード内に含まれたすべてのノード(このノードを含む)のシーケンスを再帰的に返します。 このメソッドは、以下の点でhou.Node.allSubChildrenと異なります:

• 戻りのシーケンスには、このノードが含まれます。

• 上から下または下から上の走査順を保証していません。

• このメソッドはジェネレータであり、タプルを返さないので、その戻り値によってループさせてノードを作成または削除するのは危険です。

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

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

パターンに合致した子ノード名のタプルを返します。

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

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

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

>>> obj = hou.node("/obj")
>>> obj.createNode("geo", "geo1")
<hou.ObjNode of type geo at /obj/geo1>
>>> obj.createNode("geo", "geo2")
<hou.ObjNode of type geo at /obj/geo2>
>>> obj.createNode("geo", "grid")
<hou.ObjNode of type geo at /obj/grid>
>>> obj.createNode("geo", "garbage")
<hou.ObjNode of type geo at /obj/garbage>
>>> obj.createNode("geo", "box")
<hou.ObjNode of type geo at /obj/box>

>>> def names(nodes):
... return [node.name() for node in nodes]

>>> names(obj.glob("g*"))
['geo1', 'geo2', 'grid', 'garbage']
>>> names(obj.glob("ge* ga*"))
['geo1', 'geo2', 'garbage']
>>> names(obj.glob("g* ^ga*"))
['geo1', 'geo2', 'grid']

hou.Node.recursiveGlobも参照してください。

hou.Node.globと同様に、パターンに合致した名前の子ノードのタプルを返します。 違うのは、その合致した子ノードからさらに再帰的にその子ノードすべてが追加されます。 さらに、その結果はノードタイプでフィルタリングすることができます。

Houdiniは、パターンに対して子ノードをマッチングしてから、その合致した子ノードのサブ子ノードを再帰的に追加し、 そしてフィルターを適用します。

パターンとフィルターの挙動は、Houdiniのノードバンドルの挙動と非常に似ています。 詳細は、hou.NodeBundleを参照してください。

パターンが無効な場合は、hou.OperationFailedを引き起こします。

node_type_nameタイプのノードをこのノードの子として新しく作成します。

指定したノード名が無効、且つ、force_valid_node_nameがFalseの場合は、hou.OperationFailedを引き起こします。 このノードに子を含めることができなかった場合は、hou.OperationFailedを引き起こします。 このノードがロックされたアセット内にあった場合は、hou.PermissionErrorを引き起こします。

>>> obj = hou.node("/obj")

# Houdiniにノードタイプ名に基づいた名前を選択させます。
>>> obj.createNode("geo")
<hou.ObjNode of type geo at /obj/geo1>

# Houdiniに固有の名前を選択させます。
>>> obj.createNode("geo")
<hou.ObjNode of type geo at /obj/geo2>

# ノードに特定の名前を指定します。
>>> obj.createNode("geo", "foo")
<hou.ObjNode of type geo at /obj/foo>

# Houdiniに私達が提案した名前から固有の名前を作成させます。
# また、ジオメトリオブジェクトに初期スクリプトを実行させなければ、中身が空っぽになります。
>>> obj.createNode("geo", "geo1", run_init_scripts=False)
<hou.ObjNode of type geo at /obj/geo3>
>>> obj.node("geo1").children()
(<hou.SopNode of type file at /obj/geo1/file1>,)
>>> obj.node("geo3").children()
()

このノードを削除します。

Nodeインスタンスを削除した後に、それに対してメソッドをコールすると、Houdiniはhou.ObjectWasDeletedを引き起こします。

ロックされたアセット内のノードを削除しようとした場合は、hou.OperationFailedを引き起こします。

disable_safety_checksをTrueにすると安全性チェックが無効になるので、ノードをクック中にこのメソッドがコールされるとHoudiniがクラッシュしてしまう場合があります。

指定したアイテムすべてのコピーをこのネットワーク内に作成します。これらのアイテムは、このネットワークの子である必要はありませんが、すべてのアイテムが同じ親ネットワーク内に含まれている必要があります。

channel_reference_originalsがTrueの場合、新しいノードすべてのパラメータが元のノードのチャンネル参照に設定されます。 コピーしたノードがサブネットワークであれば、トップレベルのノードのみが元のサブネットワークのチャンネル参照を構築します。 そのサブネットワーク内の子ノードは、元の子ノードの単純コピーになります。 relative_referencesパラメータは、チャンネル参照がソースノードの相対パスまたは絶対パスのどちらを使用するのかを制御します。

connect_outputs_to_multi_inputsがTrueで、コピーされるアイテムの出力が複数の入力ノードに接続されている場合(例えば、Merge)、そのコピーされた新しいアイテムの出力にもその複数の入力ノードが接続されます。 通常では、コピーされるノードには、そのコピーされるセットの外側のノードへの出力はありません。

新しいネットワークアイテムすべてのtupleを返します。

このノードに子を含めることができなかった場合はhou.OperationFailedを引き起こします。 このノードがロックされたアセット内にあった場合はhou.PermissionErrorを引き起こします。

指定したhou.NetworkMovableItemオブジェクトのタプル内のすべてのアイテムを削除します。 これは、それらのアイテムをループさせて個々にdestroy()をコールするよりも非常に効率的です。 また、これは他のオブジェクトも削除しないと削除することができないオブジェクトが存在する場合でも安全に処理します。

指定した1つ以上のアイテムがこのノードの子でなかった場合は、hou.OperationFailedを引き起こします。 このノードがロックされていたり、ロックされたデジタルアセット内にあった場合は、hou.PermissionErrorを引き起こします。

disable_safety_checksをTrueにすると安全性チェックが無効になるので、ノードをクック中にこのメソッドがコールされるとHoudiniがクラッシュしてしまう場合があります。

hou.Node.createDigitalAssetが成功できれば、Trueを返します。

ノードが、ネットワーク内で最後に選択したノードであるかどうかを示すブールを返します。

各ネットワーク(つまり、子を含んだノード)自体には、選択したノードのリストが記録されており、最後に選択したノードが特別な意味を持っています。 例えば、ピン留めしていないパラメータペインで表示されるノードがそれです。

Houdiniですべてのネットワーク内の選択したノードすべてのタプルを取得するには、hou.selectedNodes()も参照してください。 このリストの最後のノードもHoudiniでは特別な意味をもち、グローバルの現行ノードに相当します。

このノードを最後に選択したノードとして設定または未設定にします。

各ネットワーク(つまり、子を含んだノード)自体には、選択したノードのリストが記録されており、最後に選択したノードが特別な意味を持っています。 例えば、ピン留めしていないパラメータペインで表示されるノードがそれです。

onがTrueの場合、このノードが最後に選択したノードになります。 Falseで、このノードが最後に選択したノードだった場合、そのノードが非選択になり、最後から2番目に選択したノードが最後に選択したノードになります。

clear_all_selectedがtrueの場合、Houdiniは、その処理を実行する前に、このネットワーク内のすべてのノードを非選択にします。

hou.Node.setSelectedとhou.selectedNodes()も参照してください。

選択されたこのノードの子を含んだタプルを返します。 最後に選択したノードが特別な意味を持ち、そのノードはhou.Node.isCurrentを使って取得することもできることを覚えておいてください。

以下のサンプルは、/obj内の選択したオブジェクトすべての名前をプリントします:

for n in hou.node("/obj").selectedChildren():
    print n.name()

選択した子ノードの合計を調べるには、len(node.selectedChildren())を使用します。

選択されているこのノードの子を含んだタプルを返します。 selectedChildrenとは違い、このメソッドは、選択されたhou.NetworkBox, hou.SubnetIndirectInput, hou.StickyNote, hou.NetworkDotのオブジェクトも返します。

以下のサンプルは、/obj内の選択したアイテムすべての位置をプリントします:

for n in hou.node("/obj").selectedItems():
    print n.position()

選択されていて且つitem_typeで指定したタイプのノードの子の数を返します。

このノードに対してhou.NodeTypeオブジェクトを返します。

例えば、すべてのカメラノードインスタンスは、同じノードタイプを共有します。

このノードの子に相当するhou.NodeTypeCategoryを返します。 例えば、このノードがジオメトリオブジェクトの場合、その子はSOPです。 オブジェクトサブネットの場合、その子はオブジェクトです。

このノードの入力に接続されたノードのタプルを返します。 入力がhou.SubnetIndirectInputに接続されている場合、それに該当する親サブネットの入力に接続されたノードが返されます。 言い換えれば、間接入力の存在を隠すということです。つまり、その結果のノードは、すべてが呼び出し側のノードの兄弟であるとは限りません。

特定の入力が接続されていない(または、それが間接入力に接続されていても、それに該当するサブネットの親入力が接続されていない)場合は、タプルのその箇所にNone値が配置されます。

このノードの指定された入力に接続されているノードを返します。 入力がhou.SubnetIndirectInputに接続されている場合、それに該当する親サブネットの入力に接続されたノードが返されます。 言い換えれば、間接入力の存在を隠すということです。つまり、その結果のノードは、すべてが呼び出し側のノードの兄弟であるとは限りません。

その入力が接続されていない(または、それが間接入力に接続されていても、それに該当するサブネットの親入力が接続されていない)場合は、None値が返されます。

このノードの指定された入力に接続されているノードを返します。 入力がhou.SubnetIndirectInputに接続されている場合、それに該当する親サブネットの入力に接続されたノードが返されます。 言い換えれば、間接入力の存在を隠すということです。つまり、その結果のノードは、すべてが呼び出し側のノードの兄弟であるとは限りません。

さらに、その入力がSOPsの非プライマリ出力に接続されている場合、返されるノードは、サブネットそのものではなく、SOPネットワーク内のノードになります。 このメソッドを使用することで、このノードの入力に呼応する1番目の出力を持ったノードを取得したい時に、コードが複数出力を考慮しなくて済みます。

その入力が接続されていない(または、それが間接入力に接続されていても、それに該当するサブネットの親入力が接続されていない)場合は、None値が返されます。

このノードの出力に接続されたノードのタプルを返します。

このメソッドは、[connection.outputNode() for connection in self.outputConnections()]のショートカットです。

このノードのトップに繋がっている接続のhou.NodeConnectionオブジェクトのタプルを返します。 このタプルの長さは、このノードに入ってくる接続の数と同じになります。 このノードに何も繋がっていなかった場合は、空っぽのタプルが返されます。

接続されたノード自体のリストを取得するには、hou.Node.inputsを使用します。 (接続の有無に関係なく)接続可能なコネクタのリストすべてを取得するには、hou.Node.inputConnectorsを使用します。

>>> cookie = hou.node("/obj").createNode("geo").createNode("cookie")
>>> cookie.setInput(1, cookie.parent().createNode("box"))
>>> cookie.inputConnections()
(<hou.NodeConnection from grid1 output 0 to cookie input 1>,)
>>> cookie.inputConnectors()
((), (<hou.NodeConnection from grid1 output 0 to cookie input 1>,))

hou.Node.inputConnectorsも参照してください。

このノードの下から繋がっている接続のNodeConnectionオブジェクトのタプルを返します。 このノードの出力に何も繋がっていなかった場合は、空っぽのタプルが返されます。

接続されたノード自体のリストを取得するには、hou.Node.outputsを使用します。

このメソッドは、reduce(lambda a, b: a+b, self.outputConnectors(), ())のショートカットです。 ほとんどのノードは出力コネクタを1つしか持たないので、このメソッドは通常では、self.outputConnectors()[0]と等価です。

>>> box = hou.node("/obj").createNode("geo").createNode("box")
>>> box.parent().createNode("xform").setFirstInput(box)
>>> box.parent().createNode("subdivide").setFirstInput(box)
>>> box.outputConnections()
(<hou.NodeConnection from box1 output 0 to xform1 output 0>, <hou.NodeConnection from box1 output 0 to subdivide1 input 0>)

hou.node.outputConnectorsも参照してください。

hou.NodeConnectionオブジェクトのタプルのタプルを返します。 その結果のタプルの長さは、このノードに接続可能な入力の最大数と同じです。 なにかそのコネクタに接続されていれば、各サブタプルは必ず1個のノード接続を含みます。 何も接続されていなければ、それは空っぽのタプルです。

hou.NodeConnectionとhou.Node.inputConnectionsも参照してください。

hou.NodeConnectionオブジェクトのタプルのタプルを返します。 その結果のタプルの長さは、このノードの出力コネクタの数と同じです。 各サブタプルは、そのコネクタから出ているコネクションすべてを含み、そのコネクタに何も接続されていなければ、それは空っぽのタプルです。

>>> split = hou.node("/obj").createNode("dopnet").createNode("split")
>>> split.parent().createNode("rbdsolver").setFirstInput(split)
>>> split.parent().createNode("gravity").setFirstInput(split, 1)
>>> split.parent().createNode("merge").setFirstInput(split, 1)
>>> split.outputConnectors()
((<hou.NodeConnection from split1 output 0 to rbdsolver1 input 0>,), (<hou.NodeConnection from split1 output 1 to gravity2 input 0>, <hou.NodeConnection from split1 output 1 to merge1 input 0>), (), ())

hou.NodeConnectionとhou.Node.outputConnectionsも参照してください。

サブネットのhou.SubnetIndirectInputオブジェクトを返します。

このノードがサブネットワークでない場合は、hou.InvalidNodeTypeを引き起こします。

サブネットワークの子出力ノードを返します。

SOPsなどの特定のネットワークには、通常のディスプレイノードまたはレンダーノードをオーバーライドして複数の出力を可能にするための特別なOutputノードがあります。 何かしらのOutputノードが存在すれば、これは、それらのノードのリストを返します。 何もOutputノードが存在しなければ、クックのターゲットがディスプレイノードなのか出力ドライバなのかに応じて、ディスプレイノードまたはレンダーノードのどちらかが返されます。 サブネットに何も子がなければ、空っぽのリストが返されます。

このノードの入力ノードすべてのタプルを返します。include_ref_inputsがFalseの場合、参照入力を辿りません。 follow_subnetsがTrueの場合、サブネットワークノードを単一ノードとして扱わず、そのディスプレイノードから始まる子ノードも辿ります。 only_used_inputsがTrueの場合、最後のクックに関係したノードのみを辿ります。

inputs()メソッドも参照してください。

指定した名前のノード入力のインデックスを取得します。

入力名を使用するノードカテゴリに関しては、指定した名前の入力のインデックスを返します。 VOPノードに関しては、その名前が、それに該当する入力を持ったノードパラメータ名にもなります。

指定した名前のノード出力のインデックスを取得します。

入力名を使用するノードカテゴリに関しては、指定した名前の出力のインデックスを返します。

item_to_become_inputがNoneでない場合、他のノードの出力コネクタをこのノードの入力コネクタに接続します。 それ以外の場合、入力コネクタに接続されたすべてのノードの接続を解除します。

output_indexが無効の場合は、hou.InvalidInputを引き起こします。 item_to_become_inputがこのノードと同じネットワーク内にない場合は、hou.OperationFailedを引き起こします。 ノードがロックされたアセット内にある場合は、hou.PermissionErrorを引き起こします。

input_nameで指定されたこのノード上の入力を、output_nameまたはoutput_indexで指定したitem_to_become_input上の出力に接続します。

self.setInput(0, item_to_become_input)のショートカット。 詳細は、hou.Node.setInputを参照してください。

他のノードからの出力コネクタを、このノードの1番目の非接続入力コネクタまたは複数入力コネクタに接続します。 ノードにOrdered InputsとUnordered Inputs(複数入力コネクタ)がある場合、unordered_onlyパラメータを使用することで強制的に入力を、Ordered Inputではなく、Unordered Inputs(複数入力コネクタ)に接続することができます。

このメソッドは、ほぼ以下と等価です:

for input_index, connectors in enumerate(self.inputConnectors()):
    if len(connectors) == 0:
        self.setInput(input_index, item_to_become_input, output_index)
    raise hou.InvalidInput("All inputs are connected")

すべての入力が接続されていれば、hou.InvalidInputを引き起こします。 詳細は、hou.Node.setInputを参照してください。

入力ワイヤーを挿入します。つまり、input_indexの後の入力コネクタ毎に、その入力コネクタの内容を次のコネクタにシフトさせて、 hou.Node.setInputをコールします。パラメータの意味については、hou.Node.setInputを参照してください。

いくつかのノードでは、特有の意味を持つ専用の入力をいくつか持っており、その後に任意の数の追加入力を持っています。 この追加入力では隙間は許可されていません(これらの入力のことをUnordered Inputsと呼びます)。 これは、Multiple Solver DOPなどのDOPノードがそうです。 この関数は、そのUnordered Inputsの前の専用(またはOrdered)の入力の数を返します。 このノードのhou.Node.typeオブジェクトに対してhou.NodeType.hasUnorderedInputs関数がTrueを返す場合は、この関数はゼロ以外の値を返すだけです。

新しくノードを作成し、そのノードをこのノードの入力の1つに接続します。その新しいノードを返します。

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

新しくノードを作成し、その1番目の入力のこのノードの(1番目の)出力に接続します。その新しいノードを返します。

パラメータの詳細は、createNodeメソッドを参照してください。

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

このノードに対して入力名すべてのタプルを返します。不可視の入力コネクタの名前も含まれます。

このノードの入力ラベルすべてのタプルを返します。非表示の入力コネクタのラベルも含まれます。

このノードに対して出力名すべてのタプルを返します。

このノードの出力ラベルすべてのタプルを返します。

指定した入力インデックスに関連のある文字列キー/値のペアの辞書を返します。 これらの文字列の目的は、あるノードタイプを他のノードタイプに変換することです。

このメソッドは、そのノードタイプがこの機能を利用していなければ例外を引き起こします。 そのノードタイプが、編集可能な入力データに対応しているかどうか判断するには、hasEditableInputDataを使用します。

指定した入力インデックスとキーに関連のある文字列を返します。 この文字列の目的は、あるノードタイプを他のノードタイプに可変させることです。

このメソッドは、そのノードタイプがこの機能を使用していない場合に例外を引き起こします。 hasEditableInputDataを使用することで、ノードタイプが編集可能入力データに対応しているかどうかを判断することができます。

指定した入力インデックスとキーに関連のある文字列を設定します。 この文字列の目的は、あるノードタイプを他のノードタイプに可変させることです。

このメソッドは、そのノードタイプがこの機能を使用していない場合に例外を引き起こします。 hasEditableInputDataを使用することで、ノードタイプが編集可能入力データに対応しているかどうかを判断することができます。

ノードがサブネットワークならTrue、そうでないならFalseを返します。

このノードの子ノードのシーケンスを指定すると、それらの子ノードをサブネットワークに折りたたみます。 つまり、このノードのネットワーク内にサブネットが作成され、このネットワークの指定した子をそのサブネット内に移動させます。

child_nodes内のノードがこのネットワークの子でない場合やchild_nodesが空っぽのシーケンスの場合は、hou.OperationFailedを引き起こします。

このサンプルの関数は、単一ノードを受け取り、それをサブネットに置換し、そのノードをサブネットに移動させます..

def collapseSingleNodeIntoSubnet(node, subnet_name=None):
    node.parent().collapseIntoSubnet((node,), subnet_name=None)

このサブネットノードの子を移動させて、このノードの兄弟にし、このノードを削除します。このメソッドは、collapseIntoSubnet()と逆のメソッドです。 抽出されたすべてのアイテムを含んだタプルを返します。

このノードがサブネットワークでない場合は、hou.InvalidNodeTypeを引き起こします。

ノードのコメント文字列を返します。

このノードに関連したコメントを設定します。 appendComment()も参照してください。

指定したテキストを、このノードに関連したコメントに追加します。

ネットワークエディタ内でノードが説明的名前を表示するかどうかを示すブールを返します。

ネットワークディター内でこのノードが説明的名前を表示するかどうか設定します。

このノードから、異なるタイプの最初の親を返します。 単純なネットワークでは、これはparent()と同じですが、その親が同じノードタイプの場合(例えば、どちらもSOPだった場合)、異なるタイプが見つかるまで処理が繰り返されます。 これは、コンテナノードを検索するのに役立ち、例えば、入れ子状になったSOPネットワークについて気にすることなく、SOPが格納されているObjectを検索することができます。 とはいえ、SOPの親が必ずしもObjectであるとは限らないことに注意してください!

ノードをその入力や出力の近くで上手く間隔を空けて動かし、そのノードの新しい位置を返します。

このノードのすべてまたは一部の子ノードをネットワークエディタ内で自動的に配置します。

ノードがネットワークエディタ内で非表示かどうか返します。 Houdiniは、“exposed”という用語を使用して、非表示でないノードを参照することもできます。

可視ノードを不可視ノードに接続した場合、ネットワークエディタは、その可視ノードから不可視ノードまでのワイヤーを破線で表示します。

hou.Node.hideも参照してください。

ネットワークエディタ内にノードを非表示または表示します。不可視ノードに関する詳細は、hou.Node.isHiddenを参照してください。

このノードの最後のクックからのエラーのテキストを返します。エラーがなければ空っぽのタプルが返されます。

このノードの最後のクックからの警告のテキストを返します。警告がなければ空っぽのタプルが返されます。

このノードの最後のクックからメッセージのテキストを返します。メッセージがなければ空っぽのタプルが返されます。

このノード内のネットワークボックスのリストを返します。

このノード内のすべてのネットワークボックスを巡回するジェネレータを返します。

このノード内の指定した名前のネットワークボックスを返します。または指定した名前のネットワークボックスが存在しなかった場合はNoneが返されます。

このノード内のパターンに合致した名前のネットワークボックスのリストを返します。

このネットワーク内にネットワークボックスを作成します。このノードがネットワークでない場合は、hou.OperationFailedを引き起こします。

nameを指定しなかった場合は、Houdiniは、そのネットワークボックスにデフォルトの名前を付けます。

ネットワークボックス名はネットワークエディタペイン内に表示されません。 その代わり、hou.NetworkBox.setCommentメソッドによって“コメント”を指定することができます。 このコメントは、ネットワークボックスのタイトルバーに表示されます。

ネットワークボックスをコピーし、そのコピーを返します。

new_nameを指定した場合、そのネットワークボックスがnew_nameという名前の新しいネットワークボックスにコピーされます(既にその名前のネットワークボックスが存在すれば別の名前が生成されます)。

channel_reference_originalがTrueの場合、そのコピーで作成されたすべてのオペレータは、元のオペレータを参照するように設定されたアニメーション可能なパラメータを持ちます。

このノードがネットワークでない場合や、ノードの子タイプがネットワークボックスのノードタイプに合致しなかった場合は、hou.OperationFailedを引き起こします。

このノード内のステッキーノートのリストを返します。

このノード内のすべてのステッキーノートを巡回するジェネレータを返します。

このノード内の指定した名前のステッキーノートを返します。指定した名前のステッキーノートが存在しなかった場合は、Noneを返します。

このノード内のパターンに合致した名前のステッキーノートのリストを返します。

このネットワーク内にステッキーノートを作成します。このノードがネットワークでない場合は、hou.OperationFailedを引き起こします。

nameを指定しなかった場合、Houdiniは、そのノートをデフォルトの名前にします。

ステッキーノートをコピーして、そのコピーを返します。

new_nameを指定した場合、そのステッキーノートがnew_nameという名前の新しいステッキーノートにコピーされます(既にその名前のステッキーノートが存在すれば別の名前が生成されます)。

このノードがネットワークでない場合や、ノードの子タイプがステッキーノートのノードタイプに合致しなかった場合は、hou.OperationFailedを引き起こします。

このネットワーク内にネットワークドットを作成します。このノードがネットワークでない場合は、hou.OperationFailedを引き起こします。

このネットワーク内のすべてのドットのタプルを返します。

子アイテムのシーケンス(ノード、ネットワークボックス、ステッキーノートなど)を指定すると、このネットワークまたは他のネットワーク内にそれらをペーストできるように、 それらのアイテムがクリップボードに保存されます。

これらのノードまたはネットワークボックスがこのノードの子でない場合は、hou.OperationFailedを引き起こします。 このノードの内容を読み込む権限がない場合は、hou.PermissionErrorを引き起こします。

hou.Node.copyItemsToClipboardを使って保存されたファイルの内容を、このノードの内容に読み込みます。 positionパラメータを2つのfloat値のタプル(またはhou.Vector2のような同等のもの)として指定すると、ペーストしたアイテムが、その位置を中心に配置されるように移動されます。

このノードがネットワークでない場合やクリップボードからアイテムを読み込む時にエラーが発生した場合は、hou.OperationFailedを引き起こします。 このノードがロックされたデジタルアセットインスタンスであれば、hou.PermissionErrorを引き起こします。

Nodeオブジェクト間に==を実装します。

例えば、hou.root() == hou.node(“/”)はTrueを返します。

同じHoudiniノードに対して複数のPython Nodeオブジェクトが存在できます。 hou.node()の2つの同一コールは、異なるPython Nodeオブジェクトを返し、それぞれ同じHoudiniノードを意味します。 ==(別名__eq__)を使用してそれらのノードを比較すると、Trueを返し、 is(オブジェクト同一性テスト)を使用してそれらのノードを比較するとFalseを返します。

Nodeオブジェクト間に!=を実装します。__eq__()を参照してください。

このノードインスタンス上に名前付き文字列を追加/設定します。

この名前/値のペアがHIPファイルに格納され、それがopscriptとhou.Node.asCodeからの出力に含まれます。

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

>>> n = hou.node("/obj").createNode("geo")
>>> n.setUserData("my data", "my data value")
>>> n.userData("my data")
'my data value'
>>> n.userDataDict()
{'my data': 'my data value'}
>>> n.destroyUserData("my data")
>>> n.userDataDict()
{}
>>> print n.userData("my data")
None

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

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

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

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

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

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

def userData(self, name):
    return self.userDataDict().get(name)

この名前のユーザ定義データを削除します。

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

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

すべてのユーザ定義データを削除します。

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

指定したフラグが読み込み可ならTrue、そうでないならFalseを返します。

flagは、hou.nodeFlag値でなければなりません。

指定したフラグが書き込み可ならTrueを、そうでないならFalseを返します。

flagは、hou.nodeFlag値でなければなりません。

指定したフラグの値を返します。

flagは、hou.nodeFlag値でなければなりません。

bool、valueに基づいて、指定したフラグの値を設定します。

flagは、hou.nodeFlag値でなければなりません。