﻿---
title: Creating and editing objects
description: Every action of the Deformable menus and shelf that makes or changes a deformable object, its material, its regions, its fields, its splinters and its surface, and the mesh checks.
url: https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/creating-objects/
---

# Creating and editing objects – Maya Plugin – Deformable v0.7.0

The actions are in the **Deformable** menu set, in the **Deformable Object**, **Edit Deformable** and **Deformable
Material** menus, and most of them on the **Deformable** shelf. They work on the selected objects. A mesh that is a
deformable object already is skipped by the create actions. Each action is one undo step: **Ctrl+Z** takes back all
it did.

A menu item with an option box (![Option box](https://help.tangerina.io/deformable/v0.7.0/images/option-box.svg)) opens a window of its options. Its first button runs the action with them and
closes the window, **Apply** runs it and keeps the window open, and **Edit > Save Settings** keeps the values for the
next time without running it. On the shelf, double-click the button to open the same window. The values a window
keeps stay between Maya sessions; **Edit > Reset Settings** brings back the defaults.

An action that cannot run with the selection says what to select, such as **Deformable: Select one or more deformable
objects**, and changes nothing. The others report what they did, in the Script Editor and on the Command Line.

Each create action adds a **Deformable Scene** when the Maya scene has none, and selects what it made. Once the tools of
a new object finish, it reports the object with its tetrahedrons and the total of its scene, such as
**Deformable: Created pCube1: 94 tetrahedrons; scene total 2,006**. The plugin counts at the start frame. On Free, a
scene that holds more than the limit adds **Free: the scene would simulate 3,120 tetrahedrons; the limit is 2,500 per
scene** to that line. See [Free](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/license-and-preferences/#free). An
object that Play would leave out is reported as a warning that says why, such as **Created Bolt: 2,258 tetrahedrons;
scene total 2,258. Play will leave it out: its tetrahedrons are too small. See Troubleshooting.** See
[An object stays still at Play](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/troubleshooting/#an-object-stays-still-at-play).

## Which action to use

| Your mesh | Use | Tetrahedrons from | Render surface |
|---|---|---|---|
| No mesh yet | Create Primitive Object | A new primitive | The primitive, triangulated |
| A closed mesh with a simple shape | Create Object from Polygon Mesh | Your mesh, triangulated | The triangulated mesh itself |
| Any mesh you want to keep exactly as it renders | Create Object with Autocage | A new cage around the mesh | Your mesh |
| A floor, a wall or a quick test | Create Bare Object | Depends on the source | None: the tetrahedrons show, in orange |
| A thin sheet or panel | Create Bare Object > From Non-Closed Polygon Mesh | Your mesh, extruded | None: the tetrahedrons show, in orange |

You can add a render surface to a bare object later. See
[Add a surface to a bare object](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/creating-objects/#add-a-surface-to-a-bare-object).

### Hollow and thin-walled objects

Why a hollow object needs its walls is on
[Hollow and thin-walled objects](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/preparing-meshes/#hollow-and-thin-walled-objects).
In Maya:

- **From the non-closed polygon mesh:** **Create Bare Object > From Non-Closed Polygon Mesh**, with **Thickness** set to
  the wall thickness and **Direction** to **Down**.
- **From two layers of the non-closed polygon mesh:** **Span Layers** needs both layers to have the same triangles, so
  triangulate the mesh before you copy it:
  1. Select the mesh and choose **Mesh > Triangulate**, in the **Modeling** menu set.
  2. Choose **Edit > Duplicate** to copy it.
  3. Right-click the copy, choose **Vertex**, and select all its vertices. Choose **Edit Mesh > Transform**, and in
     the Channel Box set **Local Translate Z** to the wall thickness as a negative number, such as `-0.05`, which
     moves the copy inward when the normals face out. Sculpt the copy now if its walls should vary.
  4. Select the original mesh, then Shift-select the copy. Open the option box of **Create Bare Object > From
     Non-Closed Polygon Mesh**, turn on **Span Layers**, and click **Create**.
- **From a closed mesh with the walls modelled**, such as one extruded with **Edit Mesh > Extrude** into a solid shell:
  **Create Object from Polygon Mesh**.

Or keep the autocage and set **Density** on the object's Deformable Material to the real mass divided by the cage's
volume. To read the volume:

1. Select the mesh. **Create Autocage Mesh** takes only a mesh that is no deformable object, so on an object that is
   deformable already, choose **Edit Deformable > Show Shape > Input Surface Mesh**, select that shape, choose
   **Edit > Duplicate**, and choose **Edit Deformable > Hide Shape > Input Surface Mesh** on the object again.
2. Choose [Create Autocage Mesh](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/creating-objects/#create-autocage-mesh). It adds the
   cage and selects it. If you changed **Target Face Count** or **Scale Gap** on the object's Autocage, set the same
   values on the cage's, `<mesh>_deformableAutocage`.
3. Run these lines in the Script Editor, on a **Python** tab. Replace `pSphere1_autocage` with the cage's name:

   ```python
   from maya.api import OpenMaya

   path = OpenMaya.MSelectionList().add("pSphere1_autocage").getDagPath(0)
   mesh = OpenMaya.MFnMesh(path)
   points = mesh.getPoints(OpenMaya.MSpace.kWorld)
   counts, corners = mesh.getTriangles()
   volume = 0.0
   for first in range(0, len(corners), 3):
       a, b, c = (OpenMaya.MVector(points[corners[first + k]]) for k in range(3))
       volume += a * (b ^ c) / 6.0
   print(abs(volume))
   ```

4. Delete the cage, and the copy if you made one.

## Create Scene

**Deformable Scene > Create Scene**, or **Create
Scene** on the shelf, adds a Deformable Scene, `deformableScene1`, or selects the one the Maya scene has. It sets its
**Start Frame** to the start of the playback range, and the playback to **Play every frame**, because a frame that
playback skips is never simulated. It also adds a line to the Render Settings' pre-render-frame and post-render MEL,
so a render checks the bakes first: leave it there.

The create actions call it for you, so you rarely need it. See
[The Deformable Scene](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/how-the-plugin-works/#the-deformable-scene).

**Deformable Scene > Create New Scene** adds another Deformable Scene, such as `deformableScene2`, even when the Maya
scene has one, with the same settings, and selects it. Its objects simulate apart from the others'. See
[More than one Deformable Scene](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/how-the-plugin-works/#more-than-one-deformable-scene).

## Create Primitive Object

**Deformable Object > Create Primitive Object** adds a primitive at the origin and makes it a deformable object, as
**Create Object from Polygon Mesh** does. The submenu, and the shelf buttons
**Cube**,
**Sphere**,
**Cylinder**,
**Cone**,
**Pyramid** and
**Platonic Solid**, make:

| Primitive | Made with | Tetrahedrons |
|---|---|---|
| Cube | A polygon cube 1 unit wide | 94 |
| Sphere | A polygon sphere of radius 1, with 16 sides and 8 rings | 836 |
| Cylinder | A polygon cylinder of radius 1, 2 units high | 608 |
| Cone | A polygon cone of radius 1, 2 units high | 292 |
| Pyramid | A polygon pyramid with sides 1 unit long | 35 |
| Platonic Solid | An icosahedron of radius 1 | 141 |

The primitive's Deformable Triangulate uses **Maximum Area** 0.15 and **Quality** 20, and its Deformable Tetrahedralize
**Maximum Edge Length** 0.3, so each primitive gets some tetrahedrons at its small size. They give the same count every
time. One of each fits in the 2,500 tetrahedrons of Free together. The primitive keeps
its Maya history, such as `polyCube1`, so you can change its size or its subdivisions in the Channel Box: the tools
compute again.

## Create Object from Polygon Mesh

**Deformable Object > Create Object from Polygon Mesh**, or
**Create Object
from Polygon Mesh** on the shelf, makes each selected mesh a deformable object. Its Deformable Triangulate turns your
mesh into the cage, its Deformable Tetrahedralize fills it, and the triangulated cage is also the render surface. The
surface keeps your shading, normals and UV sets.

Options:

| Option | Default | What it does |
|---|---|---|
| Maximum area | 10,000 | Largest triangle area of the cage. The default is so large that the cage keeps your mesh's own resolution. |
| Quality | 20 | Smallest triangle angle, in degrees, from 1 to 20. |
| Maximum edge length | 100 | A size limit for the tetrahedrons inside the cage. The default is so large that the cage's triangles set the tetrahedron size. On a coarse cage, a smaller value changes nothing: lower **Maximum area** for more tetrahedrons. See [Tetrahedralize](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/preparing-meshes/#tetrahedralize). |
| Anisotropy scale | 1 | Element size along the anisotropy direction, as a factor from 0.02 to 50. |
| Anisotropy direction | (1, 1, 1) | The direction the anisotropy scale applies along. |

The mesh must be closed. Its own triangles set the tetrahedron count, so a dense mesh gives a heavy simulation. For a
dense mesh, use Create Object with Autocage instead.

## Create Object with Autocage

**Deformable Object > Create Object with Autocage**, or
**Create Object with
Autocage** on the shelf, makes each selected mesh a deformable object inside an *autocage*: a new, light, closed cage
around the mesh. The cage is filled with tetrahedrons, and your mesh stays the render surface, exactly as you modelled
it.

This is the best choice for a detailed model: the simulation cost depends on the cage, not on your mesh.

![A detailed mesh, then the same mesh inside a light autocage of a few large triangles.](../../images/creating-objects-autocage.svg "The simulation cost depends on the cage, not on your mesh, which stays the render surface.")

The autocage itself wraps any mesh, but the action still checks that your mesh is clean and closed. For a
non-closed mesh, such as a model with separate eyes or holes, turn off the
[mesh check](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/creating-objects/#mesh-checks-before-creating) first.

Options:

| Option | Default | What it does |
|---|---|---|
| Scale gap | 1 | Size of the gaps the cage bridges, as a factor from 0.1 to 10. |
| Target face count | 100 | Number of cage triangles to aim for. More triangles follow the shape more closely and make more tetrahedrons. |
| Maximum edge length | 100 | A size limit for the tetrahedrons inside the cage. The cage's triangles set the tetrahedron size, so raise **Target face count** for more tetrahedrons. |
| Breakable | On | On: the surface cracks open where the object breaks. Off: the surface stays whole. |

To bring the cage closer to the mesh later, raise **Target Face Count** on the object's Deformable Autocage, in the
Attribute Editor. See
[The surface and contact](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/render-surfaces/#the-surface-and-contact).

## Create Bare Object

**Deformable Object > Create Bare Object** makes each selected mesh a deformable object with no render surface. The
object shows its simulated tetrahedrons, in `<mesh>_simulatedTetrahedralMesh`, in see-through orange, so a cage stands
out from a finished object. The orange is the `deformableCageTint` material, and it renders too.

Your mesh stays under the object, as it was, as a hidden intermediate shape. To render the object, give it a surface:
**Use Tetrahedral Mesh as Surface Mesh** gives it a surface made of its own tetrahedrons, in the mesh's shading, and
**Add Surface Mesh to Object** makes another mesh its surface. Both take the orange away. See
[Add a surface to a bare object](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/creating-objects/#add-a-surface-to-a-bare-object). Or
assign the tetrahedrons a material of your own: it replaces the orange.

The submenu picks the source. On the shelf,
**Create Bare Object** makes one from a
polygon mesh; right-click it to pick another source.

| Entry | The mesh is |
|---|---|
| From Polygon Mesh | A closed polygon mesh, triangulated into the cage |
| From Polygon Mesh with Autocage | Any mesh, wrapped in an autocage |
| From Triangle Mesh | A closed mesh that is already a clean triangle cage, such as one from Create Autocage Mesh |
| From Tetrahedral Mesh | A tetrahedral mesh, stored as 4 triangles per tetrahedron |
| From Non-Closed Polygon Mesh | A non-closed polygon mesh, such as a plane |

A tetrahedral mesh is what **Extract Output Shapes** writes as `<object>_extractedTetrahedralMesh`. See
[Extract Output Shapes](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/playback-and-baking/#extract-output-shapes).

### Thin objects: From Non-Closed Polygon Mesh

From Non-Closed Polygon Mesh turns a non-closed polygon mesh into one layer of tetrahedrons with the
[Extrude](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/preparing-meshes/#extrude) tool. Its option box holds the tool's
**Thickness**, 0.1 by default, and its **Direction**, **Both** by default; **Down** grows it against the normals.
With its third option, **Span Layers**, it fills the space between two meshes with the
[Span Layers](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/preparing-meshes/#span-layers) tool instead. The window never keeps
Span Layers turned on, so the next single mesh is not refused.

With **Span Layers**, select two meshes: the one you select first holds the object, and the second moves under it.
Both meshes must be made of triangles, with the same vertices and faces: triangulate the first mesh, then copy it.

1. Select the first mesh and choose **Mesh > Triangulate**, in the **Modeling** menu set.
2. Choose **Edit > Duplicate** and move the copy up.
3. Bend or sculpt the copy as you like, but do not add, delete or reorder its vertices or faces.
4. Select the first mesh, then Shift-select the copy. Open the option box of **Deformable Object > Create Bare Object >
   From Non-Closed Polygon Mesh**, turn on **Span Layers**, and click **Create**.

The action refuses:

- any other selection, with **Span Layers needs exactly two selected meshes: the first one selected holds the object**;
- a mesh with a face that is not a triangle, with **Span Layers needs triangles: triangulate the mesh (Mesh >
  Triangulate) before you copy it**;
- two meshes with different numbers of vertices or faces, with **Span Layers needs two meshes with the same vertices
  and faces, such as a mesh and a moved copy of it**.

Two meshes triangulated one at a time can get different triangles. The object is then made, but its Deformable Span
Layers node shows **Span Layers needs two layers with the same triangles, such as a triangulated mesh and a moved copy
of it**. For that and for the last two refusals, triangulate the first mesh as in step 1, delete the copy, copy the
first mesh again and redo your change to the copy.

## Create Autocage Mesh

**Deformable Object > Create Autocage Mesh**, or
**Create Autocage Mesh** on the shelf,
adds the autocage of each selected mesh as a child, `<mesh>_autocage`, drawn in see-through magenta. Unlike the other
helpers, it renders. It makes no deformable object.

The cage is a triangle mesh. To simulate a cage you made or edited, use **Create Bare Object > From Triangle Mesh**,
never **From Polygon Mesh with Autocage**, which would wrap the cage in another cage.

Use it to see a cage before you commit to it, or to shape a cage by hand:

1. Select `<mesh>_autocage` and choose **Edit > Unparent**.
2. Choose **Edit > Delete by Type > History**. The cage is now a plain mesh that you can edit. Keep it closed and made
   of triangles.
3. Choose **Deformable Object > Create Bare Object > From Triangle Mesh**.
4. Select your model, Shift-select the cage, and choose **Deformable Object > Add Surface Mesh to Object**. With
   **Breakable** on, the action refuses a model that is not a clean, closed mesh: turn it off in the option box for
   such a model. See
   [Add a surface to a bare object](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/creating-objects/#add-a-surface-to-a-bare-object).

## Add a surface to a bare object

Two actions give a bare object a render surface. Both take its orange away, and both put its simulated tetrahedrons
away again: **Edit Deformable > Show Shape > Simulated Tetrahedral Mesh** shows them.

**Deformable Object > Add Surface Mesh to Object**, or
**Add Surface Mesh to Object** on
the shelf, makes another mesh the render surface:

1. Select the mesh that should render and the bare object.
2. Choose **Deformable Object > Add Surface Mesh to Object**.

The mesh moves under the object, keeping its place, and hides. With **Breakable** on, the default in the option box,
the surface cracks open where the object breaks, and the action checks that the mesh is clean and closed first.

**Deformable Object > Use Tetrahedral Mesh as Surface Mesh**, or
**Use
Tetrahedral Mesh as Surface Mesh** on the shelf, gives each selected bare object a surface made of its own cage, or of
the outer faces of its tetrahedrons when it has no cage, such as an extruded plane. The surface always breaks with the
object. The outer faces of the tetrahedrons are shaded flat.

The surface takes the shading of the object's mesh, unless you gave the tetrahedrons a material of your own. From
Polygon Mesh and From Triangle Mesh keep each face's shading group. The other sources show the mesh's first shading
group on every face.

## Mesh checks before creating

By default, every create action checks each mesh first and refuses one that is not clean and closed. The warning names
the mesh and the problems, such as **Not verified: pSphere1: non closed boundary (12)**. From Non-Closed Polygon Mesh
checks the mesh too, but it may be non-closed.

The action also refuses a mesh with a mirrored or flat transform, such as a negative scale or a scale of 0, with **Not
verified: pCube1: the world matrix is mirrored or flat (determinant ≤ 0)**. Set the scale positive.

To find and fix the problems, see [Verify Mesh](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/creating-objects/#verify-mesh). To turn
the check off, see [Preferences](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/license-and-preferences/#preferences).

## Duplicate Object

**Edit Deformable > Duplicate Object**, or
**Duplicate Object** on the shelf, copies
each selected deformable object with its own network. The copy keeps the tool outputs, so nothing computes again, and
joins the original's Deformable Scene, with the fields that push the original. The report says how many, such as
**Duplicated 1 object**.

Maya's own **Edit > Duplicate** copies the shapes without the network that moves them. Use Duplicate Object instead.

## Verify Mesh

**Deformable Object > Verify Mesh**, or **Verify
Mesh** on the shelf, checks the one selected mesh. When it finds a problem, it switches to component mode and selects
every vertex, edge and face it found, and the Script Editor lists the problems, such as **Deformable: pSphere1: non
closed boundary (12), small angle (3)**. A clean mesh reports **Deformable: pSphere1: no issue**. Its options, in the option
box, and what each problem means are on
[Verify Mesh](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/preparing-meshes/#verify-mesh).

It checks a plain mesh. To check the mesh of a deformable object, show it with **Edit Deformable > Show Shape > Input
Surface Mesh** and duplicate it.

The fixes in Maya, in the **Modeling** menu set:

| Problem | Fix |
|---|---|
| inverted normal, inward normals | **Mesh Display > Conform**, or **Mesh Display > Reverse** on the faces that point inward. |
| co located vertices, near vertices | **Edit Mesh > Merge**. |
| degenerate edge, degenerate face | **Mesh > Cleanup**, with **Edges with zero length** and **Faces with zero geometry area** on. |
| non planar | **Mesh > Triangulate**. |
| non closed boundary | **Mesh > Fill Hole**, or use an autocage. |

### Check Co-located Vertices

**Deformable Object > Check Co-located Vertices** runs Verify Mesh with a gap threshold of 0.001. Fix what it finds
with **Edit Mesh > Merge**.

## Find Intersecting Objects

**Edit Deformable > Intersecting Objects > Find Intersecting Objects**, or
**Find Intersecting
Objects** on the shelf, adds to the selection every deformable object that overlaps a selected one. **Keep
Intersecting Objects in Selection** deselects the selected objects that overlap no other selected one. Both report
what they found, such as **Found 2 intersecting objects: floor, wall**, or **No intersecting objects**. See
[Overlapping objects](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/preparing-meshes/#overlapping-objects).

## Assign a material

Each deformable object has its own Deformable Material, `<object>_deformableMaterial`, with a **Preset** menu and the
ten values in the Attribute Editor. Choose **Deformable Material > Select Material Node**, or click
**Select Material Node** on the shelf, to
show it.

1. Select one or more deformable objects or material regions.
2. Choose **Deformable Material > Assign Material Preset** and pick a preset, such as **rubber** or **glass**.

The report says what it gave, such as **Assigned rubber to 2 objects**. Picking a preset in the material's **Preset**
menu in the Attribute Editor does the same for that material. Either way, one undo restores the values and the preset
together.

To copy one object's material to others, select them, select the object to copy from last, and choose **Deformable
Material > Assign Material from Active**. It copies the preset and the ten values, and reports **Copied the material of
pCube1 to 2 objects**.

Both actions refuse an object whose **material** input another kind of node feeds, with **Material must come from
Deformable Material: `<object>`**, and a material value that is connected or locked, such as
**pCube1_deformableMaterial.density is connected or locked: break its connection or unlock it first**.

To keyframe a value, right-click it in the Attribute Editor and choose **Set Key**. When a keyed value leaves its
preset, the **Preset** turns to **Custom**.

## Make Dynamic and Make Kinematic

These actions set the deformableObject's attributes of all selected objects at once:

| Action | Shelf | Sets |
|---|---|---|
| Edit Deformable > Make Dynamic | **Make Dynamic** | Type to Dynamic |
| Edit Deformable > Make Kinematic | **Make Kinematic** | Type to Kinematic |
| Edit Deformable > Enable | **Enable** | Disabled off |
| Edit Deformable > Disable | **Disable** | Disabled on |

They report how many objects they changed, such as **Made 2 objects Kinematic** or **Disabled 1 object**. An object
whose value is keyed, connected or locked is kept as it is and named, such as **Type is connected or locked on:
pCube1**.

To animate a Kinematic object, key its transform:

1. Go to the start frame. Select the object and press **S** to key it.
2. Go to a later frame, move the object, and press **S** again.
3. Return to the start frame and play.

A Kinematic object follows its transform and its `_drivenTetrahedralMesh` shape. To bend or deform it as it moves,
deform that shape: show it with **Edit Deformable > Show Shape > Driven Tetrahedral Mesh**, then put a cluster, a
skinCluster or vertex keys on it, as on any mesh.

To release an object, key its **Type**: select the object, click `<object>_deformableObject` under **INPUTS** in the
Channel Box, set **Type** to **Kinematic** at the start frame and key it (right-click **Type** and choose **Key
Selected**), then set it to **Dynamic** at the frame of the release and key it again. See
[Release an object](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/kinematic-and-regions/#release-an-object).

## Make Breakable and Make Unbreakable

**Edit Deformable > Make Breakable** and **Make Unbreakable**, or
**Make Breakable** and
**Make Unbreakable** on the shelf, set **Clip
Mode** on the Deformable Prepare of the selected objects, and report **Made 3 objects breakable**. An object in
Tetrahedral Mesh Boundary mode is kept as it is, with **Kept 1 object in Tetrahedral Mesh Boundary mode, which is always
breakable**. See
[Make Breakable and Make Unbreakable](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/fracture-and-splinters/#make-breakable-and-make-unbreakable).

## Regions

A region is a convex mesh drawn in its kind's see-through color and left out of renders. Four actions make one:

| Action | Shelf | What it adds |
|---|---|---|
| Deformable Object > Add Glue Region | **Add Glue Region** | A box named `deformableGlueRegion1` that covers the selected objects and glues them, and only them. One object glues its own broken pieces. |
| Deformable Object > Add New Region > Passive | **Add Passive Region** | A cube named `deformablePassiveRegion1`, 1 unit wide, at the center of the selected objects, that holds the vertices inside it. |
| Deformable Object > Add New Region > Material | **Add Material Region** | A cube named `deformableMaterialRegion1`, 1 unit wide, at the center of the selected objects, with a Deformable Material of its own set to the preset you pick. The shelf button gives the first preset, **sponge**; right-click it to pick another. |
| Deformable Object > Add New Region > Density | **Add Density Region** | A cube named `deformableDensityRegion1` at the center of each selected object, as its child, so it moves with the object. |

**Deformable Object > Make Mesh into Region** makes convex meshes of your own regions of the selected objects: select
the meshes and the deformable objects, and pick **Passive**, **Glue**, **Material** or **Density**. The shelf has a
button for each: **Make Mesh
into Passive Region**, **Make Mesh
into Glue Region**, **Make
Mesh into Material Region** and
**Make Mesh into Density
Region**. The mesh's name gets the kind at its end, such as `pCube2_passiveRegion`. A mesh that is not convex is left
out with **A region must be convex: `<mesh>`**.

| Region | Color | Its settings |
|---|---|---|
| Passive | Green | None. |
| Glue | Yellow | **Deformable Spring Constant** and **Deformable Damping Coefficient**, on the region's shape in the Channel Box. 0 uses the built-in strong glue. |
| Material | Purple | Its own Deformable Material. Select the region and choose **Deformable Material > Select Material Node**, or give it another preset with **Assign Material Preset**. |
| Density | Red | **Deformable Density Scale**, on the region's shape in the Channel Box. |

A passive region does not follow the object on its own. When the object moves, parent the region to it: select the
region, Shift-select the object, and press **P**.

For a density region, set **Maximum Edge Length** on the object's Deformable Tetrahedralize first, then **Deformable
Density Scale** on the cube. See [Density regions](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/preparing-meshes/#density-regions).
A density region needs a Deformable Tetrahedralize in the object's history, and refuses another object with **A
density region needs a Deformable Tetrahedralize in the object's history**. **Make Mesh into Region > Density** takes
one object at a time.

To see or hide the regions of the selected objects, choose **Edit Deformable > Show Shape > Regions** or **Hide Shape >
Regions**.

## Paint Driven Vertices

A driven vertex follows the object's animation instead of the simulation, as inside a passive region. You pick them
by painting:

1. Select the deformable object and choose **Edit Deformable > Paint Driven Vertices**. It shows and selects the
   object's `_drivenTetrahedralMesh`, whose vertices are the ones the tetrahedrons share, and opens Maya's **Paint
   Attributes Tool** on its **drivenPerVertex** map.
2. Paint a **Value** of 1 on the vertices to hold. A vertex painted above 0.5 is driven; the others are simulated.
3. Choose **Edit Deformable > Hide Shape > Driven Tetrahedral Mesh** when you are done.

The driven vertices follow the object's transform and the `_drivenTetrahedralMesh` shape, so you can move them by
keying the transform, or by deforming that shape with a cluster or a skinCluster. The simulation reads them on every
frame.

## Apply Field to Object

Maya's fields push deformable objects, as they push particles: Air, Drag, Gravity, Newton, Radial, Turbulence,
Uniform, Vortex, Volume Axis and Volume Curve, and a fluid too. The table below says how each one pushes.

1. Make the field with nothing selected, such as with **Fields/Solvers > Air** in the **FX** menu set. A field made
   while an object is selected belongs to that object.
2. Select the fields and the deformable objects.
3. Choose **Deformable Object > Apply Field to Object**.

The report counts what it connected, such as **Applied 1 field to 2 objects**. A field that already pushes the
selected objects is skipped, with **The selected fields already act on the selected objects**. An object in no
Deformable Scene is named with **Add to a Deformable Scene to simulate: `<object>`**: a field pushes an object through
its scene.

The Deformable Scene's **Fields** section in the Attribute Editor lists each field it takes, with the objects it pushes.
Click a field's name to select it.

A field pushes every vertex of the tetrahedral mesh, inside and out, but those held by a Kinematic object, a passive
region or a painted driven vertex. A held vertex saves nothing up: once released, it takes the field's push from its
first free frame. The simulation reads the force on every frame, so keys on the field play. The field reads each
vertex's position and velocity in Maya units, as it reads a particle's, so a speed such as an Air field's is in Maya
units a second at any **Scale**. Its force is in newtons in simulation units, and the scene's **Scale** never changes
it, as it never changes the scene's **Gravity**.

**Gravity** and **Newton** pull by each vertex's mass, so they are accelerations: a light and a heavy object move
alike, and a Gravity field of magnitude 9.8 pulls as a scene **Gravity** of 9.8. The others are forces, whatever the
mass: an object of real density needs magnitudes in the hundreds or thousands, and an Air field of magnitude 30 moves
the cube of **Create Primitive Object > Cube** only about half a unit along its direction in 40 frames.

Make a field with **Fields/Solvers**, and a fluid with **Fluids > 3D Container**, in the **FX** menu set.

| Field | Supported | Note |
|---|---|---|
| Air | Yes | Toward the air's velocity, **Magnitude** along **Direction**: the force is the air's velocity less the vertex's, so the object speeds up until it moves with the air. **Speed** does nothing to a deformable object: **Magnitude** is the air's speed, in Maya units a second. |
| Drag | Yes | Against the vertex's velocity, **Magnitude** times it: it slows what moves, and holds an object another field pushes to the speed where the two balance. |
| Gravity | Yes | Along **Direction**, **Magnitude** times the vertex's mass: an acceleration. |
| Newton | Yes | Toward the field, by the vertex's mass and its distance: an acceleration. |
| Radial | Yes | Away from the field, or toward it with a negative **Magnitude**; **Use Max Distance** stops it at **Max Distance**. |
| Turbulence | Yes | Each place its own way, by noise. It changes over time only through its **Phase**: key the Phase to make it churn. |
| Uniform | Yes | The same force on every vertex, so a light object moves further than a heavy one. |
| Vortex | Yes | Around its **Axis**, never along it. Its push never exceeds what turns a vertex about the axis in one frame, whatever the mass, so it turns light objects and barely moves heavy ones. |
| Volume Axis | Yes | Inside its volume only, along the volume's own axes, which the field's rotation turns: **Along Axis**, **Away From Axis**, **Away From Center**. |
| Volume Curve | Yes | Along its curve, the way the curve runs, within **Section Radius** of it. |
| Fluid | Yes | Along the fluid's velocity, inside the container only. A velocity you set by hand on a **Static Grid** needs **Fluids > Set Initial State**, or the start frame clears it. |

A field whose force is not a finite number at some vertex of an object it was applied to, held vertices and Kinematic
objects included, such as one whose **Magnitude** is so large that the push overflows, pushes no vertex at all on that
frame. Its Deformable Scene says **A field gives a force that is not a finite number, so it pushes nothing**, with the
field's name. It says so once, and again only when the fields it names change.

**Move to Scene** and **Duplicate Object** carry an object's fields with it.

### Detach Fields

**Edit Deformable > Detach > Fields** stops the fields selected with each selected object pushing it, or every field
that pushes it when you select no field. It reports **Detached the fields of 1 object**, or **Nothing to detach**. A
field that pushes nothing any more leaves the Deformable Scene.

## Splinters

1. Select the deformable object. It needs a render surface: for example, make it with **Create Object with
   Autocage**.
2. Choose **Deformable Object > Create Splinters from Image**, or click
   **Create Splinters
   from Image** on the shelf. Its option box picks the **Image library** pattern, **rough_bricks** by default. Or
   choose **Deformable Object > Import Splinter Mesh** and pick a mesh, such as **glass_shards**; on the shelf,
   **Import Splinter Mesh** gives
   **brick_wall**, and its right-click menu lists the others.
3. The action adds a splinter cage, `splinters1`, drawn in see-through cyan and left out of renders, fed by its
   Deformable Splinter, `splinters1_deformableSplinter`. Its cells cover the bounding box of the selected objects,
   with a little to spare on every side. With one object selected, `splinters1` becomes its child, so it moves with it.
4. Select `splinters1` and the deformable objects.
5. Choose **Deformable Object > Add Splinters to Object**, or click
   **Add Splinters to Object** on
   the shelf.
6. Return to the start frame and play.

One splinter cage can serve several objects: select it and all of them in step 4. To take the splinters off, choose
**Edit Deformable > Detach > Splinters**.

The settings are on `splinters1_deformableSplinter` in the Attribute Editor. See
[Splinter settings](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/fracture-and-splinters/#splinter-settings). In Maya, the box's
**Origin** is its smallest X, smallest Y and largest Z. A line drawing faces the Front view: the image covers the box's
width along X and its height along Y, and its cells reach back from Origin Z by Size Z. So a drawing suits an upright
wall facing the front as it is made.

For a floor or a tabletop, the pattern should face the Top view instead. Select `splinters1` and set its **Rotate X**
to 90, with its translation at 0. Then, on its Deformable Splinter, set **Size** and **Origin** to a box around the
floor:

- **Size** to one and a half times the floor's width along X and its depth along Z, and a little more than its
  thickness;
- **Origin** to the floor's smallest X less a quarter of its width, its smallest Z less a quarter of its depth, and
  minus its smallest Y plus half the extra thickness.

For a floor 4 units wide and 4 deep, 0.2 thick, with its top at 0 and centered on the origin, that is Size (6, 6, 0.4)
and Origin (-3, -3, 0.3).

**Import Splinter Mesh > From File…** reads an OBJ file of your own cells. A Deformable Splinter whose **Mesh Library**
is **Custom** reads its **Mesh File**, or a mesh you connect to its **inputMesh** in the Node Editor, which wins over
the file. After you edit the file, click **Reload** beside **Mesh File** in the Attribute Editor.

**Start Splintered** is in the **Surface** section of the deformableObject's Attribute Editor.

### Draw your own pattern

1. Select the deformable object and open the option box of **Deformable Object > Create Splinters from Image**.
2. Set **Image library** to **Custom** and pick your file in **Image file**. Any image format Maya reads works, such as
   PNG, BMP or TIFF.
3. Click **Create**, and continue from step 4 of
   [Splinters](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/creating-objects/#splinters).

With Custom and no file, the action stops with **Image Library is Custom and no Image File is set**. When the trace
fails, the Deformable Splinter shows why in its **Error Message**. The node keeps the image it read in the scene file.
After you edit the image, click **Reload** beside **Image File** in its Attribute Editor.

## Assign Inner Material

The inner faces a crack opens take the first shading group of the surface. To give them their own:

1. Make a material for the inside, such as raw stone or wood grain, in the Hypershade.
2. Select the deformable objects, then the material or its shading group, such as in the Hypershade or the Outliner.
3. Choose **Edit Deformable > Assign Inner Material**.

It reports **Assigned stoneSG to the inner faces of 1 object**. The assignment lasts through a reopen of the file.

To check it without breaking the object, turn on **Show Inner Faces** in the **Surface** section of the
deformableObject's Attribute Editor. See [Inner faces](https://help.tangerina.io/deformable/v0.7.0/user-guides/engine/render-surfaces/#inner-faces).
**UV Scale** is on the object's Deformable Prepare.

## Change the surface

Edit the mesh the surface is made from at the start frame, as usual: change its history, such as the radius of its
`polySphere1`, or show it with **Edit Deformable > Show Shape > Input Surface Mesh**, edit it, and hide it again with
**Hide Shape > Input Surface Mesh**. The Deformable Prepare runs again, and the next play uses the new surface. While
it runs, the progress bar shows **Deformable: Prepare (`<object>`)** with how long it has run, such as **0:12**.

To swap the surface of an object for another mesh, choose **Edit Deformable > Detach > Surface Mesh**, or click
**Detach Surface Mesh** on the shelf,
then [add the new surface](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/creating-objects/#add-a-surface-to-a-bare-object).

### Refresh Surface Mesh

Maya does not pass a shading change of a mesh down to the surface made from it. After you assign other materials to
the mesh, select the object and choose **Edit Deformable > Refresh Surface Mesh**. It computes the object's tools
again and gives its surface the mesh's shading, and reports **Refreshed the surface mesh of 1 object**.

## Before you play

- **Objects must not overlap at the start.** Select an object and choose **Find Intersecting Objects** to select every
  object that overlaps it.
- **Keep an eye on the tetrahedron count.** See
  [Count the tetrahedrons](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/how-the-plugin-works/#count-the-tetrahedrons).
- **Freeze transformations before you create an object, never after.** See
  [Deformable objects](https://help.tangerina.io/deformable/v0.7.0/user-guides/maya/how-the-plugin-works/#deformable-objects).
