1 /***************************************************************************
2 * Copyright (C) 2010 by Till Theato (root@ttill.de) *
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. *
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. *
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 ***************************************************************************/
21 #ifndef COLORPICKERWIDGET_H
22 #define COLORPICKERWIDGET_H
30 class KCDPickerFilter;
34 * @class ColorPickerWidget
35 * @brief A widget to pick a color anywhere on the screen.
38 * The code is partially based on the color picker in KColorDialog.
41 class ColorPickerWidget : public QWidget
46 /** @brief Sets up the widget. */
47 ColorPickerWidget(QWidget *parent = 0);
48 /** @brief Makes sure the event filter is removed. */
49 virtual ~ColorPickerWidget();
52 virtual void mousePressEvent(QMouseEvent *event);
53 virtual void mouseReleaseEvent(QMouseEvent *event);
54 virtual void keyPressEvent(QKeyEvent *event);
57 /** @brief Closes the event filter and makes mouse and keyboard work again on other widgets/windows. */
58 void closeEventFilter();
60 /** @brief Calculates the average color for a rect around @param pos with m_size->value() as width. */
62 QColor averagePickedColor(const QPoint pos);
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);
74 KCDPickerFilter *m_filter;
80 /** @brief Sets up an event filter for picking a color. */
81 void slotSetupEventFilter();
84 void colorPicked(QColor);
85 void displayMessage(const QString&, int);