エージェント定義には、リグ、シェイプライブラリ、レイヤー、クリップが含まれており、それらをエージェントプリミティブ間で共有することができます。 詳細は、Agent Primitivesを参照してください。
エージェント定義はエージェントプリミティブ(例えば、上流SOPのジオメトリ内のエージェント)のコピー間で共有されるので、 hou.Agent.definition()が返すエージェント定義は読み取り専用です。 hou.AgentDefinition.freeze()メソッドを使用すれば、編集可能なエージェント定義のコピーを作成することができます。
メソッド
__init__(rig, shapelib)
新しい(そして編集可能な)エージェント定義を作成します。
rig
エージェント定義が参照するhou.AgentRig。
shapelib
エージェント定義が参照するhou.AgentShapeLibrary。
addClip(clip)
クリップをエージェント定義に追加します。
エージェント定義が編集不可ならhou.GeometryPermissionErrorを引き起こします。
クリップが別のリグと関連付けられていればhou.OperationFailedを引き起こします。
clip
addLayer(layer)
レイヤーをエージェント定義に追加します。
エージェント定義が編集不可ならhou.GeometryPermissionErrorを引き起こします。
レイヤーが別のリグまたはシェイプライブラリと関連付けられていればhou.OperationFailedを引き起こします。
layer
addTransformGroup(group)
トランスフォームグループをエージェント定義に追加します。
エージェント定義が編集不可ならhou.GeometryPermissionErrorを引き起こします。
グループが別のリグと関連付けられていればhou.OperationFailedを引き起こします。
group
findClip(name)
→ hou.AgentClip
指定した名前のクリップを検索します。そのようなクリップがなければNoneを返します。
findLayer(name)
→ hou.AgentLayer
指定した名前のレイヤーを検索します。そのようなレイヤーがなければNoneを返します。
findTransformGroup(name)
→ hou.AgentTransformGroup
指定した名前のトランスフォームグループを検索します。そのようなグループがなければNoneを返します。
freeze(new_shapelib = None)
→ hou.AgentDefinition
編集可能なエージェント定義のコピーを作成します。 1つ以上のエージェントが新しいエージェント定義を使用するように変更するには、hou.Agent.setDefinition()を使用します。
new_shapelib
これを指定すると、コピーしたエージェント定義とそのレイヤーが、新しいシェイプライブラリを参照します。
removeClip(name)
removeLayer(name)
removeTransformGroup(name)
エージェント定義からトランスフォームグループを削除します。
エージェント定義が編集不可ならhou.GeometryPermissionErrorを引き起こします。
name
削除するトランスフォームグループの名前。
transformGroups()
→ tuple
of hou.AgentTransformGroup
エージェント定義内のトランスフォームグループのリストを返します。
See also |