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
166
167
168
169
170
171
172
173
174
175
|
/*
* SPDX-FileCopyrightText: 2013-2020 Mattia Basaglia
*
* SPDX-License-Identifier: LGPL-3.0-or-later
*/
#ifndef COLOR_WHEEL_HPP
#define COLOR_WHEEL_HPP
#include <QWidget>
#include "colorwidgets_global.hpp"
namespace color_widgets {
/**
* \brief Display an analog widget that allows the selection of a HSV color
*
* It has an outer wheel to select the Hue and an intenal square to select
* Saturation and Lightness.
*/
class QCP_EXPORT ColorWheel : public QWidget
{
Q_OBJECT
Q_PROPERTY(QColor color READ color WRITE setColor NOTIFY colorChanged DESIGNABLE true STORED false )
Q_PROPERTY(qreal hue READ hue WRITE setHue DESIGNABLE false )
Q_PROPERTY(qreal saturation READ saturation WRITE setSaturation DESIGNABLE false )
Q_PROPERTY(qreal value READ value WRITE setValue DESIGNABLE false )
Q_PROPERTY(unsigned wheelWidth READ wheelWidth WRITE setWheelWidth NOTIFY wheelWidthChanged DESIGNABLE true )
Q_PROPERTY(ShapeEnum selectorShape READ selectorShape WRITE setSelectorShape NOTIFY selectorShapeChanged DESIGNABLE true )
Q_PROPERTY(bool rotatingSelector READ rotatingSelector WRITE setRotatingSelector NOTIFY rotatingSelectorChanged DESIGNABLE true )
Q_PROPERTY(ColorSpaceEnum colorSpace READ colorSpace WRITE setColorSpace NOTIFY colorSpaceChanged DESIGNABLE true )
Q_PROPERTY(bool mirroredSelector READ mirroredSelector WRITE setMirroredSelector NOTIFY mirroredSelectorChanged DESIGNABLE true )
public:
enum ShapeEnum
{
ShapeTriangle, ///< A triangle
ShapeSquare, ///< A square
};
enum AngleEnum
{
AngleFixed, ///< The inner part doesn't rotate
AngleRotating, ///< The inner part follows the hue selector
};
enum ColorSpaceEnum
{
ColorHSV, ///< Use the HSV color space
ColorHSL, ///< Use the HSL color space
ColorLCH, ///< Use Luma Chroma Hue (Y_601')
};
Q_ENUM(ShapeEnum);
Q_ENUM(AngleEnum);
Q_ENUM(ColorSpaceEnum);
explicit ColorWheel(QWidget *parent = nullptr);
~ColorWheel();
/// Get current color
QColor color() const;
virtual QSize sizeHint() const Q_DECL_OVERRIDE;
/// Get current hue in the range [0-1]
qreal hue() const;
/// Get current saturation in the range [0-1]
qreal saturation() const;
/// Get current value in the range [0-1]
qreal value() const;
/// Get the width in pixels of the outer wheel
unsigned int wheelWidth() const;
/// Set the width in pixels of the outer wheel
void setWheelWidth(unsigned int w);
/// Shape of the internal selector
ShapeEnum selectorShape() const;
/// Whether the internal selector should rotare in accordance with the hue
bool rotatingSelector() const;
/// Color space used to preview/edit the color
ColorSpaceEnum colorSpace() const;
/// Whether the internal selector's should be mirrored horizontally
bool mirroredSelector() const;
public Q_SLOTS:
/// Set current color
void setColor(QColor c);
/**
* @param h Hue [0-1]
*/
void setHue(qreal h);
/**
* @param s Saturation [0-1]
*/
void setSaturation(qreal s);
/**
* @param v Value [0-1]
*/
void setValue(qreal v);
/// Sets the shape of the internal selector
void setSelectorShape(ShapeEnum shape);
/// Sets whether the internal selector should rotare in accordance with the hue
void setRotatingSelector(bool rotating);
/// Sets the color space used to preview/edit the color
void setColorSpace(ColorSpaceEnum space);
/// Sets whether the internal selector should be mirrored horizontally
void setMirroredSelector(bool mirrored);
Q_SIGNALS:
/**
* Emitted when the user selects a color or setColor is called
*/
void colorChanged(QColor);
/**
* Emitted when the user selects a color
*/
void colorSelected(QColor);
void wheelWidthChanged(unsigned);
void selectorShapeChanged(ShapeEnum shape);
void rotatingSelectorChanged(bool rotating);
void colorSpaceChanged(ColorSpaceEnum space);
void mirroredSelectorChanged(bool mirrored);
/**
* Emitted when the user releases from dragging
*/
void editingFinished();
protected:
void paintEvent(QPaintEvent *) Q_DECL_OVERRIDE;
void mouseMoveEvent(QMouseEvent *) Q_DECL_OVERRIDE;
void mousePressEvent(QMouseEvent *) Q_DECL_OVERRIDE;
void mouseReleaseEvent(QMouseEvent *) Q_DECL_OVERRIDE;
void resizeEvent(QResizeEvent *) Q_DECL_OVERRIDE;
void dragEnterEvent(QDragEnterEvent* event) Q_DECL_OVERRIDE;
void dropEvent(QDropEvent* event) Q_DECL_OVERRIDE;
protected:
class Private;
ColorWheel(QWidget *parent, Private* data);
Private* data() const { return p; }
private:
Private * const p;
};
} // namespace color_widgets
#endif // COLOR_WHEEL_HPP
|
