comparison audioio/AudioCallbackPlayTarget.h @ 1:97c69acdcb82

* Adjust use of target sample rate, so as to make the decision about whether
  to resample or not more robust.
* Update copyrights to 2006

 /* -*- c-basic-offset: 4 -*-  vi:set ts=8 sts=4 sw=4: */
 
 /*
     A waveform viewer and audio annotation editor.
-    Chris Cannam, Queen Mary University of London, 2005
+    Chris Cannam, Queen Mary University of London, 2005-2006
     
     This is experimental software.  Not for distribution.
 */
 
 #ifndef _AUDIO_CALLBACK_PLAY_TARGET_H_

     /**
      * Set the playback gain (0.0 = silence, 1.0 = levels unmodified)
      */
     virtual void setOutputGain(float gain);
 
+    /**
+     * The main source model (providing the playback sample rate) has
+     * been changed.  The target should query the source's sample
+     * rate, set its output sample rate accordingly, and call back on
+     * the source's setTargetSampleRate to indicate what sample rate
+     * it succeeded in setting at the output.  If this differs from
+     * the model rate, the source will resample.
+     */
     virtual void sourceModelReplaced() = 0;
 
 protected:
     AudioCallbackPlaySource *m_source;
     float m_outputGain;