詳細は、Crowd Agentsを参照してください。
メソッド ¶
__init__(filename, keep_external_ref = True)
指定したJSONファイルからエージェントリグを読み込むことで、新しいエージェントリグを作成します。
ファイルが存在しない、または読み込むことができなかった場合はhou.OperationFailedを引き起こします。
filename
JSONファイルのパス。
keep_external_ref
エージェントをジオメトリファイルに保存した時に外部参照を維持するかどうかを示すbool
。
外部参照を維持した場合、(リグファイルのパスのみがジオメトリファイルに保存されているので)その保存したジオメトリを使用する時には、そのリグファイルが利用可能な状態になっている必要があります。
維持しなかった場合、ジオメトリを保存した時に、そのリグのコピーが埋め込まれるので、元のリグファイルは、もはや不要です。
__init__(name, transform_names, hierarchy)
指定したトランスフォーム階層から新しいエージェントリグを作成します。
name
新しいリグの名前。
transform_names
トランスフォーム名のシーケンス。
hierarchy
transform_names
内のトランスフォーム毎に、transform_names
内のその子のインデックスを指定したint
シーケンスのシーケンス。
hou.AgentRig.transformHierarchyを参照してください。
以下のサンプルでは、“b”と“c”のトランスフォームが“a”トランスフォームの子になっている単純なリグを作成する方法を載せています。
transforms = ["a", "b", "c"] hierarchy = [ [1, 2], [], [] ] rig = hou.AgentRig("my_rig", transforms, hierarchy)
addChannel(name, default_value=0.0, transform=-1)
リグに新しいチャンネルを追加します。 同じ名前のチャンネルが既に存在している場合、デフォルト値などのプロパティが上書きされます。
リグが変更不可の場合、hou.GeometryPermissionErrorを引き起こします。
name
チャンネルの名前。
`default_value
チャンネルのデフォルト値を含んだfloat
。
`transform
チャンネルに関連付けるトランスフォームのオプションのインデックス。
channelCount()
→ int
リグ内のチャンネル数を返します。
channelDefaultValue(channel_index)
→ float
指定したチャンネルのデフォルト値を返します。
channel_index
リグ内のチャンネルのインデックス。
channelTransform(channel_index)
→ int
指定したチャンネルに関連付けられているトランスフォームインデックスを返します。なければ、-1を返します。
channel_index
リグ内のチャンネルのインデックス。
channelName(channel_index)
→ str
指定したチャンネルの名前を返します。
channel_index
リグ内のチャンネルのインデックス。
childIndices(transform)
→ tuple
of int
指定されたトランスフォームの子を返します。
transform
リグでのトランスフォームのインデックス。
fileName(expanded = False)
→ str
リグが外部参照の場合、ディスク上のファイルのパスを返します。
expanded
パス内の変数(例えば$HIP
)を展開するかどうかを指定します。
findChannel(channel_name)
→ int
指定した名前のチャンネルのインデックスを返します。チャンネル名が無効の場合は-1を返します。
channel_name
リグ内のチャンネルの名前。
findTransform(transform_name)
→ int
指定された名前を持つトランスフォームのインデックス、または、 トランスフォームの名前が無効の場合は、-1を返します。
transform_name
リグでのトランスフォームの名前。
freeze()
→ hou.AgentRig
変更可能なリグのコピーを作成します。 このコピーは、外部参照としてマークされません。
isExternalReference()
→ bool
リグがディスク上のファイルを参照しているかどうかを示したbool
を返します。
name()
→ str
リグの名前またはファイル名を返します。
parentIndex(transform)
→ int
指定されたトランスフォームの親、または、 トランスフォームがトランスフォームの階層のルートにある場合は、-1を返します。
transform
リグでのトランスフォームのインデックス。
restLocalTransform(transform)
→ hou.Matrix4
階層内の指定したインデックスのローカル空間Restトランスフォームを返します。
transform
リグでのトランスフォームのインデックス。
restWorldTransform(transform)
→ hou.Matrix4
階層内の指定したインデックスのワールド空間Restトランスフォームを返します。
transform
リグでのトランスフォームのインデックス。
setRestLocalTransforms(xforms)
リグにローカル空間Restトランスフォームを設定します。
リグが変更不可の場合、hou.GeometryPermissionErrorを引き起こします。
xforms
リグ内のジョイント毎のローカル空間トランスフォームを含んだhou.Matrix4のシーケンス。 このシーケンス長がhou.AgentRig.transformCountと同じでない場合、hou.InvalidSizeを引き起こします。
transformCount()
→ int
リグでのトランスフォームの数を返します。
transformName(transform)
→ str
指定されたトランスフォームの名前を返します。
transform
リグでのトランスフォームのインデックス。
transformNames()
→ tuple
of str
リグでのトランスフォーム名のリストを返します。
transformHierarchy()
→ tuple
of tuple
of int
リグでの各トランスフォームの子インデックスのリストを返します。