qcolor.h
上传用户:detong
上传日期:2022-06-22
资源大小:20675k
文件大小:7k
源码类别:

系统编程

开发平台:

Unix_Linux

  1. /****************************************************************************
  2. **
  3. ** Copyright (C) 2008 Nokia Corporation and/or its subsidiary(-ies).
  4. ** Contact: Qt Software Information (qt-info@nokia.com)
  5. **
  6. ** This file is part of the QtGui module of the Qt Toolkit.
  7. **
  8. ** Commercial Usage
  9. ** Licensees holding valid Qt Commercial licenses may use this file in
  10. ** accordance with the Qt Commercial License Agreement provided with the
  11. ** Software or, alternatively, in accordance with the terms contained in
  12. ** a written agreement between you and Nokia.
  13. **
  14. **
  15. ** GNU General Public License Usage
  16. ** Alternatively, this file may be used under the terms of the GNU
  17. ** General Public License versions 2.0 or 3.0 as published by the Free
  18. ** Software Foundation and appearing in the file LICENSE.GPL included in
  19. ** the packaging of this file.  Please review the following information
  20. ** to ensure GNU General Public Licensing requirements will be met:
  21. ** http://www.fsf.org/licensing/licenses/info/GPLv2.html and
  22. ** http://www.gnu.org/copyleft/gpl.html.  In addition, as a special
  23. ** exception, Nokia gives you certain additional rights. These rights
  24. ** are described in the Nokia Qt GPL Exception version 1.3, included in
  25. ** the file GPL_EXCEPTION.txt in this package.
  26. **
  27. ** Qt for Windows(R) Licensees
  28. ** As a special exception, Nokia, as the sole copyright holder for Qt
  29. ** Designer, grants users of the Qt/Eclipse Integration plug-in the
  30. ** right for the Qt/Eclipse Integration to link to functionality
  31. ** provided by Qt Designer and its related libraries.
  32. **
  33. ** If you are unsure which license is appropriate for your use, please
  34. ** contact the sales department at qt-sales@nokia.com.
  35. **
  36. ****************************************************************************/
  37. #ifndef QCOLOR_H
  38. #define QCOLOR_H
  39. #include <QtGui/qrgb.h>
  40. #include <QtCore/qnamespace.h>
  41. #include <QtCore/qstringlist.h>
  42. QT_BEGIN_HEADER
  43. QT_BEGIN_NAMESPACE
  44. QT_MODULE(Gui)
  45. class QColor;
  46. class QColormap;
  47. class QVariant;
  48. #ifndef QT_NO_DEBUG_STREAM
  49. Q_GUI_EXPORT QDebug operator<<(QDebug, const QColor &);
  50. #endif
  51. #ifndef QT_NO_DATASTREAM
  52. Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QColor &);
  53. Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QColor &);
  54. #endif
  55. class Q_GUI_EXPORT QColor
  56. {
  57. public:
  58.     enum Spec { Invalid, Rgb, Hsv, Cmyk };
  59.     QColor();
  60.     QColor(Qt::GlobalColor color);
  61.     QColor(int r, int g, int b, int a = 255);
  62.     QColor(QRgb rgb);
  63.     QColor(const QString& name);
  64.     QColor(const char *name);
  65.     QColor(const QColor &color);
  66.     QColor(Spec spec);
  67.     bool isValid() const;
  68.     QString name() const;
  69.     void setNamedColor(const QString& name);
  70.     static QStringList colorNames();
  71.     inline Spec spec() const
  72.     { return cspec; }
  73.     int alpha() const;
  74.     void setAlpha(int alpha);
  75.     qreal alphaF() const;
  76.     void setAlphaF(qreal alpha);
  77.     int red() const;
  78.     int green() const;
  79.     int blue() const;
  80.     void setRed(int red);
  81.     void setGreen(int green);
  82.     void setBlue(int blue);
  83.     qreal redF() const;
  84.     qreal greenF() const;
  85.     qreal blueF() const;
  86.     void setRedF(qreal red);
  87.     void setGreenF(qreal green);
  88.     void setBlueF(qreal blue);
  89.     void getRgb(int *r, int *g, int *b, int *a = 0) const;
  90.     void setRgb(int r, int g, int b, int a = 255);
  91.     void getRgbF(qreal *r, qreal *g, qreal *b, qreal *a = 0) const;
  92.     void setRgbF(qreal r, qreal g, qreal b, qreal a = 1.0);
  93.     QRgb rgba() const;
  94.     void setRgba(QRgb rgba);
  95.     QRgb rgb() const;
  96.     void setRgb(QRgb rgb);
  97.     int hue() const; // 0 <= hue < 360
  98.     int saturation() const;
  99.     int value() const;
  100.     qreal hueF() const; // 0.0 <= hueF < 360.0
  101.     qreal saturationF() const;
  102.     qreal valueF() const;
  103.     void getHsv(int *h, int *s, int *v, int *a = 0) const;
  104.     void setHsv(int h, int s, int v, int a = 255);
  105.     void getHsvF(qreal *h, qreal *s, qreal *v, qreal *a = 0) const;
  106.     void setHsvF(qreal h, qreal s, qreal v, qreal a = 1.0);
  107.     int cyan() const;
  108.     int magenta() const;
  109.     int yellow() const;
  110.     int black() const;
  111.     qreal cyanF() const;
  112.     qreal magentaF() const;
  113.     qreal yellowF() const;
  114.     qreal blackF() const;
  115.     void getCmyk(int *c, int *m, int *y, int *k, int *a = 0);
  116.     void setCmyk(int c, int m, int y, int k, int a = 255);
  117.     void getCmykF(qreal *c, qreal *m, qreal *y, qreal *k, qreal *a = 0);
  118.     void setCmykF(qreal c, qreal m, qreal y, qreal k, qreal a = 1.0);
  119.     QColor toRgb() const;
  120.     QColor toHsv() const;
  121.     QColor toCmyk() const;
  122.     QColor convertTo(Spec colorSpec) const;
  123.     static QColor fromRgb(QRgb rgb);
  124.     static QColor fromRgba(QRgb rgba);
  125.     static QColor fromRgb(int r, int g, int b, int a = 255);
  126.     static QColor fromRgbF(qreal r, qreal g, qreal b, qreal a = 1.0);
  127.     static QColor fromHsv(int h, int s, int v, int a = 255);
  128.     static QColor fromHsvF(qreal h, qreal s, qreal v, qreal a = 1.0);
  129.     static QColor fromCmyk(int c, int m, int y, int k, int a = 255);
  130.     static QColor fromCmykF(qreal c, qreal m, qreal y, qreal k, qreal a = 1.0);
  131.     QColor light(int f = 150) const;
  132.     QColor lighter(int f = 150) const;
  133.     QColor dark(int f = 200) const;
  134.     QColor darker(int f = 200) const;
  135.     QColor &operator=(const QColor &);
  136.     QColor &operator=(Qt::GlobalColor color);
  137.     bool operator==(const QColor &c) const;
  138.     bool operator!=(const QColor &c) const;
  139.     operator QVariant() const;
  140. #ifdef Q_WS_X11
  141.     static bool allowX11ColorNames();
  142.     static void setAllowX11ColorNames(bool enabled);
  143. #endif
  144. #ifdef QT3_SUPPORT
  145.     inline QT3_SUPPORT_CONSTRUCTOR QColor(int x, int y, int z, Spec colorSpec)
  146.     { if (colorSpec == Hsv) setHsv(x, y, z); else setRgb(x, y, z); }
  147.     inline QT3_SUPPORT void rgb(int *r, int *g, int *b) const
  148.     { getRgb(r, g, b); }
  149.     inline QT3_SUPPORT void hsv(int *h, int *s, int *v) const
  150.     { getHsv(h, s, v); }
  151.     inline QT3_SUPPORT void setRgba(int r, int g, int b, int a)
  152.     { setRgb(r, g, b, a); }
  153.     inline QT3_SUPPORT void getRgba(int *r, int *g, int *b, int *a) const
  154.     { getRgb(r, g, b, a); }
  155.     QT3_SUPPORT uint pixel(int screen = -1) const;
  156. #endif
  157. private:
  158. #ifndef QT3_SUPPORT
  159.     // do not allow a spec to be used as an alpha value
  160.     QColor(int, int, int, Spec);
  161. #endif
  162.     void invalidate();
  163.     Spec cspec;
  164.     union {
  165.         struct {
  166.             ushort alpha;
  167.             ushort red;
  168.             ushort green;
  169.             ushort blue;
  170.             ushort pad;
  171.         } argb;
  172.         struct {
  173.             ushort alpha;
  174.             ushort hue;
  175.             ushort saturation;
  176.             ushort value;
  177.             ushort pad;
  178.         } ahsv;
  179.         struct {
  180.             ushort alpha;
  181.             ushort cyan;
  182.             ushort magenta;
  183.             ushort yellow;
  184.             ushort black;
  185.         } acmyk;
  186.     } ct;
  187.     friend class QColormap;
  188. #ifndef QT_NO_DATASTREAM
  189.     friend Q_GUI_EXPORT QDataStream &operator<<(QDataStream &, const QColor &);
  190.     friend Q_GUI_EXPORT QDataStream &operator>>(QDataStream &, QColor &);
  191. #endif
  192. };
  193. inline QColor::QColor()
  194. { invalidate(); }
  195. inline QColor::QColor(int r, int g, int b, int a)
  196. { setRgb(r, g, b, a); }
  197. inline QColor::QColor(const char *aname)
  198. { setNamedColor(QLatin1String(aname)); }
  199. inline QColor::QColor(const QString& aname)
  200. { setNamedColor(aname); }
  201. inline QColor::QColor(const QColor &acolor)
  202.     : cspec(acolor.cspec)
  203. { ct.argb = acolor.ct.argb; }
  204. inline bool QColor::isValid() const
  205. { return cspec != Invalid; }
  206. inline QColor QColor::lighter(int f) const 
  207. { return light(f); }
  208. inline QColor QColor::darker(int f) const 
  209. { return dark(f); }
  210. QT_END_NAMESPACE
  211. QT_END_HEADER
  212. #endif // QCOLOR_H