r4001 - in trunk/bse: . tests

[stw svn gnome org]

Author: stw
Date: 2006-10-21 15:03:11 -0400 (Sat, 21 Oct 2006)
New Revision: 4001

Modified:
   trunk/bse/ChangeLog
   trunk/bse/tests/resamplehandle.cc
Log:
Sat Oct 21 20:56:27 2006  Stefan Westerfeld  <stefan space twc de>

	* tests/resamplehandle.cc: Improved comment.


Modified: trunk/bse/ChangeLog
===================================================================
--- trunk/bse/ChangeLog	2006-10-21 17:05:37 UTC (rev 4000)
+++ trunk/bse/ChangeLog	2006-10-21 19:03:11 UTC (rev 4001)
@@ -1,3 +1,7 @@
+Sat Oct 21 20:56:27 2006  Stefan Westerfeld  <stefan space twc de>
+
+	* tests/resamplehandle.cc: Improved comment.
+
 Sat Oct 21 18:58:35 2006  Tim Janik  <timj gtk org>
 
 	* tests/resamplehandle.cc: reworked to split performance tests from

Modified: trunk/bse/tests/resamplehandle.cc
===================================================================
--- trunk/bse/tests/resamplehandle.cc	2006-10-21 17:05:37 UTC (rev 4000)
+++ trunk/bse/tests/resamplehandle.cc	2006-10-21 19:03:11 UTC (rev 4001)
@@ -83,7 +83,19 @@
 
   double worst_diff, worst_diff_db;
 
-  /* read through the datahandle linearily _twice_ */
+  /* Read through the datahandle linearily _twice_, and compare expected output
+   * with actual output, to determine whether the actual output is correct.
+   *
+   * This checks four things:
+   * - the datahandle introduces no delay (or shifts the signal in the other
+   *   direction; a negative delay)
+   * - the datahandle resamples the signal correctly
+   * - the initial state of the datahandle is correct (that is, when you first
+   *   read from it, it starts correctly reading at the beginning)
+   * - the seek-to-position zero after reading the datahandle works correctly,
+   *   that is, you get the same output when reading the datahandle a second
+   *   time
+   */
   for (int repeat = 1; repeat <= 2; repeat++)
     {
       GslDataPeekBuffer peek_buffer = { +1 /* incremental direction */, 0, };