Spatial Trajectory Painter — Interactive Spatial Authoring
Draw speaker-array or Full-3D Ambisonic motion directly in Praat, preview the trajectory, and commit speaker feeds or HOA1–5 ambiX as one multichannel Sound.
What this does
Spatial Trajectory Painter is the spatial-authoring member of the Praat AudioTools Ambisonic workflow. Draw a moving trajectory directly in a Praat Demo window and commit it either to a speaker array or directly to an ambiX ACN/SN3D field.
Speaker-array authoring
Render a mono source to 4, 6, 8, 12, or 16 speaker channels using a line or ring topology and equal-power interpolation.
Ambisonic authoring
Draw azimuth and elevation independently and encode the moving source directly to HOA1–5: 4, 9, 16, 25, or 36 ACN/SN3D channels.
Quick start
- Select exactly one Sound.
- Run
Spatial_Trajectory_Painter.praat. - Choose Speaker array or Ambisonic trajectory.
- For Ambisonics, choose 1st through 5th order.
- Click in the azimuth/position lane to add points; add elevation points in the second lane when desired.
- Press U to undo, P for stereo preview, Enter to commit, or Esc to cancel.
Speaker-array output
Speaker mode produces 4, 6, 8, 12, or 16 channels. Line topology clamps motion at the endpoints; Ring topology wraps around continuously. The output is immediately usable as a loudspeaker-channel master when the physical array matches the selected topology.
Ambisonic trajectory: HOA1–5
| Order | Channels |
|---|---|
| 1st | 4 |
| 2nd | 9 |
| 3rd | 16 |
| 4th | 25 |
| 5th | 36 |
The current version uses the same generic real spherical-harmonic ACN/SN3D engine as the companion HOA Encoder. The trajectory is encoded directly into the Ambisonic domain; there is no intermediate speaker-bed stage.
Drawing and interpolation
- Azimuth uses the ambiX convention: 0° front, +90° left, −90° right, ±180° back.
- Elevation ranges from −90° to +90°.
- Azimuth takes the shorter circular route between successive points.
- If no elevation points are drawn, elevation remains at 0°.
- The control-rate renderer samples the trajectory at the selected rate and linearly interpolates the gain tiers between frames.
Stereo preview
The P preview is intentionally an approximation for checking motion and timing. In Ambisonic mode it is not a full binaural or loudspeaker decode. Use the HOA Decoder or IRCAM binaural renderer for actual spatial playback.
Outputs and cleanup
On commit, the multichannel Sound is kept. Temporary gain tiers, working channels, mono copy, and trajectory RealTier objects are removed after rendering. Preview renders are also cleaned up, and Cancel leaves no trajectory-control object behind.
Role in the unified spatial workflow
CREATE MOTION
Spatial Trajectory Painter
↓
ambiX master
↙ ↓ ↘
7.1.4 22.2 binaural
↑ ↑
HOA Decoder
EXISTING SPEAKER BED
8ch / 16ch / 7.1 / 22.2
↓
HOA Encoder
↓
ambiX masterThe Painter creates spatial motion; the Encoder converts point sources or existing speaker beds into AmbiX; the Decoder adapts AmbiX to physical loudspeaker layouts. Together with the IRCAM binaural tools, these workflows remain inside one Praat AudioTools package.