You are viewing the documentation for Deformable v0.5.0, 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.
Elastic Plastic Breakable
Maximum Yield and Creep Fraction above 0 keep a bend, and Toughness sets how much stress cracks the object.

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

See it in: Blender · Maya · C · Rust · Python