Edge groups reside inside the geometry, and each edge group has a unique name.
See hou.Edge for more information about edges. See also hou.PrimGroup, hou.PointGroup, and hou.VertexGroup.
Methods ¶
name()
Return the name of the group. Each edge group has a unique name.
geometry()
→ hou.Geometry
Return the geometry object containing this group.
edges()
→ tuple
of hou.Edge
Return the contents of this group.
See also hou.EdgeGroup.iterEdges.
iterEdges()
→ generator of hou.Edge
Return a generator that iterates through all the contents of this group.
Whereas hou.EdgeGroup.edges allocates and returns a tuple of all the edges in the group, this method returns a generator object that will yield hou.Edge objects on demand.
contains(edge)
→ bool
Return whether or not an edge is in this group.
Raises hou.OperationFailed if the edge belongs to a different geometry object than this group.
edgeCount()
→ int
Returns the number of edges in this group.
add(edge_or_list_or_edge_group)
If given a hou.Edge or a list of hou.Edge's, add the edge(s) to the group. If given a hou.EdgeGroup, merge the contents of the other edge group with this group (the other group is unaffected). You would typically call this method from the code of a Python-defined SOP.
It is ok to add edges to the group that were already in the group.
Raises hou.GeometryPermissionError if this geometry is not modifiable.
Raises hou.OperationFailed if the edge or edge group belong to a different geometry object than this group.
remove(edge_or_list_or_edge_group)
If given a hou.Edge or a list of hou.Edge's, remove the edge(s) from the group. If given a hou.EdgeGroup, remove all edges in the other group from this group (the other group is unaffected). You would typically call this method from the code of a Python-defined SOP.
It is not an error to try to remove an edge from the group that wasn’t already in the group.
Raises hou.GeometryPermissionError if this geometry is not modifiable.
Raises hou.OperationFailed if the edge belongs to a different geometry object than this group.
clear()
Remove all edges from this group. You would typically call this method from the code of a Python-defined SOP.
The edges remain in the geometry; only the group is affected.
Raises hou.GeometryPermissionError if this geometry is not modifiable.
destroy()
Remove this group from the geometry. You would typically call this method from the code of a Python-defined SOP.
Raises hou.GeometryPermissionError if this geometry is not modifiable.
dataId()
Returns the data id that represents the contents of this group.
incrementDataId()
Increment the data id to indicate that the contents of this group has changed.