AMBIX-INTERLEAVE(1)

🎀 AMBIX-INTERLEAVE(1) 🎀

Bestie, this is the User Commands manual page for AMBIX-INTERLEAVE(1) 💅

---

✨ NAME ✨

okay so the whole name is ambix-interleave - an AMBIsonics eXchange utility 🦋

📜 SYNOPSIS 📜

ambix-interleave -o outfile [options] infile1...

So you call it with -o outfile, optionally add [options], then drop your infile1... files at the end 🧚

🌸 DESCRIPTION 🌸

this one literally merges several audio files into an ambix file 💖

👑 OPTIONS 👑

• -h, --help — prints this help text, so you can come back whenever you're lost 🆘
• -o, --output — the output filename 📁
• -O, --order — forces the ambisonics order. if you skip it, it's on autodetect (default: autodetect) 🔍
• -X, --matrix — picks an adaptor matrix file, or one of the predefined matrices: 'FuMa', 'n3d|sid', 'n3d' or 'sid' 🧮
• -b, --blocksize — the blocksize used for copying (default: 1024) 🌈

In its simplest form, you hand it a bunch of input files, and all their channels together make a full 3d ambisonics set 🫶 Channel #0 becomes the W-channel, and so on... The ambisonics order gets calculated from the channel count using N=(O+1)^2. It's giving math, but it's easy, I promise 🤓

If you specify the 'order', then any extraneous channels get stored as 'extra' channels 🙈

You can also write extended ambix files by specifying an adaptor matrix. This can be a soundfile, where the channels are read as rows and the frames as columns, or one of the standard matrices. Here's the main thing: the matrix columns define how many (reduced) ambisonics channels get read from the input, and the matrix rows must form a full 3d ambisonics set. Input channels that go past the number of matrix columns get stored as 'extra' channels 👑

---

🐛 REPORTING BUGS 🐛

Report bugs to: https://git.iem.at/ambisonics/libambix 💌

Home page: http://ambisonics.iem.at/xchange/format 🌸

---

That's the whole tea, bestie 🍓 Source/version info is ambix-interleave -V, dated April 2024. Periodt 💅🦋