Houdini 20.5 Nodes Dynamics nodes

Vellum Constraint Properties dynamics node

Modifies common Vellum constraint properties during a Vellum solve.

Since 17.0

The Vellum Constraint Properties 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.

Parameters

Properties

Stiffness

The stiffness of the constraint, which controls how strongly it will pull a particle back to its rest state.

Compression Stiffness

The stiffness of the constraint when being compressed below its initial rest distance.

Stiffness Dropoff

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.

Velocity Blend

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.

Damping Ratio

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.

Rest Length

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.

Rest Vector

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.

Sliding Rate

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.

Plastic Threshold

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.

Note

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.

Plastic Rate

The speed at which the material adopts its new rest lengths when it begins to flow.

Plastic Hardening

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.

Break Threshold

The amount of stress or displacement on a constraint to trigger a break.

Break Type

This controls how the solver decides to break constraints.

None

No automated tests are performed.

Stretch Stress

The stretch stress must exceed the threshold.

Bend Stress

The bend stress must exceed the threshold.

Stretch Distance

The total distance from the goal location and the current location must exceed the threshold.

Stretch Ratio

The ratio between the current distance and the rest distance must exceed the threshold.

Bend Angle

The difference between the current angle and the rest angle must exceed the threshold. This value is specified in degrees.

Remove

A pseudo-property that will cause the constraint to be removed immediately when set to 1.

Broken

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.

Use VEXpression

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, stiffness.

Bindings

Geometry

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.

Inputs

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.

See also

Dynamics nodes