1021 lines
28 KiB
C++
1021 lines
28 KiB
C++
/***************************************************************************
|
|
|
|
qcolor.cpp
|
|
|
|
(c) 2000-2017 Benoît Minisini <benoit.minisini@gambas-basic.org>
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 2, or (at your option)
|
|
any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with this program; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
|
|
MA 02110-1301, USA.
|
|
|
|
***************************************************************************/
|
|
|
|
/****************************************************************************
|
|
** $Id: qt/qcolor.cpp 3.3.4 edited Dec 22 17:04 $
|
|
**
|
|
** Implementation of QColor class
|
|
**
|
|
** Created : 940112
|
|
**
|
|
** Copyright (C) 1992-2002 Trolltech AS. All rights reserved.
|
|
**
|
|
** This file is part of the kernel module of the Qt GUI Toolkit.
|
|
**
|
|
** This file may be distributed under the terms of the Q Public License
|
|
** as defined by Trolltech AS of Norway and appearing in the file
|
|
** LICENSE.QPL included in the packaging of this file.
|
|
**
|
|
** This file may be distributed and/or modified under the terms of the
|
|
** GNU General Public License version 2 as published by the Free Software
|
|
** Foundation and appearing in the file LICENSE.GPL included in the
|
|
** packaging of this file.
|
|
**
|
|
** Licensees holding valid Qt Enterprise Edition or Qt Professional Edition
|
|
** licenses may use this file in accordance with the Qt Commercial License
|
|
** Agreement provided with the Software.
|
|
**
|
|
** This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
|
|
** WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
|
|
**
|
|
** See http://www.trolltech.com/pricing.html or email sales@trolltech.com for
|
|
** information about Qt Commercial License Agreements.
|
|
** See http://www.trolltech.com/qpl/ for QPL licensing information.
|
|
** See http://www.trolltech.com/gpl/ for GPL licensing information.
|
|
**
|
|
** Contact info@trolltech.com if any conditions of this licensing are
|
|
** not clear to you.
|
|
**
|
|
**********************************************************************/
|
|
|
|
#include "qcolor.h"
|
|
//#include "qnamespace.h"
|
|
//#include "qdatastream.h"
|
|
|
|
#include <stdio.h>
|
|
|
|
|
|
/*!
|
|
\class QColor qcolor.h
|
|
\brief The QColor class provides colors based on RGB or HSV values.
|
|
|
|
\ingroup images
|
|
\ingroup graphics
|
|
\ingroup appearance
|
|
|
|
A color is normally specified in terms of RGB (red, green and blue)
|
|
components, but it is also possible to specify HSV (hue, saturation
|
|
and value) or set a color name (the names are copied from from the
|
|
X11 color database).
|
|
|
|
In addition to the RGB value, a QColor also has a pixel value and a
|
|
validity. The pixel value is used by the underlying window system
|
|
to refer to a color. It can be thought of as an index into the
|
|
display hardware's color table.
|
|
|
|
The validity (isValid()) indicates whether the color is legal at
|
|
all. For example, a RGB color with RGB values out of range is
|
|
illegal. For performance reasons, QColor mostly disregards illegal
|
|
colors. The result of using an invalid color is unspecified and
|
|
will usually be surprising.
|
|
|
|
There are 19 predefined QColor objects: \c white, \c black, \c
|
|
red, \c darkRed, \c green, \c darkGreen, \c blue, \c darkBlue, \c
|
|
cyan, \c darkCyan, \c magenta, \c darkMagenta, \c yellow, \c
|
|
darkYellow, \c gray, \c darkGray, \c lightGray, \c color0 and \c
|
|
color1, accessible as members of the Qt namespace (ie. \c Qt::red).
|
|
|
|
\img qt-colors.png Qt Colors
|
|
|
|
The colors \c color0 (zero pixel value) and \c color1 (non-zero
|
|
pixel value) are special colors for drawing in \link QBitmap
|
|
bitmaps\endlink. Painting with \c color0 sets the bitmap bits to 0
|
|
(transparent, i.e. background), and painting with \c color1 sets the
|
|
bits to 1 (opaque, i.e. foreground).
|
|
|
|
The QColor class has an efficient, dynamic color allocation
|
|
strategy. A color is normally allocated the first time it is used
|
|
(lazy allocation), that is, whenever the pixel() function is called.
|
|
The following steps are taken to allocate a color. If, at any point,
|
|
a suitable color is found then the appropriate pixel value is
|
|
returned and the subsequent steps are not taken:
|
|
|
|
\list 1
|
|
\i Is the pixel value valid? If it is, just return it; otherwise,
|
|
allocate a pixel value.
|
|
\i Check an internal hash table to see if we allocated an equal RGB
|
|
value earlier. If we did, set the corresponding pixel value for the
|
|
color and return it.
|
|
\i Try to allocate the RGB value. If we succeed, we get a pixel value
|
|
that we save in the internal table with the RGB value.
|
|
Return the pixel value.
|
|
\i The color could not be allocated. Find the closest matching
|
|
color, save it in the internal table, and return it.
|
|
\endlist
|
|
|
|
A color can be set by passing setNamedColor() an RGB string like
|
|
"#112233", or a color name, e.g. "blue". The names are taken from
|
|
X11's rgb.txt database but can also be used under Windows. To get
|
|
a lighter or darker color use light() and dark() respectively.
|
|
Colors can also be set using setRgb() and setHsv(). The color
|
|
components can be accessed in one go with rgb() and hsv(), or
|
|
individually with red(), green() and blue().
|
|
|
|
Use maxColors() and numBitPlanes() to determine the maximum number
|
|
of colors and the number of bit planes supported by the underlying
|
|
window system,
|
|
|
|
If you need to allocate many colors temporarily, for example in an
|
|
image viewer application, enterAllocContext(), leaveAllocContext() and
|
|
destroyAllocContext() will prove useful.
|
|
|
|
\section1 HSV Colors
|
|
|
|
Because many people don't know the HSV color model very well, we'll
|
|
cover it briefly here.
|
|
|
|
The RGB model is hardware-oriented. Its representation is close to
|
|
what most monitors show. In contrast, HSV represents color in a way
|
|
more suited to the human perception of color. For example, the
|
|
relationships "stronger than", "darker than" and "the opposite of"
|
|
are easily expressed in HSV but are much harder to express in RGB.
|
|
|
|
HSV, like RGB, has three components:
|
|
|
|
\list
|
|
|
|
\i H, for hue, is either 0-359 if the color is chromatic (not
|
|
gray), or meaningless if it is gray. It represents degrees on the
|
|
color wheel familiar to most people. Red is 0 (degrees), green is
|
|
120 and blue is 240.
|
|
|
|
\i S, for saturation, is 0-255, and the bigger it is, the
|
|
stronger the color is. Grayish colors have saturation near 0; very
|
|
strong colors have saturation near 255.
|
|
|
|
\i V, for value, is 0-255 and represents lightness or brightness
|
|
of the color. 0 is black; 255 is as far from black as possible.
|
|
|
|
\endlist
|
|
|
|
Here are some examples: Pure red is H=0, S=255, V=255. A dark red,
|
|
moving slightly towards the magenta, could be H=350 (equivalent to
|
|
-10), S=255, V=180. A grayish light red could have H about 0 (say
|
|
350-359 or 0-10), S about 50-100, and S=255.
|
|
|
|
Qt returns a hue value of -1 for achromatic colors. If you pass a
|
|
too-big hue value, Qt forces it into range. Hue 360 or 720 is
|
|
treated as 0; hue 540 is treated as 180.
|
|
|
|
\sa QPalette, QColorGroup, QApplication::setColorSpec(),
|
|
\link http://www.inforamp.net/~poynton/Poynton-color.html Color FAQ\endlink
|
|
*/
|
|
|
|
/*****************************************************************************
|
|
Global colors
|
|
*****************************************************************************/
|
|
|
|
#if defined(Q_WS_WIN)
|
|
#define COLOR0_PIX 0x00ffffff
|
|
#define COLOR1_PIX 0
|
|
#else
|
|
#define COLOR0_PIX 0
|
|
#define COLOR1_PIX 1
|
|
#endif
|
|
|
|
#if 0
|
|
static QColor stdcol[19];
|
|
|
|
QT_STATIC_CONST_IMPL QColor & Qt::color0 = stdcol[0];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::color1 = stdcol[1];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::black = stdcol[2];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::white = stdcol[3];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::darkGray = stdcol[4];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::gray = stdcol[5];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::lightGray = stdcol[6];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::red = stdcol[7];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::green = stdcol[8];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::blue = stdcol[9];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::cyan = stdcol[10];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::magenta = stdcol[11];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::yellow = stdcol[12];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::darkRed = stdcol[13];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::darkGreen = stdcol[14];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::darkBlue = stdcol[15];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::darkCyan = stdcol[16];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::darkMagenta = stdcol[17];
|
|
QT_STATIC_CONST_IMPL QColor & Qt::darkYellow = stdcol[18];
|
|
#endif
|
|
|
|
/*****************************************************************************
|
|
QColor member functions
|
|
*****************************************************************************/
|
|
|
|
bool QColor::color_init = FALSE; // color system not initialized
|
|
bool QColor::globals_init = FALSE; // global color not initialized
|
|
QColor::ColorModel QColor::colormodel = d32;
|
|
|
|
#if 0
|
|
QColor* QColor::globalColors()
|
|
{
|
|
return stdcol;
|
|
}
|
|
#endif
|
|
|
|
/*!
|
|
Initializes the global colors. This function is called if a global
|
|
color variable is initialized before the constructors for our
|
|
global color objects are executed. Without this mechanism,
|
|
assigning a color might assign an uninitialized value.
|
|
|
|
Example:
|
|
\code
|
|
QColor myColor = red; // will initialize red etc.
|
|
|
|
int main( int argc, char **argc )
|
|
{
|
|
}
|
|
\endcode
|
|
*/
|
|
|
|
#if 0
|
|
void QColor::initGlobalColors()
|
|
{
|
|
globals_init = TRUE;
|
|
|
|
#if 0
|
|
#ifdef Q_WS_X11
|
|
// HACK: we need a way to recognize color0 and color1 uniquely, so
|
|
// that we can use color0 and color1 with fixed pixel values on
|
|
// all screens
|
|
stdcol[ 0].d.argb = qRgba(255, 255, 255, 1);
|
|
stdcol[ 1].d.argb = qRgba( 0, 0, 0, 1);
|
|
#else
|
|
stdcol[ 0].d.argb = qRgb(255,255,255);
|
|
stdcol[ 1].d.argb = 0;
|
|
#endif // Q_WS_X11
|
|
stdcol[ 0].setPixel( COLOR0_PIX );
|
|
stdcol[ 1].setPixel( COLOR1_PIX );
|
|
|
|
// From the "The Palette Manager: How and Why" by Ron Gery, March 23,
|
|
// 1992, archived on MSDN:
|
|
// The Windows system palette is broken up into two sections,
|
|
// one with fixed colors and one with colors that can be changed
|
|
// by applications. The system palette predefines 20 entries;
|
|
// these colors are known as the static or reserved colors and
|
|
// consist of the 16 colors found in the Windows version 3.0 VGA
|
|
// driver and 4 additional colors chosen for their visual appeal.
|
|
// The DEFAULT_PALETTE stock object is, as the name implies, the
|
|
// default palette selected into a device context (DC) and consists
|
|
// of these static colors. Applications can set the remaining 236
|
|
// colors using the Palette Manager.
|
|
// The 20 reserved entries have indices in [0,9] and [246,255]. We
|
|
// reuse 17 of them.
|
|
stdcol[ 2].setRgb( 0, 0, 0 ); // index 0 black
|
|
stdcol[ 3].setRgb( 255, 255, 255 ); // index 255 white
|
|
stdcol[ 4].setRgb( 128, 128, 128 ); // index 248 medium gray
|
|
stdcol[ 5].setRgb( 160, 160, 164 ); // index 247 light gray
|
|
stdcol[ 6].setRgb( 192, 192, 192 ); // index 7 light gray
|
|
stdcol[ 7].setRgb( 255, 0, 0 ); // index 249 red
|
|
stdcol[ 8].setRgb( 0, 255, 0 ); // index 250 green
|
|
stdcol[ 9].setRgb( 0, 0, 255 ); // index 252 blue
|
|
stdcol[10].setRgb( 0, 255, 255 ); // index 254 cyan
|
|
stdcol[11].setRgb( 255, 0, 255 ); // index 253 magenta
|
|
stdcol[12].setRgb( 255, 255, 0 ); // index 251 yellow
|
|
stdcol[13].setRgb( 128, 0, 0 ); // index 1 dark red
|
|
stdcol[14].setRgb( 0, 128, 0 ); // index 2 dark green
|
|
stdcol[15].setRgb( 0, 0, 128 ); // index 4 dark blue
|
|
stdcol[16].setRgb( 0, 128, 128 ); // index 6 dark cyan
|
|
stdcol[17].setRgb( 128, 0, 128 ); // index 5 dark magenta
|
|
stdcol[18].setRgb( 128, 128, 0 ); // index 3 dark yellow
|
|
#endif
|
|
}
|
|
#endif
|
|
|
|
/*!
|
|
\enum QColor::Spec
|
|
|
|
The type of color specified, either RGB or HSV, e.g. in the
|
|
\c{QColor::QColor( x, y, z, colorSpec)} constructor.
|
|
|
|
\value Rgb
|
|
\value Hsv
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn QColor::QColor()
|
|
|
|
Constructs an invalid color with the RGB value (0, 0, 0). An
|
|
invalid color is a color that is not properly set up for the
|
|
underlying window system.
|
|
|
|
The alpha value of an invalid color is unspecified.
|
|
|
|
\sa isValid()
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn QColor::QColor( int r, int g, int b )
|
|
|
|
Constructs a color with the RGB value \a r, \a g, \a b, in the
|
|
same way as setRgb().
|
|
|
|
The color is left invalid if any or the arguments are illegal.
|
|
|
|
\sa setRgb()
|
|
*/
|
|
|
|
|
|
/*!
|
|
Constructs a color with the RGB value \a rgb and a custom pixel
|
|
value \a pixel.
|
|
|
|
If \a pixel == 0xffffffff (the default), then the color uses the
|
|
RGB value in a standard way. If \a pixel is something else, then
|
|
the pixel value is set directly to \a pixel, skipping the normal
|
|
allocation procedure.
|
|
*/
|
|
|
|
QColor::QColor( QRgb rgb, uint pixel )
|
|
{
|
|
if ( pixel == 0xffffffff ) {
|
|
setRgb( rgb );
|
|
} else {
|
|
d.argb = rgb;
|
|
setPixel( pixel );
|
|
}
|
|
}
|
|
|
|
void QColor::setPixel( uint pixel )
|
|
{
|
|
switch ( colormodel ) {
|
|
case d8:
|
|
d.d8.direct = TRUE;
|
|
d.d8.invalid = FALSE;
|
|
d.d8.dirty = FALSE;
|
|
d.d8.pix = pixel;
|
|
break;
|
|
case d32:
|
|
d.d32.pix = pixel;
|
|
break;
|
|
}
|
|
}
|
|
|
|
|
|
/*!
|
|
Constructs a color with the RGB or HSV value \a x, \a y, \a z.
|
|
|
|
The arguments are an RGB value if \a colorSpec is QColor::Rgb. \a
|
|
x (red), \a y (green), and \a z (blue). All of them must be in the
|
|
range 0-255.
|
|
|
|
The arguments are an HSV value if \a colorSpec is QColor::Hsv. \a
|
|
x (hue) must be -1 for achromatic colors and 0-359 for chromatic
|
|
colors; \a y (saturation) and \a z (value) must both be in the
|
|
range 0-255.
|
|
|
|
\sa setRgb(), setHsv()
|
|
*/
|
|
|
|
QColor::QColor( int x, int y, int z, Spec colorSpec )
|
|
{
|
|
d.d32.argb = Invalid;
|
|
d.d32.pix = Dirt;
|
|
if ( colorSpec == Hsv )
|
|
setHsv( x, y, z );
|
|
else
|
|
setRgb( x, y, z );
|
|
}
|
|
|
|
|
|
/*!
|
|
Constructs a named color in the same way as setNamedColor() using
|
|
name \a name.
|
|
|
|
The color is left invalid if \a name cannot be parsed.
|
|
|
|
\sa setNamedColor()
|
|
*/
|
|
|
|
#if 0
|
|
QColor::QColor( const QString& name )
|
|
{
|
|
setNamedColor( name );
|
|
}
|
|
#endif
|
|
|
|
/*!
|
|
Constructs a named color in the same way as setNamedColor() using
|
|
name \a name.
|
|
|
|
The color is left invalid if \a name cannot be parsed.
|
|
|
|
\sa setNamedColor()
|
|
*/
|
|
|
|
#if 0
|
|
QColor::QColor( const char *name )
|
|
{
|
|
setNamedColor( QString(name) );
|
|
}
|
|
#endif
|
|
|
|
|
|
/*!
|
|
Constructs a color that is a copy of \a c.
|
|
*/
|
|
|
|
QColor::QColor( const QColor &c )
|
|
{
|
|
//if ( !globals_init )
|
|
//initGlobalColors();
|
|
d.argb = c.d.argb;
|
|
d.d32.pix = c.d.d32.pix;
|
|
}
|
|
|
|
|
|
/*!
|
|
Assigns a copy of the color \a c and returns a reference to this
|
|
color.
|
|
*/
|
|
|
|
QColor &QColor::operator=( const QColor &c )
|
|
{
|
|
//if ( !globals_init )
|
|
//initGlobalColors();
|
|
d.argb = c.d.argb;
|
|
d.d32.pix = c.d.d32.pix;
|
|
return *this;
|
|
}
|
|
|
|
|
|
/*!
|
|
\fn bool QColor::isValid() const
|
|
|
|
Returns FALSE if the color is invalid, i.e. it was constructed using the
|
|
default constructor; otherwise returns TRUE.
|
|
*/
|
|
|
|
/*!
|
|
\internal
|
|
*/
|
|
bool QColor::isDirty() const
|
|
{
|
|
if ( colormodel == d8 ) {
|
|
return d.d8.dirty;
|
|
} else {
|
|
return d.d32.probablyDirty();
|
|
}
|
|
}
|
|
|
|
/*!
|
|
Returns the name of the color in the format "#RRGGBB", i.e. a "#"
|
|
character followed by three two-digit hexadecimal numbers.
|
|
|
|
\sa setNamedColor()
|
|
*/
|
|
|
|
#if 0
|
|
QString QColor::name() const
|
|
{
|
|
#ifndef QT_NO_SPRINTF
|
|
QString s;
|
|
s.sprintf( "#%02x%02x%02x", red(), green(), blue() );
|
|
return s;
|
|
#else
|
|
char s[20];
|
|
sprintf( s, "#%02x%02x%02x", red(), green(), blue() );
|
|
return QString(s);
|
|
#endif
|
|
}
|
|
|
|
static int hex2int( QChar hexchar )
|
|
{
|
|
int v;
|
|
if ( hexchar.isDigit() )
|
|
v = hexchar.digitValue();
|
|
else if ( hexchar >= 'A' && hexchar <= 'F' )
|
|
v = hexchar.cell() - 'A' + 10;
|
|
else if ( hexchar >= 'a' && hexchar <= 'f' )
|
|
v = hexchar.cell() - 'a' + 10;
|
|
else
|
|
v = -1;
|
|
return v;
|
|
}
|
|
#endif
|
|
|
|
|
|
/*!
|
|
Sets the RGB value to \a name, which may be in one of these
|
|
formats:
|
|
\list
|
|
\i #RGB (each of R, G and B is a single hex digit)
|
|
\i #RRGGBB
|
|
\i #RRRGGGBBB
|
|
\i #RRRRGGGGBBBB
|
|
\i A name from the X color database (rgb.txt) (e.g.
|
|
"steelblue" or "gainsboro"). These color names also work
|
|
under Windows.
|
|
\endlist
|
|
|
|
The color is invalid if \a name cannot be parsed.
|
|
*/
|
|
|
|
#if 0
|
|
void QColor::setNamedColor( const QString &name )
|
|
{
|
|
if ( name.isEmpty() ) {
|
|
d.argb = 0;
|
|
if ( colormodel == d8 ) {
|
|
d.d8.invalid = TRUE;
|
|
} else {
|
|
d.d32.argb = Invalid;
|
|
}
|
|
} else if ( name[0] == '#' ) {
|
|
const QChar *p = name.unicode()+1;
|
|
int len = name.length()-1;
|
|
int r, g, b;
|
|
if ( len == 12 ) {
|
|
r = (hex2int(p[0]) << 4) + hex2int(p[1]);
|
|
g = (hex2int(p[4]) << 4) + hex2int(p[5]);
|
|
b = (hex2int(p[8]) << 4) + hex2int(p[9]);
|
|
} else if ( len == 9 ) {
|
|
r = (hex2int(p[0]) << 4) + hex2int(p[1]);
|
|
g = (hex2int(p[3]) << 4) + hex2int(p[4]);
|
|
b = (hex2int(p[6]) << 4) + hex2int(p[7]);
|
|
} else if ( len == 6 ) {
|
|
r = (hex2int(p[0]) << 4) + hex2int(p[1]);
|
|
g = (hex2int(p[2]) << 4) + hex2int(p[3]);
|
|
b = (hex2int(p[4]) << 4) + hex2int(p[5]);
|
|
} else if ( len == 3 ) {
|
|
r = (hex2int(p[0]) << 4) + hex2int(p[0]);
|
|
g = (hex2int(p[1]) << 4) + hex2int(p[1]);
|
|
b = (hex2int(p[2]) << 4) + hex2int(p[2]);
|
|
} else {
|
|
r = g = b = -1;
|
|
}
|
|
if ( (uint)r > 255 || (uint)g > 255 || (uint)b > 255 ) {
|
|
d.d32.argb = Invalid;
|
|
d.d32.pix = Dirt;
|
|
#if defined(QT_CHECK_RANGE)
|
|
qWarning( "QColor::setNamedColor: could not parse color '%s'",
|
|
name.local8Bit().data() );
|
|
#endif
|
|
} else {
|
|
setRgb( r, g, b );
|
|
}
|
|
} else {
|
|
setSystemNamedColor( name );
|
|
}
|
|
}
|
|
#endif
|
|
|
|
#undef max
|
|
#undef min
|
|
|
|
/*!
|
|
\fn void QColor::getHsv( int &h, int &s, int &v ) const
|
|
\obsolete
|
|
*/
|
|
|
|
/*! \fn void QColor::getHsv( int *h, int *s, int *v ) const
|
|
|
|
Returns the current RGB value as HSV. The contents of the \a h, \a
|
|
s and \a v pointers are set to the HSV values. If any of the three
|
|
pointers are null, the function does nothing.
|
|
|
|
The hue (which \a h points to) is set to -1 if the color is
|
|
achromatic.
|
|
|
|
\warning Colors are stored internally as RGB values, so getHSv()
|
|
may return slightly different values to those set by setHsv().
|
|
|
|
\sa setHsv(), rgb()
|
|
*/
|
|
|
|
/*! \obsolete Use getHsv() instead.
|
|
*/
|
|
void QColor::hsv( int *h, int *s, int *v) const
|
|
{
|
|
if ( !h || !s || !v )
|
|
return;
|
|
int r = qRed(d.argb);
|
|
int g = qGreen(d.argb);
|
|
int b = qBlue(d.argb);
|
|
uint max = r; // maximum RGB component
|
|
int whatmax = 0; // r=>0, g=>1, b=>2
|
|
if ( (uint)g > max ) {
|
|
max = g;
|
|
whatmax = 1;
|
|
}
|
|
if ( (uint)b > max ) {
|
|
max = b;
|
|
whatmax = 2;
|
|
}
|
|
uint min = r; // find minimum value
|
|
if ( (uint)g < min ) min = g;
|
|
if ( (uint)b < min ) min = b;
|
|
int delta = max-min;
|
|
*v = max; // calc value
|
|
*s = max ? (510*delta+max)/(2*max) : 0;
|
|
if ( *s == 0 ) {
|
|
*h = -1; // undefined hue
|
|
} else {
|
|
switch ( whatmax ) {
|
|
case 0: // red is max component
|
|
if ( g >= b )
|
|
*h = (120*(g-b)+delta)/(2*delta);
|
|
else
|
|
*h = (120*(g-b+delta)+delta)/(2*delta) + 300;
|
|
break;
|
|
case 1: // green is max component
|
|
if ( b > r )
|
|
*h = 120 + (120*(b-r)+delta)/(2*delta);
|
|
else
|
|
*h = 60 + (120*(b-r+delta)+delta)/(2*delta);
|
|
break;
|
|
case 2: // blue is max component
|
|
if ( r > g )
|
|
*h = 240 + (120*(r-g)+delta)/(2*delta);
|
|
else
|
|
*h = 180 + (120*(r-g+delta)+delta)/(2*delta);
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
|
|
/*!
|
|
Sets a HSV color value. \a h is the hue, \a s is the saturation
|
|
and \a v is the value of the HSV color.
|
|
|
|
If \a s or \a v are not in the range 0-255, or \a h is < -1, the
|
|
color is not changed.
|
|
|
|
\warning Colors are stored internally as RGB values, so getHSv()
|
|
may return slightly different values to those set by setHsv().
|
|
|
|
\sa hsv(), setRgb()
|
|
*/
|
|
|
|
void QColor::setHsv( int h, int s, int v )
|
|
{
|
|
if ( h < -1 || (uint)s > 255 || (uint)v > 255 ) {
|
|
#if defined(QT_CHECK_RANGE)
|
|
qWarning( "QColor::setHsv: HSV parameters out of range" );
|
|
#endif
|
|
return;
|
|
}
|
|
int r=v, g=v, b=v;
|
|
if ( s == 0 || h == -1 ) { // achromatic case
|
|
// Ignore
|
|
} else { // chromatic case
|
|
if ( (uint)h >= 360 )
|
|
h %= 360;
|
|
uint f = h%60;
|
|
h /= 60;
|
|
uint p = (uint)(2*v*(255-s)+255)/510;
|
|
uint q, t;
|
|
if ( h&1 ) {
|
|
q = (uint)(2*v*(15300-s*f)+15300)/30600;
|
|
switch( h ) {
|
|
case 1: r=(int)q; g=(int)v, b=(int)p; break;
|
|
case 3: r=(int)p; g=(int)q, b=(int)v; break;
|
|
case 5: r=(int)v; g=(int)p, b=(int)q; break;
|
|
}
|
|
} else {
|
|
t = (uint)(2*v*(15300-(s*(60-f)))+15300)/30600;
|
|
switch( h ) {
|
|
case 0: r=(int)v; g=(int)t, b=(int)p; break;
|
|
case 2: r=(int)p; g=(int)v, b=(int)t; break;
|
|
case 4: r=(int)t; g=(int)p, b=(int)v; break;
|
|
}
|
|
}
|
|
}
|
|
setRgb( r, g, b );
|
|
}
|
|
|
|
|
|
/*!
|
|
\fn QRgb QColor::rgb() const
|
|
|
|
Returns the RGB value.
|
|
|
|
The return type \e QRgb is equivalent to \c unsigned \c int.
|
|
|
|
For an invalid color, the alpha value of the returned color is
|
|
unspecified.
|
|
|
|
\sa setRgb(), hsv(), qRed(), qBlue(), qGreen(), isValid()
|
|
*/
|
|
|
|
/*! \fn void QColor::getRgb( int *r, int *g, int *b ) const
|
|
|
|
Sets the contents pointed to by \a r, \a g and \a b to the red,
|
|
green and blue components of the RGB value respectively. The value
|
|
range for a component is 0..255.
|
|
|
|
\sa rgb(), setRgb(), getHsv()
|
|
*/
|
|
|
|
/*! \obsolete Use getRgb() instead */
|
|
void QColor::rgb( int *r, int *g, int *b) const
|
|
{
|
|
*r = qRed(d.argb);
|
|
*g = qGreen(d.argb);
|
|
*b = qBlue(d.argb);
|
|
}
|
|
|
|
|
|
/*!
|
|
Sets the RGB value to \a r, \a g, \a b. The arguments, \a r, \a g
|
|
and \a b must all be in the range 0..255. If any of them are
|
|
outside the legal range, the color is not changed.
|
|
|
|
\sa rgb(), setHsv()
|
|
*/
|
|
|
|
void QColor::setRgb( int r, int g, int b)
|
|
{
|
|
/* if ( (uint)r > 255 || (uint)g > 255 || (uint)b > 255 ) {
|
|
#if defined(QT_CHECK_RANGE)
|
|
qWarning( "QColor::setRgb: RGB parameter(s) out of range" );
|
|
#endif
|
|
return;
|
|
}*/
|
|
d.argb = qRgba( r, g, b, alpha() );
|
|
if ( colormodel == d8 ) {
|
|
d.d8.invalid = FALSE;
|
|
d.d8.direct = FALSE;
|
|
d.d8.dirty = TRUE;
|
|
} else {
|
|
d.d32.pix = Dirt;
|
|
}
|
|
}
|
|
|
|
|
|
/*!
|
|
\overload
|
|
Sets the RGB value to \a rgb.
|
|
|
|
The type \e QRgb is equivalent to \c unsigned \c int.
|
|
|
|
\sa rgb(), setHsv()
|
|
*/
|
|
|
|
void QColor::setRgb( QRgb rgb )
|
|
{
|
|
d.argb = rgb;
|
|
if ( colormodel == d8 ) {
|
|
d.d8.invalid = FALSE;
|
|
d.d8.direct = FALSE;
|
|
d.d8.dirty = TRUE;
|
|
} else {
|
|
d.d32.pix = Dirt;
|
|
}
|
|
}
|
|
|
|
/*!
|
|
\fn int QColor::red() const
|
|
|
|
Returns the R (red) component of the RGB value.
|
|
*/
|
|
|
|
|
|
/*!
|
|
\fn int QColor::green() const
|
|
|
|
Returns the G (green) component of the RGB value.
|
|
*/
|
|
|
|
/*!
|
|
\fn int QColor::blue() const
|
|
|
|
Returns the B (blue) component of the RGB value.
|
|
*/
|
|
|
|
|
|
/*!
|
|
Returns a lighter (or darker) color, but does not change this
|
|
object.
|
|
|
|
Returns a lighter color if \a factor is greater than 100. Setting
|
|
\a factor to 150 returns a color that is 50% brighter.
|
|
|
|
Returns a darker color if \a factor is less than 100. We recommend
|
|
using dark() for this purpose. If \a factor is 0 or negative, the
|
|
return value is unspecified.
|
|
|
|
(This function converts the current RGB color to HSV, multiplies V
|
|
by \a factor, and converts the result back to RGB.)
|
|
|
|
\sa dark()
|
|
*/
|
|
|
|
QColor QColor::light( int factor ) const
|
|
{
|
|
if ( factor <= 0 ) // invalid lightness factor
|
|
return *this;
|
|
else if ( factor < 100 ) // makes color darker
|
|
return dark( 10000/factor );
|
|
|
|
int h, s, v;
|
|
hsv( &h, &s, &v );
|
|
v = (factor*v)/100;
|
|
if ( v > 255 ) { // overflow
|
|
s -= v-255; // adjust saturation
|
|
if ( s < 0 )
|
|
s = 0;
|
|
v = 255;
|
|
}
|
|
QColor c;
|
|
c.setHsv( h, s, v );
|
|
return c;
|
|
}
|
|
|
|
|
|
/*!
|
|
Returns a darker (or lighter) color, but does not change this
|
|
object.
|
|
|
|
Returns a darker color if \a factor is greater than 100. Setting
|
|
\a factor to 300 returns a color that has one-third the
|
|
brightness.
|
|
|
|
Returns a lighter color if \a factor is less than 100. We
|
|
recommend using lighter() for this purpose. If \a factor is 0 or
|
|
negative, the return value is unspecified.
|
|
|
|
(This function converts the current RGB color to HSV, divides V by
|
|
\a factor and converts back to RGB.)
|
|
|
|
\sa light()
|
|
*/
|
|
|
|
QColor QColor::dark( int factor ) const
|
|
{
|
|
if ( factor <= 0 ) // invalid darkness factor
|
|
return *this;
|
|
else if ( factor < 100 ) // makes color lighter
|
|
return light( 10000/factor );
|
|
int h, s, v;
|
|
hsv( &h, &s, &v );
|
|
v = (v*100)/factor;
|
|
QColor c;
|
|
c.setHsv( h, s, v );
|
|
return c;
|
|
}
|
|
|
|
|
|
/*!
|
|
\fn bool QColor::operator==( const QColor &c ) const
|
|
|
|
Returns TRUE if this color has the same RGB value as \a c;
|
|
otherwise returns FALSE.
|
|
*/
|
|
|
|
/*!
|
|
\fn bool QColor::operator!=( const QColor &c ) const
|
|
Returns TRUE if this color has a different RGB value from \a c;
|
|
otherwise returns FALSE.
|
|
*/
|
|
|
|
/*!
|
|
Returns the pixel value.
|
|
|
|
This value is used by the underlying window system to refer to a
|
|
color. It can be thought of as an index into the display
|
|
hardware's color table, but the value is an arbitrary 32-bit
|
|
value.
|
|
|
|
\sa alloc()
|
|
*/
|
|
|
|
/*!
|
|
\fn QStringList QColor::colorNames()
|
|
Returns a QStringList containing the color names Qt knows about.
|
|
*/
|
|
|
|
/*****************************************************************************
|
|
QColor stream functions
|
|
*****************************************************************************/
|
|
#ifndef QT_NO_DATASTREAM
|
|
/*!
|
|
\relates QColor
|
|
Writes a color object, \a c to the stream, \a s.
|
|
|
|
\sa \link datastreamformat.html Format of the QDataStream operators \endlink
|
|
*/
|
|
|
|
QDataStream &operator<<( QDataStream &s, const QColor &c )
|
|
{
|
|
Q_UINT32 p = (Q_UINT32)c.rgb();
|
|
if ( s.version() == 1 ) // Swap red and blue
|
|
p = ((p << 16) & 0xff0000) | ((p >> 16) & 0xff) | (p & 0xff00ff00);
|
|
return s << p;
|
|
}
|
|
|
|
/*!
|
|
\relates QColor
|
|
Reads a color object, \a c, from the stream, \a s.
|
|
|
|
\sa \link datastreamformat.html Format of the QDataStream operators \endlink
|
|
*/
|
|
|
|
QDataStream &operator>>( QDataStream &s, QColor &c )
|
|
{
|
|
Q_UINT32 p;
|
|
s >> p;
|
|
if ( s.version() == 1 ) // Swap red and blue
|
|
p = ((p << 16) & 0xff0000) | ((p >> 16) & 0xff) | (p & 0xff00ff00);
|
|
c.setRgb( p );
|
|
return s;
|
|
}
|
|
#endif
|
|
|
|
/*****************************************************************************
|
|
QColor global functions (documentation only)
|
|
*****************************************************************************/
|
|
|
|
/*!
|
|
\fn int qRed( QRgb rgb )
|
|
\relates QColor
|
|
|
|
Returns the red component of the RGB triplet \a rgb.
|
|
\sa qRgb(), QColor::red()
|
|
*/
|
|
|
|
/*!
|
|
\fn int qGreen( QRgb rgb )
|
|
\relates QColor
|
|
|
|
Returns the green component of the RGB triplet \a rgb.
|
|
\sa qRgb(), QColor::green()
|
|
*/
|
|
|
|
/*!
|
|
\fn int qBlue( QRgb rgb )
|
|
\relates QColor
|
|
|
|
Returns the blue component of the RGB triplet \a rgb.
|
|
\sa qRgb(), QColor::blue()
|
|
*/
|
|
|
|
/*!
|
|
\fn int qAlpha( QRgb rgba )
|
|
\relates QColor
|
|
|
|
Returns the alpha component of the RGBA quadruplet \a rgba.
|
|
*/
|
|
|
|
/*!
|
|
\fn QRgb qRgb( int r, int g, int b )
|
|
\relates QColor
|
|
|
|
Returns the RGB triplet \a (r,g,b).
|
|
|
|
The return type QRgb is equivalent to \c unsigned \c int.
|
|
|
|
\sa qRgba(), qRed(), qGreen(), qBlue()
|
|
*/
|
|
|
|
/*!
|
|
\fn QRgb qRgba( int r, int g, int b, int a )
|
|
\relates QColor
|
|
|
|
Returns the RGBA quadruplet \a (r,g,b,a).
|
|
|
|
The return type QRgba is equivalent to \c unsigned \c int.
|
|
|
|
\sa qRgb(), qRed(), qGreen(), qBlue()
|
|
*/
|
|
|
|
/*!
|
|
\fn int qGray( int r, int g, int b )
|
|
\relates QColor
|
|
|
|
Returns a gray value 0..255 from the (\a r, \a g, \a b) triplet.
|
|
|
|
The gray value is calculated using the formula (r*11 + g*16 +
|
|
b*5)/32.
|
|
*/
|
|
|
|
/*!
|
|
\overload int qGray( qRgb rgb )
|
|
\relates QColor
|
|
|
|
Returns a gray value 0..255 from the given \a rgb colour.
|
|
*/
|
|
|