]> git.sesse.net Git - kdenlive/blob - src/colorpickerwidget.h
Color Picker:
[kdenlive] / src / colorpickerwidget.h
1 /***************************************************************************
2  *   Copyright (C) 2010 by Till Theato (root@ttill.de)                     *
3  *                                                                         *
4  *   This program is free software; you can redistribute it and/or modify  *
5  *   it under the terms of the GNU General Public License as published by  *
6  *   the Free Software Foundation; either version 2 of the License, or     *
7  *   (at your option) any later version.                                   *
8  *                                                                         *
9  *   This program is distributed in the hope that it will be useful,       *
10  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
11  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
12  *   GNU General Public License for more details.                          *
13  *                                                                         *
14  *   You should have received a copy of the GNU General Public License     *
15  *   along with this program; if not, write to the                         *
16  *   Free Software Foundation, Inc.,                                       *
17  *   51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA          *
18  ***************************************************************************/
19
20
21 #ifndef COLORPICKERWIDGET_H
22 #define COLORPICKERWIDGET_H
23
24 #include <QtCore>
25 #include <QWidget>
26
27 class QSpinBox;
28 #ifdef Q_WS_X11
29 #include <X11/Xlib.h>
30 class KCDPickerFilter;
31 #endif
32
33 /**
34  * @class ColorPickerWidget
35  * @brief A widget to pick a color anywhere on the screen.
36  * @author Till Theato
37  *
38  * The code is partially based on the color picker in KColorDialog. 
39  */
40
41 class ColorPickerWidget : public QWidget
42 {
43     Q_OBJECT
44
45 public:
46     /** @brief Sets up the widget. */
47     ColorPickerWidget(QWidget *parent = 0);
48     /** @brief Makes sure the event filter is removed. */
49     virtual ~ColorPickerWidget();
50
51 protected:
52     virtual void mousePressEvent(QMouseEvent *event);
53     virtual void mouseReleaseEvent(QMouseEvent *event);
54     virtual void keyPressEvent(QKeyEvent *event);
55
56 private:
57     /** @brief Closes the event filter and makes mouse and keyboard work again on other widgets/windows. */
58     void closeEventFilter();
59
60     /** @brief Calculates the average color for a rect around @param pos with m_size->value() as width. */
61
62     QColor averagePickedColor(const QPoint pos);
63
64     /** @brief Color of the screen at point @param p.
65     * @param p Position of color requested
66     * @param destroyImage (optional) Whether or not to keep the XImage in m_image
67                           (needed for fast processing of rects) */
68     QColor grabColor(const QPoint &p, bool destroyImage = true);
69
70     bool m_filterActive;
71     QSpinBox *m_size;
72 #ifdef Q_WS_X11
73     XImage *m_image;
74     KCDPickerFilter *m_filter;
75 #else
76     QImage m_image;
77 #endif 
78
79 private slots:
80     /** @brief Sets up an event filter for picking a color. */
81     void slotSetupEventFilter();
82
83 signals:
84     void colorPicked(QColor);
85     void displayMessage(const QString&, int);
86 };
87
88 #endif