You are viewing the documentation for Deformable v0.6.0, an older version. Read the latest, v0.9.0
Deformable
Licensing
Free, the Standalone subscription, and the Standalone and Application licenses side by side, how to subscribe, buy and manage them on the platform, how to sign in and activate them in the Blender and Maya plugins and the C, Rust and Python SDKs, and the third-party software Deformable uses.
On this page
Deformable can be used in four ways. Free comes with every copy: the Blender and Maya plugins and the C, Rust and Python SDKs work forever without an account or a key, up to 2,500 tetrahedrons per scene. The Standalone subscription and the Standalone license both lift the limit on your own device, in the plugins and the SDKs: the subscription for $14 per month or $79 per year, for as long as you subscribe, and the license for $99 per seat, once. The Application license is for one company that ships the engine inside one app, built with the C, Rust or Python SDK, to any number of users. The license check lives in the engine library that the plugins and every SDK load: one sign-in call starts the subscription, and one activate call takes either kind of key.
Four ways to use Deformable
| Free | Standalone subscription | Standalone license | Application license | |
|---|---|---|---|---|
| Who | Anyone | 1 device | 1 device per seat | 1 company, 1 app, any number of users |
| Works in | The Blender and Maya plugins, the C, Rust and Python SDKs | The Blender and Maya plugins, the C, Rust and Python SDKs | The Blender and Maya plugins, the C, Rust and Python SDKs | The C, Rust and Python SDKs only. The Blender and Maya plugins refuse it. |
| Limit | 2,500 tetrahedrons per scene | None | None | None |
| Price | $0 | $14 per month or $79 per year | $99 per seat, one time | $499 per app, with 12 months of updates and support. $99 per year to renew them. |
| Updates | Every future version | Every version, while you subscribe | Every future version | Every version released before your updates end |
| Use | Your own work, personal and commercial. Not inside apps you give to others. | Your own work, personal and commercial | Your own work, personal and commercial | Inside the 1 app the key names |
| Account | Not needed | Needed: you sign in with it | Needed to buy | Needed for the trial and to buy |
| Key | None | None | tgdfp-xxxxx-xxxxx-xxxxx-xxxxx, checked online |
A long signed key that starts with tgdfp-, checked offline |
| Internet | Never | To sign in, then at least once a day | To activate, then at least once every 7 days | Never |
| Before buying | — | Use Free. There is no trial. | Use Free | A 30-day trial key, with no limit |
| Support | This documentation | Email, while your updates last | ||
| Refund | — | The first payment, within 14 days, on the subscription’s page | Within 14 days, on the Licenses page | None. Try it first with the 30-day trial. |
| Status line | Free: up to 2,500 tetrahedrons per scene | Standalone subscription | Standalone license | Application license: followed by your company’s name |
To learn Deformable, or for scenes that fit in 2,500 tetrahedrons, use Free. To use Deformable without the limit yourself, in a plugin or in your own scripts and programs, take the Standalone subscription, to pay as you go and stop when you like, or the Standalone license, to pay once and keep it. To ship the engine inside an app you give to others, take the Application license. Prices are in US dollars. The payment page shows the price in your local currency, and you pay in it.
Free
Free needs no account, no key and no internet. Install a plugin or an SDK and use it: every feature works, in every future version, forever. Nothing is sent anywhere, and Deformable writes no license file on your device.
Use it for your own work, personal or commercial, in the plugins or with the SDKs. To ship the engine inside an app that others use, you need an Application license. The Deformable License Agreement holds the full terms.
The tetrahedron limit
On Free, a scene simulates up to 2,500 tetrahedrons. Every object in it counts, floors included, but a disabled one, which takes no part in the simulation. The mesh tools and render surfaces have no limit.
- Adding an object that does not fit fails with a message that names the count and the limit, such as Free: this would simulate 3,120 tetrahedrons; the limit is 2,500 per scene. In an SDK, the object is not added, and a smaller one can still fit.
- When a scene holds more than fits, for example after a subscription or a license stopped, the objects that do not fit stay still (they are not simulated), in the order they were added, and the rest of the scene runs. They move again as soon as a subscription or a license applies.
- In the plugins, the objects that do not fit show the message, and a scene over the limit says how many tetrahedrons it simulates.
To stay under the limit, lower Target Face Count on the object’s Autocage, use a simpler cage, or simulate fewer objects. See Use fewer tetrahedrons.
Deformable also runs as Free whenever a subscription or a license does not apply: a Standalone subscription that needs to go online, has no seat on this device or ended, a Standalone license that needs to go online, and an Application trial key that ended. Nothing ever refuses to run: the limit is the only difference.
Your account on the platform
You subscribe, buy and manage everything on the Tangerina platform, at platform.tangerina.io: the Standalone subscription on its Subscriptions page, and the Standalone and the Application license on its Licenses page.
- Open platform.tangerina.io and click Create an account.
- Type your name, your email address and a password, and click Create account.
- Open the link in the email we send you, to confirm your address. You confirm it once, before you subscribe, buy a license or start a trial.
The Subscriptions page starts with one card per product that sells a subscription, with its plans and their prices, and below it lists your subscriptions. Click a subscription to open its page, which shows its plan, its status and the date it renews, its Devices, and its actions: Change card, Cancel or Resume, and Ask for refund, as each applies. In a plugin, Manage Subscription opens this page, and Subscribe opens Deformable’s subscribe page, where you choose monthly or yearly and pay.
The Licenses page starts with one card per product on sale, with its prices, a Buy button for each license, and a Start a free 30-day trial link until your account has had that product’s trial. Below it, two tables list your licenses, newest first, with a search box: Standalone licenses and then Application licenses. Each purchase and each Application trial is a license of its own, with its own key. Click a license to open its page, which shows:
- Its status and its current key, with a copy button. Previous keys lists the keys that came before it.
- Devices, for a Standalone license: the devices that use its seats, each with its name, its first activation and its last refresh.
- Payments: the purchase, renewals and refunds.
- Its actions: Buy Application license (on an Application trial), Renew updates, Replace key, Remove beside a device and Ask for refund, as each applies.
We email you when a subscription starts, renews soon (yearly plans), changes, will end or ends, and when its payment failed; when a license is ready or its updates are renewed, 3 days before an Application trial ends, 30 days before an Application license’s updates end, after a refund, and when a license is revoked. The emails link to the subscription’s or the license’s page. They never hold a key: you copy it from the page.
Standalone subscription
The Standalone subscription covers the Blender plugin, the Maya plugin and the C, Rust and Python SDKs on 1 device, with no tetrahedron limit, for your own work, personal and commercial. It is $14 per month or $79 per year, renews automatically until you cancel, and has no trial: use Free to try Deformable first. It unlocks exactly what a Standalone license unlocks. Like the Standalone license, it does not let you ship the engine inside an app that others use: that needs an Application license.
There is no key. You sign in to your account from a plugin or an SDK, approve the sign-in in your browser, and Deformable uses your subscription on that device. It checks in with our licensing service at least once a day.
In short: subscribe on the platform, click Sign In in a plugin (or call the SDK’s sign-in function), approve the code in your browser, and use Deformable.
Subscribe
- Click Subscribe in a plugin, or open the subscribe page. Sign in, or create an account first. If your account already has a subscription to Deformable, the page opens it instead.
- Choose monthly ($14 per month) or yearly ($79 per year). On the Subscriptions page, Subscribe monthly and Subscribe yearly on the Deformable card do the same.
- Check the plan, and click Continue to checkout.
- Pay on the payment page. It shows the price in your local currency, and you get an invoice with each payment.
- Your subscription’s page opens. Now sign in from a plugin or an SDK on the device where you use Deformable.
Your account has one subscription to Deformable. To move between monthly and yearly, open the Subscriptions page and click Change to yearly or Change to monthly on the Deformable card.
Sign in
Sign in once on each device. The plugins and the SDKs on that device share the sign-in. The device must be online.
In Blender:
- Open Edit > Preferences > Add-ons and expand Deformable.
- Click Sign In. The License box shows a code, such as Your code: ABCD-EFGH, 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 plugin shows Standalone subscription and Signed in as your email. The tetrahedron limit is gone.
In Maya:
- Choose Deformable Help > License…. The Deformable Preferences window opens.
- Click Sign In in its License section. The section shows the code, and your browser opens the platform’s sign-in page with the code filled in. If it does not, click Open Browser. Copy Code works as in Blender.
- Approve the code in the browser, as in Blender.
- The window shows Standalone subscription and Signed in as your email. The tetrahedron limit is gone.
From an SDK, start the sign-in, show the code and the address to the user, and wait for the approval, as in The SDKs.
The code works for 10 minutes. Approve only a sign-in you started yourself: an approved app uses your account’s subscription until you sign it out. If you click Deny, the plugin says The sign-in was denied: check your account on the platform, then sign in again. Cancel beside the code stops waiting.
When the account has no running subscription to Deformable, the sign-in still succeeds, and the status line says This account has no active Standalone subscription — Subscribe. Click Subscribe in the plugin, or, when its payment failed, Manage Subscription to change its card; then click Check Now.
One device at a time
A Standalone subscription has 1 seat: it works on 1 device at a time. A device is one computer. The Blender plugin, the Maya plugin and the SDKs on it all use the same seat, and reinstalling a plugin or an SDK keeps it.
When you sign in on a second device while the first one uses the seat, the second device shows Your subscription is in use on followed by the first device’s name, and runs as Free. To move the seat:
- Click Use It Here Instead on the new device (or call the SDK’s take-over function). The seat moves to this device at once. The old device learns it at its next check-in, within an hour while a plugin is open and within a day if it is offline, then shows Your subscription is now in use on followed by the new device’s name, and runs as Free. Use It Here Instead there takes the seat back.
- Or click Sign Out on the old device first, then Check Now on the new one. That takes the free seat without taking it from anyone.
A device that is lost or dead frees its seat by itself after a day without a check-in. To free it at once, open the Subscriptions page (Manage Subscription in a plugin), open your subscription, and click Remove beside the device. A removed device shows This device was removed from your subscription at its next check-in.
The subscription’s page lists the devices that use its seat, by the device’s name (its host name), with the app, its place and its last check-in.
Online and offline with a subscription
A Standalone subscription needs the internet to sign in. After that, each check-in lets the device work offline for 1 day:
- While Deformable runs on a device that is online, it checks in by itself, every few hours at most. The plugins also check when they start, and every hour while they are open. You do not need to do anything.
- From 6 hours before the day runs out, the status line counts down, such as Standalone subscription — Connect to the internet within 5 hours.
- When the device was offline for longer than a day, Deformable shows Connect to the internet to check your Standalone subscription, and runs as Free, with its limit, until the device is online again. Connect, and Deformable checks in; in a plugin, click Check Now to check at once.
- Your sign-in lasts as long as you use it. After 7 days without a check-in, it ends, and the status line says Your sign-in ended: sign in again to use your Standalone subscription: click Sign In again. It also ends when you change your password, turn two-factor authentication on or off, or sign it out in the Sessions list of your account on the platform.
- In Blender, Deformable follows Allow Online Access (Edit > Preferences > System > Network), as for a Standalone license. While it is off, the subscription runs only as long as it runs offline. The Maya plugin is always allowed online.
- Deformable checks the device’s clock. If it is set back by more than an hour, the subscription is not trusted and Deformable runs as Free, with Connect to the internet to check your Standalone subscription, until a check-in online succeeds.
A device that is never online cannot use a Standalone subscription. For a device that is often offline, take a Standalone license, which works 7 days offline between renewals. A device without internet uses Free, or your app ships with an Application license, which needs no internet.
Sign out
Click Sign Out in a plugin’s license section, or call the SDK’s sign-out function. Deformable forgets the sign-in on that device at once, even offline, and runs as Free. When the device is online, it also frees the seat and ends the sign-in on the platform. Offline, it says Signed out on this device, but its seat could not be freed: it frees itself within a day.
Signing out in one plugin signs out the other plugin and the SDKs on that device too.
Subscription and license on one device
A device uses either a Standalone subscription or a Standalone license, never both:
- Sign In on a device with an active Standalone license says Deactivate the current license first.
- Activate with a Standalone key on a device that is signed in says Sign out of the Standalone subscription first.
If both ever end up on one device, such as when two programs act at once, the Standalone license applies, and the plugin offers Sign Out beside Deactivate. A program that activated an Application key never uses the subscription: signing in there says This program uses an Application license.
Cancel and refunds
- Cancel: open the Subscriptions page (Manage Subscription in a plugin), open your subscription, and click Cancel. The subscription keeps working until the end of the period you paid for, then ends; until then, Resume undoes it. After it ends, each device shows This account has no active Standalone subscription — Subscribe at its next check-in, and runs as Free.
- Refund: within 14 days of your first payment, open your subscription’s page and click Ask for refund. You get back what you paid, in the currency you paid in, and the subscription ends at once. Renewals are not refunded. Once you have had money back for a Deformable subscription, by a refund or a reversed payment, a refund of another one in the next year goes through support@tangerina.io, within 14 days of its first payment.
- Card: to pay with another card, click Change card on the subscription’s page.
- Payment failed: our payment provider tries again over the following days, and we email you to update your card. If every try fails, the subscription ends.
Standalone license
The Standalone license covers the Blender plugin, the Maya plugin and the C, Rust and Python SDKs on one device per seat. One seat covers both plugins and every SDK on that device: there is no separate license for Maya. It is $99 per seat, one time: you pay once. It is perpetual and covers every future version: every update is included.
In short: buy on the Licenses page, copy the key, activate it in a plugin or an SDK, and use Deformable. It works offline between renewals, which need the internet at least once every 7 days.
Buy a Standalone license
- Click Buy License in a plugin, or Buy beside Standalone license on the Deformable card of the Licenses page. Sign in, or create an account first.
- Choose the number of seats, from 1 to 1,000: one per device. Click Continue to checkout.
- Pay on the payment page, $99 per seat. It shows the price in your local currency, and you get an invoice with the receipt.
- The license page opens and shows your key. It looks like
tgdfp-xxxxx-xxxxx-xxxxx-xxxxx. Click the copy button.
A license of several seats has one key: paste the same key on every device. To add seats later, buy another Standalone license; it has its own key.
Activate a Standalone license
Activate the key in a plugin or from any SDK. One activation is enough for all of them on that device. The device must be online this one time.
In Blender:
- 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 plugin shows Standalone license. The tetrahedron limit is gone.
In Maya:
- Choose Deformable Help > License…. The Deformable Preferences window opens.
- Paste your license key into the key field of its License section.
- Make sure the device is online, and click Activate.
- The window shows Standalone license. The tetrahedron limit is gone.
From an SDK, call its activate function once with the key, as in The SDKs.
The key’s letter case does not matter, and spaces and line breaks in it are ignored.
One activation per device
On each device, your user account holds one activation. The plugins, your Python scripts and your own programs on that device all share it:
- A license you activate in one plugin also licenses the other plugin and the SDKs on that device, and a license you activate from an SDK also licenses the plugins.
- Deactivating in one of them deactivates it for all of them.
- Reinstalling a plugin or an SDK keeps the license: it is kept in your user folder, outside the plugins and the SDKs.
Another user account on the same device keeps its own state, so it activates the key again. It uses the same seat.
Online and offline
A Standalone license needs the internet to activate. After that it works offline, for up to 7 days at a time:
- While Deformable runs on a device that is online, it renews the license by itself, a few times a day at most. You do not need to do anything. The Blender plugin also checks each time Blender starts, and the Maya plugin each time it loads in Maya’s window.
- Each renewal lets the license run 7 days offline. When the device was offline for longer, Deformable shows Connect to the internet to renew your Standalone license and runs as Free, with its limit, until the device is online again. Connect, and Deformable renews the license; in a plugin, click Check Now to renew it at once.
- In Blender, Deformable follows Allow Online Access (Edit > Preferences > System > Network). While it is off, Deformable contacts nothing, the license runs as long as it runs offline, and the plugin preferences show Online access is off in Blender’s preferences (System > Network).
- In Maya, the plugin contacts our licensing service whenever the license needs it. Maya has no setting that turns a plugin’s internet access off, so the Maya plugin has none either.
- Deformable checks the device’s clock. If it is set back by more than an hour, the license is not trusted and the device runs as Free, with Connect to the internet to renew your Standalone license, until a renewal online succeeds. If the renewal finds the clock wrong, it says The clock of this device is wrong: set the correct time, then try again.
A device that is never online cannot activate a Standalone license. For a device without internet, such as a machine on a closed network, use Free, or ship your app with an Application license, which needs no internet.
Devices
A Standalone license has as many seats as you bought, 1 device per seat. The license page lists the devices that use them, by the device’s name (its host name), with its First activation and its Last refresh, the last time it renewed the license. Activating the key again on the same device, such as after a reinstall, uses no new seat.
To move a seat to another device:
- On the old device, click Deactivate in a plugin’s license section, or call the SDK’s deactivate function. The license is forgotten on that device at once, even offline, and its seat is freed when the device is online. If it is offline, Deformable says Deactivated on this device, but its seat could not be freed: remove this device on the Licenses page: then do step 2.
- If the old device is dead, lost or offline, open the license’s page (Manage Licenses in a plugin), click Remove beside it, then Remove device. The seat is free at once. That device learns it at its next renewal, and stops within 7 days if it stays offline.
- On the new device, install a plugin or an SDK and activate it with the same key, as in Activate a Standalone license.
When every seat is in use, activating says Every seat of this license is in use: remove a device on the Licenses page, or buy another license.
Replace a key
If your key leaked, such as in a public repository, open the license’s page and click Replace key. The license gets a new key, with the same seats, and the old key stops working. On each device that used the old key, click Deactivate (or call the SDK’s deactivate function), then activate the new key. A device that keeps the old key goes back to Free at its next renewal, with This license key was revoked.
Lost Standalone license key
Sign in to the Licenses page, open the license, and copy its key. If you forgot your password, click Forgot your password? on the sign-in page.
Application license
The Application license lets one company ship the engine inside one app, built with the C, Rust or Python SDK, to any number of users. It is $499 per app, with 12 months of updates and support. After that, renewing the updates is $99 per year. Your app carries the key and turns it on each time it starts, offline. A second app needs a second Application license.
The Application license works in the SDKs only. The Blender and Maya plugins refuse an Application key with the message Application licenses work in the SDKs only: the plugins need a Standalone license: to use the plugins without the limit, take a Standalone license.
In short: start the 30-day trial on the Licenses page, activate its key in your app, buy the license, and put the full key in the trial key’s place.
Application trial
- Sign in to the Licenses page, or create an account first.
- On the Deformable card, click Start a free 30-day trial.
- Type your company and the app you build, and click Start Application trial.
- The license page opens and shows the trial key. Click the copy button.
The trial key works for 30 days, with every feature and no tetrahedron limit. It works in any program you build while it lasts: the app’s name is only shown. Use it the way you will use the full key, as in Activate an Application license. It works offline: the key itself holds the day it ends. Each account has one Application trial. To try for longer, email support@tangerina.io.
The status line counts the days down, from Application trial: 30 days left to Application trial: 1 day left. When the trial key ends, the status is Application trial ended — Buy license, and a running program goes on as Free, with its limit. Activating the ended key at the next start fails with the same message, and the program runs as Free.
The trial key is for testing only: never ship it inside your app.
Buy an Application license
- On the Licenses page, open your Application trial and click Buy Application license: the company and the app are filled in from the trial. Or click Buy beside Application license on the Deformable card and type your company and the app you ship.
- Click Continue to checkout, and pay $499 on the payment page. It shows the price in your local currency, and you get an invoice with the receipt that names your company and your app. Each renewal gets one too.
- The license page opens and shows the full key. Click the copy button.
Buying from your trial keeps the same license, so its page holds the trial key, now replaced, and the full key. The form refuses a company and app that already have a license on your account, with You already have a license for this app. Renew it instead.: renew that license instead of buying a second one. When that license is your Application trial, it says You have an Application trial for this app. Buy it from its license page instead.: open the trial and buy from there, as in step 1. Another app is another license.
Activate an Application license
Your app turns the key on itself, with the SDK’s activate call: the same call that activates a Standalone key. The
library tells the two apart by their shape: an Application key is a long key in three parts,
tgdfp-<payload hex>-<signature hex>. It checks the key offline, against the signature it carries, and never contacts
the network, so the call’s timeout does not matter. Nothing is stored on the device: the key holds for that run of the
program only. So:
- Call activate with the key at every start of your app, as its first Deformable call, before any engine call and before status and refresh. Every scene then runs without the limit from the start, and your app never reads or renews a Standalone license of its user’s device.
- Keep the key inside your app, such as in its code, never in a file that its users read or edit, and never in a public place such as a public repository.
- To move from the trial key to the full key, or to a renewed key, put the new key in the old key’s place. A running program keeps the first Application key it activated: activating a different one fails with Another Application license key is already set in this program, so the new key counts from the next start.
- Once an Application key is active, the program refuses a Standalone key with This program uses an Application license.
The code for each SDK is in The SDKs.
Updates and renewals
A full Application key covers every version of Deformable released before its updates end, 12 months after you buy. Those versions keep working with the key forever, in your app and for all its users: the library compares its own release date with the key’s end of updates, never with today’s date, so an app you shipped never stops.
A version released after your updates end refuses the key with This Application license covers versions released until followed by the date, — Renew updates. You see this on your own machine as soon as you update the SDK, before you ship anything with it.
To renew, open the license’s page and click Renew updates, and pay $99. The license gets a new key whose updates run 1 year past the old end, or 1 year from today if the old end has passed. Put the new key in your app when you move to a newer version. The old key keeps working for every version it covered. We email you 30 days before your updates end.
Renewals also keep your email support.
What users need
Nothing. On your users’ devices, your app needs no activation, no network, no seat and no end date. Deformable keeps no license state in their user folder and contacts no licensing service. The status line shows Application license: followed by your company’s name.
The key covers the one app that you named when you bought it, with its updates, new versions and editions under the same name. Ship the engine library only inside that app, keep the key hidden in it, and never pass on the key. Ship the SDK only as the part your app needs to run, never as a way for others to build their own apps on the engine. The Deformable License Agreement holds the full terms.
Lost Application license key
Sign in to the Licenses page, open the license, and copy its key.
Refunds and reversed payments
- Standalone subscription: within 14 days of your first payment, open the subscription’s page and click Ask for refund. You get back what you paid, in the currency you paid in, and the subscription ends at once. Each device learns it at its next check-in, within an hour while a plugin is open and within a day if it stays offline, and goes back to Free. Renewals are not refunded. Once you have had money back for a Deformable subscription, by a refund or a reversed payment, a refund of another one in the next year goes through support@tangerina.io, within 14 days of its first payment. See Cancel and refunds.
- Standalone license: within 14 days of purchase, open the license’s page and click Ask for refund. You get back what you paid, in the currency you paid in, and the key stops working at once. Each device learns it at its next renewal, within a few hours while it is online, and goes back to Free. A device that stays offline keeps the license until its 7 days offline run out. Once you have had money back for a Standalone license of Deformable, by a refund or a reversed payment, a refund of another one in the next year goes through support@tangerina.io, within 14 days of its purchase. A refund of a subscription does not count against a license, nor the other way round.
- Application license and renewals: there is no refund, because the key works offline and cannot be taken back from an app that already shipped. Try the license first with the 30-day trial.
- All of them: if a payment is reversed, such as by a dispute with your bank, what it paid for stops working. A subscription and a Standalone key stop at each device’s next check-in or renewal. An Application key is refused by the versions of Deformable released after that, with This Application license key was revoked.
Status lines
Each plugin shows the status line, the Blender plugin in its preferences and the Maya plugin in its Deformable Preferences window, and the SDKs give the same text as the license status’s message.
| Status | What it means |
|---|---|
| Free: up to 2,500 tetrahedrons per scene | No subscription or license is active. Every feature works, up to 2,500 tetrahedrons per scene. |
| 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. The number counts down to 1 hour. 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. Deformable runs as Free until it checks in. |
| Your subscription is in use on a device’s name | You signed in here while another device uses the seat. Deformable runs as Free. Click Use It Here Instead to move the seat here. See One device at a time. |
| Every seat of your subscription is in use | As above, when the device that uses the seat cannot be named. |
| Your subscription is now in use on a device’s name | Another device took the seat with Use It Here Instead. Deformable runs as Free. 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. Deformable runs as Free. 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, or its payment failed. Deformable runs as Free. Click Subscribe in a plugin, 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. Deformable runs as Free. 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 Standalone license went 7 days without a renewal, or the clock was set back. Deformable runs as Free until it renews. |
| Application trial: 30 days left | An Application trial key is active in this program. The number counts down each day, to Application trial: 1 day left. There is no limit. |
| Application trial ended — Buy license | The Application trial key ended. Deformable runs as Free. |
| Application license: followed by the company’s name | A full Application key is active in this program. There is no limit. A long company name is cut short to fit the line. |
In the plugins, the statuses in which Deformable runs as Free add a line under the status: Meanwhile, Deformable runs as Free: up to 2,500 tetrahedrons per scene.
Status messages
Signing in and out, activating, deactivating, Check Now in the plugins and the SDKs’ refresh can also show these messages.
Free messages
| Message | What to do |
|---|---|
| Free: this would simulate a count tetrahedrons; the limit is 2,500 per scene | The object would take the scene past the limit, so it stays still: in an SDK the add call adds nothing, and in a plugin the object is not simulated. Use fewer tetrahedrons, or sign in with a subscription or activate a license. See The tetrahedron limit. |
Subscription messages
| Message | What to do |
|---|---|
| The sign-in was denied: check your account on the platform, then sign in again | Deny was clicked in the browser, or the account cannot sign in yet, such as when its email address is not confirmed. Check your account, then click Sign In again. |
| This sign-in code is no longer valid: sign in again | The code’s 10 minutes ran out, or it was already used. Click Sign In again for a new code. |
| This version of Deformable cannot sign in: update Deformable | Install the newest version of the plugin or the SDK. |
| Signed out on this device, but its seat could not be freed: it frees itself within a day | The device was offline. The seat frees itself after a day without a check-in. To free it at once, remove the device on the subscription’s page. |
| Deactivate the current license first | You signed in on a device with an active Standalone license. Use the license, or deactivate it before you sign in. See Subscription and license on one device. |
| Sign out of the Standalone subscription first | You activated a Standalone key, or started a sign-in, on a device that is already signed in. Use the subscription, or sign out first. |
| Sign in first | An SDK waited for a sign-in, or took over the seat, before any sign-in started. Start the sign-in first. |
| This program uses an Application license | The program already activated an Application key, so it needs no subscription. |
The messages about reaching the licensing service, the device’s clock, the license state’s folder and online access are the same as for a Standalone license, below.
Standalone messages
| Message | What to do |
|---|---|
| This is not a license key | Copy the key again from the Licenses page. A Standalone key looks like tgdfp-xxxxx-xxxxx-xxxxx-xxxxx. |
| This license key does not exist | Check the key for typos, or copy it again from the Licenses page. |
| This license key is not for Deformable | The key is for another Tangerina product. Use your Deformable key. |
| Every seat of this license is in use: remove a device on the Licenses page, or buy another license | See Devices. |
| This license key was revoked | The key was replaced, or its payment was reversed. Copy the current key from the Licenses page. |
| This license was refunded | The license was refunded, so it no longer works. Deformable runs as Free. |
| This device was removed from the license: activate the key again | This device was removed on the Licenses page. Activate the key again, while a seat is free. |
| Deactivate the current license first | A different key is already active here. Deactivate it before you activate another. |
| Deactivated on this device, but its seat could not be freed: remove this device on the Licenses page | The device was offline. See Devices. |
| Could not reach the licensing service: check the internet connection | Connect to the internet, and try again. |
| The licensing service did not answer: try again in a few minutes | Our licensing service is busy or down. Try again later. A device with an active subscription or license keeps working meanwhile. |
| The licensing service’s answer did not verify | The answer was not signed by our licensing service, as on a network that rewrites traffic. Try another network. |
| The licensing service could not read this request: update Deformable | Install the newest version of the plugin or the SDK. |
| The clock of this device is wrong: set the correct time, then try again | Correct the date and time of the device. |
| The license state could not be written in a folder | Your user folder is full or read-only. Free space or fix its permissions, then try again. |
| Online access is off in this program, so the licensing service was not contacted | The program turned online access off (in Blender, Allow Online Access; the Maya plugin never turns it off). Turn it on. |
| This program uses an Application license | The program already activated an Application key, so it needs no Standalone key. |
Application messages
| Message | What to do |
|---|---|
| This is not a license key | Copy the whole key again from the Licenses page. An Application key starts with tgdfp- and has three parts. |
| This license key is not valid | The key is cut short, changed or not signed by us. Copy the whole key again from the Licenses page. |
| This license key needs a newer version of Deformable | Update the SDK to the newest version. |
| This license key is not a Deformable Application license | The key is for another product. Use your Deformable key. |
| Application licenses work in the SDKs only: the plugins need a Standalone license | An Application key was given to the Blender or Maya plugin. Use a Standalone subscription or a Standalone license there. |
| This Application license key was revoked | Write to support@tangerina.io. |
| This Application license covers versions released until a date — Renew updates | This version of the SDK came out after your updates ended. Renew them, and put the new key in your app; or keep a version released before that date. See Updates and renewals. |
| Application trial ended — Buy license | The trial key ended. Buy the license on the Licenses page, or write to support@tangerina.io for a longer trial. |
| Another Application license key is already set in this program | The program activated a different Application key earlier in this run. Activate one key only, and restart the program to use another. |
Who does what
| Step | Standalone subscription | Standalone license | Application license |
|---|---|---|---|
| Account, buying and keys | The subscribe page (Subscribe in a plugin), or Subscribe monthly or Subscribe yearly on the Subscriptions page’s Deformable card. No key. | The Licenses page: Buy on the Deformable card | The Licenses page: Start a free 30-day trial and Buy on the Deformable card |
| Payment | Our payment provider’s payment page, each month or year, with an invoice | Our payment provider’s payment page, with an invoice | Our payment provider’s payment page, with an invoice that names your company and app |
| Devices, cancelling and refunds | The subscription’s page | The Licenses page | — |
| Sign-in or activation, and the check | The engine library: a sign-in in the browser once, then a check-in at least once a day, in the plugins and in every SDK | The engine library, online once and then at least every 7 days, in the plugins and in every SDK | The engine library, offline, in every SDK |
Privacy
On Free and with an Application license, the engine library sends nothing.
With a Standalone subscription, it signs in to your account through your browser and keeps a token for that sign-in in your user folder. It sends the platform that token to check in, with a device hash, the device’s name when it takes a seat, afterwards the id the platform gave the device, the version of Deformable and the name of your system (macOS, Windows or Linux). It reads your account’s email back once, to show Signed in as your email. Your scenes and files are never sent.
With a Standalone license, it contacts our licensing service to activate, renew and deactivate. It sends the key and a device hash, the device’s name when it activates, afterwards the id the service gave the device, and the version of Deformable and the name of your system (macOS, Windows or Linux).
The device hash is made on the device from its hardware id, and is useless outside Deformable. The device’s name is its host name, which the subscription’s or the license’s page shows so you can tell your devices apart. We keep these with each activation, check-in and renewal time, and IP addresses for rate limits. The Deformable Privacy Notice holds the details.
The SDKs
The C, Rust and Python SDKs use the engine in your own app. All four work in them: Free, with its limit; the Standalone subscription and the Standalone license, for your own work on your device, which the SDKs share with the plugins; and the Application license, for an app you ship to others.
A Standalone subscription or license belongs to the device where the engine runs. A program you build with an SDK and run on other devices, such as your colleagues’, a server or a render farm, runs as Free on each of them unless that device has its own seat. A seat activated inside a container that is thrown away stays taken until you remove it on the Licenses page; a subscription’s seat frees itself after a day. To ship the engine inside an app you give to others, you need an Application license.
The C SDK zip comes from the download section of tangerina.io/deformable, the Rust crate from crates.io and the Python package from PyPI:
| SDK | How to get it |
|---|---|
| C | The zip for your platform, from the C SDK tab. See C SDK. |
| Rust | cargo add deformable. The first build downloads the engine library for your system. See Rust SDK. |
| Python | pip install deformable. See Python SDK. |
Each SDK has the same license calls:
| Call | What it does |
|---|---|
| status | Reads the license state: the Application license of this program when it activated one, otherwise Free, the Standalone subscription or the Standalone license of this device. It also says whether the device is signed in, and the account’s email. It never goes online, so it is cheap to call often. |
| refresh | Renews the Standalone license, or checks in the Standalone subscription, when that is due. Call it when your program starts. On Free, and under an Application license, it contacts nothing. |
| start sign-in | Starts a sign-in with a Standalone subscription: it returns the code and the address of the page that approves it, and how long the code lasts. Show both to the user, or open the address in the browser. |
| wait for sign-in | Waits for the approval, for at most the timeout you pass. It returns nothing while the sign-in is not approved yet, so call it again until it returns the status. |
| take over | Moves the subscription’s seat to this device: Use It Here Instead in the plugins. |
| sign out | Forgets the sign-in on this device at once, even offline, and frees its seat when the device is online. |
| activate | Takes either kind of key. A Standalone key is activated on this device and needs internet. An Application key is checked offline and holds for this run of the program. |
| deactivate | Forgets the Standalone license on this device at once, even offline, and frees its seat when the device is online. Under an Application license it contacts nothing and changes nothing. |
| set online access | Keeps your program off the network when its user asked for that: nothing is sent, and a subscription or a Standalone license runs only as long as it runs offline. |
With an Application key active, status, refresh, deactivate and sign out return the Application status and contact nothing, and the sign-in and take-over calls are refused with This program uses an Application license. The other calls wait for our licensing service for at most the timeout you pass, 15 seconds by default. Waiting for a sign-in can take up to 25 seconds more than its timeout: a check already sent gets its answer, and an approval gets its own time to take the seat. Every call is safe to call from any thread; a program with an interface calls them off its interface thread.
Activate checks the key itself first. A key in the wrong format, or an Application key that is not valid, is refused
before anything else, with its message, such as This is not a license key or This license key is not valid:
the status DEFORMABLE_STATUS_INVALID_ARGUMENT in C, the kind ErrorKind::InvalidArgument in Rust, and in Python a
DeformableError with the status INVALID_ARGUMENT (an empty or blank key, or one that holds a NUL character,
raises ValueError instead). The same goes for a second Standalone key while one is active, a second, different
Application key, a Standalone key in a program that uses an Application license, a Standalone key while the device is
signed in, a sign-in while a Standalone key is active or while the device is already signed in, a wait for a sign-in
that was not started, and a take-over before the device has signed in. It is not a license error, and the license state
does not change.
A subscription that has no seat on this device, or no active subscription behind it, is not an error either: the call succeeds, and the status says so.
The license errors are these. The error’s message is written to show the user as it is.
| Error | When |
|---|---|
| Tetrahedron limit exceeded | On Free, adding the object would take the scene past 2,500 tetrahedrons; a disabled object does not count. The error’s first index is the count the scene would simulate, the second the limit. The call that adds the object (add_, or deformable_ in C) adds nothing, and the scene goes on with the objects it holds. It is the only engine call the license can refuse. |
| License service unavailable | Our licensing service could not be reached or did not answer, its answer did not verify, the device’s clock contradicts it, or online access is off. Or a deactivation or a sign-out could not free the seat. |
| License key rejected | Our licensing service refused the Standalone key: it does not exist, was revoked or refunded, is not for Deformable, every seat is in use, or this device was removed. Or the Application key was refused: it was revoked, its trial ended, its updates ended before this version was released, or the program is Blender or Maya, where Application licenses do not work. |
| License storage failed | The license state could not be saved in your user folder. The message names the folder. |
| License sign-in failed | The sign-in was denied, its code is no longer valid, or this version of Deformable cannot sign in or send its request. Start a new sign-in, or update Deformable. |
C
A Standalone subscription, signed in once on this device. The program shows the code and the address, and waits until the user approves it in the browser:
#include <stdio.h>
#include "deformable.h"
int main(void) {
DeformableSignIn sign_in;
if (deformable_license_start_sign_in(15000, &sign_in) != DEFORMABLE_STATUS_OK) {
fprintf(stderr, "%s\n", deformable_last_error_message());
return 1;
}
printf("Open %s and approve the code %s\n", sign_in.verification_url, sign_in.user_code);
DeformableLicenseStatus status;
uint8_t approved = 0;
while (!approved) {
if (deformable_license_wait_for_sign_in(5000, &approved, &status) != DEFORMABLE_STATUS_OK) {
fprintf(stderr, "%s\n", deformable_last_error_message());
return 1;
}
}
printf("%s\n", status.message);
return 0;
}Open https://platform.tangerina.io/device?user_code=ABCDEFGH and approve the code ABCD-EFGH
Standalone subscriptionA Standalone key, activated once on this device:
#include <stdio.h>
#include "deformable.h"
int main(void) {
DeformableLicenseStatus status;
if (deformable_license_activate("tgdfp-xxxxx-xxxxx-xxxxx-xxxxx", 15000, &status) != DEFORMABLE_STATUS_OK) {
fprintf(stderr, "%s\n", deformable_last_error_message());
return 1;
}
printf("%s\n", status.message);
return 0;
}Standalone licenseAn Application key, activated at every start of your app, as its first Deformable call. Put the whole key from the
Licenses page in place of tgdfp-<payload>-<signature>:
#include <stdio.h>
#include "deformable.h"
static const char APPLICATION_LICENSE_KEY[] = "tgdfp-<payload>-<signature>";
int main(void) {
DeformableLicenseStatus status;
if (deformable_license_activate(APPLICATION_LICENSE_KEY, 15000, &status) != DEFORMABLE_STATUS_OK) {
fprintf(stderr, "%s\n", deformable_last_error_message());
return 1;
}
printf("%s\n", status.message);
/* The app's engine calls come after this. */
return 0;
}Application license: Acme Inc.deformable_license_status reads the state, deformable_license_refresh renews it, deformable_license_deactivate
frees the seat, deformable_license_take_over moves the subscription’s seat here, deformable_license_sign_out signs
out, and deformable_license_set_online_access(0) keeps the program off the network. The status’s signed_in is 1
while a subscription is signed in on this device, and account holds its email. The timeouts are in milliseconds.
The license statuses are DEFORMABLE_STATUS_TETRAHEDRON_LIMIT_EXCEEDED (44) to
DEFORMABLE_STATUS_LICENSE_SIGN_IN_FAILED (48). See
Memory and errors.
Rust
A Standalone subscription, signed in once on this device:
use std::time::Duration;
use deformable::license;
fn main() -> Result<(), deformable::Error> {
let sign_in = license::start_sign_in(license::DEFAULT_TIMEOUT)?;
println!("Open {} and approve the code {}", sign_in.verification_url, sign_in.user_code);
let status = loop {
if let Some(status) = license::wait_for_sign_in(Duration::from_secs(5))? {
break status;
}
};
println!("{}", status.message);
Ok(())
}Open https://platform.tangerina.io/device?user_code=ABCDEFGH and approve the code ABCD-EFGH
Standalone subscriptionA Standalone key, activated once on this device:
use deformable::license;
fn main() -> Result<(), deformable::Error> {
let status = license::activate("tgdfp-xxxxx-xxxxx-xxxxx-xxxxx", license::DEFAULT_TIMEOUT)?;
println!("{}", status.message);
Ok(())
}Standalone licenseAn Application key, activated at every start of your app, as its first Deformable call:
use deformable::license;
const APPLICATION_LICENSE_KEY: &str = "tgdfp-<payload>-<signature>";
fn main() -> Result<(), deformable::Error> {
let status = license::activate(APPLICATION_LICENSE_KEY, license::DEFAULT_TIMEOUT)?;
println!("{}", status.message);
// The app's engine calls come after this.
Ok(())
}Application license: Acme Inc.license::status() reads the state, license::refresh(timeout) renews it, license::deactivate(timeout) frees the
seat, license::take_over(timeout) moves the subscription’s seat here, license::sign_out(timeout) signs out, and
license::set_online_access(false) keeps the program off the network. The status’s signed_in is true while a
subscription is signed in on this device, and account holds its email. The license errors are the ErrorKind
variants TetrahedronLimitExceeded, LicenseServiceUnavailable, LicenseKeyRejected, LicenseStorageFailed and
LicenseSignInFailed. See Errors and threads.
Python
A Standalone subscription, signed in once on this device:
import deformable
sign_in = deformable.license.start_sign_in()
print(f"Open {sign_in.verification_url} and approve the code {sign_in.user_code}")
status = None
while status is None:
status = deformable.license.wait_for_sign_in(timeout=5)
print(status.message)Open https://platform.tangerina.io/device?user_code=ABCDEFGH and approve the code ABCD-EFGH
Standalone subscriptionA Standalone key, activated once on this device:
import deformable
status = deformable.license.activate("tgdfp-xxxxx-xxxxx-xxxxx-xxxxx")
print(status.message)Standalone licenseAn Application key, activated at every start of your app, as its first Deformable call:
import deformable
APPLICATION_LICENSE_KEY = "tgdfp-<payload>-<signature>"
status = deformable.license.activate(APPLICATION_LICENSE_KEY)
print(status.message)
# The app's engine calls come after this.Application license: Acme Inc.deformable.license.status() reads the state, deformable.license.refresh() renews it,
deformable.license.deactivate() frees the seat, deformable.license.take_over() moves the subscription’s seat here,
deformable.license.sign_out() signs out, and deformable.license.set_online_access(False) keeps the program off the
network. The status’s signed_in is True while a subscription is signed in on this device, and account holds its
email. Every call that goes online takes a timeout in seconds. A refused call raises
deformable.LicenseError, a DeformableError, or its subclass TetrahedronLimitExceededError. See
Types and errors.
Third-party software
The Tetrahedralize tool of the engine library, which fills a closed triangle mesh with tetrahedrons, is based on Netgen, the mesh generator by Joachim Schöberl, with parts by Johannes Gerstmayr. That part of the engine library is licensed under the GNU Lesser General Public License, version 2.1. The rest of the engine library is proprietary.
The notice and the license text are in THIRD_PARTY_NOTICES.txt, which comes with the Blender plugin’s .zip file,
the deformable folder of the Maya plugin, the C SDK’s .zip file, the Rust crate and the Python package.