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.

Author: Shai CohenAffiliation: Department of Music, Bar-Ilan University, IsraelLicense: MIT LicenseRepo: Praat AudioTools
Contents:

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

  1. Select exactly one Sound.
  2. Run Spatial_Trajectory_Painter.praat.
  3. Choose Speaker array or Ambisonic trajectory.
  4. For Ambisonics, choose 1st through 5th order.
  5. Click in the azimuth/position lane to add points; add elevation points in the second lane when desired.
  6. 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

OrderChannels
1st4
2nd9
3rd16
4th25
5th36

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.

Portable master: an Ambisonic trajectory can later be decoded to different speaker layouts or rendered binaurally without redrawing the motion.

Drawing and interpolation

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 master

The 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.