Chris@0: /* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */
Chris@0: 
Chris@0: /*
Chris@0:     Sonic Visualiser
Chris@0:     An audio file viewer and annotation editor.
Chris@0:     Centre for Digital Music, Queen Mary, University of London.
Chris@77:     This file copyright 2006 Chris Cannam and QMUL.
Chris@0:     
Chris@0:     This program is free software; you can redistribute it and/or
Chris@0:     modify it under the terms of the GNU General Public License as
Chris@0:     published by the Free Software Foundation; either version 2 of the
Chris@0:     License, or (at your option) any later version.  See the file
Chris@0:     COPYING included with this distribution for more information.
Chris@0: */
Chris@0: 
Chris@0: #ifndef _SV_FILE_READER_H_
Chris@0: #define _SV_FILE_READER_H_
Chris@0: 
Chris@0: #include "layer/LayerFactory.h"
Chris@0: #include "transform/Transform.h"
Chris@30: #include "transform/PluginTransform.h"
Chris@0: 
Chris@0: #include <QXmlDefaultHandler>
Chris@0: 
Chris@0: #include <map>
Chris@0: 
Chris@0: class Pane;
Chris@0: class Model;
Chris@0: class Document;
Chris@0: class PlayParameters;
Chris@0: 
Chris@0: class SVFileReaderPaneCallback
Chris@0: {
Chris@0: public:
Chris@137:     virtual ~SVFileReaderPaneCallback();
Chris@0:     virtual Pane *addPane() = 0;
Chris@0:     virtual void setWindowSize(int width, int height) = 0;
Chris@0:     virtual void addSelection(int start, int end) = 0;
Chris@0: };
Chris@0: 
Chris@127: /**
Chris@127:     SVFileReader loads Sonic Visualiser XML files.  (The SV file
Chris@127:     format is bzipped XML.)
Chris@127: 
Chris@127:     Some notes about the SV XML format follow.  We're very lazy with
Chris@127:     our XML: there's no schema or DTD, and we depend heavily on
Chris@127:     elements being in a particular order.
Chris@127:  
Chris@127: \verbatim
Chris@127: 
Chris@127:     <sv>
Chris@127: 
Chris@127:     <data>
Chris@127: 
Chris@127:       <!-- The data section contains definitions of both models and
Chris@127:            visual layers.  Layers are considered data in the document;
Chris@127:            the structure of views that displays the layers is not. -->
Chris@127: 
Chris@127:       <!-- id numbers are unique within the data type (i.e. no two
Chris@127:            models can have the same id, but a model can have the same
Chris@127:            id as a layer, etc).  SV generates its id numbers just for
Chris@127:            the purpose of cross-referencing within the current file;
Chris@127:            they don't necessarily have any meaning once the file has
Chris@127:            been loaded. -->
Chris@127: 
Chris@127:       <model id="0" name="..." type="..." ... />
Chris@127:       <model id="1" name="..." type="..." ... />
Chris@127: 
Chris@127:       <!-- Models that have data associated with them store it
Chris@127:            in a neighbouring dataset element.  The dataset must follow
Chris@127:            the model and precede any derivation or layer elements that
Chris@127:            refer to the model. -->
Chris@127: 
Chris@127:       <model id="2" name="..." type="..." dataset="0" ... />
Chris@127: 
Chris@127:       <dataset id="0" type="..."> 
Chris@127:         <point frame="..." value="..." ... />
Chris@127:       </dataset>
Chris@127: 
Chris@127:       <!-- Where one model is derived from another via a transform,
Chris@127:            it has an associated derivation element.  This must follow
Chris@127:            both the source and target model elements.  The source and
Chris@127:            model attributes give the source model id and target model
Chris@127:            id respectively.  A model can have both dataset and
Chris@127:            derivation elements; if it does, dataset must appear first. 
Chris@127:            If the model's data are not stored, but instead the model
Chris@127:            is to be regenerated completely from the transform when 
Chris@127:            the session is reloaded, then the model should have _only_
Chris@127:            a derivation element, and no model element should appear
Chris@127:            for it at all. -->
Chris@127: 
Chris@127:       <derivation source="0" model="2" transform="..." ...>
Chris@127:         <plugin id="..." ... />
Chris@127:       </derivation>
Chris@127: 
Chris@127:       <!-- The playparameters element lists playback settings for
Chris@127:            a model. -->
Chris@127: 
Chris@127:       <playparameters mute="false" pan="0" gain="1" model="1" ... />
Chris@127: 
Chris@127:       <!-- Layer elements.  The models must have already been defined.
Chris@127:            The same model may appear in more than one layer (of more
Chris@127:            than one type). -->
Chris@127: 
Chris@127:       <layer id="1" type="..." name="..." model="0" ... />
Chris@127:       <layer id="2" type="..." name="..." model="1" ... />
Chris@127: 
Chris@127:     </data>
Chris@127: 
Chris@127: 
Chris@127:     <display>
Chris@127: 
Chris@127:       <!-- The display element contains visual structure for the
Chris@127:            layers.  It's simpler than the data section. -->
Chris@127: 
Chris@127:       <!-- Overall preferred window size for this session. -->
Chris@127: 
Chris@127:       <window width="..." height="..."/>
Chris@127: 
Chris@127:       <!-- List of view elements to stack up.  Each one contains
Chris@127:            a list of layers in stacking order, back to front. -->
Chris@127: 
Chris@127:       <view type="pane" ...>
Chris@127:         <layer id="1"/>
Chris@127:         <layer id="2"/>
Chris@127:       </view>
Chris@127: 
Chris@127:       <!-- The layer elements just refer to layers defined in the
Chris@127:            data section, so they don't have to have any attributes
Chris@127:            other than the id.  For sort-of-historical reasons SV
Chris@127:            actually does repeat the other attributes here, but
Chris@127:            it doesn't need to. -->
Chris@127: 
Chris@127:       <view type="pane" ...>
Chris@127:         <layer id="2"/>
Chris@127:       <view>
Chris@127: 
Chris@127:     </display>
Chris@127: 
Chris@127: 
Chris@127:     <!-- List of selected regions by audio frame extents. -->
Chris@127: 
Chris@127:     <selections>
Chris@127:       <selection start="..." end="..."/>
Chris@127:     </selections>
Chris@127: 
Chris@127: 
Chris@127:     </sv>
Chris@127:  
Chris@127: \endverbatim
Chris@127:  */
Chris@127: 
Chris@127: 
Chris@0: class SVFileReader : public QXmlDefaultHandler
Chris@0: {
Chris@0: public:
Chris@0:     SVFileReader(Document *document,
Chris@87: 		 SVFileReaderPaneCallback &callback,
Chris@87:                  QString location = ""); // for audio file locate mechanism
Chris@0:     virtual ~SVFileReader();
Chris@0: 
Chris@0:     void parse(const QString &xmlData);
Chris@0:     void parse(QXmlInputSource &source);
Chris@0: 
Chris@0:     bool isOK();
Chris@0:     QString getErrorString() const { return m_errorString; }
Chris@0: 
Chris@0:     // For loading a single layer onto an existing pane
Chris@0:     void setCurrentPane(Pane *pane) { m_currentPane = pane; }
Chris@0:     
Chris@0:     virtual bool startElement(const QString &namespaceURI,
Chris@0: 			      const QString &localName,
Chris@0: 			      const QString &qName,
Chris@0: 			      const QXmlAttributes& atts);
Chris@0: 
Chris@0:     virtual bool characters(const QString &);
Chris@0: 
Chris@0:     virtual bool endElement(const QString &namespaceURI,
Chris@0: 			    const QString &localName,
Chris@0: 			    const QString &qName);
Chris@0: 
Chris@0:     bool error(const QXmlParseException &exception);
Chris@0:     bool fatalError(const QXmlParseException &exception);
Chris@0: 
Chris@0: protected:
Chris@0:     bool readWindow(const QXmlAttributes &);
Chris@0:     bool readModel(const QXmlAttributes &);
Chris@0:     bool readView(const QXmlAttributes &);
Chris@0:     bool readLayer(const QXmlAttributes &);
Chris@0:     bool readDatasetStart(const QXmlAttributes &);
Chris@0:     bool addBinToDataset(const QXmlAttributes &);
Chris@0:     bool addPointToDataset(const QXmlAttributes &);
Chris@0:     bool addRowToDataset(const QXmlAttributes &);
Chris@0:     bool readRowData(const QString &);
Chris@0:     bool readDerivation(const QXmlAttributes &);
Chris@0:     bool readPlayParameters(const QXmlAttributes &);
Chris@0:     bool readPlugin(const QXmlAttributes &);
Chris@0:     bool readSelection(const QXmlAttributes &);
Chris@0:     void addUnaddedModels();
Chris@0: 
Chris@0:     Document *m_document;
Chris@0:     SVFileReaderPaneCallback &m_paneCallback;
Chris@87:     QString m_location;
Chris@0:     Pane *m_currentPane;
Chris@0:     std::map<int, Layer *> m_layers;
Chris@0:     std::map<int, Model *> m_models;
Chris@0:     std::set<Model *> m_addedModels;
Chris@0:     std::map<int, int> m_awaitingDatasets; // map dataset id -> model id
Chris@0:     Model *m_currentDataset;
Chris@0:     Model *m_currentDerivedModel;
Chris@55:     int m_currentDerivedModelId;
Chris@0:     PlayParameters *m_currentPlayParameters;
Chris@0:     QString m_currentTransform;
Chris@55:     Model *m_currentTransformSource;
Chris@30:     PluginTransform::ExecutionContext m_currentTransformContext;
Chris@0:     QString m_currentTransformConfiguration;
Chris@0:     QString m_datasetSeparator;
Chris@0:     bool m_inRow;
Chris@0:     bool m_inView;
Chris@0:     bool m_inData;
Chris@0:     bool m_inSelections;
Chris@0:     int m_rowNumber;
Chris@0:     QString m_errorString;
Chris@0:     bool m_ok;
Chris@0: };
Chris@0: 
Chris@0: #endif