Generators
Ponk input
Play live laser paths sent over the network from TouchDesigner, MadMapper and other Ponk senders.
Ponk input plays laser paths that another program sends over the network with Ponk, MadMapper's open protocol. MadMapper, TouchDesigner (with MadMapper's PonkSender plugin) and openFrameworks (ofxPonk) can send it.
Receive from a sender
- Right-click an empty pad and choose Create Cue. The cue editor opens.
- In the Generators panel, click + (Add generator), pick Ponk input and click Create.
- Delete the track's Frame Based Animation generator, so only the Ponk paths play.
- Start the sender on this computer or on the same network. Leave it on multicast, or send unicast to this computer's IP address, port 5583.
- Select the Ponk generator. Under Follow, pick the sender, or leave Any sender.
- When the status reads Receiving with the sender's name, play the pad.
Choose the sender
The status line shows Receiving with the sender's name, frame rate, paths and points, or No signal when the output is blank. An orange warning means a sender uses a Ponk version or format this version of Live Alchemy can't read.
| Follow | What it does |
|---|---|
| Any sender | Plays the live sender that was heard first. When it stops, the next live one takes over. |
| A sender from the list | Plays only that sender, and finds it again after it restarts if its name is the same. While it is silent the output is blank, even if other senders are live. |
Senders that stop stay in the list for 10 seconds, marked silent for a time.
When the signal stops
When no new frame arrives for Signal timeout (250 ms by default, 50 to 5000 ms), the output goes blank, so a stopped or paused sender never leaves a frozen beam. It plays again as soon as frames come back.
Record to frames
Live input can't be rendered: mixdowns and show packages draw Ponk input blank. Record it to turn it into ordinary frames that work everywhere, including the timeline exports and Show Alchemy.
- With the sender running, select the Ponk generator in the cue editor.
- Click Record. The length shows while it records.
- Click Stop and save, or Discard to throw the take away.
The take becomes a new frame stack and a new time-based cue, both named after the cue plus take and a number, at 50 frames per second. The cue appears on the Cues page, not on a pad. Silence at the start and end is trimmed, and changes you make in the panel while recording are kept. A take stops and saves itself at 5 minutes.
Transform and colour
X and Y move the paths by a percentage of half the field. Red, Green and Blue go up to 200 %. Brightness is multiplied by the generator's Intensity lane. Click the diamond next to Size, X, Y, Rotation, Brightness, Red, Green or Blue to animate it with keyframes.
Laser output
| Control | What it does |
|---|---|
| Max points | Points per frame, blanking and dwell included (4096 by default, 8192 at most). Over it, paths are thinned, then the last paths are left out; the line below the controls says when. |
| Blanking | Blanked points on each move between paths. |
| Start dwell, End dwell | Extra points on the first and last point of each path. |
| Corner dwell | Extra points on corners that turn at least Corner from degrees. |
| Beam points | Points for a path that is a single point (a beam). |
| Outside the field | Blank hides points that end up outside the field; Clamp keeps them lit on its edge. |
| Sender dwell hints | On by default. Where the sender sets its own first-point, last-point or single-point repeats, they replace Start dwell, End dwell and Beam points. |
Network settings
These apply to every Ponk input cue and stay with this computer, not the workspace.
| Control | What it does |
|---|---|
| Multicast 239.255.10.24 | On by default: joins the Ponk multicast group senders use by default. Unicast to port 5583 is received either way. |
| Extra unicast port | Also listens on this port (0 is off), for a sender that can't use 5583 or when another Ponk app on this computer already listens there. |
If nothing arrives
- macOS: click Allow when macOS asks to let Live Alchemy find devices on your local
network. It asks when a workspace first has a Ponk input cue, unless you already allowed it
for DACs. If you declined, turn on Live Alchemy in
System Settings → Privacy & Security → Local Network. A sender on the same Mac sending to
127.0.0.1needs no permission. - Windows: the installer lets Live Alchemy through Windows Defender Firewall. If you once blocked it at a firewall prompt, that block still wins: delete it from the firewall's inbound rules.
- Linux: if a firewall such as
ufwis on, allow UDP port 5583 (and your extra unicast port). - Another Ponk app on this computer can take unicast packets sent to port 5583. Send to an Extra unicast port instead.