エージェント定義には、リグ、シェイプライブラリ、レイヤー、クリップが含まれており、それらをエージェントプリミティブ間で共有することができます。 詳細は、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, new_rig = None)
→ hou.AgentDefinition
編集可能なエージェント定義のコピーを作成します。 1つ以上のエージェントが新しいエージェント定義を使用するように変更するには、hou.Agent.setDefinitionを使用します。
new_shapelib
これを指定すると、コピーしたエージェント定義とそのレイヤーが、新しいシェイプライブラリを参照します。
new_rig
これを指定すると、コピーしたエージェント定義(とそのクリップ、レイヤー、トランスフォームグループ)が、新しいリグを参照します。
metadata()
→ hou.AgentMetadata
エージェント定義のメタデータを返します。
エージェント定義に何もメタデータがなければ、これはNone
を返します。
removeClip(name)
removeLayer(name)
removeTransformGroup(name)
エージェント定義からトランスフォームグループを削除します。
エージェント定義が編集不可ならhou.GeometryPermissionErrorを引き起こします。
name
削除するトランスフォームグループの名前。
setMetadata(metadata)
エージェント定義のメタデータを置換します。 エージェント定義が編集不可ならhou.GeometryPermissionErrorを引き起こします。
metadata
transformGroups()
→ tuple
of hou.AgentTransformGroup
エージェント定義内のトランスフォームグループのリストを返します。
See also |