You are viewing the documentation for Deformable v0.7.0, 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
- Which action to use
- Create Scene
- Create Primitive Object
- Create Object from Polygon Mesh
- Create Object with Autocage
- Create Bare Object
- Create Autocage Mesh
- Add a surface to a bare object
- Mesh checks before creating
- Duplicate Object
- Verify Mesh
- Find Intersecting Objects
- Assign a material
- Make Dynamic and Make Kinematic
- Make Breakable and Make Unbreakable
- Regions
- Paint Driven Vertices
- Apply Field to Object
- Splinters
- Assign Inner Material
- Change the surface
- Before you play
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: 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. 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.
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:
- Select the mesh and choose Mesh > Triangulate, in the Modeling menu set.
- Choose Edit > Duplicate to copy it.
- 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. - 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:
-
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.
-
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. -
Run these lines in the Script Editor, on a Python tab. Replace
pSphere1_autocagewith the cage’s name: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)) -
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 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. |
| 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.
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.
- Select the first mesh and choose Mesh > Triangulate, in the Modeling menu set.
- Choose Edit > Duplicate and move the copy up.
- Bend or sculpt the copy as you like, but do not add, delete or reorder its vertices or faces.
- 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:
- Select
<mesh>_autocageand choose Edit > Unparent. - Choose Edit > Delete by Type > History. The cage is now a plain mesh that you can edit. Keep it closed and made of triangles.
- Choose Deformable Object > Create Bare Object > From Triangle Mesh.
- 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:
- Select the mesh that should render and the bare object.
- 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.
- Select one or more deformable objects or material regions.
- 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:
- Go to the start frame. Select the object and press S to key it.
- Go to a later frame, move the object, and press S again.
- 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 deformable 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 deformable, 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 deformable, 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 deformable 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:
- 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. - Paint a Value of 1 on the vertices to hold. A vertex painted above 0.5 is driven; the others are simulated.
- 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.
- 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.
- Select the fields and the deformable objects.
- 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
- Select the deformable object. It needs a render surface: for example, make it with Create Object with Autocage.
- 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.
- 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,splinters1becomes its child, so it moves with it. - Select
splinters1and the deformable objects. - Choose Deformable Object > Add Splinters to Object, or click Add Splinters to Object on the shelf.
- 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
- Select the deformable object and open the option box of Deformable Object > Create Splinters from Image.
- Set Image library to Custom and pick your file in Image file. Any image format Maya reads works, such as PNG, BMP or TIFF.
- 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:
- Make a material for the inside, such as raw stone or wood grain, in the Hypershade.
- Select the deformable objects, then the material or its shading group, such as in the Hypershade or the Outliner.
- 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.