PropertyContainer.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_PROPERTY_CONTAINER_H
#define SV_PROPERTY_CONTAINER_H

#include "Command.h"

#include <QString>
#include <QObject>
#include <vector>
#include <memory>

class PlayParameters;
class RangeMapper;

class PropertyContainer : public QObject
{
    Q_OBJECT

public:
    virtual ~PropertyContainer() { }

    typedef QString PropertyName;
    typedef std::vector<PropertyName> PropertyList;
    
    enum PropertyType {
        ToggleProperty, // on or off
        RangeProperty, // range of integers
        ValueProperty, // range of integers given string labels
        ColourProperty, // colours, get/set as ColourDatabase indices
        ColourMapProperty, // colour maps, get/set as ColourMapper::StandardMap enum
        UnitsProperty, // unit from UnitDatabase, get/set unit id
        InvalidProperty, // property not found!
    };

    virtual PropertyList getProperties() const;

    virtual QString getPropertyLabel(const PropertyName &) const = 0;

    virtual PropertyType getPropertyType(const PropertyName &) const;

    virtual QString getPropertyIconName(const PropertyName &) const;

    virtual QString getPropertyGroupName(const PropertyName &) const;

    virtual int getPropertyRangeAndValue(const PropertyName &,
                                         int *min, int *max, int *deflt) const;

    virtual QString getPropertyValueLabel(const PropertyName &,
                                          int value) const;

    virtual QString getPropertyValueIconName(const PropertyName &,
                                             int value) const;

    virtual RangeMapper *getNewPropertyRangeMapper(const PropertyName &) const;

    virtual QString getPropertyContainerName() const = 0;
    virtual QString getPropertyContainerIconName() const = 0;

    virtual std::shared_ptr<PlayParameters> getPlayParameters() { return {}; }

signals:
    void propertyChanged(PropertyContainer::PropertyName);

public slots:
    virtual void setProperty(const PropertyName &, int value);

    virtual Command *getSetPropertyCommand(const PropertyName &, int value);

    virtual void setPropertyFuzzy(QString nameString, QString valueString);

    virtual Command *getSetPropertyCommand(QString nameString, QString valueString);

protected:

    class SetPropertyCommand : public Command
    {
    public:
        SetPropertyCommand(PropertyContainer *pc, const PropertyName &pn, int);
        virtual ~SetPropertyCommand() { }

        void execute() override;
        void unexecute() override;
        QString getName() const override;

    protected:
        PropertyContainer *m_pc;
        PropertyName m_pn;
        int m_value;
        int m_oldValue;
    };

    virtual bool convertPropertyStrings(QString nameString, QString valueString,
                                        PropertyName &name, int &value);
};

#endif