NodeIcon 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:

../../_images/SelectPolygonsEditor.jpg
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 Fnput

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. Supports Path Interpretation.

Export:

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

Import:

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