PoissonMesh

The PoissonMesh node (NukeX and Nuke Studio only) uses information from a dense point cloud to generate a mesh that you can further use as a 3D object, in 3D modeling for instance. The PoissonMesh node is based on the Poisson Surface Reconstruction calculation method. The original source code and paper were created by Michael Kazhdan, Matthew Bolitho, and Hugues Hoppe (for more information, see http://www.cs.jhu.edu/~misha/Code/PoissonRecon/).

See also PointCloudGenerator and ModelBuilder.

Inputs and Controls

Connection Type

Connection Name

Function

Input

unnamed

The PointCloudGenerator node on which the mesh is based.

Control (UI)

Knob (Scripting)

Default Value

Function

PoissonMesh Tab

Use Selection

useSelection

enabled

When enabled, selection flags from GeoSelect nodes further up the tree are used to create the mesh.

Filtering

useFiltering

enabled

When enabled, only faces with normals similar to those of the input are created.

Depth

depth

8

Sets the maximum depth of the calculation tree that is used for surface reconstruction.

You can also think of it as the density of the voxels (volumetric pixel) used by the solver. 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. Note that since the reconstructor dynamically adapts the octree, the specified reconstruction depth is only an upper bound.

Note:  Each increment increases the solver's potential memory usage by 8 times, so keep it as low as possible. Due to the scaling of memory requirements with each increment, the maximum value is 10.

Scale

scale

1.25

Sets the floating point ratio between the 3D cube used to create the mesh and the bounding box of the footage it’s created from.

Solver Divide

solverDivide

8

Sets the depth at which the solver equation is used in the creation of your mesh. Using this parameter can help reduce the memory overhead at the cost of a small increase in reconstruction time. For example, with a reconstruction Depth of 9 or higher, a subdivide depth of 7 or 8 can reduce the memory usage.

Iso Divide

isoDivide

8

Sets the depth at which the iso-surface extractor is used in extraction. This can help you reduce your memory usage when generating complex meshes. For example, with a reconstruction Depth of 9 or higher, a subdivide depth of 7 or 8 can reduce the memory usage.

Samples per Node

samplesPerNode

1

Sets the minimum number of sample points used to create your mesh.

For noise-free samples, small values in the range [1.0 - 5.0] are acceptable.

For more noisy samples, larger values in the range [15.0 - 20.0] may be needed to provide a smoother, noise-reduced reconstruction.

Confidence

confidence

disabled

When enabled, the size of the normals is used as confidence information when generating the mesh. This may take longer, but can give you better results - your point cloud point creation is double-checked.

Step-by-Step Guides

Using the PoissonMesh Node