|On this page|
This node creates capture weights on geometry that is to be deformed by the Joint Deform SOP. It provides a high-level setup for using Bone Capture Biharmonic by internally building the required tetrahedral mesh.
This node uses Intel’s Math Kernel Library when run on x86 processors. You can use an environment variable to tune the library for speed or for producing identical results from run to run.
Optional point group from the first input for computing capture weights. By default, all points are used.
Optional point group from the second input used to compute capture weights. By default, all points are used.
The maximum number of iterations when solving for the weights. Using a large number of max iterations will allow the solver to converge to a higher quality solution at the expense of speed. Since biharmonic functions for capture weights do not usually need to be very precise, a low number of max iterations often produces suitable results.
Tetrahedralization method. The choices here trade quality and speed depending on the skin geometry.
Creates a tetrahedral mesh from an adaptively remeshed version of the skin geometry. This method offers a good trade off between performance and accuracy. It will almost always produce a tetrahedralization that faithfully matches the surface of the input, but can give unnecessary detail to certain areas.
Creates a tetrahedral mesh from a uniformly remeshed version of the skin geometry. This method can be faster than Adaptive at the loss of accuracy. More useful when the amount of detail in the skin geometry that you want to capture is fairly even.
Creates a tetrahedral mesh whose surface polygons matches the skin geometry exactly. This is the most precise method but is usually the slowest. This method is best for avoiding accidental weight leakage in tight areas like in between fingers.
Creates a tetrahedral mesh whose surface polygons only approximately matches the skin geometry while giving an even distribution of tet sizes. This uses Tet Embed which was the default method used in the Objects-level Capture Geometry shelf tool. While this method is slower than Uniform, it can guarantee that the resulting tetrahedral mesh fully encloses the skin geometry when Enlarge Offset is set to 1 or more. Therefore it can provide higher quality surface capture weights while being slower at generating the tetrahedral mesh. It can also be useful for capturing certain 2D surfaces, like a flat grid, by giving it a thickness.
When enabled, use the specified float point attribute to control the size of tets at particular areas on the skin geometry. This can be created from Attribute Paint for fine control over where capture weights should be computed more precisely.
This is only available when Tet Method is set to Adaptive.
Controls the size of the triangles when remeshing the skin geometry. This is only available when Tet Method is set to Uniform.
When enabled, this enlarges the tethedral mesh by the given the number of tet layers.
This is only available when Tet Method is set to Embed.
Max Tet Scale
Controls the maximum size of individual generated tets. The higher the value, the larger the tetrahedra in the interior of the tetrahedral mesh are allowed to be (less interior detail).
Max Triangle Scale
Controls the maximum size of the triangles on the surface of the tetrahedral mesh. The higher the value, the larger the triangles on the tet mesh boundary will be (less surface detail).
This is only available when Tet Method is set to Adaptive.
Min Triangle Scale
Controls the minimum size of the triangles on the surface of the tetrahedral mesh. The higher the value, the larger the triangles on the tet mesh boundary will be (less surface detail).
This is not available when Tet Method is set to Exact.
Enable blending of the result with the existing capture weights from the skin geometry input.
When enabled, the blend factor used to blend the result with the input capture weights.
Skeleton Resample Options
Specifies how the lines should be resampled.
By Max Axis Fraction
Resample using a maximum segment length derived from Max Axis Fraction multiplied by the largest axis of the lines' bounding box.
By Max Segment Length
Resample using the Max Segment Length value.
Max Axis Fraction
The fraction of the largest axis of the lines' bounding box side to use for resampling. This is only used when Resample Segments is set to Max Axis Fraction.
Max Segment Length
When when Resample Segments is set to Max Segment Length, this specifies the maximum line segment length to resample with.
Exclude Short Bones
When enabled, bones whose lengths are equal or less than Exclude Threshold will be ignored.
When Exclude Short Bones is enabled, bones whose lengths are equal or less than this value are ignored.
The threshold at which points will be fused in the output. A tolerance is computed from this value by multiplying it with the maximum bounding box axis size. Points whose positions are equal or less than the tolerance will be fused into a single point.
Capture Geo Options
Use Capture Geo
When enabled, the attached joint geometry of the Capture Pose input will be used as influence objects for the biharmonic solve. The the points of the geometry attached to a specific joint will strengthen the influence of the given joint in that region of the geometry to be captured.
Capture Geo Role
Defines the function within the rig setup of the attached geometry.
The attached geometry will be used as control geometry that eases joint selection for viewport interactions with the skeleton.
The attached geometry will be used to manipulate the result of the the Joint Capture Biharmonic SOP. The the points of the geometry attached to a specific joint will strengthen the influence of the given joint in that region of the geometry to be captured.
The geometry to capture. It must be closed.
The SOP skeleton to capture the Skin Geometry to.
The SOP skeleton intended for deforming the skin geometry. It is provided for wiring convenience since this input merely passed through to the corresponding output.
The skin geometry with capture attributes created as the
Provided for wiring convenience, it is identical to the second input.
Provided for wiring convenience, it is identical to the third input.
Attribute added in the Skin Geometry output that defines the skinning weights for the deformation ready for use with Joint Deform.