This node is used to create line geometry with suitable capture attributes that are used for setups when using the Bone Capture Biharmonic SOP. It generates the lines by looking at Capture Region primitives that can be specified from either the geometry of the (optional) first input and/or from parameter values.
This node merges overlapping line segments into polygonal curves, and creates attributes understood by the /nodes/sop/deform and Bone Capture Biharmonic SOPs:
For its input, it can either be an a set of Capture Region
primitives or alternatively, a set of polygonal lines to be treated as a
skeleton. If given a set of polygonal lines, then the input also requires a
name string attribute as well as a matrix3
transform attribute to specify
the capture pose. In the latter case, the Capture parameter options will be
The points of the lines do not include the end caps of the capture region
Clicking Force cook has no effect if the targeted objects are Bones.
The capture pose data is stored in parameters on the Bone object on the Capture >Capture Region sub-tab under Bone Capture Pose.
When an input is given, this specifies a point group to use from it. All points from the input is used when blank (default).
Top of the object hierarchy traversed for the Capture Region operations.
The list of paths to extra bone objects or capture regions to be used separated by spaces. This list is appended to what the Hierarchy parameter specifies.
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.
Use Capture Pose
If turned on, the capture parameters of bones and capture regions are used. This means that the output will be capture frame independent. The capture pose can be viewed by choosing Edit ▸ Objects ▸ Bone Kinematic Override: Capture Pose from the main menu.
Specify when this node is allowed to cook.
Frame number at which to get evaluate the capture parameters.
Forces the operation to recook immediately.
Specifies the geometry in which to find the Capture Regions.
Traverse into subnets
If turned on, when traversing the hierarchy for capture regions, also traverse inside object subnets.
Create Relative Skeleton Root Path
If on, the internal cregion paths are generated with a skeleton path prefix (
pCaptSkelRoot attribute value) that is relative to this SOP. If off, the prefix is determined by the longest common object path prefix out of all the capture region paths.