Assimilate Scratch User Guide

LightSpace CMS can be integrated with Assimilate Scratch for accurate display profiling and LUT generation, enabling Closed Loop display profiling.

The following instructions are for calibration of Displays connected to Assimilate Scratch with LightSpace CMS.

Initial Operation

Scratch Calibration

Calibration of displays connected to Scratch using LightSpace CMS uses a Light Illusion developed plug-in that enables Scratch to act as the pattern generator. The plug-in can be downloaded from the Downloads page, and includes the following files:

  • - which is the Scratch SPA plugin.
  • calPatch.tif - the icon file.
  • CustomCommands.xml - an example custom command XML file.


The and calPatch.tif file need to be copied to a location where Scratch can find them at startup. One way to achieve this is on Windows by putting them in a directory and setting the correct environment variable.

  • ASSIMILATE_PLUGINS c:\myScratchPluginHome

Another way is to copy both files to:

  • C:\Program Files\Assimilate\plugin64\

Or on Mac OSX, copying them to:

  • /Library/Application Support/Assimilator/Plugins

Please see Chapter 11 of the Scratch User Guide called 'Customizing Scratch' for details how Scratch scans for plug-ins.

Plug-in Setup

The Custom Command XML allows you to add a button to the Scratch interface to automatically start the calibration session rather than having to manually initialize the plug-in.

For Windows the example custom command XML file should be placed in:

  • C:\ProgramData\Assimilator\Settings

And for Mac OSX:

  • /Library/Application Support/Assimilator/Settings

If there is an existing CustomCommands.xml, then they should be combined using a text editor.

Please see Chapter 11 of the SCRATCH User Guide called 'Customizing Scratch' for details on Custom Commands.

Calibration Operation

  • Connect the Scratch workstation to the LightSpace PC via a dedicated network cable.
    (We do not recommend WiFi connections as interrupts can cause sync problems)
  • Open Scratch, and open LightSpace CMS.
  • Select the 'Network Manager' menu within LightSpace, which controls synchronisation with Scratch.
  • Select Enable to activate the Network Manager.
Resolve Calibration

The Network Manager menu is located within the top-level icons.
Note: The 'Patch Indent/Size' controls define the size/position of the patch to be displayed. To see more about the Patch Indent/Size controls see the Direct Profiling page of the website.

The Scratch plug-in can then be used to 'connect' to LightSpace.

  • Note down the IP address of the LightSpace CMS machine
  • In Scratch, enter any project and select the Tools menu (lower left corner)
  • There the custom command button for LightSpace CMS has been added - click it
  • You will be taken into the Player, where you can configure the patch generator inside the 'Calbration..' menu
  • Fill in the IP address of the LightSpace CMS machine into the corresponding field (by default it probably reads "localhost"), in order to connect to LightSpace
  • The Patch Size can be controlled directly within Scratch.

Profiling can then be performed as normal, using the probe connected to LightSpace, and with Scratch displaying the required patches on the display being profiled when the patch window within LightSpace is active (the LightSpace CMS internal floating patch window has been made active by clicking the small colour display box when using Quick Profiling or Manual Measure modes).


After profiling, a Calibration LUT can be generated as normal, and used where required, either within Scratch, a LUT box, or uploaded directly into a suitable display.

© Light Illusion - All rights reserved - Privacy Notice