詳細は、Crowd Agentsを参照してください。
メソッド ¶
__init__()
空っぽの(そして編集可能な)エージェントシェイプライブラリを作成します。
__init__(geometry, name = "")
ジオメトリ表現からエージェントシェイプライブラリを読み込むことで、新しいエージェントシェイプライブラリを作成します。
そのシェイプライブラリを読み込むことができなかった場合はhou.OperationFailedを引き起こします。
geometry
シェイプライブラリの読み込み元のhou.Geometry。
name
新しいシェイプライブラリの名前。
__init__(filename, keep_external_ref = True)
指定したジオメトリファイルからエージェントシェイプライブラリを読み込むことで、新しいエージェントシェイプライブラリを作成します。
そのファイルが存在しない、または読み込むことができなかった場合はhou.OperationFailedを引き起こします。
filename
ジオメトリファイルのパス。
keep_external_ref
エージェントをジオメトリファイルに保存した時に外部参照を維持するかどうかを示すbool
。
外部参照を維持した場合、(シェイプライブラリのパスのみがジオメトリファイルに保存されているので)その保存したジオメトリを使用する時には、そのシェイプライブラリが利用可能な状態になっている必要があります。
維持しなかった場合、ジオメトリを保存した時に、そのシェイプライブラリのコピーが埋め込まれるので、元のシェイプライブラリは、もはや不要です。
addShape(name, geometry)
→ hou.AgentShape
新しいシェイプをシェイプライブラリに追加します。
シェイプライブラリが編集不可ならhou.GeometryPermissionErrorを引き起こします。
name
新しいシェイプの名前。
geometry
シェイプのジオメトリを含んだhou.Geometry。
data()
→ hou.Geometry
シェイプライブラリのジオメトリ表現を返します。これをディスクに保存することができます。
fileName(expanded = False)
→ str
シェイプライブラリが外部参照の場合、ディスク上のファイルのパスを返します。
expanded
パス内の変数(例えば$HIP
)を展開するかどうかを指定します。
freeze(keep_external_ref = False)
→ hou.AgentShapeLibrary
編集可能なシェイプライブラリのコピーを作成します。
keep_external_ref
元のシェイプライブラリがディスク上のファイルを参照していた場合、新しいシェイプライブラリが元のライブラリを 含んでいる ものとしてマークするかどうかを指定します。 有効な場合、新しいシェイプライブラリを保存することで、元のライブラリに含まれていないシェイプと、元のライブラリに含まれていたシェイプライブラリのパスのみが書き出されます。 無効な場合、新しいシェイプライブラリを保存することで、すべてのシェイプが含まれたスタンドアローンなライブラリが生成されます。
isExternalReference()
→ bool
シェイプライブラリがディスク上のファイルを参照しているかどうかを示したbool
を返します。
findShape(shape_name)
→ hou.AgentShape
指定した名前のシェイプを検索し、そのようなシェイプがなければNoneを返します。
name()
→ str
シェイプライブラリの名前またはファイル名を返します。