Gravity Feed for ICST AmbiEncoder

Index-based XYZ OSC with the ICST Gravity Profile and an axis fixture test.

This guide explains how Spatial9 Gravity Feed drives the ICST AmbiEncoder from the Institute for Computer Music and Sound Technology at the Zurich University of the Arts. Status: documented route. Gravity Feed ships the icst_ambiencoder_candidate_v1 profile, built from ICST's published OSC addresses. It has not been verified against a running plugin, so conversion_verified is false.

At a glance

ItemDetail
StatusDocumented route
Gravity Profileicst_ambiencoder_candidate_v1
Control routeOSC with a source index
Required fieldsource_index on each target, because one encoder handles several sources
FormatsCheck ICST's download page for your platform

How the profile works

The profile sends each source's position as Cartesian coordinates:

AddressArguments
/icst/ambi/sourceindex/xyzsource index, x, y, z

Gravity Feed computes x, y and z deterministically from the planned azimuth, elevation and distance with its own convention: x forward, y left, z up. Each action's osc block includes address, args and source_index.

Connecting

  1. Load AmbiEncoder and enable its OSC input on a free port.
  2. In your Gravity Feed request, list a target with profile_id: "icst_ambiencoder_candidate_v1" and the source_index that matches each source.
  3. Send each returned osc message to the plugin's port at the action's beat time.

Fixture test before verifying

  1. Send x=1, y=0, z=0 and confirm the source is in front.
  2. Send x=0, y=1, z=0 and confirm it is on the left.
  3. Send x=0, y=0, z=1 and confirm it is above.
  4. Record the plugin version and the result. If an axis is flipped, the profile needs a correction before it can be verified.

FAQ

Why does ICST need a source index?

Its OSC address carries several sources at once, so each message must say which source it moves.

Can Gravity Feed move distance with ICST?

Yes in the plan, because distance changes the length of the x, y, z vector. How the plugin renders distance must be checked in the fixture test.

Go deeper on the blog