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
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
|
/* -*- 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 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_PANNER_H
#define SV_PANNER_H
#include <QWidget>
#include "WheelCounter.h"
namespace sv {
class Panner : public QWidget
{
Q_OBJECT
public:
Panner(QWidget *parent = 0);
virtual ~Panner();
void setDefaultRectCentre(float, float);
void setThumbColour(QColor colour);
void setAlpha(int backgroundAlpha, int thumbAlpha);
/**
* Set the amount the scroll() function or mouse wheel movement
* makes the panner rectangle move by. The default value of 0
* means to select a value automatically based on the dimensions
* of the panner rectangle.
*/
void setScrollUnit(float unit);
void getRectExtents(float &x0, float &y0, float &width, float &height);
QSize sizeHint() const override;
signals:
/**
* Emitted when the panned rectangle is dragged or otherwise
* moved. Arguments are x0, y0, width and height of the rectangle
* in the range 0 -> 1 as proportions of the width and height of
* the whole widget.
*/
void rectExtentsChanged(float, float, float, float);
/**
* Emitted when the rectangle is dragged or otherwise moved (as
* well as extentsChanged). Arguments are the centre coordinates
* of the rectangle in the range 0 -> 1 as proportions of the
* width and height of the whole widget.
*/
void rectCentreMoved(float, float);
/**
* Emitted when the panner is double-clicked (for the "customer"
* code to pop up a value editing dialog, for example).
*/
void doubleClicked();
void mouseEntered();
void mouseLeft();
public slots:
/**
* Set the extents of the panned rectangle within the overall
* panner widget. Coordinates are in the range 0 -> 1 in both axes,
* with 0 at the top in the y axis.
*/
void setRectExtents(float x0, float y0, float width, float height);
/**
* Set the width of the panned rectangle as a fraction (0 -> 1) of
* that of the whole panner widget.
*/
void setRectWidth(float width);
/**
* Set the height of the panned rectangle as a fraction (0 -> 1)
* of that of the whole panner widget.
*/
void setRectHeight(float height);
/**
* Set the location of the centre of the panned rectangle on the x
* axis, as a proportion (0 -> 1) of the width of the whole panner
* widget.
*/
void setRectCentreX(float x);
/**
* Set the location of the centre of the panned rectangle on the y
* axis, as a proportion (0 -> 1) of the height of the whole panner
* widget.
*/
void setRectCentreY(float y);
/**
* Move up (if up is true) or down a bit. This is basically the
* same action as rolling the mouse wheel one notch.
*/
void scroll(bool up);
/**
* Move up (if up is true) or down a bit. This is basically the
* same action as rolling the mouse wheel n notches.
*/
void scroll(bool up, int n);
void resetToDefault();
protected:
void mousePressEvent(QMouseEvent *e) override;
void mouseDoubleClickEvent(QMouseEvent *e) override;
void mouseMoveEvent(QMouseEvent *e) override;
void mouseReleaseEvent(QMouseEvent *e) override;
void wheelEvent(QWheelEvent *e) override;
void paintEvent(QPaintEvent *e) override;
void enterEvent(QEnterEvent *) override;
void leaveEvent(QEvent *) override;
void normalise();
void emitAndUpdate();
float m_rectX;
float m_rectY;
float m_rectWidth;
float m_rectHeight;
float m_scrollUnit;
float m_defaultCentreX;
float m_defaultCentreY;
bool m_defaultsSet;
QColor m_thumbColour;
int m_backgroundAlpha;
int m_thumbAlpha;
float centreX() const { return m_rectX + m_rectWidth/2; }
float centreY() const { return m_rectY + m_rectHeight/2; }
bool m_clicked;
QPoint m_clickPos;
float m_dragStartX;
float m_dragStartY;
WheelCounter m_wheelCounter;
};
} // end namespace sv
#endif
|
