Feature Selector in action.
The Feature Selector node generates a grayscale mask from a selection of features in the input texture.
The node defines a feature as a region of pixels. The node identifies features in the input texture automatically. You cannot manually define a feature area, but you can use the node properties to influence how the node identifies features. For a list of available properties and what they do, see the Properties section below.
To create a selection from one or more features, you can bring the node into the 2D Viewport and use the node’s 2D Viewport Overlay.
When you execute the node, it creates and outputs a black and white mask texture. The white pixels in this texture represent the features you selected. The rest of the texture is black.
From the features the node identifies, you can select the ones to include in the output mask. To create and adjust a feature selection:
When using the 2D Viewport Overlay, you can further manipulate the selection in the following ways:
An alternative way to select features is by using the Lasso Selection tool. This allows you to draw a polygonal lasso by placing multiple points in the 2D Viewport. When you close the lasso, the node creates a new selection from the features that are inside the lasso area.
Note: The Lasso Selection tool only selects features that are completely enclosed within the lasso area.
To use Lasso Selection:
Below is a complete list of shortcuts for working with the 2D Viewport Overlay.
Action | Description |
---|---|
Left-click | Select a single feature (left-click on its region in the viewport). |
Left-click and drag | Select one or more features (left-click and drag over their regions in the viewport). |
Ctrl + left-click | Deselect a single feature. |
Ctrl + left-click and drag | Deselect one or more features. |
Shift + left-click | Add a single feature to the current selection. |
Shift + left-click and drag | Add one or more features to the current selection. |
L | Press to activate or deactivate the Lasso Selection tool. |
To create a new mask, select the features you want to include and execute the node.
The Feature Selector node outputs the mask as a texture, which you can export or use elsewhere in the Node Graph of your project.
Node category | Paint |
---|---|
Node execution style | Manual |
Input Type | Description |
---|---|
Bitmap | The input texture you want to select features from. |
Output Type | Description |
---|---|
Bitmap (Mask) | The output mask texture, which contains a representation of the selection. |
Property/Setting | Description |
---|---|
Granularity | Controls the size and number of features that the node breaks the input texture into. Higher values produce a higher number of, smaller features. |
Color | Controls how strongly color similarity influences the formation of feature regions. At higher values, the node is more selective in judging colors as similar. As a result, the feature borders follow different colors more precisely. |
Regularity | Control how blocky the features are. At higher values, features maintain a primarily square shape and are more similar to each other in size. |
Smoothness | Controls the smoothness of feature region borders. At higher values, the node avoids adding many small pixels along feature borders, effectively smoothing them out. |
Overlay Color | Specifies the color of the selection overlay in the 2D Viewport. |
Overlay Opacity | Controls the opacity of the selection overlay in the 2D Viewport. |