com.trolltech.qt.gui
Class QColor

java.lang.Object
  extended by com.trolltech.qt.internal.QSignalEmitterInternal
      extended by com.trolltech.qt.QSignalEmitter
          extended by com.trolltech.qt.QtJambiObject
              extended by com.trolltech.qt.gui.QColor
All Implemented Interfaces:
QtJambiInterface, java.lang.Cloneable

public class QColor
extends QtJambiObject
implements java.lang.Cloneable

The QColor class provides colors based on RGB, HSV or CMYK values. A color is normally specified in terms of RGB (red, green, and blue) components, but it is also possible to specify it in terms of HSV (hue, saturation, and value) and CMYK (cyan, magenta, yellow and black) components. In addition a color can be specified using a color name. The color name can be any of the SVG 1.0 color names.







RGB
HSV
CMYK
The QColor constructor creates the color based on RGB values. To create a QColor based on either HSV or CMYK values, use the toHsv() and toCmyk() functions respectively. These functions return a copy of the color using the desired format. In addition the static fromRgb(), fromHsv() and fromCmyk() functions create colors from the specified values. Alternatively, a color can be converted to any of the three formats using the convertTo() function (returning a copy of the color in the desired format), or any of the setRgb(), setHsv() and setCmyk() functions altering this color's format. The spec() function tells how the color was specified.

A color can be set by passing an RGB string (such as "#112233"), or a color name (such as "blue"), to the setNamedColor() function. The color names are taken from the SVG 1.0 color names. The name() function returns the name of the color in the format "#RRGGBB". Colors can also be set using setRgb(), setHsv() and setCmyk(). To get a lighter or darker color use the lighter() and darker() functions respectively.

The isValid() function indicates whether a QColor 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, and for that reason, the result of using an invalid color is undefined.

The color components can be retrieved individually, e.g with red(), hue() and cyan(). The values of the color components can also be retrieved in one go using the getRgb(), getHsv() and getCmyk() functions. Using the RGB color model, the color components can in addition be accessed with rgb().

There are several related non-members: QRgb is a typdef for an unsigned int representing the RGB value triplet (r, g, b). Note that it also can hold a value for the alpha-channel (for more information, see the Alpha-Blended Drawing section). The qRed(), qBlue() and qGreen() functions return the respective component of the given QRgb value, while the qRgb() and qRgba() functions create and return the QRgb triplet based on the given component values. Finally, the qAlpha() function returns the alpha component of the provided QRgb, and the qGray() function calculates and return a gray value based on the given value.

QColor is platform and device independent. The QColormap class maps the color to the hardware.

For more information about painting in general, see The Paint System documentation.

Integer vs. Floating Point Precision

QColor supports floating point precision and provides floating point versions of all the color components functions, e.g. getRgbF(),
hueF() and fromCmykF(). Note that since the components are stored using 16-bit integers, there might be minor deviations between the values set using, for example, setRgbF() and the values returned by the getRgbF() function due to rounding.

While the integer based functions take values in the range 0-255 (except hue() which must have values within the range 0-359), the floating point functions accept values in the range 0.0 - 1.0.

Alpha-Blended Drawing

QColor also support alpha-blended outlining and filling. The alpha channel of a color specifies the transparency effect, 0 represents a fully transparent color, while 255 represents a fully opaque color. For example:
        // Specify semi-transparent red
        painter.setBrush(new QColor(255, 0, 0, 127));
        painter.drawRect(0, 0, width()/2, height());

        // Specify semi-transparent blue
        painter.setBrush(new QColor(0, 0, 255, 127));
        painter.drawRect(0, 0, width(), height()/2);
The code above produces the following output:

Alpha-blended drawing is supported on Windows, Mac OS X, and on X11 systems that have the X Render extension installed.

The alpha channel of a color can be retrieved and set using the alpha() and setAlpha() functions if its value is an integer, and alphaF() and setAlphaF() if its value is qreal (double). By default, the alpha-channel is set to 255 (opaque). To retrieve and set all the RGB color components (including the alpha-channel) in one go, use the rgba() and setRgba() functions.

Predefined Colors

There are 20 predefined QColors: Qt::white , Qt::black , Qt::red , Qt::darkRed , Qt::green , Qt::darkGreen , Qt::blue , Qt::darkBlue , Qt::cyan , Qt::darkCyan , Qt::magenta , Qt::darkMagenta , Qt::yellow , Qt::darkYellow , Qt::gray , Qt::darkGray , Qt::lightGray , Qt::color0 , Qt::color1 , and Qt::transparent .

QColor provides the static colorNames() function which returns a QStringList containing the color names Qt knows about.

The colors Qt::color0 (zero pixel value) and Qt::color1 (non-zero pixel value) are special colors for drawing in QBitmaps. Painting with Qt::color0 sets the bitmap bits to 0 (transparent, i.e. background), and painting with Qt::color1 sets the bits to 1 (opaque, i.e. foreground).

The HSV Color Model

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:

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 hue value that is too large, Qt forces it into range. Hue 360 or 720 is treated as 0; hue 540 is treated as 180.

In addition to the standard HSV model, Qt provides an alpha-channel to feature alpha-blended drawing.

The CMYK Color Model

While the RGB and HSV color models are used for display on computer monitors, the CMYK model is used in the four-color printing process of printing presses and some hard-copy devices.

CMYK has four components, all in the range 0-255: cyan (C), magenta (M), yellow (Y) and black (K). Cyan, magenta and yellow are called subtractive colors; the CMYK color model creates color by starting with a white surface and then subtracting color by applying the appropriate components. While combining cyan, magenta and yellow gives the color black, subtracting one or more will yield any other color. When combined in various percentages, these three colors can create the entire spectrum of colors.

Mixing 100 percent of cyan, magenta and yellow does produce black, but the result is unsatisfactory since it wastes ink, increases drying time, and gives a muddy colour when printing. For that reason, black is added in professional printing to provide a solid black tone; hence the term 'four color process'.

In addition to the standard CMYK model, Qt provides an alpha-channel to feature alpha-blended drawing.

See also:
QPalette, QBrush, and QApplication::setColorSpec().


Nested Class Summary
static class QColor.Spec
          The type of color specified, either RGB, HSV or CMYK.
 
Nested classes/interfaces inherited from class com.trolltech.qt.QSignalEmitter
QSignalEmitter.AbstractSignal, QSignalEmitter.PrivateSignal0, QSignalEmitter.PrivateSignal1, QSignalEmitter.PrivateSignal2, QSignalEmitter.PrivateSignal3, QSignalEmitter.PrivateSignal4, QSignalEmitter.PrivateSignal5, QSignalEmitter.PrivateSignal6, QSignalEmitter.PrivateSignal7, QSignalEmitter.PrivateSignal8, QSignalEmitter.PrivateSignal9, QSignalEmitter.Signal0, QSignalEmitter.Signal1, QSignalEmitter.Signal2, QSignalEmitter.Signal3, QSignalEmitter.Signal4, QSignalEmitter.Signal5, QSignalEmitter.Signal6, QSignalEmitter.Signal7, QSignalEmitter.Signal8, QSignalEmitter.Signal9
 
Nested classes/interfaces inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
com.trolltech.qt.internal.QSignalEmitterInternal.AbstractSignalInternal
 
Field Summary
static QColor black
           
static QColor blue
           
static QColor color0
           
static QColor color1
           
static QColor cyan
           
static QColor darkBlue
           
static QColor darkCyan
           
static QColor darkGray
           
static QColor darkGreen
           
static QColor darkMagenta
           
static QColor darkRed
           
static QColor darkYellow
           
static QColor gray
           
static QColor green
           
static QColor lightGray
           
static QColor magenta
           
static QColor red
           
static QColor transparent
           
static QColor white
           
static QColor yellow
           
 
Fields inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
currentSender
 
Constructor Summary
QColor()
          Constructs an invalid color with the RGB value (0, 0, 0).
QColor(int rgb)
          Constructs a color with the value color.
QColor(int r, int g, int b)
          Constructs a color with the RGB value r, g, b, and the alpha-channel (transparency) value of a.
QColor(int r, int g, int b, int a)
          Constructs a color with the RGB value r, g, b, and the alpha-channel (transparency) value of a.
QColor(QColor color)
          Constructs a color that is a copy of color.
QColor(Qt.GlobalColor color)
          This is an overloaded member function, provided for convenience.
QColor(java.lang.String name)
          Constructs a named color in the same way as setNamedColor() using the given name.
 
Method Summary
 int alpha()
          Returns the alpha color component of this color.
 double alphaF()
          Returns the alpha color component of this color.
 int black()
          Returns the black color component of this color.
 double blackF()
          Returns the black color component of this color.
 int blue()
          Returns the blue color component of this color.
 double blueF()
          Returns the blue color component of this color.
 QColor clone()
          This method is reimplemented for internal reasons
static java.util.List colorNames()
          Returns a QStringList containing the color names Qt knows about.
 QColor convertTo(QColor.Spec colorSpec)
          Creates a copy of this color in the format specified by colorSpec.
 int cyan()
          Returns the cyan color component of this color.
 double cyanF()
          Returns the cyan color component of this color.
 QColor darker()
          Returns a darker (or lighter) color, but does not change this object.
 QColor darker(int f)
          Returns a darker (or lighter) color, but does not change this object.
static QColor fromCmyk(int c, int m, int y, int k)
          Static convenience function that returns a QColor constructed from the given CMYK color values.
static QColor fromCmyk(int c, int m, int y, int k, int a)
          Static convenience function that returns a QColor constructed from the given CMYK color values.
static QColor fromCmykF(double c, double m, double y, double k)
          This is an overloaded member function, provided for convenience.
static QColor fromCmykF(double c, double m, double y, double k, double a)
          This is an overloaded member function, provided for convenience.
static QColor fromHsv(int h, int s, int v)
          Static convenience function that returns a QColor constructed from the HSV color values, h (hue), s (saturation), v (value), and a (alpha-channel, i.
static QColor fromHsv(int h, int s, int v, int a)
          Static convenience function that returns a QColor constructed from the HSV color values, h (hue), s (saturation), v (value), and a (alpha-channel, i.
static QColor fromHsvF(double h, double s, double v)
          This is an overloaded member function, provided for convenience.
static QColor fromHsvF(double h, double s, double v, double a)
          This is an overloaded member function, provided for convenience.
static QColor fromRgb(int rgb)
          Static convenience function that returns a QColor constructed from the given QRgb value rgb.
static QColor fromRgb(int r, int g, int b)
          Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i.
static QColor fromRgb(int r, int g, int b, int a)
          Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i.
static QColor fromRgba(int rgba)
          Static convenience function that returns a QColor constructed from the given QRgb value rgba.
static QColor fromRgbF(double r, double g, double b)
          Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i.
static QColor fromRgbF(double r, double g, double b, double a)
          Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i.
 int green()
          Returns the green color component of this color.
 double greenF()
          Returns the green color component of this color.
 int hue()
          Returns the hue color component of this color.
 double hueF()
          Returns the hue color component of this color.
 boolean isValid()
          Returns true if the color is valid; otherwise returns false.
 QColor lighter()
          Returns a lighter (or darker) color, but does not change this object.
 QColor lighter(int f)
          Returns a lighter (or darker) color, but does not change this object.
 int magenta()
          Returns the magenta color component of this color.
 double magentaF()
          Returns the magenta color component of this color.
 java.lang.String name()
          Returns the name of the color in the format "#RRGGBB"; i.
 void readFrom(QDataStream arg__1)
          Reads a QColor
 int red()
          Returns the red color component of this color.
 double redF()
          Returns the red color component of this color.
 int rgb()
          Returns the RGB value of the color.
 int rgba()
          Returns the RGB value of the color.
 int saturation()
          Returns the saturation color component of this color.
 double saturationF()
          Returns the saturation color component of this color.
 void setAlpha(int alpha)
          Sets the alpha of this color to alpha.
 void setAlphaF(double alpha)
          Sets the alpha of this color to alpha.
 void setBlue(int blue)
          Sets the blue color component of this color to blue.
 void setBlueF(double blue)
          Sets the blue color component of this color to blue.
 void setCmyk(int c, int m, int y, int k)
          Sets the color to CMYK values, c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i.
 void setCmyk(int c, int m, int y, int k, int a)
          Sets the color to CMYK values, c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i.
 void setCmykF(double c, double m, double y, double k)
          This is an overloaded member function, provided for convenience.
 void setCmykF(double c, double m, double y, double k, double a)
          This is an overloaded member function, provided for convenience.
 void setGreen(int green)
          Sets the green color component of this color to green.
 void setGreenF(double green)
          Sets the green color component of this color to green.
 void setHsv(int h, int s, int v)
          Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.
 void setHsv(int h, int s, int v, int a)
          Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.
 void setHsvF(double h, double s, double v)
          Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.
 void setHsvF(double h, double s, double v, double a)
          Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.
 void setNamedColor(java.lang.String name)
          Sets the RGB value of this QColor to name, which may be in one of these formats.
 void setRed(int red)
          Sets the red color component of this color to red.
 void setRedF(double red)
          Sets the red color component of this color to red.
 void setRgb(int rgb)
          This is an overloaded member function, provided for convenience.
 void setRgb(int r, int g, int b)
          Sets the RGB value to r, g, b and the alpha value to a.
 void setRgb(int r, int g, int b, int a)
          Sets the RGB value to r, g, b and the alpha value to a.
 void setRgba(int rgba)
          Sets the RGBA value to rgba.
 void setRgbF(double r, double g, double b)
          Sets the color channels of this color to r (red), g (green), b (blue) and a (alpha, transparency).
 void setRgbF(double r, double g, double b, double a)
          Sets the color channels of this color to r (red), g (green), b (blue) and a (alpha, transparency).
 QColor.Spec spec()
          Returns how the color was specified.
 QColor toCmyk()
          Creates and returns a CMYK QColor based on this color.
 QColor toHsv()
          Creates and returns an HSV QColor based on this color.
 QColor toRgb()
          Create and returns an RGB QColor based on this color.
 java.lang.String toString()
          Returns a string representation of the this QColor.
 int value()
          Returns the value color component of this color.
 double valueF()
          Returns the value color component of this color.
 void writeTo(QDataStream arg__1)
          Writes thisQColor
 int yellow()
          Returns the yellow color component of this color.
 double yellowF()
          Returns the yellow color component of this color.
 
Methods inherited from class com.trolltech.qt.QtJambiObject
dispose, disposed, equals, finalize, reassignNativeResources, tr, tr, tr
 
Methods inherited from class com.trolltech.qt.QSignalEmitter
blockSignals, disconnect, disconnect, signalsBlocked, signalSender, thread
 
Methods inherited from class com.trolltech.qt.internal.QSignalEmitterInternal
__qt_signalInitialization
 
Methods inherited from class java.lang.Object
getClass, hashCode, notify, notifyAll, wait, wait, wait
 
Methods inherited from interface com.trolltech.qt.QtJambiInterface
disableGarbageCollection, nativeId, nativePointer, reenableGarbageCollection, setJavaOwnership
 

Field Detail

white

public static final QColor white

black

public static final QColor black

red

public static final QColor red

darkRed

public static final QColor darkRed

green

public static final QColor green

darkGreen

public static final QColor darkGreen

blue

public static final QColor blue

darkBlue

public static final QColor darkBlue

cyan

public static final QColor cyan

darkCyan

public static final QColor darkCyan

magenta

public static final QColor magenta

darkMagenta

public static final QColor darkMagenta

yellow

public static final QColor yellow

darkYellow

public static final QColor darkYellow

gray

public static final QColor gray

darkGray

public static final QColor darkGray

lightGray

public static final QColor lightGray

transparent

public static final QColor transparent

color0

public static final QColor color0

color1

public static final QColor color1
Constructor Detail

QColor

public 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.

See also:
isValid().


QColor

public QColor(Qt.GlobalColor color)
This is an overloaded member function, provided for convenience.

Constructs a new color with a color value of color.

See also:
isValid(), and Predefined Colors.


QColor

public QColor(QColor color)
Constructs a color that is a copy of color.

See also:
isValid().


QColor

public QColor(java.lang.String name)
Constructs a named color in the same way as setNamedColor() using the given name.

The color is left invalid if the name cannot be parsed.

See also:
setNamedColor(), name(), and isValid().


QColor

public QColor(int r,
              int g,
              int b)
Constructs a color with the RGB value r, g, b, and the alpha-channel (transparency) value of a.

The color is left invalid if any of the arguments are invalid.

See also:
setRgba(), and isValid().


QColor

public QColor(int r,
              int g,
              int b,
              int a)
Constructs a color with the RGB value r, g, b, and the alpha-channel (transparency) value of a.

The color is left invalid if any of the arguments are invalid.

See also:
setRgba(), and isValid().


QColor

public QColor(int rgb)
Constructs a color with the value color. The alpha component is ignored and set to solid.

See also:
fromRgb(), and isValid().

Method Detail

alpha

public final int alpha()
Returns the alpha color component of this color.

See also:
setAlpha(), alphaF(), and Alpha-Blended Drawing.


alphaF

public final double alphaF()
Returns the alpha color component of this color.

See also:
setAlphaF(), alpha(), and Alpha-Blended Drawing.


black

public final int black()
Returns the black color component of this color.

See also:
blackF(), getCmyk(), and The CMYK Color Model.


blackF

public final double blackF()
Returns the black color component of this color.

See also:
black(), getCmykF(), and The CMYK Color Model.


blue

public final int blue()
Returns the blue color component of this color.

See also:
setBlue(), blueF(), and getRgb().


blueF

public final double blueF()
Returns the blue color component of this color.

See also:
setBlueF(), blue(), and getRgbF().


convertTo

public final QColor convertTo(QColor.Spec colorSpec)
Creates a copy of this color in the format specified by colorSpec.

See also:
spec(), toCmyk(), toHsv(), toRgb(), and isValid().


cyan

public final int cyan()
Returns the cyan color component of this color.

See also:
cyanF(), getCmyk(), and The CMYK Color Model.


cyanF

public final double cyanF()
Returns the cyan color component of this color.

See also:
cyan(), getCmykF(), and The CMYK Color Model.


darker

public final QColor darker()
Returns a darker (or lighter) color, but does not change this object.

If the factor is greater than 100, this functions returns a darker color. Setting factor to 300 returns a color that has one-third the brightness. If the factor is less than 100, the return color is lighter, but we recommend using the lighter() function for this purpose. If the factor is 0 or negative, the return value is unspecified.

The function converts the current RGB color to HSV, divides the value (V) component by factor and converts the color back to RGB.

See also:
lighter(), and isValid().


darker

public final QColor darker(int f)
Returns a darker (or lighter) color, but does not change this object.

If the factor is greater than 100, this functions returns a darker color. Setting factor to 300 returns a color that has one-third the brightness. If the factor is less than 100, the return color is lighter, but we recommend using the lighter() function for this purpose. If the factor is 0 or negative, the return value is unspecified.

The function converts the current RGB color to HSV, divides the value (V) component by factor and converts the color back to RGB.

See also:
lighter(), and isValid().


green

public final int green()
Returns the green color component of this color.

See also:
setGreen(), greenF(), and getRgb().


greenF

public final double greenF()
Returns the green color component of this color.

See also:
setGreenF(), green(), and getRgbF().


hue

public final int hue()
Returns the hue color component of this color.

See also:
hueF(), getHsv(), and The HSV Color Model.


hueF

public final double hueF()
Returns the hue color component of this color.

See also:
hue(), getHsvF(), and The HSV Color Model.


isValid

public final boolean isValid()
Returns true if the color is valid; otherwise returns false.


lighter

public final QColor lighter()
Returns a lighter (or darker) color, but does not change this object.

If the factor is greater than 100, this functions returns a lighter color. Setting factor to 150 returns a color that is 50% brighter. If the factor is less than 100, the return color is darker, but we recommend using the darker() function for this purpose. If the factor is 0 or negative, the return value is unspecified.

The function converts the current RGB color to HSV, multiplies the value (V) component by factor and converts the color back to RGB.

See also:
darker(), and isValid().


lighter

public final QColor lighter(int f)
Returns a lighter (or darker) color, but does not change this object.

If the factor is greater than 100, this functions returns a lighter color. Setting factor to 150 returns a color that is 50% brighter. If the factor is less than 100, the return color is darker, but we recommend using the darker() function for this purpose. If the factor is 0 or negative, the return value is unspecified.

The function converts the current RGB color to HSV, multiplies the value (V) component by factor and converts the color back to RGB.

See also:
darker(), and isValid().


magenta

public final int magenta()
Returns the magenta color component of this color.

See also:
magentaF(), getCmyk(), and The CMYK Color Model.


magentaF

public final double magentaF()
Returns the magenta color component of this color.

See also:
magenta(), getCmykF(), and The CMYK Color Model.


name

public final java.lang.String name()
Returns the name of the color in the format "#RRGGBB"; i. . a "#" character followed by three two-digit hexadecimal numbers.

See also:
setNamedColor().


writeTo

public final void writeTo(QDataStream arg__1)
Writes thisQColor


readFrom

public final void readFrom(QDataStream arg__1)
Reads a QColor


red

public final int red()
Returns the red color component of this color.

See also:
setRed(), redF(), and getRgb().


redF

public final double redF()
Returns the red color component of this color.

See also:
setRedF(), red(), and getRgbF().


rgb

public final int rgb()
Returns the RGB value of the color. The alpha is stripped for compatibility.

See also:
setRgb(), getRgb(), and rgba().


rgba

public final int rgba()
Returns the RGB value of the color. Unlike rgb(), the alpha is not stripped.

For an invalid color, the alpha value of the returned color is unspecified.

See also:
setRgba(), and rgb().


saturation

public final int saturation()
Returns the saturation color component of this color.

See also:
saturationF(), getHsv(), and The HSV Color Model.


saturationF

public final double saturationF()
Returns the saturation color component of this color.

See also:
saturation(), getHsvF(), and The HSV Color Model.


setAlpha

public final void setAlpha(int alpha)
Sets the alpha of this color to alpha. Integer alpha is specified in the range 0-255.

See also:
alpha(), alphaF(), and Alpha-Blended Drawing.


setAlphaF

public final void setAlphaF(double alpha)
Sets the alpha of this color to alpha. qreal alpha is specified in the range 0.0-1.0.

See also:
alphaF(), alpha(), and Alpha-Blended Drawing.


setBlue

public final void setBlue(int blue)
Sets the blue color component of this color to blue. Integer components are specified in the range 0-255.

See also:
blue(), blueF(), and setRgb().


setBlueF

public final void setBlueF(double blue)
Sets the blue color component of this color to blue. Float components are specified in the range 0.0-1.0.

See also:
blueF(), blue(), and setRgbF().


setCmyk

public final void setCmyk(int c,
                          int m,
                          int y,
                          int k)
Sets the color to CMYK values, c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i. . transparency).

All the values must be in the range 0-255.

See also:
getCmyk(), setCmykF(), and The CMYK Color Model.


setCmyk

public final void setCmyk(int c,
                          int m,
                          int y,
                          int k,
                          int a)
Sets the color to CMYK values, c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i. . transparency).

All the values must be in the range 0-255.

See also:
getCmyk(), setCmykF(), and The CMYK Color Model.


setCmykF

public final void setCmykF(double c,
                           double m,
                           double y,
                           double k)
This is an overloaded member function, provided for convenience.

Sets the color to CMYK values, c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i.e. transparency).

All the values must be in the range 0.0-1.0.

See also:
getCmykF(), setCmyk(), and The CMYK Color Model.


setCmykF

public final void setCmykF(double c,
                           double m,
                           double y,
                           double k,
                           double a)
This is an overloaded member function, provided for convenience.

Sets the color to CMYK values, c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i.e. transparency).

All the values must be in the range 0.0-1.0.

See also:
getCmykF(), setCmyk(), and The CMYK Color Model.


setGreen

public final void setGreen(int green)
Sets the green color component of this color to green. Integer components are specified in the range 0-255.

See also:
green(), greenF(), and setRgb().


setGreenF

public final void setGreenF(double green)
Sets the green color component of this color to green. Float components are specified in the range 0.0-1.0.

See also:
greenF(), green(), and setRgbF().


setHsv

public final void setHsv(int h,
                         int s,
                         int v)
Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.

The saturation, value and alpha-channel values must be in the range 0-255, and the hue value must be greater than -1.

See also:
hsv(), getHsv(), setHsvF(), and The HSV Color Model.


setHsv

public final void setHsv(int h,
                         int s,
                         int v,
                         int a)
Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.

The saturation, value and alpha-channel values must be in the range 0-255, and the hue value must be greater than -1.

See also:
hsv(), getHsv(), setHsvF(), and The HSV Color Model.


setHsvF

public final void setHsvF(double h,
                          double s,
                          double v)
Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.

All the values must be in the range 0.0-1.0.

See also:
getHsvF(), setHsv(), and The HSV Color Model.


setHsvF

public final void setHsvF(double h,
                          double s,
                          double v,
                          double a)
Sets a HSV color value; h is the hue, s is the saturation, v is the value and a is the alpha component of the HSV color.

All the values must be in the range 0.0-1.0.

See also:
getHsvF(), setHsv(), and The HSV Color Model.


setNamedColor

public final void setNamedColor(java.lang.String name)
Sets the RGB value of this QColor to name, which may be in one of these formats. The color is invalid if name cannot be parsed.

See also:
QColor(), name(), isValid(), and allowX11ColorNames().


setRed

public final void setRed(int red)
Sets the red color component of this color to red. Integer components are specified in the range 0-255.

See also:
red(), redF(), and setRgb().


setRedF

public final void setRedF(double red)
Sets the red color component of this color to red. Float components are specified in the range 0.0-1.0.

See also:
redF(), red(), and setRgbF().


setRgb

public final void setRgb(int r,
                         int g,
                         int b)
Sets the RGB value to r, g, b and the alpha value to a.

All the values must be in the range 0-255.

See also:
rgb(), getRgb(), and setRgbF().


setRgb

public final void setRgb(int r,
                         int g,
                         int b,
                         int a)
Sets the RGB value to r, g, b and the alpha value to a.

All the values must be in the range 0-255.

See also:
rgb(), getRgb(), and setRgbF().


setRgb

public final void setRgb(int rgb)
This is an overloaded member function, provided for convenience.

Sets the RGB value to rgb, ignoring the alpha.


setRgbF

public final void setRgbF(double r,
                          double g,
                          double b)
Sets the color channels of this color to r (red), g (green), b (blue) and a (alpha, transparency).

All values must be in the range 0.0-1.0.

See also:
rgb(), getRgbF(), and setRgb().


setRgbF

public final void setRgbF(double r,
                          double g,
                          double b,
                          double a)
Sets the color channels of this color to r (red), g (green), b (blue) and a (alpha, transparency).

All values must be in the range 0.0-1.0.

See also:
rgb(), getRgbF(), and setRgb().


setRgba

public final void setRgba(int rgba)
Sets the RGBA value to rgba. Unlike setRgb(QRgb rgb), this function does not ignore the alpha.

See also:
rgba(), and rgb().


spec

public final QColor.Spec spec()
Returns how the color was specified.

See also:
Spec , and convertTo().


toCmyk

public final QColor toCmyk()
Creates and returns a CMYK QColor based on this color.

See also:
fromCmyk(), convertTo(), isValid(), and The CMYK Color Model.


toHsv

public final QColor toHsv()
Creates and returns an HSV QColor based on this color.

See also:
fromHsv(), convertTo(), isValid(), and The HSV Color Model.


toRgb

public final QColor toRgb()
Create and returns an RGB QColor based on this color.

See also:
fromRgb(), convertTo(), and isValid().


value

public final int value()
Returns the value color component of this color.

See also:
valueF(), getHsv(), and The HSV Color Model.


valueF

public final double valueF()
Returns the value color component of this color.

See also:
value(), getHsvF(), and The HSV Color Model.


yellow

public final int yellow()
Returns the yellow color component of this color.

See also:
yellowF(), getCmyk(), and The CMYK Color Model.


yellowF

public final double yellowF()
Returns the yellow color component of this color.

See also:
yellow(), getCmykF(), and The CMYK Color Model.


colorNames

public static java.util.List colorNames()
Returns a QStringList containing the color names Qt knows about.

See also:
Predefined Colors.


fromCmyk

public static QColor fromCmyk(int c,
                              int m,
                              int y,
                              int k)
Static convenience function that returns a QColor constructed from the given CMYK color values. c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i. . transparency).

All the values must be in the range 0-255.

See also:
toCmyk(), fromCmykF(), isValid(), and The CMYK Color Model.


fromCmyk

public static QColor fromCmyk(int c,
                              int m,
                              int y,
                              int k,
                              int a)
Static convenience function that returns a QColor constructed from the given CMYK color values. c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i. . transparency).

All the values must be in the range 0-255.

See also:
toCmyk(), fromCmykF(), isValid(), and The CMYK Color Model.


fromCmykF

public static QColor fromCmykF(double c,
                               double m,
                               double y,
                               double k)
This is an overloaded member function, provided for convenience.

Static convenience function that returns a QColor constructed from the given CMYK color values: c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i.e. transparency).

All the values must be in the range 0.0-1.0.

See also:
toCmyk(), fromCmyk(), isValid(), and The CMYK Color Model.


fromCmykF

public static QColor fromCmykF(double c,
                               double m,
                               double y,
                               double k,
                               double a)
This is an overloaded member function, provided for convenience.

Static convenience function that returns a QColor constructed from the given CMYK color values: c (cyan), m (magenta), y (yellow), k (black), and a (alpha-channel, i.e. transparency).

All the values must be in the range 0.0-1.0.

See also:
toCmyk(), fromCmyk(), isValid(), and The CMYK Color Model.


fromHsv

public static QColor fromHsv(int h,
                             int s,
                             int v)
Static convenience function that returns a QColor constructed from the HSV color values, h (hue), s (saturation), v (value), and a (alpha-channel, i. . transparency).

The value of s, v, and a must all be in the range 0-255; the value of h must be in the range 0-359.

See also:
toHsv(), fromHsvF(), isValid(), and The HSV Color Model.


fromHsv

public static QColor fromHsv(int h,
                             int s,
                             int v,
                             int a)
Static convenience function that returns a QColor constructed from the HSV color values, h (hue), s (saturation), v (value), and a (alpha-channel, i. . transparency).

The value of s, v, and a must all be in the range 0-255; the value of h must be in the range 0-359.

See also:
toHsv(), fromHsvF(), isValid(), and The HSV Color Model.


fromHsvF

public static QColor fromHsvF(double h,
                              double s,
                              double v)
This is an overloaded member function, provided for convenience.

Static convenience function that returns a QColor constructed from the HSV color values, h (hue), s (saturation), v (value), and a (alpha-channel, i.e. transparency).

All the values must be in the range 0.0-1.0.

See also:
toHsv(), fromHsv(), isValid(), and The HSV Color Model.


fromHsvF

public static QColor fromHsvF(double h,
                              double s,
                              double v,
                              double a)
This is an overloaded member function, provided for convenience.

Static convenience function that returns a QColor constructed from the HSV color values, h (hue), s (saturation), v (value), and a (alpha-channel, i.e. transparency).

All the values must be in the range 0.0-1.0.

See also:
toHsv(), fromHsv(), isValid(), and The HSV Color Model.


fromRgb

public static QColor fromRgb(int r,
                             int g,
                             int b)
Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i. . transparency).

All the values must be in the range 0-255.

See also:
toRgb(), fromRgbF(), and isValid().


fromRgb

public static QColor fromRgb(int r,
                             int g,
                             int b,
                             int a)
Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i. . transparency).

All the values must be in the range 0-255.

See also:
toRgb(), fromRgbF(), and isValid().


fromRgb

public static QColor fromRgb(int rgb)
Static convenience function that returns a QColor constructed from the given QRgb value rgb.

The alpha component of rgb is ignored (i.e. it is automatically set to 255), use the fromRgba() function to include the alpha-channel specified by the given QRgb value.

See also:
fromRgba(), fromRgbF(), toRgb(), and isValid().


fromRgbF

public static QColor fromRgbF(double r,
                              double g,
                              double b)
Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i. . transparency).

All the values must be in the range 0.0-1.0.

See also:
fromRgb(), toRgb(), and isValid().


fromRgbF

public static QColor fromRgbF(double r,
                              double g,
                              double b,
                              double a)
Static convenience function that returns a QColor constructed from the RGB color values, r (red), g (green), b (blue), and a (alpha-channel, i. . transparency).

All the values must be in the range 0.0-1.0.

See also:
fromRgb(), toRgb(), and isValid().


fromRgba

public static QColor fromRgba(int rgba)
Static convenience function that returns a QColor constructed from the given QRgb value rgba.

Unlike the fromRgb() function, the alpha-channel specified by the given QRgb value is included.

See also:
fromRgb(), and isValid().


toString

public java.lang.String toString()
Returns a string representation of the this QColor.

Overrides:
toString in class java.lang.Object

clone

public QColor clone()
This method is reimplemented for internal reasons

Overrides:
clone in class java.lang.Object