How Do I Play an Audio Sample?

To play an audio sample, you need to do the following:

  1. Call LoadSample() to load an AIFF sample into memory.

    You can also load samples of other formats into memory yourself and turn them into 3DO sample items by calling CreateSample().

  2. Call LoadInstrument() to load a DSP instrument that can play that sample. You can determine the appropriate instrument name by looking in the table at the beginning of Instrument Templates, in the 3DO Music and Audio Programmer's Reference or by calling SelectSamplePlayer().

  3. Call AttachSample() to attach the sample to the instrument.

    You can use the same sample on multiple instruments, or you can use multiple samples on one instrument.

  4. Call StartInstrument() to start playing the sample.

    The instrument starts whatever sample is attached to it.

  5. Call ReleaseInstrument() to stop a sample that is looping,

For More Information

For more information on the calls in this section, see Audio Folio Calls, in the 3DO Music and Audio Programmer's Reference.

See Preparing Instruments, and Playing Instruments, for complete programming details.

For an example of playing a sound, see the example program playsample.c.