NodeIcon VertexMask

Allows painting a vertex mask on a mesh. The mask can be loaded or saved to a file

The vertex mask stores a floating value in range 0 to 1 for each vertex of the mesh.

Vertex masks can be used with Brush, MixGeom, ProjectGeom and OpticalFlowWrapping nodes.

It is possible to convert a PolygonSelection into a VertexMask using the PolygonSelectionToVertexMask node.


Editor

The VertexMask node has a visual editor that allows painter vertex mush on a mesh surface using a brush tool.

../../_images/VertexMask.jpg

Drag with LMB

to paint the mask

Drag with LMB outside the model

to use lasso

[ or ]

to change the brush size

Drag with RMB

to change the brush size

SHIFT + [ or ]

to change falloff

Drag with SHIFT + RMB

to change falloff

Drag with MMB

to change strength

Paint with SHIFT

to smoothing the mask

Paint with CTRL

to subtract from the mask

Press G

to toggle geodesic distance mode

Inputs

geometry

Geometry Geometry to be painted with vertex mask

Output

VertexMask Painted mask

Parameters

Radius

brush radius ranges from 0 to 100 and is computed relative to the size of the model. 0 corresponds to the Min Size Factor and 100 corresponds to the Max Size Factor. Both factors are defined as a fraction of the diagonal length of the bounding box of the editable model

Strength

brush strength

Falloff

brush falloff ratio

Smooth Iterations

defines the strength of smoothing when painting with SHIFT key

Symmetry
No Symmetry

don’t use symmetry

Topological

use topological symmetry

X

use symmetry in X-axis

Y

use symmetry in Y-axis

Z

use symmetry in Z-axis

Use Geodesic Distance

if set, computes the brush influence using a geodesic distance on the surface. If not set, Euclidean distance is used

Min Size Factor

defines the minimal brush size factor

Max Size Factor

defines the maximal brush size factor

Mask color

defines the color of the displayed mask in the Visual Editor

Import from File

loads a vertex mask from a file

Import from Polygroups

loads a vertex mask from a polygroup. A new selection can be added or subtracted from the existing selection depending on the dialog properties

Import from Materials

loads a vertex mask from a material

Export

save current vertex mask into a file

Invert

inverts vertex mask

Clear

clears the current mask. All mask values will be reset to 0

File format

Wrap can import/export a vertex mask to a text file in JSON format. The format represents a vertex mask as an array of float values for each vertex.

[ 0, 0.1, 0.7, 1 ]