SVFileReader.h

Go to the documentation of this file.

/* -*- c-basic-offset: 4 indent-tabs-mode: nil -*-  vi:set ts=8 sts=4 sw=4: */

/*
    Sonic Visualiser
    An audio file viewer and annotation editor.
    Centre for Digital Music, Queen Mary, University of London.
    This file copyright 2006 Chris Cannam and QMUL.
    
    This program is free software; you can redistribute it and/or
    modify it under the terms of the GNU General Public License as
    published by the Free Software Foundation; either version 2 of the
    License, or (at your option) any later version.  See the file
    COPYING included with this distribution for more information.
*/

#ifndef SV_FILE_READER_H
#define SV_FILE_READER_H

#include "layer/LayerFactory.h"
#include "transform/Transform.h"

#include <QXmlDefaultHandler>

#include <map>

class Pane;
class Model;
class Path;
class Document;
class PlayParameters;

class SVFileReaderPaneCallback
{
public:
    virtual ~SVFileReaderPaneCallback();
    virtual Pane *addPane() = 0;
    virtual void setWindowSize(int width, int height) = 0;
    virtual void addSelection(sv_frame_t start, sv_frame_t end) = 0;
};

class SVFileReader : public QObject, QXmlDefaultHandler
{
    Q_OBJECT

public:
    SVFileReader(Document *document,
                 SVFileReaderPaneCallback &callback,
                 QString location = ""); // for audio file locate mechanism
    virtual ~SVFileReader();

    void parse(const QString &xmlData);
    void parse(QXmlInputSource &source);

    bool isOK();
    QString getErrorString() const { return m_errorString; }

    // For loading a single layer onto an existing pane
    void setCurrentPane(Pane *pane) { m_currentPane = pane; }
    
    bool startElement(const QString &namespaceURI,
                      const QString &localName,
                      const QString &qName,
                      const QXmlAttributes& atts) override;
    
    bool characters(const QString &) override;

    bool endElement(const QString &namespaceURI,
                    const QString &localName,
                    const QString &qName) override;

    bool error(const QXmlParseException &exception) override;
    bool fatalError(const QXmlParseException &exception) override;

    enum FileType
    {
        SVSessionFile,
        SVLayerFile,
        UnknownFileType
    };

    static FileType identifyXmlFile(QString path);

signals:
    void modelRegenerationFailed(QString layerName, QString transformName,
                                 QString message);
    void modelRegenerationWarning(QString layerName, QString transformName,
                                  QString message);

protected:
    bool readWindow(const QXmlAttributes &);
    bool readModel(const QXmlAttributes &);
    bool readView(const QXmlAttributes &);
    bool readLayer(const QXmlAttributes &);
    bool readDatasetStart(const QXmlAttributes &);
    bool addBinToDataset(const QXmlAttributes &);
    bool addPointToDataset(const QXmlAttributes &);
    bool addRowToDataset(const QXmlAttributes &);
    bool readRowData(const QString &);
    bool readDerivation(const QXmlAttributes &);
    bool readPlayParameters(const QXmlAttributes &);
    bool readPlugin(const QXmlAttributes &);
    bool readPluginForTransform(const QXmlAttributes &);
    bool readPluginForPlayback(const QXmlAttributes &);
    bool readTransform(const QXmlAttributes &);
    bool readParameter(const QXmlAttributes &);
    bool readSelection(const QXmlAttributes &);
    bool readMeasurement(const QXmlAttributes &);

    void makeAggregateModels();
    void addUnaddedModels();

    // We use the term "pending" of things that have been referred to
    // but not yet constructed because their definitions are
    // incomplete. They are just referred to with an ExportId.  Models
    // that have been constructed are always added straight away to
    // ById and are referred to with a ModelId (everywhere where
    // previously we would have used a Model *). m_models maps from
    // ExportId (as read from the file) to complete Models, or to a
    // ModelId of None for any model that could not be constructed for
    // some reason.

    typedef XmlExportable::ExportId ExportId;
    
    bool haveModel(ExportId id) {
        return (m_models.find(id) != m_models.end()) && !m_models[id].isNone();
    }
    
    struct PendingAggregateRec {
        QString name;
        sv_samplerate_t sampleRate;
        std::vector<ExportId> components;
    };
    
    Document *m_document;
    SVFileReaderPaneCallback &m_paneCallback;
    QString m_location;
    Pane *m_currentPane;
    std::map<ExportId, Layer *> m_layers;
    std::map<ExportId, ModelId> m_models;
    std::map<ExportId, Path *> m_paths;
    std::set<ModelId> m_addedModels; // i.e. added to Document, not just ById
    std::map<ExportId, PendingAggregateRec> m_pendingAggregates;

    // A model element often contains a dataset id, and the dataset
    // then follows it. When the model is read, an entry in this map
    // is added, mapping from the dataset's export id (the actual
    // dataset has not been read yet) back to the export id of the
    // object that needs it. We map to export id rather than model id,
    // because the object might be a path rather than a model.
    std::map<ExportId, ExportId> m_awaitingDatasets;

    // And then this is the model or path that a dataset element is
    // currently being read into, i.e. the value looked up from
    // m_awaitingDatasets at the point where the dataset is found.
    ExportId m_currentDataset;

    Layer *m_currentLayer;
    ModelId m_currentDerivedModel;
    ExportId m_pendingDerivedModel;
    std::shared_ptr<PlayParameters> m_currentPlayParameters;
    Transform m_currentTransform;
    ModelId m_currentTransformSource;
    int m_currentTransformChannel;
    bool m_currentTransformIsNewStyle;
    QString m_datasetSeparator;
    bool m_inRow;
    bool m_inLayer;
    bool m_inView;
    bool m_inData;
    bool m_inSelections;
    int m_rowNumber;
    QString m_errorString;
    bool m_ok;
};

#endif