Plugins and Scripts > trueSpace > Utilities

Protect Workspace for truespace 7.61

layers icon

The Protect Workspace script saves and restores workspace attributes to protect them against modelspace changes. It protects materials, names, matrix transforms, camera fov and spot angle.

persistent base install required

This script comes pre-installed in the Unofficial trueSpace Updates -

This version may not work with the latest trueSpace Unofficial Updates - Jan 13 2022


  1. install the persistent base if not already installed
  2. drag the node into the link editor
  3. delete the node from the scene after install is complete

Panel Controls

protect workspace panel

Backup - save data and materials nodes to temporary stores in the scene

Restore - restore the data and material nodes

Protection Options

  • Name - stop renaming of nodes
  • Materials - stop conversion of workspace materials to lightworks materials
  • Matrix - stop transformation value changes
  • Light/Camera - stop change of spot light angle and camera fov
  • Remove Backup Scene Data - optionally delete backup data when restore is run


  1. Push the Backup button to backup the nodes and values
  2. Open modelspace and do modelspace work
  3. Close the modelspace window
  4. Push the Restore button to retrieve the previous workspace state


  • Modelspace will rename items that have workspace numbering scheme by removing a space. ex. ("Spotlight, 1" with space changes to "Spotlight,1" with no space before the 1)
  • A keyframe can also be used to protect workspace matrix values from modelspace changes
  • A keyframe can also be used to protect workspace light angle and camera fov values from modelspace changes
  • The materials protection includes light colors for the Unofficial Update Lights
  • Naming changes from modelspace only effect items modelspace can see, so things like script nodes are ignored.
  • The modelspace Scene Editor will make changes to the scene
  • Protect Materials will destroy modelspace standalone deformation objects

Hooking to other scripts

Two scripts are included for calling the protect functions from other scripts and returning control back to those scripts, ReturnFromBackup and ReturnFromRestore

  • Entry point for Backup is the BackupWorkspaceData node
  • Entry point for Restore is the RestoreWorkspaceData node
  • The ReturnTo connectors on the ReturnFromBackup and ReturnfromRestore is set to the next command node in the calling script sequence. They are set to an empty string if no further action will take place in the calling scripts.
  • It may be possible to call the scripts using ScriptObject.Execute in the middle of a script, this has not been tested and may be unreliable
  • Currently hooks have been provided for Synchronize, YafaRay4tS animation renders and D3D render scripts

October 24, 2019

  • option so backup data not automatically removed on restore
  • fix to work with unofficial update ui

September 21, 2019

  • ignore animated items for matrix protection to avoid conflicts

September 17, 2019

  • Fixed rare bug with tS color requiring an explicit number conversion
  • changes by trueBlue - clean log messages
August 21, 2019
August 21, 2019