[xiph-cvs] cvs commit: positron/doc sai.html neuros.html

Sun May 25 21:43:34 PDT 2003

volsung     03/05/26 00:43:34

  Modified:    doc      neuros.html
  Added:       doc      sai.html
  Log:
  Another documentation checkpoint.

Revision  Changes    Path
1.4       +1 -1      positron/doc/neuros.html

Index: neuros.html
===================================================================
RCS file: /usr/local/cvsroot/positron/doc/neuros.html,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4

--- neuros.html	26 May 2003 03:38:22 -0000	1.3
+++ neuros.html	26 May 2003 04:43:34 -0000	1.4
@@ -79,7 +79,7 @@
 <p>
 Because the Neuros appears as a standard external hard drive when
 attached to the host computer, any type of file can be stored on it,
-regardless of whether or not it is a recognized audio file format.
+regardless of whether it is a recognized audio file format or not.
 Rather than spend extra time dynamically generating a list of
 available music files, a database of music files is maintained on the
 device.  Only those files listed in the database will be made

<p><p>1.1                  positron/doc/sai.html

Index: sai.html
===================================================================
<html>
<head>
  <title>Positron Documentation: SAI File Format</title>
</head>
<body>
<h1>SAI File Format</h1>

<p>
This document explains the format of the SAI files.  SAI files are
used in the database as a table of contents.  Every non-deleted record
in the database will have a record in the SAI file.  SAI records are
all the same size, so it is very easy to modify the contents of this
file in place, including removing and reordering entries.
</p>

<p>
A record in a SAI file consists of a pointer to a MDB record, and to
its associated PAI module (if applicable).  The pointer to the PAI
module does not point to the start of the module, however, but to the
location of the <emph>first entry within the module</emph>.  See the
<a href="pai.html">PAI file format</a> for more information.
</p>

<table>
<tr><th>Word Offset</th><th>Size (words)</th><th>Description</th></tr>
<tr><td>0</td><td>2</td><td>Signature, "0x05181971"</td><tr>
<tr><td>2</td><td>2</td><td>Reserved (zero by default)</td><tr>
<tr><td>4</td><td>1</td><td>Number of entries (N)</td><tr>
<tr><td>5</td><td>3</td><td>Reserved (zero by default) </td><tr>
<tr><td>8</td><td>4</td><td>0x00000000, 0x00000000 (looks like an empty record)</td><tr>
<tr><td>12</td><td>2</td><td>MDB pointer for record 0</td></tr>
<tr><td>14</td><td>2</td><td>PAI pointer for record 0</td></tr>
<tr><td>...</td><td>...</td><td>...</td></tr>
<tr><td>12+4*i</td><td>2</td><td>MDB pointer for record i</td></tr>
<tr><td>14+4*i</td><td>2</td><td>PAI pointer for record i</td></tr>
<tr><td>...</td><td>...</td><td>...</td></tr>
<tr><td>12+4*N</td><td>2</td><td>MDB pointer for record N</td></tr>
<tr><td>14+4*N</td><td>2</td><td>PAI pointer for record N</td></tr>
<tr><td>12+4(N+1)</td><td>4</td><td>0x00000000, 0x00000000 (looks like an empty record)</td></tr>
</table>

</body>
</html>

<p><p>--- >8 ----
List archives:  http://www.xiph.org/archives/
Ogg project homepage: http://www.xiph.org/ogg/
To unsubscribe from this list, send a message to 'cvs-request at xiph.org'
containing only the word 'unsubscribe' in the body.  No subject is needed.
Unsubscribe messages sent to the list will be ignored/filtered.

