Making an Output

Outputs are the core building block in Lightpath. An output is an individually addressable part of your installation — a video wall, an LED strip, a projector, a screen, anything you want to drive content to. Each output is a .tox file living in your project's outputs/ directory; Lightpath loads it into TouchDesigner at runtime and routes content to it from the UI.

Adding an output

1. Go to Configure → Outputs in the Lightpath UI.
2. Click + New Output in the top left.
3. Choose a name and an icon. To use a custom icon, upload a .png file into your project's outputs/ folder — it will appear in the Custom icons selector. We recommend a simple white-on-transparent outline of the output's shape.
4. Choose whether to build from one of the bundled templates or from an existing .tox file.

Templates

Lightpath ships with four output templates. Each gives you a working .tox to start from — extend or replace anything inside.

• Pixel Map — The basic setup for mapping pixel data to LEDs. Use this when you're driving addressable LED hardware (Art-Net, sACN, DMX, etc.).
• Receive — Receive a texture from another piece of software via Spout or NDI. Receive-type outputs show a simplified look editor since content isn't being generated inside Lightpath. You can automatically send OSC or HTTP when content is selected to switch the source software in lockstep — see Devices for the bidirectional binding setup.
• Send — Send the texture out via Spout or NDI for another piece of software to consume. Useful when integrating Lightpath with projection mapping software.
• Screen — Output the texture to a specific monitor. Useful for projectors, attached displays, or LED screens driven over HDMI / DisplayPort.

These templates are starting points. You can do anything you want inside the output component, leveraging the open-ended power of TouchDesigner.

Custom parameters

Outputs follow the standard Lightpath custom-parameter contract — any parameter on a page named Look is exposed per-look (e.g. LED pixel-mapping method, input texture fit, per-look effects); any parameter on a page named Config is exposed at the install level (e.g. target network address for DMX, target monitor index for a Screen output, Spout sender name for a Send output).

Outputs can also expose a Status page — read-only parameters that stream live to the TouchDesigner device on the Devices page and feed the Alerts system.

See TouchDesigner Overview → Custom parameters for the full pattern.

Accessing project files

3D models, fixture XMLs, lookup tables, custom icons — store them in your project folder and reference them via the project path shortcut. See TouchDesigner Overview → Accessing project files.