|On this page|
PolySplit has two different modes of operation, controlled by the Path type parameter. The two modes have their own tools on the Polygon shelf:
Inserting individual new edges into existing polygons. You can insert a chain of cuts (possibly self-intersecting) across multiple polygons. You can insert cuts between polygons without shared edges.
Inserting edge loops.
This node preserves vertex and primitive attributes as well as group memberships on newly created polygons.
Insert a new edge
When you finish inserting points, the tool will insert edges along the shortest path between each point. You can click ⇧ Shift + LMB in the tool to edit the points again.
Insert an edge loop
Insert multiple edge loops at regular intervals
The Edge Loop tool on the shelf just inserts a PolySplit with Path type automatically set to “Edge Loop”.
Turn on Edge snap in the toolbar at the top of the view, or click MMB, to turn on snapping to edge divisions. Change the Divisions in the toolbar or use the MOUSE_WHEEL mouse wheel to change the number of divisions.
You can increase the number of divisions up to 10 with the MOUSE_WHEEL mouse wheel. To get more than 10 divisions, enter the number in the Divisions box on the operation toolbar.
You can insert a “cut” between the ends of an open polygon to close the polygon.
You can only insert new points in the interior of a polygon if the polygon is closed.
The chain of locations along which to make cuts, using the following codes.
Cut at vertex b of primitive a, where a and b are integers.
Cut at the midpoint of edge b of primitive a, where a and b are integers.
Cut at t percent along edge b of primitive a, where a and b are integers and t is a real number from
Cut at the given
(u,v) location on primitive a, where a is an integer and u and v are real numbers from
Cut at the midpoint of the edge between points a and b, where a and b are integers.
Cut at t percent along the edge between points a and b, where a and b are integers and t is a real number from
Whether to insert edges along the shortest path between cut points, or insert edge loops.
Causes an extra cut to be made from the last split location to the first.
Allow split points on faces
By default, the node lets you insert points in the interior of existing faces, to cut pieces out of the faces, producing N-sided polygons. To prevent accidental creation of these kinds of cuts, turn this parameter off. This will only allow insertion of points on edges.
Inserts an extra cut to produce quads in two common cases where a split across the corner of a quad would create an N-sided polygon.
In the following illustration, the red dotted lines are new edges that Quad autocompletion will automatically insert if you make the yellow cuts, to prevent the larger area from becoming an N-sided polygon.
These are the only cases where this option will insert extra cuts.
Number of loops
When Path type is “Edge Loop”, the number of evenly spaced edge loops to insert along the selected edges.
Causes the edge loop to cross each edge at a fixed distance along it’s length instead of a percentage.
Causes the edge loop to measure the fixed distance from the other side of each edge it crosses. If Match Profile is off, this option is ignored.
Turn this parameter on and set a value from
0-1 to specify exactly the positions of all cut points. For example, setting this to
0.5 will lock all cut points to the midpoint of each edge. This is useful for making exact straight or diagonal cuts.
Update Point Normals
Update point normals if they exist.
When Create edge group is on, the node will put new edges it creates into this group.
Append to group
Put any new edges created by this node into an edge group with the name specified in Path edge group below.
If you are working at very small scales, or if this node generates bad geometry where the split path is very close to corners, you can try decreasing the tolerance.