AudioDial.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 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_AUDIO_DIAL_H
#define SV_AUDIO_DIAL_H

#include <QDial>
#include <map>

class RangeMapper;
class QMenu;

class AudioDial : public QDial
{
    Q_OBJECT
    Q_PROPERTY( QColor knobColor READ getKnobColor WRITE setKnobColor )
    Q_PROPERTY( QColor meterColor READ getMeterColor WRITE setMeterColor )
    Q_PROPERTY( bool mouseDial READ getMouseDial WRITE setMouseDial )

public:
    AudioDial(QWidget *parent = 0);
    ~AudioDial();

    const QColor& getKnobColor()  const { return m_knobColor;  }
    const QColor& getMeterColor() const { return m_meterColor; }
    bool getMouseDial() const { return m_mouseDial; }

    void setRangeMapper(RangeMapper *mapper); // I take ownership, will delete
    const RangeMapper *rangeMapper() const { return m_rangeMapper; }
    double mappedValue() const;

    int defaultValue() const { return m_defaultValue; }

    void setShowToolTip(bool show);
    void setProvideContextMenu(bool provide);

signals:
    void mouseEntered();
    void mouseLeft();

public slots:
    void setKnobColor(const QColor &color);

    void setMeterColor(const QColor &color);
    
    void setMouseDial(bool mouseDial);

    void setDefaultValue(int defaultValue);

    void setValue(int value);

    void setDefaultMappedValue(double mappedValue);

    void setMappedValue(double mappedValue);

    void setToDefault();

    void edit();

protected:
    void drawTick(QPainter &paint, double angle, int size, bool internal);
    void paintEvent(QPaintEvent *) override;

    // Alternate mouse behavior event handlers.
    void mousePressEvent(QMouseEvent *pMouseEvent) override;
    void mouseMoveEvent(QMouseEvent *pMouseEvent) override;
    void mouseReleaseEvent(QMouseEvent *pMouseEvent) override;
    void mouseDoubleClickEvent(QMouseEvent *pMouseEvent) override;
    void enterEvent(QEvent *) override;
    void leaveEvent(QEvent *) override;

protected slots:
    void updateMappedValue(int value);
    void contextMenuRequested(const QPoint &);

private:
    QColor m_knobColor;
    QColor m_meterColor;
    
    int m_defaultValue;
    double m_defaultMappedValue;
    double m_mappedValue;
    bool m_noMappedUpdate;

    // Alternate mouse behavior tracking.
    bool m_mouseDial;
    bool m_mousePressed;
    QPoint m_posMouse;

    bool m_showTooltip;
    bool m_provideContextMenu;

    QString m_title;

    QMenu *m_lastContextMenu;

    RangeMapper *m_rangeMapper;
};


#endif  // __AudioDial_h

// end of AudioDial.h