|On this page|
Elements can occur in more than one group. Groups are used in many parts of the Parameter Editor to specify which portions of input geometry you wish an operator to act upon.
You can also create ordered groups. To do so, enable the Ordered checkbox.
This operator is very powerful and is ideal for combining geometry that is similar. For example, all the primitive geometry of a group of door structures for a three-dimensional architectural model could be grouped together and consequently scaled and re-sized together using a Transform node. Works in conjunction with most filter nodes.
Group name specifiers become very powerful when you use pattern matching in your group specifiers.
Using Group Geometry
Creating groups based on point attributes
You can create groups based on point/primitive attributes using the Base Group tab and group specification syntax.
For example, to create a group containing all points with Y position greater than
In the parameter editor for the Group node, click the Base Group tab.
In the Base Group field (below Base Group), set value to
In this example,
P is the name of the position vector attribute,
.y takes the Y component of the vector, and
>0 selects points where the component is greater than 0. See the
@ group specification syntax for more information. Note that the
@ syntax does not allow spaces.
The geometry on which to create the groups.
Bounding geometry. (Only works for point or vertex groups when selecting by bounding geometry.)
Accepts all geometry.
The name of the group to create.
Whether to create a primitive, point, edge, or vertex group.
How to resolve collisions between the newly created group with an already existing group.
The newly created group will replace the existing group.
Union With Existing
The group will consist of the union between the newly created group and the already existing group.
Intersect With Existing
The group will consist of the intersection between the newly created group and the already existing group.
Subtract From Existing
The group will consist of the contents of the already existing group that are not also in the newly created group.
Enables grouping by pattern.
Enter the pattern to be grouped. This handles normal adhoc group syntax.
Orders the points/primitives in the group in the order they are entered. Useful when skinning.
What sort of primitives to allow in the group.
Keep in Bounding Regions
Enable grouping by bounding volume.
Shape of bounding volume.
Size of bounding volume.
Center of bounding volume.
The iso surface of volume to do the grouping with. Points whose volume value are less than this will be grouped. A value of 0 is good for SDF volumes. For fog volumes, use a value of 0.5 and turn on Invert Volumes for best results.
Inverts sense of being inside the volume.
Include Partially Contained Entities
Include entities that are not wholly contained within the bounding object. For example, an edge might cross into a bounding box but neither point is in the bounding box.
Keep by Normal
Enable grouping by normal. This is not yet supported for vertex groups.
Groups primitives facing away from this object.
Unlike grouping by normal this operation will remove items that satisfy the backface condition from any group created via another tab. If no other group is created, this operation will add satisfying items.
Groups polygons that are non-planar given the tolerance.
Polygons that are non-planar will be added to the group regardless of the other tabs.
Normal direction to group by.
Deviation from the direction to allow in the group.
Include by Edges
Points, primitives, and edges that match the edge grouping rules will be in the final group regardless of the other tabs.
Enables edge grouping. This is not yet supported for vertex groups.
Min Edge Angle
Groups primitives with at least this angle between their normals. For edge groups, an edge is included in the group if the two primitives that share it satisfy this angle requirement.
Max Edge Angle
Groups primitives with at most this angle between their normals. For edge groups, an edge is included in the group if the two primitives that share it satisfy this angle requirement.
Edge Angle Uses Angle Between Edges
For edge groups only, when this option is checked edges are included in the group based on the angle between themselves, instead of the angle between the primitives that share them.
Each edge is compared against all other edges that share a point with it.
Min Edge Length
Groups edges that have at least this length.
Max Edge Length
Groups edges that have at most this length.
Number of edges away from the points in Point Group.
Points around which group is centered.
Create Boundary Groups
Create groups containing surface boundary points.