Wrapping¶

Non-rigidly fits one geometry to another. For example wraps a generic basemesh around a specific 3D-scan. Lets you control fitting process by providing user-defined point correspondences. Also allows excluding certain polygons from fitting process.

Wrapping is a very efficient approach when dealing with big set of similar objects like human scans so that all of them can be described with the same topology.

Basemesh Limitations¶

Manifoldness

The basemesh topology should be manifold.

If the basemesh has non-manifold topology, use RepairGeom node to convert it to manifold.

Connectivity

All the polygons should be interconnected, no disconnected pieces like eyeballs, teeth are allowed.

If the basemesh contains multiple disconnected pieces, you have several options.

If changing vertex order is acceptable, use SelectPolygons or SelectSmallComponents node to select the pieces and DeletePolygons to remove them.

If vertex order should be preserved, you can wrap a model without those disconnected pieces and then apply this deformation to original model using Lattice node.

Pre-alignment

The basemesh should be roughly pre-aligned to a target geometry.

If the models are not aligned you can use RigidAlignment node to align them by translation, orientation and scale.

Tip

If a head basemesh contains eye- or mouth-socket, select corresponding polygons and pass them as fourth input of wrapping node. That will exclude them from fitting process.

Wrapping Under the Hood¶

Wrapping uses coarse-to-fine approach. The basemesh is deformed by a set of control nodes (displayed as white dots during wrapping process). The process is divided into several steps. Each step a set of control nodes is generated on the basemesh with specific density which increases with each new step. The algorithm tries to find such position of control nodes so that the basemesh fits the target geometry as close as possible. When a solution is found, it proceeds to the next step. It samples the basemesh with bigger number of control nodes and repeat the fitting again. The bigger the number of control nodes in current step the more precise the result.

Editor¶

Wrapping node has an editor which displays floating geometry, fixed geometry, points and free polygons as you plug the inputs.

Inputs¶

floating geometry: Geometry Geometry to be deformed (a basemesh)
fixed geometry: Geometry Target geometry to fit to
point correspondences: PointCorrespondences (optional) A set of point correspondences between the floating and the fixed geometry
free polygons floating: PolygonSelection (optional) A set of polygons that will be excluded from wrapping process, i.e they will not try to fit the fixed geometry but will be deformed as rigid as possible to match the rest of the polygons.

Output¶

Geometry Wrapped geometry

Parameters¶

auto-compute: if set, the node will be recomputed each time some parameter or input data is changed
compute: if auto-compute is off, starts wrapping process in preview window

Parameters tab¶

subdivisions: number of fitting steps
ICP iterations: number of alignment sub-steps inside each fitting step
optimization iterations: maximal number of optimization sub-steps inside each fitting step
sampling initial: density of control nodes during the first fitting step
sampling final: density of control nodes during the last fitting step

Advanced parameters tab¶

smoothness initial: mesh rigidness during the first fitting step
smoothness final: mesh rigidness during the last fitting step
control points weight: how much force is applied to stitch user-defined corresponding points to each other
max optimization iterations: maximal number of optimization interations
normals threshold: don’t try to fit floating and fixed vertices if the angle between their normals is bigger than a specific value in radians
Dp initial: optimization delta during the first fitting step
Dp final: optimization delta during the last fitting step

Note

For accurate wrapping of clean scans with minimal noise

Decrease sampling final and smoothness final parameters
Increase ICP iterations and optimization iterations

For robust wrapping of noisy scans with a lot of artifacts

Increase sampling final and smoothness final parameters