Core Audio
Blog

Multi-Channel Audio

08/06/07 11:24 Filed in: dShed

Delivering forty channel audio using QuickTime APIs to adjust movie files.

A little while ago, Oliver (Watershed's ICT Co-ordinator) , asked me to write a small command line tool to set the audio output channels of a QuickTime movie. Oliver was writing software for Dream Director, a project that plays audio to people sleeping in pods in response to rapid eye movement.

A Mac mini plays back the audio to up to twenty pods (containing sleeping people) through a collection of M-Audio Firewire410 boxes. As the audio-out hardware units have been aggregated into a single virtual device with forty available channels, it was just a case of playing back a stereo file through a selected pair of channels.

QuickTime movies will save the audio channel mapping inside the file, so the requirement was to build a tool that would set the selected channels in a movie and save the file to disk. The source listing is for a Cocoa command-line Tool, using QTKit, to open an audio file, set the track mapping and save as a QuickTime movie.

QuickTime now uses Core Audio to handle the audio channel mapping and I thought this may be of some use to people. The partial listing below shows the code needed to map audio channels using QuickTime and a link to the source file of the tool is below the listing. Sorry about the wrapped source listing.

  1. Movie qtMovie = [movie quickTimeMovie];
  2. Track audioTrack = GetMovieIndTrack(qtMovie,1);
  4. AudioChannelLayout* trackChannelLayout = NULL;
  5. OSStatus err = noErr;
  6. UInt32 trackChannelLayoutSize;
  9. // Allocate a layout of the required size
  10. trackChannelLayoutSize = fieldOffset(AudioChannelLayout, mChannelDescriptions[2]);
  11. trackChannelLayout = (AudioChannelLayout*)calloc(1, trackChannelLayoutSize);
  12. trackChannelLayout->mChannelLayoutTag = kAudioChannelLayoutTag_UseChannelDescriptions;
  13. trackChannelLayout->mNumberChannelDescriptions = 2;
  14. // Adjust the channel Assignment so that for an index we get a pair of channel
  15. // allocations. The index starts at 1
  16. // index channelA channelB
  17. // -----------------------------
  18. // 1 discreet0 discreet1
  19. // 2 discreet2 discreet3
  20. // 3 discreet4 discreet5
  21. // 4 discreet6 discreet7
  22. // ... and so on
  23. channelAssignment = (channelAssignment-1)*2;
  24. #warning This will break if Apple change the CoreAudio's Channel Layout internals
  25. trackChannelLayout->mChannelDescriptions[0].mChannelLabel = (1L<<16) | channelAssignment;
  26. trackChannelLayout->mChannelDescriptions[1].mChannelLabel = (1L<<16) | (channelAssignment + 1);
  29. // Set the track layout
  30. err = QTSetTrackProperty(audioTrack, kQTPropertyClass_Audio, kQTAudioPropertyID_ChannelLayout, trackChannelLayoutSize, trackChannelLayout);
  31. if (err != noErr) {
  32. NSLog(@"**Error** QuickTime SetPropertyError: %i", err);
  33. return 1;
  34. }

    35. Download the full source code.

    Tags: , ,

    |

odds&ends…
Benjamin Miller