:see_also=index

The cache component has the ability to play an mp3 file, create
buffers from sections of mp3 files, and play those buffers.

In its default play mode, the cacheable component behaves like a 
normal turntable.  A song is loaded by dropping it onto the 
filename display area.  The song can be played, the tempo and 
position changed, and the track synchronized with other sources.

In its alternate play mode (usually activated by a toggle button 
labeled 'play' or 'mode') the cacheable component plays sound
buffers.  The buffer is selected from a pull-down list of currently
cached buffers.  This buffer can be played, seeked, and synched
like a normal song.

To create a new cache buffer, you must define a starting time within
the track and a length in beats (if the tempo is unknown, a beat length
of one second is assumed).  Seek to the point in the song which should be
the beginning of the loop.  To mark the current position as the starting 
time, press the "punch in" or "start" button.  The "length" adjustment 
gives the length of the loop, in beats.  If the tempo of the song is 
not known, then a value of one second per beat is used.  After selecting 
a punch in point and a loop length, press the 'cache' button.  The loop
is exported to the buffer manager, along with the beat information
to describe it.  

Cache descriptions can be saved to the song database, so that
loops can cached quickly later.  Type a name in the text entry 
to identify the loop, and press the 'write' button to write
the loop to the database.  Pressing the 'read' button will 
read out each loop know for the current song one at a time.
Don't forget to save the song database after adding new
loops.
