map-surface¶
Synopsis¶
map-surface <input> <output> [options]
Description¶
This tool computes a mapping for each point on the surface of a given input shape embedded in 3D space. The output is a (piecewise linear) function which assigns each point on the surface of the input shape one or more values. In case of non-closed surfaces, the output map can interpolate any values given on the boundary of the surface at the interior points of the surface. More common use cases are to compute a bijective mapping from one geometric shape to another geometric shape with identical topology. The resulting map is a parameterization of the surface of the input shape. Such parameterization can be used for texturing, object morphing, and surface registration.
Arguments¶
-
input¶ Point set delineating the boundary of the map domain or name of primitive shape such as: “disk”, “square”, or “sphere”.
-
output¶ File path of output map. A piecewise linear map is stored as VTK file. Other maps are stored in a custom binary format.
Output options¶
-
-barycentric¶ Use spring constants based on generalized barycentric coordiantes.
-
-mean-value¶ Use spring constants based on mean value coordinates.
-
-conformal¶ Conformal surface map or as-conformal-as-possible volumetric map.
-
-harmonic¶ Harmonic volumetric map.
Command options¶
-
-p<n>¶ Exponent of harmonic energy term. When non-positive, solve for an approximate harmonic surface map using a spring network. (default: 0)
-
-name<string>¶ Name of point data array used as fixed point map. (default: tcoords)
-
-mask<string>¶ Name of point data array used as fixed point mask. (default: boundary)
-
-max-iterations<n>¶ Maximum no. of linear solver iterations. (default: size of problem)
Standard options¶
-
-v,-verbose[n]¶ Increase/Set verbosity of output messages. (default: 0)
-
-debug[level]¶ Increase/Set debug level for output of intermediate results. (default: 0)
-
-version[major.minor]¶ Print version and exit or set version to emulate.
-
-revision¶ Print revision (or version) number only and exit.
-
-h,-help¶ Print help and exit.