summaryrefslogtreecommitdiffstats
path: root/src/controlobjectthread.h
blob: 3ea5c5f04b9bf0f8492ff077b689e025d0c5fecd (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
/***************************************************************************
                          controlobjectthread.h  -  description
                             -------------------
    begin                : Thu Sep 23 2004
    copyright            : (C) 2004 by Tue Haste Andersen
    email                : haste@diku.dk
 ***************************************************************************/

/***************************************************************************
 *                                                                         *
 *   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.                                   *
 *                                                                         *
 ***************************************************************************/

#ifndef CONTROLOBJECTTHREAD_H
#define CONTROLOBJECTTHREAD_H

#include <QObject>

#include "configobject.h"
#include "control/control.h"

class ControlObjectThread : public QObject {
    Q_OBJECT
  public:
    ControlObjectThread(const QString& g, const QString& i, QObject* pParent=NULL);
    ControlObjectThread(const char* g, const char* i, QObject* pParent=NULL);
    ControlObjectThread(const ConfigKey& key, QObject* pParent=NULL);
    virtual ~ControlObjectThread();

    void initialize(const ConfigKey& key);

    bool connectValueChanged(const QObject* receiver,
            const char* method, Qt::ConnectionType type = Qt::AutoConnection);
    bool connectValueChanged(
            const char* method, Qt::ConnectionType type = Qt::AutoConnection);

    QString name() const;
    QString description() const;

    /** Called from update(); */
    inline void emitValueChanged() {
        emit(valueChanged(get()));
    }

    inline ConfigKey getKey() const { return m_key; }
    inline bool valid() const { return m_pControl != NULL; }

    // Returns the value of the object. Thread safe, non-blocking.
    inline double get() {
        return m_pControl ? m_pControl->get() : 0.0;
    }

    // Returns the normalized parameter of the object. Thread safe, non-blocking.
    inline double getParameter() const {
        return m_pControl ? m_pControl->getParameter() : 0.0;
    }

    // Set the normalized parameter of the object. Thread safe, non-blocking.
    inline void setParameter(double p) {
        if (m_pControl) {
            m_pControl->setParameter(p, this);
        }
    }

    inline double getParameterForValue(double value) const {
        return m_pControl ? m_pControl->getParameterForValue(value) : 0.0;
    }

    // Returns the normalized parameter of the object. Thread safe, non-blocking.
    inline double getDefault() const {
        return m_pControl ? m_pControl->defaultValue() : 0.0;
    }

  public slots:
    // Set the control to a new value. Non-blocking.
    inline void slotSet(double v) {
        set(v);
    }

    // Sets the control value to v. Thread safe, non-blocking.
    inline void set(double v) {
        if (m_pControl) {
            m_pControl->set(v, this);
        }
    }

    // Resets the control to its default value. Thread safe, non-blocking.
    inline void reset() {
        if (m_pControl) {
            // NOTE(rryan): This is important. The originator of this action does
            // not know the resulting value so it makes sense that we should emit a
            // general valueChanged() signal even though the change originated from
            // us. For this reason, we provide NULL here so that the change is
            // broadcast as valueChanged() and not valueChangedByThis().
            m_pControl->reset();
        }
    }

  signals:
    void valueChanged(double);
    // This means that the control value has changed as a result of a mutation
    // (set/add/sub/reset) originating from this object.
    void valueChangedByThis(double);

  protected slots:
    // Receives the value from the master control and re-emits either
    // valueChanged(double) or valueChangedByThis(double) based on pSetter.
    inline void slotValueChanged(double v, QObject* pSetter) {
        if (pSetter != this) {
            // This is base implementation of this function without scaling
            emit(valueChanged(v));
        } else {
            emit(valueChangedByThis(v));
        }
    }

  protected:
    ConfigKey m_key;
    // Pointer to connected control.
    QSharedPointer<ControlDoublePrivate> m_pControl;
};

#endif