SelectPolygons¶

Selects polygons on geometry, provides a set of tools to modify selections like loop, grow and invert selection. SelectPolygons node also allows loading/saving sequences of polygon selections to/from file.

Editor¶

The SelectPolygons node has an editor that lets you create and modify polygon selections.

Use LMB click to select a single polygon. Use LMB click and drag for lasso selection.

Hold SHIFT while selecting to add polygons to selection. Hold CTRL to remove polygons from selection.

Double-click on a model to select a model component (a set of connected polygons).

SHIFT + double-click near selected polygons to select a loop (only available for manifold geometry).

The editor has a toolbar with a set of useful tools:

Grow: grow selection by one row of polygons
Shrink: shrink selection by one row of polygons
Loop: loop selection. Requires at least two polygons to be selected. Only available for manifold geometry.
Invert: invert selection
Hide selection: hide selected polygons, makes it easier to select inner parts of a model like mouth-socket
Unhide all: unhide all
+ Polygroup: choose a polygroup name from drop-down list to load selection from specific polygroup to add it to current selection
- Polygroup: choose a polygroup name from drop-down list to load selection from specific polygroup to subtract it from current selection
+ Material: choose a material name from drop-down list to load selection from specific material to add it to current selection
- Material: choose a material name from drop-down list to load selection from specific material to subtract it from current selection

Inputs¶

geometry: Geometry An input geometry

Output¶

PolygonSelection PolygonSelection

Parameters¶

display

Standard: displays geometry as is.
Polygroups: highlights each polygroup (if the geometry has polygroups) with unique color.
Materials: highlights each material (if the geometry has materials) with unique color.

source

User input: the selection is defined by user and can be modified within the Editor
File: the selection is loaded from a file defined by file name parameter. The selection can not be modified by user.

file name

defines a file to save points to or to load points from in User input or File modes. If the file name contains # characters, they will be replaced with current frame number when saving/loading the selection.

save

save current selection to a file (defined by file name parameter). Only available in User input mode.

load

load selection from file (specified by file name parameter). Only available in User input mode.

clear

clear current selection . Only available in User input mode.

File Format¶

Wrap can import/export polygon selection data to a text file in JSON format. The format is compatible with WrapX. The format represents selection in the following way:

[0, 1, 55, 100]

Where 0, 1, 55 and 100 are indices of selected polygons.

Tip

Use # characters in file name so save/load sequences of selection. The characters will be substituted with a current frame number during import/export.

Save a Sequence of Selections¶

Set source parameter to User input.
Set a file name parameter to something like C:/Selections/Selection###.txt
Switch to frame 0 on the Timeline, select a set of polygons in Editor and click Save. The selection will be saved to file C:/Selections/Selection000.txt
Switch to frame 1, change the selection and click Save again. That will save the selection for the current frame to a corresponding file C:/Selections/Selection001.txt

Load a Sequence of Selections¶

Set a file name parameter to something like C:/Selections/Selection###.txt
Set source parameter to File.
Switch to frame 0 on the Timeline. The selection will be automatically loaded from file C:/Selections/Selection000.txt
Switch to frame 1. That will load a corresponding selection from file C:/Selections/Selection001.txt