You are viewing the documentation for Deformable v0.4.0, an older version. Read the latest, v0.9.0

Engine

Fracture and splinters

Control how and where objects break, keep a surface whole, and break surfaces into bricks, tiles or shards with splinters.

On this page

An object breaks where its material is pulled harder than it can take. The cracks run between its tetrahedrons, and the render surface opens along them to show inner faces. This page shows how to control the break, and how splinters shape the broken surface into bricks, tiles, planks or shards.

Whole Cracked Inner faces

How objects break

Three things decide the break:

What Where Effect
Toughness The material How hard the material is to break. Lower breaks sooner. 0 never breaks.
Tetrahedron size Autocage, Triangulate, Tetrahedralize and density regions Cracks run between tetrahedrons. Smaller tetrahedrons give finer, more detailed cracks.
Clip Mode Prepare Whether the render surface opens along the cracks. See Make Breakable and Make Unbreakable.

The presets are tuned to break as their names say. Dropped 2 m onto a floor, a glass sphere shatters into about 50 pieces, a brick sphere breaks into about 30, and a rubber sphere bounces and stays in one piece. Each unbreakable_ preset is its namesake with Toughness 0. See Materials.

To break one part of an object more easily, give it its own material with a material region. To get finer cracks in one part only, add a density region there, and lower Maximum Edge Length on the object’s Tetrahedralize as that section shows.

The pieces of a broken object collide with each other while Self Collision is on, the default. Leave it on for objects that break.

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

Make Breakable and Make Unbreakable

Make Breakable and Make Unbreakable set how the render surface of the selected objects reacts to cracks. They work on objects with a render surface, that is, with a Prepare. A bare object always shows its tetrahedrons.

Action Sets Clip Mode to The surface
Make Breakable Clip With Inner Faces Is cut along the tetrahedrons and opens where the object breaks, showing inner faces.
Make Unbreakable Assign Only Stays whole and keeps your mesh’s own faces. Across a crack, it stretches.

The report says how many objects changed, such as Made 3 objects breakable.

An object whose surface is its tetrahedrons, with Clip Mode Tetrahedral Mesh Boundary, is always breakable: its faces already lie on the tetrahedrons. Both actions keep it as it is and say so in a warning. A primitive and an object made with Create Object from Polygon Mesh are this kind.

Make Unbreakable changes only the surface. The tetrahedrons still break when the material is weak enough. To stop an object from breaking at all, set Toughness to 0 or pick an unbreakable_ preset.

An unbreakable surface is lighter: a UV sphere of 512 faces stays at 512 faces, while the breakable one is cut into about 2,700.

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

Inner faces

When an object breaks, faces appear on the cracks. These inner faces exist in the prepared surface from the start, hidden, and each one shows when its crack opens. Three settings shape them:

Setting Where Default What it does
Inner Material Prepare None The material of the inner faces. None uses the object’s first material.
UV Scale Prepare 1 How many times a texture repeats per unit on the inner faces.
Show Inner Faces The object Off Show every inner face from the start, to check the inner material.

To give the cracks their own look, such as raw stone inside a painted statue, give the object an inner material. See Inner faces on Render surfaces.

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

Fracture points

Each deformable object gives one point on each inner face that opens at a frame. Use it to emit dust, sparks or debris where the object cracks. See What a simulation gives.

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

Splinters

Without splinters, the surface breaks along the tetrahedrons, so the pieces have the jagged shapes of tetrahedrons. A splinter cage gives them shapes you choose: bricks, tiles, planks, shards. The cage is a set of closed cells. The surface breaks along the cells, and each cell’s piece follows the tetrahedron at its center.

Object Splinters Pieces

Splinters change only how the surface breaks. The tetrahedrons, and so the motion of the pieces, stay the same. For pieces that move like real bricks, also use tetrahedrons about the size of the cells.

The plugins ship two kinds of splinter cage:

  • Line drawings (Create Splinters from Image): bricks, broken_glass, cobblestone, cracked_glass, cracked_tiles, double_herringbone, flagstones, glass_shards, herringbone, hexagon_tiles, interlocking_pavers, irregular_bricks, large_bricks, mosaic, parquet, paving_stones, pinwheel, rough_bricks and wood. Each one is a flat pattern of cells, cut straight through the object.
  • Splinter meshes (Import Splinter Mesh): brick_wall, bricks, broken_glass, broken_wood_floor, cobblestone_large, cobblestone_small, dirt, glass_shards, layered_glass, rubble_large, rubble_small, wood, wood_floor and wood_splinters. Each one is a set of 3D cells.

To use one, make a Splinters object from a drawing or a mesh with Create Splinters from Image or Import Splinter Mesh, then select it with the deformable objects and choose Add Splinters to Object. One Splinters object can serve several objects. The object needs a render surface: for example, make it with Create Object with Autocage.

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

Splinter settings

Setting Default What it does
Source Image Image traces the cells of a line drawing. Mesh uses a ready-made cage.
Image Library rough_bricks A bundled line drawing, or Custom to use Image.
Image None Your own line drawing, used when Image Library is Custom.
Mesh Library brick_wall A bundled splinter mesh, used when Source is Mesh. Custom reads a mesh of your own.
Size (1, 1, 1) Width, height and depth of the box the cells fill.
Origin (0, 0, 0) The corner of the box the cells start from.
Allow Nonconvex On Keep traced cells that are not convex. Off makes the sides of each cell run straight between corners.

A line drawing lies flat, in the plane of the scene’s floor: the whole image covers the box’s width and height, from the Origin corner, and its cells reach through the box’s depth. A splinter mesh is scaled to fill the same box.

The cage must cover the whole object: the surface outside every cell is clipped off and does not show. The create actions fill in Size and Origin so that the cells cover the selected objects, 1% of their size to spare on every side. The cells of a line drawing stop short of the image’s edges, and some outlines are notched; the cells of a splinter mesh end raggedly at its sides, each layer in its own way. So the box is larger than the objects, and the ragged edge of the pattern falls outside them.

The Splinters object is an ordinary object: move, rotate or scale it until the cells cover the part that should break, and keep them over the whole object. For an upright wall, turn it so the pattern faces the wall, and set Size and Origin to a box around the wall with a quarter of the wall’s width and height more on each side: that covers it with any bundled drawing.

Start Splintered

Start Splintered, a setting of the deformable object, shows the cells as separate pieces from the start, with their cut faces showing. Use it for objects that are already in pieces, such as a dry-stone wall. The pieces still move as one object until the tetrahedrons break.

Draw your own pattern

A line drawing is an image with black lines on a white background:

  • The lines close every cell and join into one network.
  • Lines can be any width.
  • A red dot marks each corner where a line bends without meeting another line, including the corners of the outline.
  • Use pure black (#000000) for the lines and pure red (#FF0000) for the corners.
Line drawing Red dots Cells

To use it, set Image Library to Custom and pick your file as the Image. When the trace fails, the Splinter says why.

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

Hold pieces together

To keep pieces in place until something hits them, glue them. Objects that overlap at the start frame are glued together by Glue All on the Deformable Scene, or only some of them by a glue region.

To keep part of an object from moving at all, such as the base of a wall, use a passive region.

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