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

Maya Plugin

Creating and editing objects

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.

On this page

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 () 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: Made pCube1: 94 tetrahedrons; scene total 2,006. The plugin counts at the start frame. During the trial, a scene that holds more than the trial allows adds Trial limit: the scene simulates 3,120 tetrahedrons; the trial allows 2,500 to that line. See The trial. An object that Play would leave out is reported as a warning that says why, such as Made 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.

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.

Hollow and thin-walled objects

Why a hollow object needs its walls is on 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. 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.

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.

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 trial’s 2,500 tetrahedrons 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.
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.

Your mesh Autocage

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 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.

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. 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.

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 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 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.

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. To turn the check off, see 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.

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.

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.

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.

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. 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. 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.

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. 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.

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.
  • Freeze transformations before you create an object, never after. See Deformable objects.