Model.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.
    
    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 _MODEL_H_
#define _MODEL_H_

#include <vector>
#include <QObject>

#include "base/XmlExportable.h"

typedef std::vector<float> SampleBlock;

class ZoomConstraint;
class AlignmentModel;

class Model : public QObject,
              public XmlExportable
{
    Q_OBJECT

public:
    virtual ~Model();

    virtual bool isOK() const = 0;

    virtual size_t getStartFrame() const = 0;

    virtual size_t getEndFrame() const = 0;

    virtual size_t getSampleRate() const = 0;

    virtual size_t getNativeRate() const { return getSampleRate(); }

    virtual QString getTitle() const;

    virtual QString getMaker() const;

    virtual QString getLocation() const;

    virtual QString getTypeName() const = 0;

    virtual Model *clone() const = 0;
    
    virtual bool isReady(int *completion = 0) const {
        bool ok = isOK();
        if (completion) *completion = (ok ? 100 : 0);
        return ok;
    }
    static const int COMPLETION_UNKNOWN;

    virtual const ZoomConstraint *getZoomConstraint() const {
        return 0;
    }

    virtual Model *getSourceModel() const {
        return m_sourceModel;
    }

    virtual void setSourceModel(Model *model);

    virtual void setAlignment(AlignmentModel *alignment);

    virtual const Model *getAlignmentReference() const;

    virtual size_t alignToReference(size_t frame) const;

    virtual size_t alignFromReference(size_t referenceFrame) const;

    virtual int getAlignmentCompletion() const;

    virtual void toXml(QTextStream &stream,
                       QString indent = "",
                       QString extraAttributes = "") const;

    virtual QString toDelimitedDataString(QString) const { return ""; }

public slots:
    void aboutToDelete();
    void sourceModelAboutToBeDeleted();

signals:
    void modelChanged();

    void modelChanged(size_t startFrame, size_t endFrame);

    void completionChanged();

    void alignmentCompletionChanged();

    void aboutToBeDeleted();

protected:
    Model() : m_sourceModel(0), m_alignment(0), m_aboutToDelete(false) { }

    // Not provided.
    Model(const Model &);
    Model &operator=(const Model &); 

    Model *m_sourceModel;
    AlignmentModel *m_alignment;
    bool m_aboutToDelete;
};

#endif

---