[Gnash-commit] /srv/bzr/gnash/trunk r11035: Add note about interpretation of delaySeek samples

[Sandro Santilli]

------------------------------------------------------------
revno: 11035
committer: Sandro Santilli <address@hidden>
branch nick: trunk
timestamp: Mon 2009-06-08 16:28:17 +0200
message:
  Add note about interpretation of delaySeek samples
modified:
  libmedia/SoundInfo.h

=== modified file 'libmedia/SoundInfo.h'
--- a/libmedia/SoundInfo.h      2009-06-07 23:54:11 +0000
+++ b/libmedia/SoundInfo.h      2009-06-08 14:28:17 +0000
@@ -63,6 +63,10 @@
        ///     sound is played.
        ///     If this value is negative the player plays this
        ///     number of silent samples before playing the sound block
+       ///     NOTE that this value refers to input samples, so must
+       ///     be multiplied by OUTPUT_SAMPLE_RATE/getSampleRate()
+       ///     and by 2 (two channels) to find number of output
+       ///     samples to skip or fill.
        ///
        SoundInfo(audioCodecType format, bool stereo, boost::uint32_t 
sampleRate,
             boost::uint32_t sampleCount, bool is16bit,
@@ -101,7 +105,10 @@
        ///
        unsigned long getSampleCount() const { return _sampleCount; }
 
-       /// Return the number of samples to seek forward or delay.
+       /// Return the number of samples to seek forward or delay
+       // 
+       /// The number is to be considered in pre-resampling units.
+       ///
        boost::int16_t getDelaySeek() const { return _delaySeek; }
 
        /// Returns the 16bit status of the sound