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