This feature is still under development. The current functionality is unfinished and subject to change, and may have thin or no documentation. Please bear this in mind when using it.

This node builds a mesh of quads (four-sided polygons) with the same shape as the input surface, but as quads and with potentially much better edge flow.

The higher the target number of polygons, the better the shape of the output can match the shape of the input. In this example, the input model on the left has 16 million polygons, and the output on the right has 15 thousand quads.

(Note that since it works to a target quad count, this node can also increase the number of polygons in the model.)

The node does not allow a lot of control over the final result, however you can use the parameters to tweak the output.

• Changing the Decimation level can give different results. For high resolution input, higher levels of reduction can give better results.

• The Curvature edge flow parameter lets you influence the trade-off between smoother edge flow versus capturing the curvature of the surface in the flow. Increasing Curvature edge flow increases the number of singularities.

• Some of the options that influence the topology of the output, such as symmetry or a guide attribute, constrain the node’s search for a parameterization. As you add more constraints, or increase their weight, they may have less of an impact on the resulting quad mesh, since they make it harder to find a solution that satisfies all the constraints, especially with input geometry of higher complexity.

  For example, the more “guide lines” you add through a guide attribute, the less influence they may have, because it becomes impossible for the node to satisfy all the constraints.

  Generally, if you visualize the direction field, and it doesn’t already look roughly like what you want, you can’t add constraints to force it to look like what you want. You can only influence it.

• The Target quad count lets you choose how much detail to include in the output. Once the node has created the direction field internally, changing the level of detail in the output is quite fast.

• The parameters on the Symmetry tab let you specify planes of symmetry in the input model. The node will only remesh one side of the symmetry plane and (optionally) mirror the remeshed surface back across the symmetry plane. (This is a convenience, there is basically no different between using these options, or adding a Clip node before this node and a Mirror node after.)

This node is a work in progress. The node is very useful for certain use cases, but has a few limitations in its current “beta” state. We hope to address these issues as we continue to work on the node.

• There is currently no way to interactive influence edge flow (for example, by brushing or drawing lines). However, you can manually set up a vector attribute on the polygons to have some influence over the edge flow. See the Guide Attribute parameter on the Guide tab.

• The node is currently not good at “hard surface” models with sharp edges, in those cases the node will round off the sharp edge in the output. The node is currently better at “organic” shapes.

• Currently, when you use the Symmetry options, the seam along the symmetry plane will be straight in 3D space, but may not always be straight in UV space. This can cause edges to run into the symmetry line instead of running parallel to it.

• The flattened UVs created by the node can be quite complicated. This can cause artifacts in the output.

• The node currently produces uniform sized quads, rather than adapting the size of the quads to better capture small details.

Select a Quad Remesh node in the network editor, and click the Handles tool to the left of the viewer, or press Enter in the viewport to use the Quad Remesh tool.

Currently the tool does not have viewport interaction (use the parameter editor to change how the node works), but does provide visualizes to help you understand how the node generates the output, and what parts of the input model might be difficult for the node to deal with.

You can control visualization options using the controls in the operator toolbar (above the viewer). (See how the node works internally for information about what these visualizations show.)