You are viewing the documentation for Deformable v0.1.1, an older version. Read the latest, v0.9.0
Engine
Materials
The Deformable Material, its ten values, and the 43 material presets with their values.
On this page
A material sets how an object behaves: how stiff and heavy it is, whether it dents, and how easily it breaks. Every deformable object has one, from a Deformable Material. An object with no material uses the defaults below.
Pick a preset
The quickest way is a preset. Assign Material Preset gives the selected deformable objects or material regions a preset, such as rubber or glass, which fills the ten values. When you then edit a value, the material’s Preset turns back to Custom, and your values stay.
Assign Material from Active copies one object’s material, the preset and all ten values, to the other selected objects.
You can keyframe every value while the simulation plays: the objects take the new values as they move. A change to which material an object takes applies only from the start frame: return to it and play again. See What you can animate.
See it in: Blender · Maya · C · Rust · Python
The ten values
| Value | Default | Range | What it does |
|---|---|---|---|
| Young’s Modulus | 800,000 | 1,000 to 10,000,000,000 | Stiffness, in pascals. Low values bend like rubber, high values stay rigid like stone. |
| Poisson’s Ratio | 0 | −0.9 to 0.49 | How much the material keeps its volume. Near 0.49, it bulges sideways when you squash it, like jelly. |
| Density | 2,500 | 0 to 10,000 | Mass per volume, in kilograms per cubic metre. Values above 10,000 count as 10,000. |
| Toughness | 200,000 | 0 to 100,000,000 | Resistance to fracture. Low values break easily. 0 never breaks. |
| Young’s Damping | 0 | 0 to 1,000,000,000 | Damping that grows with stiffness. It calms wobble and jiggle. |
| Yield Strain | 0 | 0 to 1 | How far the material stretches before it dents for good. |
| Maximum Yield | 0 | 0 to 1 | The most permanent stretch the material can keep. 0 turns denting off. |
| Creep Fraction | 0 | 0 to 1 | How fast a dent forms: once the stretch passes Yield Strain, the share of it that becomes permanent at each step. 0 turns denting off. |
| Wake Up Radius | 1.2 | 1 to 1,000 | How far an impact reaches to wake sleeping parts, in simulation units. |
| Friction | 0.6 | 0 to 1 | How much the surface grips. Where two objects touch, the lower friction of the two applies. |
The default is a stiff, breakable material.
See it in: Blender · Maya · C · Rust · Python
Elastic, plastic and breakable
- Elastic. The object springs back to its shape. This is the default.
- Plastic. The object keeps a dent or a bend. Set Maximum Yield and Creep Fraction above 0, and Yield Strain to how far it stretches before it dents; at 0 it dents from any stretch. Presets such as plastic, sheet_metal and iron do this.
- Breakable. The object cracks where the stress is too high. Toughness sets how high. Set it to 0 for an object that never breaks. A material can be both plastic and breakable.
To keep a breakable material but stop one object from cracking its surface open, see Make Breakable and Make Unbreakable.
Units
Material values are in simulation units, where a unit reads as a metre and gravity is 9.81. The Scale of the Deformable Scene converts scene units to simulation units, and it does not change material values. Set Scale to match your scene’s unit, and a brick behaves like a brick. See Scale.
Sleep
Objects that come to rest on a support go to sleep. A sleeping object costs almost nothing, and an impact wakes it. Wake Up Radius sets how far around an impact the material wakes. To keep an object awake at all times, turn on Never Sleep on the object. See Sleep.
Parts with their own material
A material region gives the part of an object inside a convex mesh its own material, for example a steel core in a concrete pillar. See Material regions.
See it in: Blender · Maya · C · Rust · Python
The presets
The plugins and the SDKs have the same 43 presets, and the plugins’ menus list them in this order. The values of each preset are chosen for its material and checked by dropping a cube onto a floor and by loading a beam held at one end. A preset shatters at a touch, breaks from a fall, or survives both; the same checks show whether it bounces or keeps a dent, and how far it sags.
Every preset has a Wake Up Radius of 1.2 and a Young’s Damping of 0, except jelly, which has a Young’s Damping
of 500. A preset whose name starts with unbreakable_ is its namesake with Toughness 0. In the Plastic column,
“Yes, past 0.02” means the material dents once it stretches past a Yield Strain of 0.02, and “Yes, from any stretch”
that its Yield Strain is 0.
Soft solids
| Preset | Young’s Modulus | Poisson’s Ratio | Density | Toughness | Plastic | Friction |
|---|---|---|---|---|---|---|
| sponge | 12,000 | 0.1 | 40 | 0, never breaks | No | 0.8 |
| foam | 13,000 | 0.2 | 60 | 400 | Yes, past 0.02 | 0.8 |
| snow | 100,000 | 0.2 | 300 | 0, never breaks | Yes, past 0.005 | 0.3 |
| jelly | 60,000 | 0.48 | 1,030 | 0, never breaks | No | 0.3 |
| rubber | 970,000 | 0 | 2,100 | 22,000 | No | 1 |
| unbreakable_rubber | 970,000 | 0 | 2,100 | 0, never breaks | No | 1 |
| hard_rubber | 9,400,000 | −0.21 | 970 | 150,000 | No | 0.56 |
Living and wooden
| Preset | Young’s Modulus | Poisson’s Ratio | Density | Toughness | Plastic | Friction |
|---|---|---|---|---|---|---|
| flesh | 20,000 | 0 | 240 | 1,700 | Yes, from any stretch | 0.56 |
| bone | 65,000,000 | 0.3 | 1,900 | 40,000 | No | 0.5 |
| plant | 970,000 | 0 | 920 | 4,300 | No | 0.62 |
| straw | 60,000 | 0.3 | 120 | 0, never breaks | Yes, past 0.05 | 0.5 |
| cork | 6,000,000 | 0 | 240 | 0, never breaks | No | 0.6 |
| tree | 9,900,000 | 0 | 930 | 25,000 | No | 0.9 |
| wood | 5,300,000 | 0 | 970 | 28,000 | No | 0.91 |
| plywood | 3,700,000 | 0 | 970 | 18,000 | Yes, past 0.14 | 0.76 |
| cardboard | 590,000 | 0 | 160 | 2,000 | Yes, past 0.064 | 1 |
Building materials and stone
| Preset | Young’s Modulus | Poisson’s Ratio | Density | Toughness | Plastic | Friction |
|---|---|---|---|---|---|---|
| drywall | 7,800,000 | 0.34 | 770 | 17,000 | Yes, past 0.3 | 0.53 |
| plaster | 7,900,000 | 0.31 | 1,200 | 17,000 | Yes, past 0.13 | 0.48 |
| asphalt | 3,500,000 | 0.19 | 1,000 | 35,000 | Yes, past 0.071 | 1 |
| clay | 32,000,000 | 0.35 | 960 | 11,000 | No | 0.63 |
| brick | 3,100,000 | 0 | 970 | 2,900 | No | 1 |
| concrete | 120,000,000 | 0 | 3,300 | 30,000 | No | 1 |
| reinforced_concrete | 120,000,000 | 0 | 3,300 | 39,000 | No | 1 |
| sandstone | 87,000,000 | 0.00095 | 2,900 | 40,000 | No | 0.68 |
| stone | 96,000,000 | 0.00097 | 4,200 | 39,000 | No | 0.77 |
| granite | 54,000,000 | 0.17 | 1,300 | 210,000 | No | 0.9 |
Glass and ceramics
| Preset | Young’s Modulus | Poisson’s Ratio | Density | Toughness | Plastic | Friction |
|---|---|---|---|---|---|---|
| glass | 94,000,000 | 0 | 2,100 | 1,400 | No | 0.61 |
| safety_glass | 95,000,000 | 0 | 2,100 | 19,000 | Yes, past 0.083 | 0.54 |
| ceramic | 87,000,000 | 0.00097 | 3,800 | 42,000 | No | 0.7 |
| diamond | 970,000,000 | 0.097 | 3,300 | 0, never breaks | No | 1 |
Plastics and carbon
| Preset | Young’s Modulus | Poisson’s Ratio | Density | Toughness | Plastic | Friction |
|---|---|---|---|---|---|---|
| plastic | 8,300,000 | 0.2 | 1,200 | 49,000 | Yes, past 0.33 | 0.66 |
| rigid_foam | 9,000,000 | 0.3 | 40 | 0, never breaks | No | 0.6 |
| carbon_fiber | 14,000,000 | 0.3 | 1,600 | 50,000 | No | 0.5 |
| graphite | 45,000,000 | 0 | 2,400 | 2,600 | No | 1 |
Metals
| Preset | Young’s Modulus | Poisson’s Ratio | Density | Toughness | Plastic | Friction |
|---|---|---|---|---|---|---|
| wire | 32,000,000 | 0.31 | 920 | 0, never breaks | No | 0.63 |
| stiff_wire | 93,000,000 | 0.34 | 970 | 0, never breaks | Yes, past 0.028 | 1 |
| steel | 120,000,000 | 0.23 | 3,700 | 0, never breaks | Yes, past 0.033 | 0.63 |
| sheet_metal | 7,400,000 | 0.18 | 1,000 | 89,000 | Yes, past 0.21 | 0.76 |
| foil | 24,000,000 | 0.26 | 210 | 0, never breaks | Yes, past 0.032 | 0.56 |
| rebar | 10,000,000 | 0.32 | 970 | 250,000 | Yes, past 0.093 | 0.56 |
| unbreakable_rebar | 10,000,000 | 0.32 | 970 | 0, never breaks | Yes, past 0.093 | 0.56 |
| lead | 17,000,000 | 0.47 | 10,000 | 120,000 | Yes, past 0.14 | 1 |
| iron | 10,000,000 | 0.28 | 7,300 | 150,000 | Yes, past 0.056 | 1 |