diff document/SVFileReader.cpp @ 127:fbd09fcda469

* doc updates
author Chris Cannam
date Fri, 30 Mar 2007 17:16:48 +0000
parents b4110b17bca8
children 006c90387f40
line wrap: on
line diff
--- a/document/SVFileReader.cpp	Thu Mar 15 16:13:59 2007 +0000
+++ b/document/SVFileReader.cpp	Fri Mar 30 17:16:48 2007 +0000
@@ -41,113 +41,6 @@
 
 #include <iostream>
 
-/*
-    Some notes about the SV XML format.  We're very lazy with our XML:
-    there's no schema or DTD, and we depend heavily on elements being
-    in a particular order.
- 
-    <sv>
-
-    <data>
-
-      <!-- The data section contains definitions of both models and
-           visual layers.  Layers are considered data in the document;
-           the structure of views that displays the layers is not. -->
-
-      <!-- id numbers are unique within the data type (i.e. no two
-           models can have the same id, but a model can have the same
-           id as a layer, etc).  SV generates its id numbers just for
-           the purpose of cross-referencing within the current file;
-           they don't necessarily have any meaning once the file has
-           been loaded. -->
-
-      <model id="0" name="..." type="..." ... />
-      <model id="1" name="..." type="..." ... />
-
-      <!-- Models that have data associated with them store it
-           in a neighbouring dataset element.  The dataset must follow
-           the model and precede any derivation or layer elements that
-           refer to the model. -->
-
-      <model id="2" name="..." type="..." dataset="0" ... />
-
-      <dataset id="0" type="..."> 
-        <point frame="..." value="..." ... />
-      </dataset>
-
-      <!-- Where one model is derived from another via a transform,
-           it has an associated derivation element.  This must follow
-           both the source and target model elements.  The source and
-           model attributes give the source model id and target model
-           id respectively.  A model can have both dataset and
-           derivation elements; if it does, dataset must appear first. 
-           If the model's data are not stored, but instead the model
-           is to be regenerated completely from the transform when 
-           the session is reloaded, then the model should have _only_
-           a derivation element, and no model element should appear
-           for it at all. -->
-
-      <derivation source="0" model="2" transform="..." ...>
-        <plugin id="..." ... />
-      </derivation>
-
-      <!-- The playparameters element lists playback settings for
-           a model. -->
-
-      <playparameters mute="false" pan="0" gain="1" model="1" ... />
-
-      <!-- Layer elements.  The models must have already been defined.
-           The same model may appear in more than one layer (of more
-           than one type). -->
-
-      <layer id="1" type="..." name="..." model="0" ... />
-      <layer id="2" type="..." name="..." model="1" ... />
-
-    </data>
-
-
-    <display>
-
-      <!-- The display element contains visual structure for the
-           layers.  It's simpler than the data section. -->
-
-      <!-- Overall preferred window size for this session. -->
-
-      <window width="..." height="..."/>
-
-      <!-- List of view elements to stack up.  Each one contains
-           a list of layers in stacking order, back to front. -->
-
-      <view type="pane" ...>
-        <layer id="1"/>
-        <layer id="2"/>
-      </view>
-
-      <!-- The layer elements just refer to layers defined in the
-           data section, so they don't have to have any attributes
-           other than the id.  For sort-of-historical reasons SV
-           actually does repeat the other attributes here, but
-           it doesn't need to. -->
-
-      <view type="pane" ...>
-        <layer id="2"/>
-      <view>
-
-    </display>
-
-
-    <!-- List of selected regions by audio frame extents. -->
-
-    <selections>
-      <selection start="..." end="..."/>
-    </selections>
-
-
-    </sv>
- 
- */
-
-
 SVFileReader::SVFileReader(Document *document,
 			   SVFileReaderPaneCallback &callback,
                            QString location) :