File indexing completed on 2024-05-19 04:23:09

0001 
0002 /*
0003    Copyright (c) 2003-2007 Clarence Dang <dang@kde.org>
0004    All rights reserved.
0005 
0006    Redistribution and use in source and binary forms, with or without
0007    modification, are permitted provided that the following conditions
0008    are met:
0009 
0010    1. Redistributions of source code must retain the above copyright
0011       notice, this list of conditions and the following disclaimer.
0012    2. Redistributions in binary form must reproduce the above copyright
0013       notice, this list of conditions and the following disclaimer in the
0014       documentation and/or other materials provided with the distribution.
0015 
0016    THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
0017    IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
0018    OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
0019    IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
0020    INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
0021    NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
0022    DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
0023    THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
0024    (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
0025    THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
0026 */
0027 
0028 
0029 #ifndef kpColorSimilarityToolBarItem_H
0030 #define kpColorSimilarityToolBarItem_H
0031 
0032 
0033 #include "widgets/colorSimilarity/kpColorSimilarityHolder.h"
0034 
0035 #include <QToolButton>
0036 
0037 
0038 class QTimer;
0039 
0040 
0041 class kpColorSimilarityToolBarItem : public QToolButton,
0042         public kpColorSimilarityHolder
0043 {
0044 Q_OBJECT
0045 
0046 public:
0047     // (reads the color similarity config setting)
0048     explicit kpColorSimilarityToolBarItem (QWidget *parent);
0049 
0050     int processedColorSimilarity () const;
0051 
0052 private:
0053     // <writeConfig> specifies whether to write the color similarity config
0054     // setting.
0055     void setColorSimilarityInternal (double similarity, bool writeConfig);
0056 public:
0057     void setColorSimilarity (double similarity) override;
0058 
0059 Q_SIGNALS:
0060     void colorSimilarityChanged (double similarity, int processedSimilarity);
0061 
0062 public:
0063     // (only valid in slots connected to colorSimilarityChanged());
0064     double oldColorSimilarity () const;
0065 
0066 
0067 public Q_SLOTS:
0068     // Open configuration dialog for color similarity.
0069     void openDialog ();
0070 
0071 private Q_SLOTS:
0072     void slotFlashTimerTimeout ();
0073 
0074 public:
0075     // Animates the cube, so that the user is aware of its existence.
0076     // Call this whenever a tool or command uses color similarity.
0077     void flash ();
0078 
0079 public:
0080     // Whether to ignore calls to flash().
0081     // You can nest blocks of suppressFlash()/unsuppressFlash().
0082     bool isSuppressingFlash () const;
0083     void suppressFlash ();
0084     void unsupressFlash ();
0085 
0086 
0087 private:
0088     void updateToolTip ();
0089     void updateIcon ();
0090 
0091     void resizeEvent (QResizeEvent *e) override;
0092 
0093 
0094 private:
0095     double m_oldColorSimilarity;
0096     int m_processedColorSimilarity;
0097 
0098     QTimer *m_flashTimer;
0099     int m_flashHighlight;
0100     int m_suppressingFlashCounter;
0101 };
0102 
0103 
0104 #endif  // kpColorSimilarityToolBarItem_H