Version: 1.3

Posted: 2008-01-21

Build Requirements: Xcode 3.0

Runtime Requirements: Mac OS X 10.5

View Source Code:

Download Sample (“QTAudioContextInsert.zip”, 305.7K)
Download Sample (“QTAudioContextInsert.dmg”, 344.2K)


Description

This sample demonstrates how a client application of QuickTime can use the Audio Context Insert APIs to hook in a custom audio processing unit into QuickTime's audio processing chain. By hooking in an insert, an application is able to tap into and optionally manupulate QuickTime's audio stream during playback to device or during extraction of movie audio. Inserts may be attached at the movie or individual track level.

The sample code seeks to establish good practices in using the new APIs. It illustrates steps involved in configuring and registering an insert with the movie or track whose audio data is to be tapped and/or processed. The code gives example implementations of the three callbacks - reset , process data, finalize - that need to implemented by an insert's processing logic. Finally, the sample code shows the steps involved in applying an insert to audio being extracted through QuickTime's Movie Audio Extraction APIs.

Document Revision History

Date Notes
2008-01-21Editorial
2007-06-04Illustrates the setting up of track-level inserts (UI has been updated to demonstrate track-level inserts). Sample also now uses the preferred method for registering movie-level inserts, where an insert can be attached to an existing context (GetMovieAudioContext, register movie-level insert with the context, SetMovieAudioContext) rather than having to create a new context every time an insert needs to be registered/unregistered (QTAudioContextCreateForDevice, register movie-level insert with the context, SetMovieAudioContext).
2006-07-31Made some cosmetic changes to the windows. Changed window textures, cleaned up the ACInsertWindowController's window UI elements, and changed the related Interface Builder action methods.
2006-07-27Demonstrates use of Audio Context Insert APIs to perform custom processing on QuickTime's audio stream.

Did this document help you?
Yes: Tell us what works for you.
It’s good, but: Report typos, inaccuracies, and so forth.
It wasn’t helpful: Tell us what would have helped.