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

Maya Plugin

License and preferences

The Deformable Preferences window in Maya, the license status, the trial and its limit, activating and deactivating a license key, the mesh check and frame cache settings, the help items, and updating the plugin.

On this page

The plugin keeps its settings in the Deformable Preferences window. There you see the state of your trial or license, activate a license key, turn the mesh check on or off, set how much memory the frame cache takes, open this guide, and copy what a support email needs.

To open it, choose Deformable Scene > Preferences… or Deformable Help > License….

License status

The window’s License section starts with the status, beside an icon:

Status What it means
Standard trial: 7 days left The trial runs. The number counts down each day, to Standard trial: 1 day left. The next line shows Trial limit: 2,500 tetrahedrons.
Standard trial ended — Buy license The 7 days are over. The tools and the simulation stop until you activate a license.
No Standard trial on this device — Buy license This computer gives no device id, so it cannot have a trial. A license works.
Standard license A Standard license key is active on this computer. There is no limit.
Go online once to start the Standard trial The trial has not started yet. Connect to the internet and click Check Now.
Go online once to renew the Standard license The license went about 7 days without a renewal. Connect to the internet and click Check Now.
The clock is behind: set the correct time The computer’s clock was set back. Correct it.

Below the status, the section shows:

  • Contacting the licensing service… while the plugin starts the trial, renews, activates or deactivates. When that fails, the section shows why, such as This license key does not exist. Status messages lists every message and what to do.
  • The license key field and Activate when no key is active, or Deactivate when one is.
  • Check Now while the status asks you to go online. It contacts our licensing service right away: it starts the trial or renews the license.
  • Buy License while no key is active. It opens the pricing on tangerina.io/deformable.

The Maya plugin is always allowed online. Maya has no setting that keeps a plugin offline, so the plugin has none either: it contacts our licensing service when it loads in Maya’s window and whenever the license needs it, and only then.

The trial and the license belong to the computer, not to the plugin: one Standard license covers the Blender plugin and the Maya plugin, and the C, Rust and Python SDKs, on the same computer. A license activated in the Blender plugin or from an SDK shows Standard license here too. A Developer license key does not work in the plugin: Activate refuses it with Developer licenses work in the SDKs only: the plugins need a Standard license. The plans, prices and the buying steps are on Licensing.

The trial

The trial starts the first time Deformable runs on the computer, in a plugin or in an SDK. The computer must be online that one time: the plugin asks our licensing service to start the trial when Maya loads it. After that, the trial also works offline.

During the trial, every feature works, and a Deformable Scene can hold up to 2,500 tetrahedrons. Every object in it counts, floors included, but an object that is disabled: it takes no part in the simulation. Each create action names its object with its count and the scene’s total, disabled objects included, such as Deformable: Made pPlane1: 6 tetrahedrons; scene total 198.

A bigger Deformable Scene says so, as a warning, when a create action makes it too big, at the start frame and when you play, such as Deformable: Made pSphere2: 836 tetrahedrons; scene total 3,120. Trial limit: the scene simulates 3,120 tetrahedrons; the trial allows 2,500. When you play it, the plugin stops the playback and shows the limit in a dialog, with Buy License, Preferences and Close. The objects that do not fit stay still, and the rest of the scene runs. To simulate the whole scene, use fewer tetrahedrons, for example with a lower Target Face Count on the object’s Deformable Autocage or a simpler cage, split the objects between two Deformable Scenes, or buy a license. See Use fewer tetrahedrons.

On day 8, the status shows Standard trial ended — Buy license, and the tools and the simulation stop: each tool node shows the same message as its error. Reinstalling the plugin does not restart the trial: the start is kept in your user folder, outside the plugin, which a reinstall leaves alone.

Buy a license

Click Buy License in the Deformable Preferences window. Your browser opens the pricing on tangerina.io/deformable. Click Buy license there to open the payment page. After you pay, you get your license key by email.

The Standard license is $99 one time (USD), with no subscription. It is perpetual, covers all future versions (every update is included), covers the Blender and Maya plugins and the C, Rust and Python SDKs, and includes email support at support@tangerina.io.

Activate a license

  1. Choose Deformable Help > License….
  2. Paste your license key into the key field of the License section.
  3. Make sure the computer is online, and click Activate.

The section shows Contacting the licensing service…, then Standard license, and the tetrahedron limit is gone. The plugin clears the field: the engine keeps the key. Activation needs internet one time. If it fails, the section shows why, such as This license is active on another device: deactivate it there or remove that device in the license portal. With an empty field, Activate says Paste the license key from the email first.

The tools that the license refused before compute again by themselves.

After that, the plugin works offline between renewals. While you use it on a computer that is online, it renews the license quietly, a few times a day at most, and checks each time Maya loads it. Each renewal lets it run about 7 days offline. When it was not used for longer than that, the first tool or simulation step renews the license first. After about 7 days offline, it shows Go online once to renew the Standard license and the tools stop until you connect and click Check Now.

Deactivate a license

A Standard license is 1 seat: one computer. A second computer needs the license moved to it, or a second license. To move it to another computer, deactivate it on this one first:

  1. Choose Deformable Help > License….
  2. Make sure the computer is online, and click Deactivate.
  3. On the new computer, install the plugin, then activate the same key.
Old computer 1. Deactivate New computer 2. Activate Same key

Deactivating here also deactivates the Blender plugin and the SDKs on this computer. Offline, the plugin keeps the license and shows Go online to deactivate, or remove this device in the license portal.

If you no longer have the old computer, remove it in the license portal instead. The link is in the FAQ at tangerina.io/deformable. Lost keys and refunds are on Licensing.

Preferences

The Settings section of the window holds:

Preference Default What it does
Verify Meshes Before Creating Objects On Refuse a mesh that is not clean and closed when you create a deformable object.
Frame Cache Limit 2 GB per scene The memory each Deformable Scene keeps its simulated frames in. Past it, new frames are not kept. See Frame Cache Limit.

Maya keeps them in your preferences, between sessions.

With Verify Meshes Before Creating Objects on, every create action checks each mesh first, and so does Add Surface Mesh to Object with Breakable on. A mesh with problems is refused, and the warning names them, such as Not verified: pSphere1: non closed boundary (84), co located vertices (2), non planar (104).

Turn it off to create objects from meshes with small problems that do not matter for your shot, such as a model with separate eyes. The tools may then still fail on the mesh, and the node shows why. To find and fix the problems instead, see Verify Mesh.

With the preference off, the create actions do not check the object’s transform either. An object with a mirrored or flat transform, such as a negative scale, is then left out of the simulation, and Play names it with its scale is negative or zero. See Mesh checks before creating.

Help

The bottom of the window has two buttons:

  • Documentation opens this user guide in your browser.
  • Copy Support Info copies the Maya version, the operating system, the plugin and library versions and the license status. Paste it into your email to support@tangerina.io. The plugin then says Copied the support info: paste it into your email.

The Deformable Help menu has the same and more:

Item What it does
User Guide Opens this user guide.
Scripting Reference Opens Command line and scripting.
Copy Support Info As the button above. In mayapy, it prints the lines instead.
About Deformable Shows the plugin, library and Maya versions and the system.
License… Opens the Deformable Preferences window.

The pages of this guide also open from the plugin’s windows: an option window’s Help menu opens the page of its action, and the Attribute Editor’s Help menu, on a Deformable node, opens the page of its node type.

Update the plugin

To install a new version:

  1. Download the .zip file for your system from tangerina.io/deformable.
  2. Quit Maya.
  3. In your modules folder, delete deformable.mod and the deformable folder, and unzip the new version in their place, as in Install the plugin. On a Mac, clear the download’s mark again.
  4. Start Maya. The plugin loads by itself while Auto load is on.

A running Maya keeps the version it loaded, so always quit Maya first. The plugin rebuilds its shelf each time it loads, so the shelf always matches the version.

To remove the plugin, choose File > New Scene, turn off Loaded and Auto load in Windows > Settings/Preferences > Plug-in Manager, quit Maya, and delete deformable.mod and the deformable folder. Your trial or license stays on the computer.