Difference between revisions of "Privacy"

From TouchDesigner Documentation
Jump to: navigation, search
Line 14: Line 14:
=== Component Privacy with Password ===
=== Component Privacy with Password ===
Right-click on any component and select Privacy... A dialog will open prompting for a password to enable component privacy.  
Right-click on any component and select Privacy... A dialog will open prompting for a password to enable component privacy. This will block access to the contents of a component but it will run normally.

Revision as of 14:48, 8 August 2018

These features can limit access to the entire project .toe file or to individual components. Privacy features require TouchDesigner Pro license to set after which all licenses types respect the privacy settings of a project or component.

Project Privacy[edit]

The Project Privacy option blocks access to editing networks in a .toe project file. This will protect the contents of the .toe file.

In TouchDesigner, under File -> Save Private...(Pro Only), you can save a separate private version of your project. Launching this .toe will only open in Perform Mode, with no access to the networks. When you press the Shift+Esc key over the Perform window, it will expose the window borders if not already exposed and the user can close the window and application through the window title bar buttons.

To hide image, movie, audio and other media that you embed in the file use the Virtual File System.

Component Privacy[edit]

Component Privacy blocks access to the contents of a component. The contents can not be viewed or access by users or other operators and scripts. You can set Component Privacy with a password or with a CodeMeter dongle.

Component Privacy with Password[edit]

Right-click on any component and select Privacy... A dialog will open prompting for a password to enable component privacy. This will block access to the contents of a component but it will run normally.


Right-click > Privacy... on a component that has privacy enabled and a dialog will prompt the user for a password for temporary access. This will let allow access to the component for the remainder of the session but restarting the project will restore the privacy.

Right-click > Privacy... on a component that is temporarily accessed (as described above) will give the option for restoring the privacy again. This allows testing the component is private without having to restart the file. The other option here is to provide the password again to completely remove privacy from this component. This deletes the privacy and the component is no longer private until a new password is set.

Component Privacy with CodeMeter Dongle[edit]

Component Privacy can also be locked to CodeMeter dongles.

You can now setup CodeMeter dongles that will license a component to run (cook). These dongles do not give access to the networks inside, they just allow them to run on any licensed TouchDesigner or TouchPlayer computer. If the dongle is not present, the component will not cook. This gives you a way to customize and manage the licensing of components you create and keep the internal networks private. A using this component dongle privacy requires a Pro license for setup but no additional fees charged by Derivative. The component with dongle privacy set will work on all license types of TouchDesigner and TouchPlayer when the appropriate dongle is present.

Steps to Using CodeMeter Dongle Component Privacy[edit]

1) Initially it is required to get a dongle FirmCode from CodeMeter. This is a service provided by CodeMeter and handled between the developer and CodeMeter. CodeMeter will issue you a dongle FirmCode once you have an account setup with them.

2) Once you have a FirmCode, you can then setup a dongle with your unique FirmCode and create any number of ProductCodes. These can be used for different products, components, or features you wish to associate with the ProductCodes. All dongle setup is handled by the CodeMeter License Editor which is part of the CodeMeter Development Kit.

3) You can now create 2 types of dongle

  • Developer Dongle - This dongle allows access and editing of the private component and is for the author(s) of the component. To create this you must set the FirmCode, the ProductCode and additionally set FeatureMap = 1 on that ProductCode. This developer dongle is also required to setup the dongle privacy on the component, in otherwords to 'lock' it.
  • License Dongle - This dongle allows for the component to run in TouchDesigner or TouchPlayer when it is plugged in. However, it still blocks access to the contents of a component so the networks are private. To create this you must set the FirmCode and the ProductCode only.

4) With your Developer Dongle plugged in, setting privacy on a component can be done through python or the Privacy Dialog (right-click on component and select 'Privacy...').


CodeMeter dongles can have multiple FirmCodes and ProductCodes on the same dongle. So it is possible to add your own component licensing to the same dongle that holds a TouchDesigner or TouchPlayer Commercial or Pro license.

Contact us for further details about Developer Dongles.

Privacy and Licenses[edit]

A private .toe or component does not affect the licensing installed on the system. They will work with any licenses (non-commercial included), and work the same as a non-private file running on that license. That means if the file uses Pro only nodes, those nodes will only function if a Pro license is installed. If the license is non-commercial, all of the TOPs will still be limited resolution. Private files will work in TouchPlayer as well, with the same limitations that TouchPlayer has with a regular .toe file. If a private .toe file is being used for a commercial (paying) project, it still requires a Commercial license.

TOuch Environment file, the file type used by TouchDesigner to save your project.

Privacy of Components or .toe files is the protection of networks to enable using them but not accessing them internally.

An Operator Family that contains its own Network inside. There are twelve 3D Object Component and eight 2D Panel Component types. See also Network Path.

Any floating window that is not a Pane or Viewer.