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