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	to select with a lasso
LMB Double-click on a model	to select/add/remove a polygroup
RMB on a model opens menu	to select/add/remove component, polygroup, material or UDIM
Hold SHIFT while selecting	to add polygons to selection
Hold CTRL while selecting	to remove polygons from selection
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

1. Set source parameter to User input.

2. Set a file name parameter to something like C:/Selections/Selection###.txt

3. 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

4. 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

1. Set a file name parameter to something like C:/Selections/Selection###.txt

2. Set source parameter to File.

3. Switch to frame 0 on the Timeline. The selection will be automatically loaded from file C:/Selections/Selection000.txt

4. Switch to frame 1. That will load a corresponding selection from file C:/Selections/Selection001.txt