This guide is designed to assist users in configuring TouchDesigner to implement 2D Orthographic ScaSDK warp and blend files after a successful Scalable Calibration. Before proceeding, it is assumed that the user has completed all necessary calibration steps within the Scalable software.
Note
When exporting with the Scalable EasyBlend SDK, you must have a TouchDesigner Pro Key. It is also recommended that you use TouchDesigner build 2025.31550 and newer, as there were key updates that assist with Scalable integration.
TouchDesigner Integration with Scalable
Calibration File |
TD License Type |
Scalable Software |
|
|---|---|---|---|
| Scalable SDK | |||
| Orthographic (2D) | ScalableDataOrthographic.ol | Pro | SDM, SPA |
| Perspective (3D) | ScalableData.ol | Pro | SDM, SPA |
| Projection Mapping (SL) | ScalableData.ol | Pro | Atlas |
| MPCDI | |||
| Orthographic (2D) | scalable.mpcdi | Commercial | SDM, SPA |
| Perspective (3D) | scalable.mpcdi | Commercial | SDM, SPA |
| Projection Mapping (SL) | scalable.mpcdi | Commercial | Atlas |
Export your Calibration File, and Set a File Destination Within Scalable Display Manager
Scalable Export Options Panel
- Navigate to the Export Options panel, and you can choose where your calibration files are saved by selecting Remote Output Directory and adding a file pathway.
If not manually changed, the default Remote Output Directory location will be - C:\Program Files\Scalable Display\DEI\LocalCalibration\ - Select EasyBlendSDK as the Warp Application Method, and select Update Calibration. Your warp and blend files will now be in the remote output directory that you defined.
Applying 2D Orthographic Scalable SDK Files in TouchDesigner
Note
Scalable can provide a basic 2D scene upon request.
- Set up a 2D scene within TouchDesigner. This could be any 2D scene pipeline.
- Add in a Constant TOP
- The Constant TOP should have the correct resolution set and an output type of 2D texture.
- The Constant TOP should have the correct resolution set and an output type of 2D texture.
- Add in a ScalableDisplay TOP for each projector in your system.
- In the ScalableDisplay TOP parameters, select the exported Scalable SDK 2D Orthographic warp and blend file as the configuration file for each TOP. (The default file location is: C:\Program Files\Scalable Display\DEI\LocalCalibration).
- In the ScalableDisplay TOP parameters, select the exported Scalable SDK 2D Orthographic warp and blend file as the configuration file for each TOP. (The default file location is: C:\Program Files\Scalable Display\DEI\LocalCalibration).
- The preview image should now show a view into the 2D scene based on the calibrated geometry. Scalable files are now applied via ScalableDisplay TOP.
Example Output: Two Projectors on a Single PC
Caution
The following section is just one way to complete your TouchDesigner pipeline to export content. This is a basic starting point.
- Reorder & Output ScalableDisplay TOPs to align with your projectors and .toe network.
- Each TOP corresponds to a specific projector, so the signal path after each TOP should output to that corresponding projector. This can be managed at the container level with multiple Out TOPs or as one custom aspect ratio Out TOP with the calibration files combined with a Layout TOP.
- The Perform parameters and Container parameters should facilitate launching the custom aspect ratio or multiple Out TOPS.
- Example Output: 2 x ScalableDisplay TOP > Layout TOP > Out TOP.
- Navigate to the Project Container and to the Look tab. Adjust Background TOP parameter to be set to ./out1. Go to the Layout tab and make sure resolution is set up to match the resolution of the Out TOP.
 |
 |
- Navigate to the Perform Container and set the Window Operator parameter to the output project node. The Display Offset parameter can be set to 1. Next, the Justify Horizontal is set to left, and the Justify Vertical is set to bottom.