This guide is designed to assist users in configuring TouchDesigner to implement 2D Orthographic MPCDI 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 MPCDI format, you only need a TouchDesigner Commercial 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 |
Update Advanced Options, Export your Calibration File, and Set a File Destination Within Scalable Display Manager
Scalable Advanced Options
- Navigate to the Scalable dropdown menu in the top left of the screen and select Support > Advanced Options.
- Select Add and configure the option: MPCDICoordinateFrameSelector | Int | 1. Select Accept.
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 MPCDI as the Warp Application Method, select 2 as the MPCDI Version, select 2D as the MPCDI Profile.
Select Update Calibration. Your warp and blend files will now be in the remote output directory that you defined.
Applying 2D Orthographic MPCDI 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 and output type of 2D texture.
- The Constant TOP should have the correct resolution and output type of 2D texture.
- Add in an MPCDI TOP for each projector in your system.
- Connect the Constant TOP output to each MPCDI TOP input.
- In the MPCDI TOP parameters, select the exported MPCDI 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).
- For each MPCDI TOP, change the Buffer ID parameter to "Buff0". Set the Region ID parameter for each TOP to its "associated Projector" in the array. Starting with "Proj0".
- The preview image should now show a view into the 2D scene based on the calibrated geometry. Your Scalable files are now applied via MPCDI 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 MPCDI 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 MPCDI 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.
