You are viewing the documentation for Deformable v0.7.0, an older version. Read the latest, v0.9.0
Blender Plugin
License and preferences
The plugin's preferences in Blender, the license status, Free and its limit, signing in with a Standalone subscription, activating and deactivating a license key, the mesh check setting, and the Documentation and Copy Support Info buttons.
On this page
The plugin keeps its settings in Blender’s preferences. There you see your license, sign in with a subscription or activate a license key, turn the mesh check on or off, open this guide, and copy what a support email needs.
To open them, choose Edit > Preferences > Add-ons and expand Deformable.
License status
The License box at the top of the plugin preferences starts with the status, beside an icon:
| Status | What it means |
|---|---|
| Free: up to 2,500 tetrahedrons per scene | No subscription or license key is active. Every feature works, and a Deformable Scene simulates up to 2,500 tetrahedrons. |
| Standalone subscription | This device is signed in and uses your Standalone subscription. There is no limit. |
| Standalone subscription — Connect to the internet within 5 hours | The subscription works, but the device has not checked in for more than 18 hours. Connect to the internet. |
| Connect to the internet to check your Standalone subscription | The device went a day without a check-in, or the clock was set back. Connect to the internet and click Check Now. |
| Your subscription is in use on a device’s name, or Every seat of your subscription is in use | Another device uses the subscription’s seat. See Use it here instead. |
| Your subscription is now in use on a device’s name | Another device took the seat with Use It Here Instead. Click Use It Here Instead to take it back. |
| This device was removed from your subscription | This device was removed on the subscription’s page. Click Check Now or Use It Here Instead to use the seat again. |
| This account has no active Standalone subscription — Subscribe | The account you signed in with has no subscription to Deformable, or it ended. Click Subscribe, or, when its payment failed, Manage Subscription to change its card; then click Check Now. |
| Your sign-in ended: sign in again to use your Standalone subscription | The sign-in went 7 days without a check-in, or it was ended on the platform. Click Sign In. |
| Standalone license | A Standalone license key is active on this device. There is no limit. |
| Connect to the internet to renew your Standalone license | The license went 7 days without a renewal, or the clock was set back. Connect to the internet and click Check Now. |
Below the status, the box shows:
- Meanwhile, Deformable runs as Free: up to 2,500 tetrahedrons per scene while the status asks you to do something, as in the statuses after Standalone subscription above: the subscription or the license does not apply until you do it.
- Signed in as and your account’s email while a subscription is signed in.
- The code and Open Browser, Copy Code and Cancel while you sign in. See Sign in with a subscription. In Free, they show under Subscription, below the greyed-out Sign In.
- Online access is off in Blender’s preferences (System > Network) while Blender’s Allow Online Access is off. The plugin then contacts nothing: Sign In, Use It Here Instead, Activate and Check Now are greyed out, and a subscription or a license runs only as long as it runs offline. Sign Out and Deactivate still work, but cannot free the seat. Turn Allow Online Access on in Edit > Preferences > System > Network to use them all.
- Contacting the licensing service… while the plugin checks in, signs in or out, activates or deactivates. When that fails, the box shows why, such as This license key does not exist. Status messages lists every message and what to do.
- A divider, then the buttons of the status:
| Status | Buttons |
|---|---|
| Free | Two groups, with a divider between them. Subscription: Sign In; Subscribe and Manage Subscription. License Key: the key field and Activate; Buy License and Manage Licenses. While the sign-in code shows, License Key is hidden. |
| Standalone subscription | Sign Out; Manage Subscription |
| Connect to the internet to check your Standalone subscription | Check Now and Sign Out; Manage Subscription |
| In use on another device, or removed from your subscription | Use It Here Instead, Check Now and Sign Out; Manage Subscription |
| No active Standalone subscription | Check Now and Sign Out; Subscribe and Manage Subscription |
| Your sign-in ended | Sign In and Sign Out; Manage Subscription |
| Standalone license | Deactivate; Manage Licenses |
| Connect to the internet to renew your Standalone license | Deactivate and Check Now; Manage Licenses |
Check Now contacts our licensing service right away and checks in the subscription or renews the license. Subscribe opens the subscribe page, where you choose monthly or yearly and pay; an account that already subscribes is sent to its subscription. Manage Subscription opens the Subscriptions page, where you open your subscription to see its devices, cancel it or change its card. Buy License opens Buy Standalone license on the Licenses page. Manage Licenses opens the Licenses page, where you open a license to copy its key and see the devices that use its seats. Under a Standalone license, the box also shows Sign Out when a subscription is signed in on the same device: the license applies, and Sign Out frees the subscription.
The subscription and the license belong to the device, not to the plugin: the Maya plugin and the C, Rust and Python SDKs on the same device share them. A subscription signed in or a license activated in the Maya plugin or from an SDK shows here too. An Application license key does not work in the plugin: Activate refuses it with Application licenses work in the SDKs only: the plugins need a Standalone license. The subscription, the licenses, their prices and the buying steps are on Licensing.
Free
Without a subscription or a license key, the plugin runs as Free, forever: every feature works, and a Deformable Scene simulates up to 2,500 tetrahedrons. It needs no account and no internet, and the plugin sends nothing.
Every object in the scene counts, floors included, but an object with Disabled on: it takes no part in the simulation. The status bar shows how many the active object and its scene hold, disabled objects included, such as Deformable: Sphere: 212 tetrahedrons; scene total 218.
A bigger Deformable Scene says so in the status bar, at the start frame and when you play, such as Deformable: Free: the scene would simulate 3,120 tetrahedrons; the limit is 2,500 per scene. It also shows as soon as a create action makes the scene too big. When you play, the objects that do not fit stay still and the rest of the scene runs. Each Deformable Object node that does not fit shows the limit, such as Free: this would simulate 3,120 tetrahedrons; the limit is 2,500 per scene. To simulate the whole scene, use fewer tetrahedrons, for example with a lower Target Face Count on the Autocage panel or a simpler cage, or subscribe or buy a license. See Use fewer tetrahedrons.
Sign in with a subscription
The Standalone subscription is $14 per month or $79 per year, on 1 device, with no limit, and includes email support at support@tangerina.io. Click Subscribe to open the subscribe page, sign in or create an account, choose monthly or yearly, and pay. It has no key: you sign in from the plugin.
- Open Edit > Preferences > Add-ons and expand Deformable.
- Click Sign In. The box shows a code, such as Your code: ABCD-EFGH, with Approve it in your browser within 10 minutes, and your browser opens the platform’s sign-in page with the code filled in. If it does not, click Open Browser. To approve in another browser, click Copy Code, open platform.tangerina.io/device there and paste the code.
- In the browser, sign in to your account if it asks, check that the page shows the same code, type your password (and a code from your authenticator app when two-factor authentication is on), and click Approve.
- The box shows Standalone subscription and Signed in as your email, and the tetrahedron limit is gone.
Click Cancel to stop waiting. If you click Deny in the browser, the box says The sign-in was denied: check your account on the platform, then sign in again. Signing in needs the internet. While a Standalone license is active, Sign In is hidden: deactivate it first to sign in instead.
The objects that the limit held still simulate again by themselves.
After that, the plugin checks in with our licensing service when Blender starts and every hour while it is open, and the engine checks in every few hours while you use it. Each check-in lets the subscription run 1 day offline. From 6 hours before that day runs out, the status counts down, such as Standalone subscription — Connect to the internet within 5 hours. After a day offline, it shows Connect to the internet to check your Standalone subscription and the plugin runs as Free, with its limit, until you connect and click Check Now. After 7 days without a check-in, the sign-in ends: click Sign In again.
Use it here instead
A Standalone subscription works on 1 device at a time. When another device uses it, the status shows Your subscription is in use on followed by that device’s name, and the plugin runs as Free. To use the subscription on this device:
- Click Use It Here Instead. The seat moves to this device at once, and the box shows Standalone subscription. The other device learns it at its next check-in, within an hour while its plugin is open and within a day if it is offline, and shows Your subscription is now in use on followed by this device’s name.
- Or click Sign Out on the other device first, then Check Now here. That takes the free seat without taking it from anyone.
A lost or dead device frees its seat by itself after a day without a check-in. To free it at once, click Manage Subscription, open your subscription, and click Remove beside the device.
Sign out
Click Sign Out. The plugin forgets the sign-in at once, even offline, and runs as Free. When the device is online, it also frees the seat. Offline, the seat frees itself within a day, and the box shows Signed out on this device, but its seat could not be freed: it frees itself within a day. Signing out here also signs out the Maya plugin and the SDKs on this device.
To stop paying, click Manage Subscription, open your subscription, and cancel it there. Cancelling and refunds are on Licensing.
Buy a license
Click Buy License in the plugin preferences. Your browser opens Buy Standalone license on the Licenses page: sign in, or create an account first. Choose the number of seats, one per device, and pay. The license page then shows your key: copy it.
The Standalone license is $99 per seat, one time: you pay once. 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
- Open Edit > Preferences > Add-ons and expand Deformable.
- Paste your license key into the License Key field.
- Make sure the device is online, and click Activate.
The box shows Contacting the licensing service…, then Standalone 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 box shows why, such as Every seat of this license is in use: remove a device on the Licenses page, or buy another license. With an empty field, Activate says Paste the license key from the Licenses page first. While a subscription is signed in, the field is hidden: sign out first to use a key instead.
The objects that the limit held still simulate again by themselves.
After that, the plugin works offline between renewals. While you use it on a device that is online, it renews the license quietly, a few times a day at most, and checks each time Blender starts. Each renewal lets it run 7 days offline. After 7 days offline, it shows Connect to the internet to renew your Standalone license and the plugin runs as Free, with its limit, until you connect and click Check Now.
Deactivate a license
A Standalone license runs on 1 device per seat. To move a seat to another device, deactivate it on this one first:
- Open the plugin preferences.
- Click Deactivate.
- On the new device, install the plugin, then activate the same key.
Deactivating here also deactivates the Maya plugin and the SDKs on this device. The plugin forgets the license at once, even offline, and the plugin runs as Free. Offline, the seat stays taken, and the box shows Deactivated on this device, but its seat could not be freed: remove this device on the Licenses page.
If you no longer have the old device, click Manage Licenses, open the license, click Remove beside the old device, then Remove device. Lost keys and refunds are on Licensing.
Preferences
The Settings box below the License box 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. |
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: Suzanne: 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 still refuse an object with a mirrored or flat transform, such as a negative scale. See Mesh checks before creating.
Help
Below the Settings box are two buttons:
- Documentation opens this user guide in your browser.
- Copy Support Info copies the Blender 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 shows Copied the support info: paste it into your email.
The pages of this guide also open from the plugin’s menus. Hover over an item of Object > Deformable, or a button of the License box, and press F1. Or right-click it and choose Online Manual.
Update the plugin
To install a new version, download the .zip file for your system from
tangerina.io/deformable and install it the same way as the first one: Edit > Preferences > Get
Extensions > Install from Disk. Then restart Blender: a running Blender keeps the version it loaded.