Estimating the Laplace-Beltrami Operator by Restricting 3D Functions

links description executable usage changes

LINKS
SGP 2009 Paper
Windows Executables Source Code
Version 1 Page Version 2 Page Version 3 Page
License

CODE DESCRIPTION

PoissonMesh

EXECUTABLE ARGUMENTS (TextureStitcher.exe)

--in <input base mesh>: This string is the name of the file from which the base mesh will be read. The file is assumed to be in PLY format.
--scans <input scans>: This string is the name of the file containing the list of scans. Each scan is assumed to be in PLY format.
--out <output mesh>: This string is the name of the file to which the seamlessly textured mesh will be written. The mesh will be written out in PLY format, and the colors will be encoded as vertex properties of type unsigned char with names red/green/blue.
[--useKD]: If this optional parameter is specified, the input scans are read in as meshes and the nearest point to a sample on a base mesh is found using a kD-tree. Otherwise, the scans are in range-grid format, and finds the scan value by back-projection.
[--xForms <transform list>]: This optional string is the name of the file listing the names of the transformations (each encoded separately as an ASCII file with 4x4 matrix entries) that register the scans to the base mesh. It is assumed that there are the same number of transformations as there are scans, and that the listing is given in the same order.
[--depth <maximum octree depth>]: This optional integer specifies the maximum depth of the tree that will be used for defining the finite-elements system. Running at depth d corresponds to solving on a voxel grid whose resolution is no larger than 2^d x 2^d x 2^d. The default value for this parameter is 8.
[--threads <number of threads>]: This optional integer specifies the number of threads across which the solver should be parallelized. The default value for this parameter is the number of threads on the machine.
[--iters <Gauss-Seidel iterations>]: This optional integer specifies the number of iterations of Gauss-Seidel relaxation that are to be performed at each level of the multigrid solver. The default value for this parameter is 10.
[--cycles <solver cycles>]: This optional integer specifies the number of full multigird cycles that are to be run in solving the linear system. The default value for this parameter is 1.
[--subdivide <triangle subdivision iterations>]: This optional integer specifies the number of times the triangles of the mesh are to be subdivided. (Larger values results in a finer mesh, that more densely samples the reconstructed color functions, and more accurately captures the high-frequency detail, but requires more time and space for computation). The default value for this parameter is 0.
[--vWeight <value weight>]: This optional floating point value specifies the weight given to the constraint that resulting texture should be a good fit to the color values of the scans. The default value for this parameter is 0.0.
[--grazingFallOff <fall-off exponent>]: This optional floating point value specifies the exponent used to modulate distance priorities to down-play the contribution of scan points at grazing angles. The defaulf value is 2.0.
[--verbose]: If this optional argument is specified, the code outputs information about running and time and memory usage througout the processing.
[--progress]: If this optional argument is specified, the code shows a progress bar for the different steps of the system set-up.
[--dual]: If this optional argument is specified, the system is defined using second-order elements, which have larger support and therefore define a denser system with higher dimension. Otherwise, first-order elements are used.
[--elements]: If this optional argument is specified, the system and constraints will be defined using per-element functions, rather than per-basis-functions.

USAGE
For testing purposes, three datasets are provided.

Rooster: This dataset, obtained using the NextEngine scanner, consists of 8 scans that are represented in range-grid format.
To obtain the seamlessly textured surface, we execute:
TextureStitcher --in rooster.ply --scans scans.txt --out out.ply --xForms xForms.txt
To reconstruct the finer details we can subdivide the mesh in order to sample the gradient field more densely:
TextureStitcher --in rooster.ply --scans scans.txt --out out.ply --xForms xForms.txt --subdivide 1
Finally, if we would like to prevent color-bleeding due to the missing gradients at the bottom of the model, we can add in a soft constraint on the values:
TextureStitcher --in rooster.ply --scans scans.txt --out out.ply --xForms xForms.txt --subdivide 1 --vWeight 0.01
A visualization of the results can be seen in the images below. (The left-most image shows the results obtained when the colors are obtained by directly copying the color values from the nearest scan.)
Male04: This dataset, obtained courtesy of Cyberware scanner, consists of 4 scans that are represented as triangle meshes with color values associated to each vertex.
To obtain the seamlessly textured surface, we execute:
TextureStitcher --in male04.base.ply --scans male04.scans.txt --out out.ply --useKD --depth 10
To correct for the loss of gradients near the sleeve that result in color-bleed through to the arm, we introduce a soft constraint on the values:
TextureStitcher --in male04.base.ply --scans male04.scans.txt --out out.ply --useKD --depth 10 --vWeight 0.01
A visualization of the results can be seen in the images below. (The left-most image shows the results obtained when the colors are obtained by directly copying the color values from the nearest scan.)
Pleo: This dataset of the pleo robot, obtained using a Minolta Vivid 910 scanner, and generously contributed by Mario Botsch, consists of 20 scans that are represented as triangle meshes with color values associated to each vertex.
To obtain seamlessly textured surfaces with varying interpolation weights, we execute:
TextureStitcher --in Pleo.base.ply --scans Pleo.scans.txt --out out.ply --useKD --depth 10 --subdivide 1 --vWeight <10/0.1/0.001/0.00001>
A visualization of the results can be seen in the images below.

--vWeight 10 --vWeight 0.1 --vWeight 0.001 --vWeight 0.00001