Carbon Morph¶
Description¶
This node defines a Morph simulation object, its import geometry, and the Morph parameters.
The Morph is a hybrid between a Collider and a Cloth. It uses a goal skin that must be painted using the goalSkinStrength attribute name to decide which part is kinematic (static or animated) or dynamic (simulated).
Adjust the Goal Skin Strength to set the force your Morph will use to keep its shape. Strengths above the upper threshold will make the points kinematic, strengths below the lower threshold will make the points dynamic, while strengths in between the two thresholds will make the points skinned (a force pushes them back to their animated position).
A Carbon Morph.
Inputs¶
Input #1 - Morph Geometry
Morph mesh. Can be animated.
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 be used for constraints or filters.
Activation activation
Enable this object. Use 0 to disable, any other value to enable.
Stasis stasis
Tick to place this object into stasis mode. Can be animated.
Stasis Mode triggers a dynamics integration that ignores all action forces and wipes out all kinetic energy, reducing motion and deformation to only result from the reaction forces generated by constraints, such as collision, joints, or soft body primitives.
Note
If the Carbon Simulation’s Lead Simulation parameter Stasis Mode is toggled on, this node will also be in Stasis mode during the Lead Simulation, even if this node’s Stasis parameter is toggled off.
Cloth Point Group groupB
Points of the Morph that are Cloth.
If left empty, the Morph will behave like a Collider.
Animated Geometry geometryAnimated
Enable animated geometry at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Collision
Activated collisionActivated
Untick this box to remove all collision between this Morph and itself and all other Carbon node in the same simulation.
If unticked, all other Collision parameters will be disabled, as well as all Collision Material and Aerodynamics parameters.
Note
- A Morph without collision activated cannot act as parent node in a Carbon Binding constraint.
- A Morph without collision activated cannot interact with any Carbon Flow nodes.
Primitive Group groupA
Selection of primitives that are used for collision.
Note
- This parameter is optional.
- If left empty or set to *, all primitives of the Mesh will be used.
Double Sided doubleSided
Tick to use a double-sided collision model (Thickness & Self Thickness), untick to use a single-sided collision model (Inner Fatness & Outer Fatness & Self Fatness).
Note
This parameter is only available if collision is activated. See Activated.
Thickness thickness
Thickness of the morph. In scene units.
See also
Note
- This parameter is only available for double-sided collision.
- This parameter is only available if collision is activated. See Activated.
Use Self Thickness useSelfThickness
Enable self-thickness for self-collision for this object against itself. If left unticked, the Thickness value will be used for Self Thickness. In scene units.
See also
Note
- This parameter is only available for double-sided collision.
- This parameter is only available if collision is activated. See Activated.
Self Thickness selfThickness
Self Thickness of the morph. In scene units.
See also
Note
- This parameter is only available for double-sided collision.
- This parameter is only available if collision is activated. See Activated.
Inner Fatness innerFatness
Morph’s surface inner volume thickness. In scene units.
See also
Note
- This parameter is only available for single-sided collision.
- This parameter is only available if collision is activated. See Activated.
Outer Fatness outerFatness
Morph’s surface outer volume thickness. In scene units.
See also
Note
- This parameter is only available for single-sided collision.
- This parameter is only available if collision is activated. See Activated.
Use Self Fatness useSelfFatness
Enable self-fatness for self-collision for this object against itself. If left unticked, the Outer Fatness value will be used for Self Fatness. In scene units.
See also
Note
- This parameter is only available for single-sided collision.
- This parameter is only available if collision is activated. See Activated.
Self Fatness selfFatness
Self Fatness of the morph. In scene units.
See also
Note
- This parameter is only available for single-sided collision.
- This parameter is only available if collision is activated. See Activated.
Density
Animated densityAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Base Parameters
Density densityBase
Morph density. Unit in kg/m^2.
Range Parameters
Density densityRange
Painted point attribute name: density
The multiplier of the painted point attribute values that add up to the base parameter.
Stretch
Animated stretchAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Base Parameters
Stiffness stretchStiffnessBase
Morph stretch stiffness (\(mass/time^2\)).
See also
Viscosity stretchViscosityBase
Morph stretch viscosity (dimensionless).
See also
Compression stretchCompressionBase
Morph stretch compression, must be strictly greater than 0 and always be smaller than or equal to extension.
See also
Extension stretchExtensionBase
Morph stretch extension, must be strictly greater than 0 and always greater than or equal to compression.
See also
Equilibrium stretchEquilibriumBase
Morph stretch resting length (equilibrium) as a ratio of the reference length.
Use 1 for the default resting length.
See also
Range Parameters
Stiffness stretchStiffnessRange
Painted point attribute name: stretchStiffness
The multiplier of the painted point attribute values that add up to the base parameter.
Viscosity stretchViscosityRange
Painted point attribute name: stretchViscosity
The multiplier of the painted point attribute values that add up to the base parameter.
Compression stretchCompressionRange
Painted point attribute name: stretchCompression
The multiplier of the painted point attribute values that add up to the base parameter.
Extension stretchExtensionRange
Painted point attribute name: stretchExtension
The multiplier of the painted point attribute values that add up to the base parameter.
Equilibrium stretchEquilibriumRange
Painted point attribute name: stretchEquilibrium
The multiplier of the painted point attribute values that add up to the base parameter.
Bend
Animated bendAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Base Parameters
Stiffness bendStiffnessBase
Morph angular stiffness (\(mass * length^2 / time^2 / degree\)).
See also
Yield bendYieldBase
Morph angular yield (\(degree\)), between 0 and 180.
See also
Plasticity bendPlasticityBase
Morph angular plasticity, between 0 and 1.
See also
Limit bendLimitBase
Morph crease angular limit (\(degree\)), between 0 and 180.
See also
Range Parameters
Stiffness bendStiffnessRange
Painted point attribute name: bendStiffness
The multiplier of the painted point attribute values that add up to the base parameter.
Viscosity bendViscosityRange
Painted point attribute name: bendViscosity
The multiplier of the painted point attribute values that add up to the base parameter.
Yield bendYieldRange
Painted point attribute name: bendYield
The multiplier of the painted point attribute values that add up to the base parameter.
Plasticity bendPlasticityRange
Painted point attribute name: bendPlasticity
The multiplier of the painted point attribute values that add up to the base parameter.
Limit bendLimitRange
Painted point attribute name: bendLimit
The multiplier of the painted point attribute values that add up to the base parameter.
Surface
Animated surfaceAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
- It’s good practice to leave this toggled
offwhen not using animated parameters because it impacts performance. - This parameter is only accessible when using the Face-Segment-Crease or the Tailored model.
Base Parameters
Compression surfaceCompressionBase
Morph surface compression, must be strictly greater than 0 and smaller than or equal to extension.
Note
This parameter is only accessible when using the Face-Segment-Crease or the Tailored model.
See also
Extension surfaceExtensionBase
Morph surface extension, must be strictly greater than 0 and greater than or equal to compression.
Note
This parameter is only accessible when using the Face-Segment-Crease or the Tailored model.
See also
Pressure surfacePressureBase
Unit in \(mass/length/time^2\).
Describes the force per area over a surface exercised by a virtual fluid.
Warning
Explicit force, so high values can produce instability.
Note
This parameter is only accessible when using the Face-Segment-Crease or the Tailored model.
See also
Range Parameters
Compression surfaceCompressionRange
Painted point attribute name: surfaceCompression
The multiplier of the painted point attribute values that add up to the base parameter.
Note
This parameter is only accessible when using the Face-Segment-Crease or the Tailored model.
Extension surfaceExtensionRange
Painted point attribute name: surfaceExtension
The multiplier of the painted point attribute values that add up to the base parameter.
Note
This parameter is only accessible when using the Face-Segment-Crease or the Tailored model.
Pressure surfacePressureRange
Painted point attribute name: surfacePressure
The multiplier of the painted point attribute values that add up to the base parameter.
Note
This parameter is only accessible when using the Face-Segment-Crease or the Tailored model.
Viscous Damping
Animated viscousDampingAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Base Parameters
Viscous Damping viscousDampingBase
Morph viscous damping (\(1/time\)), damping control over the nodes’ group cohesion. While the viscous damping does not affect the kinetic energy of the morph, it globally constrains all the nodes to have velocities aligning with the barycentric velocity of the morph. This term is extremely powerful considering that it is capable of dissipating local vibrations and error terms.
See also
Range Parameters
Viscous Damping viscousDampingRange
Painted point attribute name: viscousDamping
The multiplier of the painted point attribute values that add up to the base parameter.
Velocity Reducer
Animated reducerAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Base Parameters
Reducer reducerBase
Morph velocity reducer. Ranges from 0 to 1, where a value of 0 has no effect and 1 removes 100% of the vertex velocity.
Range Parameters
Reducer reducerRange
Painted point attribute name: reducer
The multiplier of the painted point attribute values that add up to the base parameter.
Forces
Animated forcesAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Base Parameters
Forces forcesBase
Morph forces.
Unit in \(Newton\).
Warning
- Continually applying forces produces infinite acceleration.
- The effect of forces is proportional to the mass of the objects / nodes they are applied to.
Range Parameters
Forces forcesRange
Painted point attribute name: force
The multiplier of the painted point attribute values that add up to the base parameter.
Collision Material
Note
This section is only available if collision is activated. See Activated.
Animated materialAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Static Friction staticFriction
Morph’s static friction, greater than or equal to 0 and greater than or equal to dynamic friction.
See also
Dynamic Friction dynamicFriction
Morph’s dynamic friction, greater than or equal to 0 and smaller than or equal to static friction.
See also
Aerodynamics
Note
This section is only available if collision is activated. See Activated.
Warning
Aerodynamics / Carbon Flow does not currently work properly with Carbon Simulation Simulation Space. When using Aerodynamics in a Carbon Simulation that has a non-default Simulation Space, it will neither take the Simulation Space’s transform, nor its local velocity from the animation into account.
Animated aerodynamicsAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Base Parameters
Form Drag formDragBase
Aerodynamics form drag. Shapes with a large apparent cross section exposed to the air flow and with a high form drag coefficient will receive more drag than thinner ones.
Warning
Explicit force, so high values can produce instability.
See also
Skin Drag skinDragBase
Aerodynamics skin drag. Friction of the skin against the air flow. Usually much smaller, and never bigger than form drag.
Warning
Explicit force, so high values can produce instability.
See also
Lift liftBase
Aerodynamics lift. Lift force coefficient.Aerodynamic force that is perpendicular to the direction of the oncoming air flow.
Warning
Explicit force, so high values can produce instability.
See also
Range Parameters
Form Drag formDragRange
Painted point attribute name: formDrag
The multiplier of the painted point attribute values that add up to the base parameter.
Skin Drag skinDragRange
Painted point attribute name: skinDrag
The multiplier of the painted point attribute values that add up to the base parameter.
Lift liftRange
Painted point attribute name: lift
The multiplier of the painted point attribute values that add up to the base parameter.
Goal Skin
Animated goalSkinAnimated
Enable animated parameters for this section by evaluating and updating the values at every frame.
Note
It’s good practice to leave this toggled off when not using
animated parameters because it impacts performance.
Velocity Limit goalSkinVelocityLimit
The maximum relative velocity between a simulated and animated node.
Base Parameters
Viscosity goalSkinViscosityBase
The goal skin viscosity to cope with fast moving motions.
Viscous behavior between a node and its animation.
Range Parameters
Strength goalSkinStrengthRange
Painted point attribute name: goalSkinStrength
The multiplier of the painted point attribute values that add up to the base parameter.
Viscosity goalSkinViscosityRange
Painted point attribute name: goalSkinViscosity
The multiplier of the painted point attribute values that add up to the base parameter.
Lower Threshold
Strength goalSkinLowerThreshold
The strength threshold below which a node is not skin constrained. The value for this attribute ranges from 0 to 1, interpolating between the lowest and the highest possible goal skin strength (taking both the base and the painted parameter into account).
See also
Upper Threshold
Strength goalSkinUpperThreshold
The strength threshold above which a skinned node becomes kinematic and animated. The value for this attribute ranges from 0 to 1, interpolating between the lowest and the highest possible goal skin strength (taking both the base and the painted parameter into account).
See also
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.
Draw Goal drawGoal
Tick to enable drawing of the goal pose Physics Draw.
Import & Export¶
Import Velocity importVelocity
Tick this box to enable reading initial velocities for this morph from the
input Mesh velocity vector array
attribute, if there is one.
Export Velocity exportVelocity
Tick this box to enable exporting the velocities for this morph to the
output mesh as velocity vector array attribute.
These can then be used as input for another morph simulation, when enabling
Velocity Import for that morph.
Bend Stress bendStress
Tick this box to export the morph Bend Stress.
Stretch Stress stretchStress
Tick this box to export the morph Stretch Stress.
Surface Stress surfaceStress
Tick this box to export the morph Surface Stress.