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.

Terminal options

-color, -nocolor

Enable/disable colored output. (default: off)

Parallelization options

-threads <n>

Use maximal <n> threads for parallel execution. (default: automatic)