Group | AnimGraphLab Documentation

Nodes ›Group

Group node allows to create selections of shapes/points. These groups can be targeted by other nodes, like Transform or Color downstream, to apply modifications to a subset of geometry.

Parameters

Parameter	Description
`Label`	The display name for the node.
`Group name`	The name used to reference this group.
`Base group`	Optional existing group to merge with. If empty, uses Group name.
`Operation`	How to resolve collisions with an existing group.
`Group`	Specifies a subset of items to affect. Use commas to separate multiple patterns. Supports wildcards (*, ?).

Internal parameter names

These parameters can be used in:

Expressions: =ref('node name', 'parameter name')
Attribute randomize node, 'parameter' input.

Parameter name	UI label
`baseGroup`	Base group
`group`	Group
`groupName`	Group name
`label`	Label
`mergeOp`	Operation

Group types

Manual selection

Allows to use a selection tool on the canvas to manually pick entire shapes or individual points on a path. Use Shift+Drag to add to your selection and Alt+Drag to remove from it.

Pattern

Selects shapes based on a name-matching pattern or index. The following special characters can be used:

Pattern	Description
`*`	Wildcard. Matches any number of characters (`leg*`).
`^`	Exclusion. Placed at the start to exclude matching items (`* ^leg_foot`).
`,`	Separator. Used to combine multiple patterns (`Circle 1, Star 1`).

Bounding box

Selects any shapes or points that fall within a defined rectangular area.

Match bounds: automatically sizes the selection box to fit all incoming geometry.
Partial selection: when enabled, shapes that only partially intersect the box boundaries will be included.

You can connect any shape (like a Rectangle or Circle) into the Group node's secondary Driver input. When connected, bounding box mode will automatically use the dimensions and position of that driver shape to make the selection.

Percent

Selects a specified percentage of the total incoming shapes or points. Control the origin of the selection using the Mode dropdown:

From start: selects the first X%.
From end: selects the last X%.
From center: selects the middle X%.

Random selection

Works on a point-by-point or shape-by-shape basis. It selects items randomly based on a Seed and a Probability value (0 to 1).

Color match

Selects shapes based on their HEX color. You can target shapes Fill, Stroke or both.

Target color: HEX base color to compare against.
Tolerances: Adjustable thresholds for Hue, Saturation, and Value. Increasing these allows for selecting ranges of similar colors (e.g., selecting all shades of "Red").