頂点グループはジオメトリ内で存在し、各頂点グループの名前は固有です。
グループには順番通りのものとそうでないものがあります。
順番通りのグループの内容を問い合わせると、その結果は、グループに追加された順番で返されます。
そうでないグループに関しては、その結果は任意の順番(とはいえ、通常では頂点番号の昇順)で返されます。
Group SOPを使用してグループを作成する時は、Create Orderedチェックボックスを有効にすることで、順番通りのグループが作成されます。
Pythonからグループを作成する時は、hou.Geometry.createVertexGroupのis_ordered
パラメータを使用することで、グループを順番通りにするかどうかを制御することができます。
頂点に関する詳細は、hou.Vertexを参照してください。 また、hou.PrimGroup, hou.PointGroup, hou.EdgeGroupも参照してください。
メソッド ¶
name()
グループの名前を返します。各頂点グループの名前は固有です。
vertices()
→ tuple
of hou.Vertex
このグループの内容を返します。
hou.VertexGroup.iterVerticesも参照してください。
iterVertices()
→ generator of hou.Vertex
このグループ内のすべての内容をループするジェネレータを返します。
hou.VertexGroup.verticesは、グループ内のすべての頂点をタプルに割り当てて、そのタプルを返すのに対して、 このメソッドは、要求に応じてhou.Vertexオブジェクトをyieldするジェネレータオブジェクトを返します。
contains(vertex)
→ bool
このグループの頂点かどうか返します。
頂点が、このグループではなく別のジオメトリオブジェクトに属している場合、hou.OperationFailedを引き起こします。
vertexCount()
→ int
このグループ内の頂点の数を返します。
isOrdered()
→ bool
このグループに順番が決められているかどうかを返します。
add(vertex_or_list_or_vertex_group)
hou.Vertexまたはhou.Vertexのリストを指定すると、その頂点がグループに追加されます。 hou.VertexGroupを指定すると、他の頂点グループの内容がこのグループに結合されます(他のグループは影響を受けません)。 通常では、Python定義のSOPのコードからこのメソッドをコールします。
グループに既に入っている頂点をグループに追加しても構いません。
このジオメトリが修正不可なら、hou.GeometryPermissionErrorを引き起こします。
頂点または頂点グループが、このグループではなく別のジオメトリオブジェクトに属している場合、hou.OperationFailedを引き起こします。
remove(vertex_or_list_or_vertex_group)
hou.Vertexまたはhou.Vertexのリストを指定すると、その頂点がグループから削除されます。 hou.VertexGroupを指定すると、このグループから、他のグループの頂点すべてを削除します(他のグループは影響を受けません)。 通常では、Python定義のSOPのコードからこのメソッドをコールします。
グループから、そのグループにまだ入っていない頂点の削除をしてもエラーにはなりません。
このジオメトリが修正不可なら、hou.GeometryPermissionErrorを引き起こします。
頂点が、このグループではなく別のジオメトリオブジェクトに属している場合、hou.OperationFailedを引き起こします。
clear()
このグループから頂点すべてを削除します。通常では、Python定義のSOPのコードからこのメソッドをコールします。
頂点はジオメトリ内に残ります。グループのみが影響を受けます。
このジオメトリが修正不可なら、hou.GeometryPermissionErrorを引き起こします。
destroy()
ジオメトリからこのグループを削除します。通常では、Python定義のSOPのコードからこのメソッドをコールします。
このジオメトリが修正不可なら、hou.GeometryPermissionErrorを引き起こします。
options()
→ dict
of str
to bool
, int
, float
, str
この頂点グループに追加されているオプションを含んだ辞書を返します。
この辞書の内容は、ジオメトリファイルに保存されます。
hou.VertexGroup.option, hou.VertexGroup.setOption, hou.VertexGroup.removeOptionも参照してください。
option(name)
→ bool
, int
, float
, str
, hou.Vector2, hou.Vector3, hou.Vector4, hou.Quaternion, hou.Matrix3, hou.Matrix4, tuple of int
, or tuple of float
個々のオプションの値を返し、そのようなオプションがなければNone
を返します。
hou.VertexGroup.options, hou.VertexGroup.setOption, hou.VertexGroup.removeOptionも参照してください。
optionType(name)
→ hou.fieldType enum value
オプションに保存されたデータのタイプを記述したhou.fieldType列挙値を返します。
その名前のフィールドがなければhou.fieldType.NoSuchField
を返します。
setOption(name, value, type_hint = hou.fieldType::NoSuchField)
オプションの辞書にエントリーを設定します。詳細は、hou.VertexGroup.optionsを参照してください。
name
設定するオプションの名前。
value
整数, 浮動小数点, 文字列, hou.Vector2, hou.Vector3, hou.Vector4, hou.Quaternion, hou.Matrix3, hou.Matrix4, 数値シーケンス。
type_hint
指定した値のタイプが、タイプを明確に決めるのに十分でなかった時に、正確にhou.fieldTypeを決定するために使用されます。
removeOption(name)
オプションの辞書からエントリーを削除します。詳細は、hou.VertexGroup.optionsを参照してください。
この名前の辞書にエントリーがなかった場合、hou.OperationFailedを引き起こします。
dataId()
このグループの内容を表現したデータIDを返します。
incrementDataId()
このグループの内容が変わったことを示すためにデータIDを上げます。