annotate docs/spec/interval-index.tikz @ 580:633614461994

API for retrieving a track's data.

A new function, audiodb_retrieve_datum() fills a provided adb_datum_t
structure with the data corresponding to a given database key; the
companion audiodb_free_datum() function frees the data in a given datum
appropriately.

Just in case, I continue to require passing in the adb_t * as the first
argument to audiodb_free_datum(), even though it's not currently used:
I couldn't convince myself that _all_ possible implementations could
free a datum without reference to the adb_t.

This meant rewriting the internal code to use a new internal
audiodb_really_free_datum() function, which audiodb_free_datum() also
calls.

Sanity-checked by implementing a binding in sb-alien to this function,
lightly-tested.

All this fixes ticket:20 in Trac.

\draw (-2,0.8) rectangle (1.2,1);
% stupid floating point.
\foreach \x in {-1.6,-1.2,...,0.9} {
  \draw(\x,0.8) -- (\x,1);
}
\begin{scope}[->,>=stealth]
  \fill (-1.8,0.9) ellipse (0.05);
  \draw (-1.8,0.9) -- (-2.5,0.2);
  \draw (-1.8,0.9) -- (-2,0.2);
  \fill (-1.4,0.9) ellipse (0.05);
  \draw (-1.4,0.9) -- (-2,0.2);
  \draw (-1.4,0.9) -- (-1.4,0.2);
  \fill (-1.0,0.9) ellipse (0.05);
  \draw (-1.0,0.9) -- (-1.4,0.2);
  \draw (-1.0,0.9) -- (-0.5,0.2);
  \fill (-0.6,0.9) ellipse (0.05);
  \draw (-0.6,0.9) -- (-0.5,0.2);
  \draw (-0.6,0.9) -- (0,0.2);
  \fill (-0.2,0.9) ellipse (0.05);
  \draw (-0.2,0.9) -- (0,0.2);
  \draw (-0.2,0.9) -- (0.8,0.2);
  \fill (0.2,0.9) ellipse (0.05);
  \draw (0.2,0.9) -- (0.8,0.2);
  \draw (0.2,0.9) -- (1.3,0.2);
  \fill (0.6,0.9) ellipse (0.05);
  \draw (0.6,0.9) -- (1.3,0.2);
  \draw (0.6,0.9) -- (1.8,0.2);
  \fill (1.0,0.9) ellipse (0.05);
  \draw (1.0,0.9) -- (1.8,0.2);
  \draw (1.0,0.9) -- (2.5,0.2);
\end{scope}