copyNodesTo(nodes, destination_node) -> tuple of Nodes
コピーされるノードは、hou.OpNodeオブジェクトのシーケンスでなければなりません。 そのdestination_nodeは、新しくコピーされたノードの親になります。 すべてのソースノードのタイプは、destination_nodeの子タイプと同じでなければなりません。
この関数は、コピーされるノードに相当するhou.OpNodeオブジェクトのタプルを返します。
ノードは、コピー先の親に基づいて、束単位で目的先にコピーされます。 各束内のすべてのノードは同時にコピーされます。 このようにして、同じ親を持つノード間の相対チャンネル参照は、コピーされたノードの位置を反映して更新されます。 束自体は、順々にコピーされます。 つまり、親が異なるノード間のチャンネル参照は、コピーに対して更新されません。
コピーされるノードすべてに関しては、同じ名前のノードが既にコピー先に存在すれば、そのコピーの名前が変更されます。 そのコピーの相対チャンネル参照は、その新しいコピー名で更新されます。
この関数は、コピーされるノードのどれかが無効なタイプだったり、destination_nodeへコピーできなかったり、 ソースノードタイプがdestination_nodeの子タイプと同じでない場合に、hou.OperationFailed例外を引き起こします。
この関数は、ソースノードやdestination_nodeがHoudini内に存在していなかった場合にhou.ObjectWasDeletedを引き起こします。
部分コピーを回避するために、ソースとターゲットのノードに関する上記の問題すべてが、コピーを開始する前に報告されます。
この関数が実行を終えると、作成された新しいノードすべてが選択されます。