このオブジェクトで表現されたネットワークアイテムのタイプを示した列挙値を返します。 この値は、isinstanceビルトインPython関数でそれに一致したクラスを使用することと等価です(例えば、hou.networkItemType.Connectionはhou.NodeConnectionと等価です)。

このノードの名前を返します。hou.NetworkMovableItem.pathも参照してください。

このノードの名前を設定します。その新しい名前に英数字、.、-、_以外の文字が含まれている場合、hou.OperationFailedを引き起こします。 ノードの名前を変更できなかった場合(例えば、他のノードで同じ名前が既に使用されていたり、そのノードがルートノードまたはトップレベルマネージャ(例えば、/obj)だったり、そのノードがロックアセット内にある場合)は、hou.OperationFailedを引き起こします。 unique_nameパラメータをTrueに設定すると、指定した名前が既存ノードの名前と被らないように変更させることができます。

ノードの名前の最後の桁の値を返します。 桁がなければ0を返します。

例えば、geo102ノードは102、light12to34ノードは34を返します。

ネットワーク内のこのノードのフルパス(つまり、/から始まります)を返します。

他のノードオブジェクトを基準として、このノードの相対パスを返します。

>>> box1 = hou.node("/obj/box_object1/box1")
>>> sphere1 = hou.node("/obj/sphere_object1/sphere1")
>>> box1.relativePathTo(sphere1)
'../../sphere_object1/sphere1'
>>> hou.node("/obj").relativePathTo(box1)
'box_object1/box1'
>>> box1.relativePathTo(box1)
'.'

このアイテムを含んだノードを返します。

そのアイテムがルートノード(つまり、/)であれば、このメソッドはNoneを返すことに注意してください。

>>> hou.node("/obj/box_object1").parent()
<hou.Node at /obj>
>>> print hou.node("/").parent()
None

このアイテムを含んだ親のネットワークボックスを返します。それがネットワークボックスに含まれていなければNoneを返します。

このアイテムが選択されているかどうかを返します。

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

hou.NetworkMovableItem.isSelectedをコールする事と等価です。

このアイテムを選択または選択解除します。オプションで、このネットワーク内で選択されているアイテム以外すべてを選択解除することができます。 show_asset_if_selectedがTrueで、このアイテムがNodeの場合、このペインは、代わりに選択したアイテムのトップレベルのアセットを表示します。

すべてのオプションのパラメータのデフォルト値でhou.NetworkMovableItem.setSelectedをコールする事と等価です。

ネットワークエディタ内のこのアイテムのタイルのカラーを返します。

指定したhou.Colorで、ネットワークエディタ内のこのアイテムのタイルのカラーを設定します。

指定したHoudiniセッション内でこのアイテムを固有に識別するための整数値を返します。 このIDは、単一Houdiniプロセス内でのみ固有であることが保証されます。 このIDは、アイテムの保存、復元、参照をするのが簡単になるので便利です。 また、このIDは特定のアイテムサブクラスに対しても固有です。 そのため、NetworkBoxと同じセッションIDを持つNodeが存在することがあります。

セッションIDからノードを取得するにはhou.nodeBySessionId()を、セッションIDからネットワークボックスを取得するにはhou.networkBoxBySessionId()を、 もっと汎用的にセッションIDとアイテムサブクラスを示した列挙値を組み合わせてそのタイプのアイテムを取得するにはhou.itemBySessionId()を参照してください。

ネットワークエディタグラフ内のこのアイテムのタイルの位置をVector2として返します。 move()とsetPosition()も参照してください。

ネットワークエディタグラフ内のこのアイテムのタイルの位置を設定します。 アイテムの位置を動かせなかった場合は、hou.InvalidInputを引き起こします。

ネットワークエディタグラフ内のこのアイテムのタイルを、指定したhou.Vector2の分だけ動かします。

アイテムを絶対位置で動かすには、setPosition()を使用します。

アイテムの現行グラフ位置を取得するには、position()を使用します。

指定した位置にアイテムを動かせなかった場合は、hou.InvalidInputを引き起こします。

hou.NetworkMovableItem.moveをコールする事と等価です。

ネットワークエディタグラフ内のこのアイテムのタイルのサイズをVector2として返します。

指定したパスのノードを返します。ノードが見つからなければ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値でなければなりません。

このノードの特定の出力のデータを可視化するためのノードを作成します。 現行ネットワーク内に既にビジュアライザノードが存在する場合には、そのビジュアライザノードが、ここで指定した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ノードがすべてのワークアイテムを表示できない場合に表示させるワークアイテムサブセット(ページ)を設定します。