Carbon Binding¶
Description¶
A Binding is a collection of attachments between an Object A and an Object B where:
- Object A can be a Carbon Collider, Carbon Morph, or Carbon Cloth, or Carbon Tissue node.
- Object B can be a Carbon Cloth, or Carbon Tissue node.
Warning
Carbon Morph, Carbon Cloth, or Carbon Tissue nodes whose collision is not activated cannot act as Object A.
Each attachment is a collection of constraints called Bonds between points of Object B and positions in Object A.
Object B is required to complete the definition of each attachment with Object A. A point selection group is also mandatory to define the points of Object B that are constrained by a Bond to the Object A.
The Radius parameter controls the behavior of all the Bonds of a Binding:
- If the radius is 0, the Binding is a hard Binding constraining Object A’s points to match their attachment positions.
- If the radius is non-zero, the Binding is a soft Binding constraining Object A’s points to their attachment positions with spring forces, within a sphere of radius Radius centered on their attachment positions.
Note
Please do not use a zero Radius Binding in conjunction with a Carbon Narrow Filter for geometry where 2 open edges meet at zero distance. This can create an over-constrained situation and result in jittering. In general, zero Radius Carbon Binding should be avoided. Applying a strong stiffness value instead will produce the same visual, without the potential negative side effects, such as jittering.
The Activation parameter can be used to enable, disable, and reset the Binding in the middle of the simulation.
A Carbon Binding.
Inputs¶
Input #1 - Nodes Input
Incoming Object and Constraint Data.
Input #2 - Parent Reference Mesh
Object A’s pose in the binding reference space.
Note
This parameter is optional.
Input #3 - Child Reference Mesh
Object B’s pose in the binding reference space.
Note
This parameter is optional.
Parameters¶
Carbon Node Name carbonNodeName
The name of the Carbon node that will be spawned internally. This name can be different from the UI node, and will also be used for Carbon Narrow Filter nodes.
Activation activation
Enable this constraint. Use 0 to disable, any other value to enable or re-enable. Changing this value during the simulation to another non-zero value will force the re-activation of this constraint causing it to reset the binding attachment positions.
Collider/Morph/Soft objectA
Object A’s Carbon Node Name. Can be a Carbon Collider, a Carbon Morph, or a Carbon Cloth, or a Carbon Tissue object.
Soft objectB
Object B’s Carbon Node Name. Can be a Carbon Cloth or a Carbon Tissue object. Can be the same as Object A.
Reference
Animated referenceAnimated
Update the following property values for this constraint at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Parent Primitive Group groupA
The primitives from Object A that are constraining Object B’s points in Group B.
Note
This parameter is optional except for self-binding applications, i.e. when Object A equals Object B.
Child Point Group groupB
The points from Object B’s geometry that are attached to Object A’s Collider/Morph/Soft object.
Note
When using self-binding, please make sure to avoid choosing points that belong to any primitive in Group A.
Use Surface Offset useOffset
Tick this to enable the surface offset override.
Surface Offset surfaceOffset
The surface offset is the coordinate of the binding in the normal direction. The offset of the binding is relative to the parent object surface. There is no sign restriction since the binding position can be either at the front of the parent object surface or at the back.
Properties
Animated propertiesAnimated
Update the following property values for this constraint at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Base Parameters
Radius radiusBase
The radius of the sphere constraining the motion of an Object B point relative to its attachment position.
If the radius value is 0 then the binding is hard and the Stiffness and Viscosity parameters are ignored.
In scene units.
Stiffness stiffnessBase
The stiffness of the soft binding (\(mass/time^2\)).
See also
Viscosity viscosityBase
The viscosity of the soft binding is a viscous ratio and has no dimension.
See also
Range
Radius radiusRange
The multiplier of the painted point attribute values that add up to the base parameter.
Stiffness stiffnessRange
The multiplier of the painted point attribute values that add up to the base parameter.
Viscosity viscosityRange
The multiplier of the painted point attribute values that add up to the base parameter.
Painted Attribute Names
Radius radiusName
The Object B’s geometry point attribute name used as this parameter’s painted values.
Stiffness stiffnessName
The Object B’s geometry point attribute name used as this parameter’s painted values.
Viscosity viscosityName
The Object B’s geometry point attribute name used as this parameter’s painted values.
About¶
Constraint Count constraintCount
Number of internal constraints spawned by this node.
Physics Draw¶
Physics Draw physicsDraw
This dropdown menu provides different drawing options.
See also
Use Color useColor
Tick to enable custom color for the Physics Draw.
Color colorr colorg colorb
Custom color for the Physics Draw.