EditableDenseThreeDimensionalModel.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 _EDITABLE_DENSE_THREE_DIMENSIONAL_MODEL_H_
#define _EDITABLE_DENSE_THREE_DIMENSIONAL_MODEL_H_

#include "DenseThreeDimensionalModel.h"

#include <QReadWriteLock>

#include <vector>

class EditableDenseThreeDimensionalModel : public DenseThreeDimensionalModel
{
    Q_OBJECT

public:

    // EditableDenseThreeDimensionalModel supports a basic compression
    // method that reduces the size of multirate data (e.g. wavelet
    // transform outputs) that are stored as plain 3d grids by about
    // 60% or thereabouts.  However, it can only be used for models
    // whose columns are set in order from 0 and never subsequently
    // changed.  If the model is going to be actually edited, it must
    // have NoCompression.

    enum CompressionType
    {
        NoCompression,
        BasicMultirateCompression
    };

    EditableDenseThreeDimensionalModel(int sampleRate,
                                       int resolution,
                                       int yBinCount,
                                       CompressionType compression,
                                       bool notifyOnAdd = true);

    virtual bool isOK() const;

    virtual int getSampleRate() const;
    virtual int getStartFrame() const;
    virtual int getEndFrame() const;

    virtual Model *clone() const;
    

    virtual void setStartFrame(int);

    virtual int getResolution() const;

    virtual void setResolution(int sz);

    virtual int getWidth() const;

    virtual int getHeight() const; 

    virtual void setHeight(int sz);

    virtual float getMinimumLevel() const;

    virtual void setMinimumLevel(float sz);

    virtual float getMaximumLevel() const;

    virtual void setMaximumLevel(float sz);

    virtual bool isColumnAvailable(int x) const { return x < getWidth(); }

    virtual Column getColumn(int x) const;

    virtual float getValueAt(int x, int n) const;

    virtual void setColumn(int x, const Column &values);

    virtual QString getBinName(int n) const;

    virtual void setBinName(int n, QString);

    virtual void setBinNames(std::vector<QString> names);

    virtual bool hasBinValues() const;

    virtual float getBinValue(int n) const;

    virtual void setBinValues(std::vector<float> values);

    virtual QString getBinValueUnit() const;

    virtual void setBinValueUnit(QString unit);

    bool shouldUseLogValueScale() const;

    virtual void setCompletion(int completion, bool update = true);
    virtual int getCompletion() const { return m_completion; }

    QString getTypeName() const { return tr("Editable Dense 3-D"); }

    virtual QString toDelimitedDataString(QString delimiter) const;
    virtual QString toDelimitedDataStringSubset(QString delimiter, int f0, int f1) const;

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

protected:
    typedef QVector<Column> ValueMatrix;
    ValueMatrix m_data;

    // m_trunc is used for simple compression.  If at least the top N
    // elements of column x (for N = some proportion of the column
    // height) are equal to those of an earlier column x', then
    // m_trunc[x] will contain x-x' and column x will be truncated so
    // as to remove the duplicate elements.  If the equal elements are
    // at the bottom, then m_trunc[x] will contain x'-x (a negative
    // value).  If m_trunc[x] is 0 then the whole of column x is
    // stored.
    std::vector<signed char> m_trunc;
    void truncateAndStore(int index, const Column & values);
    Column expandAndRetrieve(int index) const;

    std::vector<QString> m_binNames;
    std::vector<float> m_binValues;
    QString m_binValueUnit;

    int m_startFrame;
    int m_sampleRate;
    int m_resolution;
    int m_yBinCount;
    CompressionType m_compression;
    float m_minimum;
    float m_maximum;
    bool m_haveExtents;
    bool m_notifyOnAdd;
    long m_sinceLastNotifyMin;
    long m_sinceLastNotifyMax;
    int m_completion;

    mutable QReadWriteLock m_lock;
};

#endif