The Vellum Constraint Property DOP allows modification of common properties of the constraints during a Vellum solve. In general each property corresponds to an attribute on a constraint primitive, except for Remove which is a pseudo-property that immediately deletes the constraint primitive when set. The properties can be further modified by specifying a VEXpression to perform more advanced VEX processing or geometry lookups. This DOP is the recommended way to modify existing constraints; use the Vellum Constraints DOP to create new constraints.
The stiffness of the constraint, which controls how strongly it will pull a particle back to its rest state.
The stiffness of the constraint when being compressed below its initial rest distance.
The distance from the rest state at which the stiffness of the constraint drops off to zero, or increases from zero to full stiffness, depending on the direction of the dropoff. A negative values indicates a decreasing dropoff, where the stiffness starts at full strength and decreases to zero at the Dropoff distance from the rest state. A positive value indicates an increasing dropoff, where the stiffness starts at zero and increases to full stiffness at the specified distance from rest. For stretch constraints this value is in length units; for bend constraints it is stored in degrees.
Controls blending of target velocity into the constrained point. Provides an amount to blend every 24th of a second. Only applies to attach and pin constraints.
Stiff constraints tend to vibrate or jitter unacceptably. Damping reduces this by bleeding energy when evaluating the constraint. Values less than 1 should be used.
The rest distance of the constraint. For Stretch-type constraints this should be in linear units (meters by default). For bend-type constraints it should be in degrees.
Rest Length Scale
A scale on the original rest length when the constraint was created. Animating this value allows shrinking constraint rest distances over time.
For Pin to Target constraints, this is the world space position of the goal position for the pin. For hair bend constraints it is the quaternion representing the relative rotation from one hair segment to the next.
For Attach to Geometry and Stitch Points constraints, the attachment point of the constraint will slide across the target surface at this rate, where 1 matches the constrained point’s velocity.
Below this threshold, the material will return to its original shape. When deformed past the threshold, it will begin to creep into its new configuration.
Thresholds that are ratios of the current rest length (created with the Ratio of Current Rest Length option enabled on the Vellum Constraints SOP) are stored on the constraints as negative numbers, and should be specified the same way.
The speed at which the material adopts its new rest lengths when it begins to flow.
Some plastic materials become stiffer after they've undergone deformation. These will have a hardening greater than 1. Some become softer so will have hardening less than 1. This is a logarithmic multiplier on stiffness.
The amount of stress or displacement on a constraint to trigger a break.
This controls how the solver decides to break constraints.
No automated tests are performed.
The stretch stress must exceed the threshold.
The bend stress must exceed the threshold.
The total distance from the goal location and the current location must exceed the threshold.
The ratio between the current distance and the rest distance must exceed the threshold.
The difference between the current angle and the rest angle must exceed the threshold. This value is specified in degrees.
A pseudo-property that will cause the constraint to be removed immediately when set to
A property indicating that the constraint is about to be broken by the solver. Resetting this to
0 can be used to override breaking if this node is plugged into the third input of the Vellum Solver DOP.
Execute the VEXpression provided to further modify the values for any properties enabled above. The names of the properties in the VEXpression will match their parameter names. For example,
The name of the data containing the constraint geometry.
Evaluation Node Path
For nodes with local expressions, this controls where
ch() style expressions in VEX are evaluated with respect to. By making this
., you can ensure relative references work.
It is important to promote this if you are embedding a node inside an HDA you are also exporting the local expressions.
Allows binding DOP data or external SOP geometry to inputs that can be referenced in the VEXpression. By default the Constraint Geometry is bound to geometry input 1, while the Vellum particle geometry is input 2. They can be referenced with the
@OpInput1-4 string parameters when using VEXpressions, or numerically as 0-3 with VEX functions that take an input number.