diff audioDB_API.h @ 693:b1723ae7675e

begin work on sampling API

This is motivated by the need to be able to sample with arbitrary feature data
(e.g. from a feature file) against a database, for the JNMR "collections" paper
revisions or possible ISMIR paper revisions.  That bit doesn't work yet, but
the C-ified version of the current functionality (sample db x db and
sample key x db) works to the level of anecdotal tests.

The general approach is to mirror the _query_spec() API, where a whole heap
of knobs and twiddles are available to the user.  Unlike in the _query_spec()
API, not quite all of the knobs make sense (and even fewer are actually
implemented), but the basic idea is the same.

I pity the poor chump who will have to document all this.

--- a/audioDB_API.h	Thu Apr 22 15:43:26 2010 +0000
+++ b/audioDB_API.h	Thu Apr 22 21:03:47 2010 +0000
@@ -167,6 +167,9 @@
 adb_liszt_results_t *audiodb_liszt(adb_t *);
 int audiodb_liszt_free_results(adb_t *, adb_liszt_results_t *);
 
+/* sample */
+adb_query_results_t *audiodb_sample_spec(adb_t *, const adb_query_spec_t *);
+
 /* backwards compatibility */
 int audiodb_insert(adb_t *, adb_insert_t *ins);
 int audiodb_batchinsert(adb_t *, adb_insert_t *ins, unsigned int size);