QColor

La classe QColor fournit la description d'une couleur se basant sur des valeurs RGB, HSV ou CMYK. Plus d'informations...

#include <QColor>

Voir la position dans l'arbre des classes.

Description détaillée

La classe QColor fournit la description d'une couleur se basant sur des valeurs RGB, HSV ou CMYK.

Une couleur est habituellement spécifiée dans le format RGB (rouge, vert et bleu) mais il est aussi possible de décrire une couleur dans le format HSV (teinte, saturation et valeur) ou dans le format CMYK (cyan, magenta, jaune et noir). De plus une couleur peut être décrite par un nom. Le nom de la couleur est l'un des noms disponibles dans SVG 1.0.

RGB	HSV	CMYK

Le constructeur de QColor crée une couleur en se basant sur les valeurs RGB. Pour créer un QColor se basant sur le format HSV ou CMYK, utilisez les fonctions toHsv() et toCmyk() respectivement. Ces fonctions retournent une copie de la couleur en utilisant le format voulu. De plus, les fonctions statiques fromRgb(), fromHsv() et fromCmyk() créent des couleurs à partir des valeurs spécifiées. Sinon, une couleur peut être convertie dans l'un des trois formats avec la fonction convertTo() (qui retourne une copie de la couleur dans le format voulu) ou l'une des fonctions setRgb(), setHsv() et setCmyk() modifiant le format de couleur de this. La fonction spec() indique comment la couleur a été spécifiée.

Une couleur peut être définie en passant une chaine de caractères dans le format RGBA (comme « #112233 ») ou un nom de couleur (comme « blue » pour bleu), à la fonction setNamedColor(). Les noms de couleur correspondent aux noms décrits dans SVG 1.0. La fonction name() retourne le nom de la couleur dans le format « #RRGGBB ». Les couleurs peuvent aussi être définies avec les fonctions setRgb(), setHsv() et setCmyk(). Pour avoir une couleur plus claire ou plus sombre, utilisez les fonctions lighter() et darker() respectivement.

La fonction isValid() indique si le QColor est valide ou non. Par exemple, une couleur RGB avec des valeurs dépassant les limites est invalide. Pour des raisons de performances, QColor ne tient pas compte des couleurs illégales et pour cette raison, l'utilisation d'une couleur invalide amène un résultat indéfini.

Les composantes d'une couleur peuvent être récupérées individuellement avec les fonctions red(), hue() et cyan(), par exemple. Les valeurs des composantes d'une couleur peuvent aussi être récupérées en une fois avec les fonctions getRgb(), getHsv() et getCmyk(). De plus, lors de l'utilisation du format de couleur RGB, les composantes de la couleur peuvent être récupérées avec rgb().

Il y a plusieurs non-membres liés aux couleurs : QRgb est un typedef pour un unsigned int représentant le triplet RGB d'une couleur. Notez qu'il peut aussi contenir une valeur pour le canal alpha (pour plus d'information, voyez la section Dessin transparent). Les fonctions qRed(), qBlue() et qGreen() retournent la composante de la couleur à partir de la valeur QRgb donnée, alors que les fonctions qRgb() et qRgba() créent et retournent le triplet QRgb en se basant sur les valeurs des composantes de la couleur. Finalement, la fonction qAlpha() retourne la composante alpha du QRgb fourni et la fonction qGray() calcule et retourne une valeur de gris basée sur la valeur donnée.

QColor est indépendant de la plateforme et du périphérique. La classe QColormap fait correspondre la couleur avec la machine.

Pour plus d'information à propos du dessin, voir la documentation du système de dessin.

Entiers //vs// nombres à virgule flottante

QColor supporte les nombres à virgule flottante et fournit une version en virgule flottante pour toutes les fonctions d'accès aux composantes, comme par exemple : getRgbF(), hueF() et fromCmykF(). Notez que les composantes sont stockées en utilisant des entiers sur 16 bits, ce qui peut provoquer de petits décalages entre les valeurs définies en utilisant, par exemple, setRgbF() et les valeurs retournées par la fonction getRgbF() à cause de l'arrondi.

Les fonctions basées sur les nombres entiers acceptent des valeurs entre 0 et 255 (à part hue() qui accepte une valeur comprise entre 0 et 359), les fonctions basées sur les nombres à virgule flottante acceptent des valeurs entre 0.0 et 1.0.

Dessin transparent

QColor supporte aussi le fondu alpha pour le contour et le remplissage. Le canal alpha d'une couleur spécifie l'effet de transparence, 0 représente une couleur complètement transparente alors que 255 représente une couleur complètement opaque. Par exemple :

 // Spécifie un rouge à moitié transparent
 painter.setBrush(QColor(255, 0, 0, 127));
 painter.drawRect(0, 0, width()/2, height());
 
 // Spécifie un bleu à moitié transparent
 painter.setBrush(QColor(0, 0, 255, 127));
 painter.drawRect(0, 0, width(), height()/2);

Le code ci-dessus produit le résultat suivant :

Le dessin avec transparence est supporté sous Windows, Mac OS X et sur les systèmes X11 qui ont l'extension X Render installée.

Le canal alpha d'une couleur peut être récupéré et défini avec les fonctions alpha() et setAlpha() si cette valeur est un entier et avec les fonctions alphaF() et setAlphaF() si cette valeur est un qreal (double). Par défaut, le canal alpha est défini à 255 (opaque). Pour récupérer et définir toutes les composantes d'une couleur RGB (avec le canal alpha) d'un coup, utilisez les fonctions rgba() et setRgba().

Couleurs prédéfinies

Il y a 20 QColor prédéfinies par l'enum Qt::GlobalColor, incluant le noir, blanc, les couleurs primaires et secondaires, les versions plus sombres de ces couleurs et trois nuances de gris. QColor reconnait aussi une variété de noms de couleur ; la fonction statique colorNames() retourne une QStringList de noms de couleur que QColor accepte.

De plus, les couleurs Qt::color0, Qt::color1 et Qt::transparent sont utilisées dans un but spécial.

Qt::color0 (valeur de pixel zéro) et Qt::color1 (valeur de pixel non-zéro) sont des couleurs spéciales pour le dessin dans les QBitmap. Le dessin avec la couleur Qt::color0 définit les bits du bitmap à 0 (transparent ; c'est-à-dire, l'arrière-plan) et un dessin avec la couleur Qt::color1 définit les bits à 1 (opaque ; c'est-à-dire, le premier plan).

Qt::transparent est utilisé pour indiquer un pixel transparent. Lors du dessin avec cette valeur, une valeur de pixel va être utilisée pour être compatible avec le format de pixel sous-jacent utilisé.

Le format de couleur HSV

Le format RGB est orienté pour la machine. Sa représentation est proche de ce que les écrans affichent. Au contraire, le format de couleur HSV est plus adéquat pour la perception des couleurs par l'être humain. Par exemple, les expressions « plus intense que », « plus sombre que » et « le contraire de » sont facilement exprimées dans le format HSV mais très difficiles à retranscrire avec le format RGB.

Le format HSV, tout comme le format RGB, possède trois composantes.

• H, pour la teinte, comprise entre 0 et 359 si la couleur est chromatique (non grise) ou sans importance si la couleur est grise. Cette valeur correspond à l'angle de la roue des couleurs, qui est familière pour la plupart des gens. Rouge est à 0 (degré), vert est à 120 et bleu à 240.

• S, pour la saturation, comprise entre 0 et 255. Plus la valeur est haute, plus la couleur est forte. Les couleurs grisâtres ont une saturation proche de 0 ; les couleurs très fortes ont une valeur proche de 255.

• V, pour la valeur, comprise entre 0 et 255. Elle représente la luminosité ou l'éclat de la couleur. 0 correspond au noir ; 255 est la couleur la plus éloignée que possible du noir.

Voici quelques exemples : un rouge pur est défini H=0, S=255, V=255 ; un rouge sombre, allant sensiblement vers le magenta, pourrait être H=350 (équivalent à -10), S=255, V=180 ; une lumière rouge grisâtre pourrait avoir une teinte proche de 0 (disons 350-359 ou 0-10), S entre 50-100 et V=255.

Qt retourne la valeur -1 pour la teinte pour les couleurs achromatiques. Si vous passez une teinte qui est trop grande, Qt force à la valeur pour correspondre à l'échelle. Une teinte de 360 ou 720 sera définie à 0 ; une teinte de 540 sera définie à 180.

En plus du format standard HSV, Qt fournit un canal alpha pour la fonctionnalité de dessin transparent.

Le format de couleur HSL

Le format HSL est similaire au HSV. À la place du paramètre de valeur du HSV, HSL a un paramètre de luminosité. Le paramètre de luminosité va du noir à la couleur et de la couleur au blanc. Si vous allez dehors en pleine nuit, c'est noir ou gris sombre. En journée c'est plein de couleurs mais si vous regardez avec une très forte lumière les choses sont blanches et sont déteintes.

Le format de couleur CMYK

Alors que les formats de couleur RGB et HSV sont utilisés pour l'affichage sur les écrans d'ordinateur, le format CMYK est utilisé dans le processus de dessin avec quatre couleurs des imprimantes et de quelques périphériques de matériel de copie.

CMYK contient quatre composantes, toutes comprises entre 0 et 255 : cyan (C), magenta (M), jaune (Y) et noir (K). Le cyan, magenta et jaune sont appelés les couleurs soustractives ; le format de couleur CMYK crée une couleur en partant d'une surface blanche et enlève alors de la couleur en appliquant les composantes appropriées. La combinaison du cyan, magenta et jaune donne le noir. Le fait d'enlever une ou plusieurs couleurs permet de garder les autres. La combinaison de ces couleurs à différents pourcentages peut recréer le spectre entier des couleurs.

Le mélange du cyan, magenta et jaune à 100 % permet de produire du noir, mais ce procédé gâche de l'encre, augmente le temps de séchage et donne une couleur boueuse lors de l'impression. Pour cette raison, le noir est ajouté dans l'impression professionnelle pour fournir un noir parfait ; d'où le terme de ‹processus 4 couleurs›.

En plus du format standard CMYK, Qt fournit un canal alpha pour la fonctionnalité de dessin transparent.

Voir aussi QPalette, QBrush et QApplication::setColorSpec().

Type

enum QColor::Spec

Le format de couleur spécifié, soit RGB, HSV, CMYK ou HSL.

Voir aussi spec() et convertTo().

Fonctions membres

QColor::QColor ()

Construit une couleur invalide avec les valeurs RGB (0, 0, 0). Une couleur invalide est une couleur qui n'est pas définie pour le système de fenêtre sous-jacent.

La valeur alpha d'une couleur invalide n'est pas spécifiée.

Voir aussi isValid().

QColor::QColor ( int r, int g, int b, int a = 255 )

Construit une couleur avec les valeurs RGB r, g, b et le canal alpha (transparence) a.

La couleur est laissée invalide si l'un des arguments est invalide.

Voir aussi setRgba() et isValid().

QColor::QColor ( QRgb color )

Construit une couleur avec la valeur color. La composante alpha est ignorée et définie comme opaque.

Voir aussi fromRgb() et isValid().

QColor::QColor ( const QString & name )

Construit une couleur nommée à l'identique de setNamedColor() en utilisant le nom name donné.

La couleur est laissée invalide si le nom name ne peut être analysé.

Voir aussi setNamedColor(), name() et isValid().

QColor::QColor ( const char * name )

Construit une couleur nommée à l'identique de setNamedColor() en utilisant le nom name donné.

La couleur est laissée invalide si le nom name ne peut être analysé.

Voir aussi setNamedColor(), name() et isValid().

QColor::QColor ( const QColor & color )

Construit une couleur qui est une copie de color.

Voir aussi isValid().

QColor::QColor ( Qt::GlobalColor color )

Il s'agit d'une fonction surchargée.

Construit une nouvelle couleur avec les valeurs de la couleur color.

Voir aussi isValid() et couleurs prédéfinies.

bool QColor::allowX11ColorNames () [static]

Retourne true si setNamedColor() peut chercher les couleurs dans la base de données de couleurs de X11. Par défaut, cette fonction retourne false.

Note : cette fonction n'est disponible que sur les plateformes X11.

Voir aussi setAllowX11ColorNames().

int QColor::alpha () const

Retourne la composante alpha de cette couleur.

Voir aussi setAlpha(), alphaF() et dessin transparent.

qreal QColor::alphaF () const

Retourne la composante alpha de cette couleur.

Voir aussi setAlphaF(), alpha() et dessin transparent.

int QColor::black () const

Retourne la composante noir de cette couleur.

Voir aussi blackF(), getCmyk() et le format de couleur CMYK.

qreal QColor::blackF () const

Retourne la composante noir de cette couleur.

Voir aussi black(), getCmykF() et le format de couleur CMYK.

int QColor::blue () const

Retourne la composante bleu de cette couleur.

Voir aussi setBlue(), blueF() et getRgb().

qreal QColor::blueF () const

Retourne la composante bleu de cette couleur.

Voir aussi setBlueF(), blue() et getRgbF().

QStringList QColor::colorNames () [static]

Retourne une QStringList contenant les noms de couleur que Qt connait.

Voir aussi Couleurs prédéfinies.

QColor QColor::convertTo ( Spec colorSpec ) const

Crée une copie de la couleur this dans le format spécifié par colorSpec.

Voir aussi spec(), toCmyk(), toHsv(), toRgb() et isValid().

int QColor::cyan () const

Retourne la composante cyan de cette couleur.

Voir aussi cyanF(), getCmyk() et le format de couleur CMYK.

qreal QColor::cyanF () const

Retourne la composante cyan de cette couleur.

Voir aussi cyan(), getCmykF() et le format de couleur CMYK.

QColor QColor::darker ( int factor = 200 ) const

Retourne une couleur plus sombre (ou plus claire) mais ne modifie pas cet objet.

Si le facteur factor est plus grand que 100, cette fonction retourne une couleur plus sombre. Définir le facteur factor à 300 retourne une couleur qui a un tiers de la luminosité. Si le facteur factor est inférieur à 100, la couleur retournée est plus claire mais nous recommandons d'utiliser la fonction lighter() dans ce cas. Si le facteur factor est zéro ou négatif, la valeur retournée est non spécifiée.

La fonction convertie la couleur RGB courante au format HSV, divise la composante valeur (V) par le facteur factor et reconvertit la couleur en RGB.

Cette fonction a été introduite dans Qt 4.3.

Voir aussi lighter() et isValid().

QColor QColor::fromCmyk ( int c, int m, int y, int k, int a = 255 ) [static]

Fonction statique de commodité qui retourne un QColor construit à partir des valeurs CMYK données : c (cyan), m (magenta), y (jaune), k (noir) et a (canal alpha, c'est-à-dire, la transparence).

Toutes les valeurs doivent être comprises entre 0 et 255.

Voir aussi toCmyk(), fromCmykF(), isValid() et le format de couleur CMYK.

QColor QColor::fromCmykF ( qreal c, qreal m, qreal y, qreal k, qreal a = 1.0 ) [static]

Il s'agit d'une fonction surchargée.

Fonction statique de commodité qui retourne un QColor construit à partir des valeurs CMYK données : c (cyan), m (magenta), y (jaune), k (noir) et a (canal alpha, c'est-à-dire, la transparence).

Toutes les valeurs doivent être comprises entre 0.0 et 1.0.

Voir aussi toCmyk(), fromCmyk(), isValid() et le format de couleur CMYK.

QColor QColor::fromHsl ( int h, int s, int l, int a = 255 ) [static]

Fonction statique de commodité qui retourne un QColor construit à partir des valeurs HSL données, h (teinte), s (saturation), l (luminosité) et a (canal alpha, c'est-à-dire, la transparence).

Les valeurs de s, l et a doivent toutes être entre 0 et 255 ; la valeur de h doit être entre 0 et 359.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi toHsl(), fromHslF() et isValid().

QColor QColor::fromHslF ( qreal h, qreal s, qreal l, qreal a = 1.0 ) [static]

Il s'agit d'une fonction surchargée.

Fonction statique de commodité qui retourne un QColor construit à partir des valeurs HSL données, h (teinte), s (saturation), l (luminosité) et a (canal alpha, c'est-à-dire, la transparence).

Toutes les valeurs doivent être comprises entre 0.0 et 1.0.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi toHsl(), fromHsl() et isValid().

QColor QColor::fromHsv ( int h, int s, int v, int a = 255 ) [static]

Fonction statique de commodité qui retourne un QColor construit à partir des valeurs HSV données, h (teinte), s (saturation), v (valeur) et a (canal alpha, c'est-à-dire, la transparence).

Les valeurs de s, v et a doivent toutes être entre 0 et 255 ; la valeur de h doit être entre 0 et 359.

Voir aussi toHsv(), fromHsvF(), isValid() et le format de couleur HSV.

QColor QColor::fromHsvF ( qreal h, qreal s, qreal v, qreal a = 1.0 ) [static]

Il s'agit d'une fonction surchargée.

Fonction statique de commodité qui retourne un QColor construit à partir des valeurs HSV données, h (teinte), s (saturation), v (valeur) et a (canal alpha, c'est-à-dire, la transparence).

Toutes les valeurs doivent être comprises entre 0.0 et 1.0.

Voir aussi toHsv(), fromHsv(), isValid() et le format de couleur HSV.

QColor QColor::fromRgb ( QRgb rgb ) [static]

Fonction statique de commodité qui retourne un QColor construit à partir de la valeur QRgb rgb donnée.

La composante alpha de rgb est ignorée (c'est-à-dire, elle est définie automatiquement à 255). Utilisez la fonction fromRgba() pour inclure le canal alpha spécifié par la valeur QRgb donnée.

Voir aussi fromRgba(), fromRgbF(), toRgb() et isValid().

QColor QColor::fromRgb ( int r, int g, int b, int a = 255 ) [static]

Fonction statique de commodité qui retourne un QColor construit à partir des valeurs RGB, r (rouge), g (vert), b (bleu) et a (canal alpha, c'est-à-dire, la transparence).

Toutes les valeurs doivent être comprises entre 0 et 255.

Voir aussi toRgb(), fromRgbF() et isValid().

QColor QColor::fromRgbF ( qreal r, qreal g, qreal b, qreal a = 1.0 ) [static]

Fonction statique de commodité qui retourne un QColor construit à partir des valeurs RGB, r (rouge), g (vert), b (bleu) et a (canal alpha, c'est-à-dire, la transparence).

Toutes les valeurs doivent être comprises entre 0.0 et 1.0.

Voir aussi fromRgb(), toRgb() et isValid().

QColor QColor::fromRgba ( QRgb rgba ) [static]

Fonction statique de commodité qui retourne un QColor construit à partir de la valeur QRgb rgba donnée.

Contrairement à la fonction fromRgb(), le canal alpha spécifié par la valeur QRgb donnée est inclus.

Voir aussi fromRgb() et isValid().

void QColor::getCmyk ( int * c, int * m, int * y, int * k, int * a = 0 )

Définit les contenus pointés par c, m, y, k et a, aux valeurs des composantes cyan, magenta, jaune, noir et alpha (transparence) de la couleur CMYK.

Ces composantes peuvent être récupérées individuellement avec les fonctions cyan(), magenta(), yellow(), black() et alpha().

Voir aussi setCmyk() et le format de couleur CMYK.

void QColor::getCmykF ( qreal * c, qreal * m, qreal * y, qreal * k, qreal * a = 0 )

Définit les contenus pointés par c, m, y, k et a, aux valeurs des composantes cyan, magenta, jaune, noir et alpha (transparence) de la couleur CMYK.

Ces composantes peuvent être récupérées individuellement avec les fonctions cyanF(), magentaF(), yellowF(), blackF() et alphaF().

Voir aussi setCmykF() et le format de couleur CMYK.

void QColor::getHsl ( int * h, int * s, int * l, int * a = 0 ) const

Définit les contenus pointés par h, s, l et a, aux valeurs des composantes teinte, saturation, luminosité et alpha (transparence) de la couleur HSL.

Ces composantes peuvent être récupérées individuellement avec les fonctions hueHsl(), saturationHsl(), lightness() et alpha().

Cette fonction a été introduite dans Qt 4.6.

Voir aussi setHsl().

void QColor::getHslF ( qreal * h, qreal * s, qreal * l, qreal * a = 0 ) const

Définit les contenus pointés par h, s, l et a, aux valeurs des composantes teinte, saturation, luminosité et alpha (transparence) de la couleur HSL.

Ces composantes peuvent être récupérées individuellement avec les fonctions hueHslF(), saturationHslF(), lightnessF() et alphaF().

Cette fonction a été introduite dans Qt 4.6.

Voir aussi setHsl().

void QColor::getHsv ( int * h, int * s, int * v, int * a = 0 ) const

Définit les contenus pointés par h, s, v et a, aux valeurs des composantes teinte, saturation, valeur et alpha (transparence) de la couleur HSV.

Ces composantes peuvent être récupérées individuellement avec les fonctions hue(), saturation(), value() et alpha().

Voir aussi setHsv() et le format de couleur HSV.

void QColor::getHsvF ( qreal * h, qreal * s, qreal * v, qreal * a = 0 ) const

Définit les contenus pointés par h, s, v et a, aux valeurs des composantes teinte, saturation, valeur et alpha (transparence) de la couleur HSV.

Ces composantes peuvent être récupérées individuellement avec les fonctions hueF(), saturationF(), valueF() et alphaF().

Voir aussi setHsv() et le format de couleur HSV.

void QColor::getRgb ( int * r, int * g, int * b, int * a = 0 ) const

Définit les contenus pointés par r, g, b et a, aux valeurs des composantes rouge, vert, bleu et alpha (transparence) de la couleur RGB.

Ces composantes peuvent être récupérées individuellement avec les fonctions red(), green(), blue() et alpha().

Voir aussi rgb() et setRgb().

void QColor::getRgbF ( qreal * r, qreal * g, qreal * b, qreal * a = 0 ) const

Définit les contenus pointés par r, g, b et a, aux valeurs des composantes rouge, vert, bleu et alpha (transparence) de la couleur RGB.

Ces composantes peuvent être récupérées individuellement avec les fonctions redF(), greenF(), blueF() et alphaF().

Voir aussi rgb() et setRgb().

int QColor::green () const

Retourne la composante vert de cette couleur.

Voir aussi setGreen(), greenF() et getRgb().

qreal QColor::greenF () const

Retourne la composante vert de cette couleur.

Voir aussi setGreenF(), green() et getRgbF().

int QColor::hslHue () const

Retourne la composante teinte de cette couleur.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi getHslF() et getHsl().

qreal QColor::hslHueF () const

Retourne la composante teinte de cette couleur.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi hue() et getHslF().

int QColor::hslSaturation () const

Retourne la composante saturation de cette couleur.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi saturationF(), getHsv() et le format de couleur HSV.

qreal QColor::hslSaturationF () const

Retourne la composante saturation de cette couleur.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi saturationF() et getHslF().

int QColor::hsvHue () const

Retourne la composante teinte de cette couleur.

Voir aussi hueF(), getHsv() et le format de couleur HSV.

qreal QColor::hsvHueF () const

Retourne la composante teinte de cette couleur.

Voir aussi hue(), getHsvF() et le format de couleur HSV.

int QColor::hsvSaturation () const

Retourne la composante saturation de cette couleur.

Voir aussi saturationF(), getHsv() et le format de couleur HSV.

qreal QColor::hsvSaturationF () const

Retourne la composante saturation de cette couleur.

Voir aussi saturation(), getHsvF() et le format de couleur HSV.

int QColor::hue () const

Retourne la composante teinte de cette couleur.

La couleur est implicitement convertie au format HSV.

Voir aussi hsvHue(), hueF(), getHsv() et le format de couleur HSV.

qreal QColor::hueF () const

Retourne la composante teinte de cette couleur.

La couleur est implicitement convertie au format HSV.

Voir aussi hsvHueF(), hue(), getHsvF() et le format de couleur HSV.

bool QColor::isValid () const

Retourne true si la couleur est valide ; sinon retourne false.

bool QColor::isValidColor ( const QString & name ) [static]

Retourne true si le nom name est un nom de couleur valide et qu'il peut être utilisé pour construire un objet QColor valide, sinon retourne false.

La fonction utilise le même algorithme que dans setNamedColor().

Cette fonction a été introduite dans Qt 4.7.

Voir aussi setNamedColor().

QColor QColor::lighter ( int factor = 150 ) const

Retourne une couleur plus claire (ou plus sombre) sans modifier cet objet.

Si le facteur factor est plus grand que 100, cette fonction retourne une couleur plus claire. Définir le facteur factor à 150 retourne une couleur qui est 50 % plus claire. Si le facteur factor est inférieur à 100, la couleur retournée est plus sombre mais nous recommandons d'utiliser la fonction darker() dans ce cas. Si le facteur factor est 0 ou négatif, la valeur retournée est non spécifiée.

La fonction convertit la couleur RGB courante au format HSV, multiplie la composante valeur (V) par le facteur factor et reconvertit la couleur en RGB.

Cette fonction a été introduite dans Qt 4.3.

Voir aussi darker() et isValid().

int QColor::lightness () const

Retourne la composante de luminosité de cette couleur.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi lightnessF() et getHsl().

qreal QColor::lightnessF () const

Retourne la composante de luminosité de cette couleur.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi value() et getHslF().

int QColor::magenta () const

Retourne la composante magenta de cette couleur.

Voir aussi magentaF(), getCmyk() et le format de couleur CMYK.

qreal QColor::magentaF () const

Retourne la composante magenta de cette couleur.

Voir aussi magenta(), getCmykF() et le format de couleur CMYK.

QString QColor::name () const

Retourne le nom de la couleur dans le format « #RRGGBB »; c'est-à-dire, le caractère « # » suivi par trois ensembles de deux nombres hexadécimaux.

Voir aussi setNamedColor().

int QColor::red () const

Retourne la composante rouge de cette couleur.

Voir aussi setRed(), redF() et getRgb().

qreal QColor::redF () const

Retourne la composante rouge de cette couleur.

Voir aussi setRedF(), red() et getRgbF().

QRgb QColor::rgb () const

Retourne la valeur RGB de cette couleur. La valeur alpha est opaque.

Voir aussi setRgb(), getRgb() et rgba().

QRgb QColor::rgba () const

Retourne la valeur RGB de cette couleur, avec son alpha.

Pour une couleur invalide, la valeur de la composante alpha retournée est non spécifiée.

Voir aussi setRgba() et rgb().

int QColor::saturation () const

Retourne la composante de saturation de cette couleur.

La couleur est implicitement convertie au format HSV.

Voir aussi hsvSaturation(), saturationF(), getHsv() et le format de couleur HSV.

qreal QColor::saturationF () const

Retourne la composante de saturation de cette couleur.

La couleur est implicitement convertie au format HSV.

Voir aussi hsvSaturationF(), saturation(), getHsvF() et le format de couleur HSV.

void QColor::setAllowX11ColorNames ( bool enabled ) [static]

Autorise setNamedColor() à regarder dans la base de données de couleurs de X11 si enabled est true. Par défaut, setNamedColor() ne regarde pas dans la base de données de couleurs de X11.

Note : cette fonction est disponible uniquement sur les plateformes X11.

Voir aussi setNamedColor() et allowX11ColorNames().

void QColor::setAlpha ( int alpha )

Définit l'alpha de cette couleur à alpha. La valeur entière doit être comprise entre 0 et 255.

Voir aussi alpha(), alphaF() et dessin transparent.

void QColor::setAlphaF ( qreal alpha )

Définit la composante alpha de cette couleur à alpha. La valeur qreal doit être comprise entre 0.0 et 1.0.

Voir aussi alphaF(), alpha() et dessin transparent.

void QColor::setBlue ( int blue )

Définit la composante bleu de cette couleur à blue. La valeur entière doit être comprise entre 0 et 255.

Voir aussi blue(), blueF() et setRgb().

void QColor::setBlueF ( qreal blue )

Définit la composante bleu de cette couleur à blue. La valeur à virgule flottante doit être comprise entre 0.0 et 1.0.

Voir aussi blueF(), blue() et setRgbF().

void QColor::setCmyk ( int c, int m, int y, int k, int a = 255 )

Définit la couleur aux valeurs CMYK, c (cyan), m (magenta), y (jaune), k (noir) et a (canal alpha, c'est-à-dire, la transparence).

Toutes les valeurs doivent être comprises entre 0 et 255.

Voir aussi getCmyk(), setCmykF() et le format de couleur CMYK.

void QColor::setCmykF ( qreal c, qreal m, qreal y, qreal k, qreal a = 1.0 )

Il s'agit d'une fonction surchargée.

Définit la couleur aux valeurs CMYK, c (cyan), m (magenta), y (jaune), k (noir) et a (canal alpha, c'est-à-dire, la transparence).

Toutes les valeurs doivent être comprises entre 0.0 et 1.0.

Voir aussi getCmykF(), setCmyk() et le format de couleur CMYK.

void QColor::setGreen ( int green )

Définit la composante vert de cette couleur à green. La valeur entière doit être comprise entre 0 et 255.

Voir aussi green(), greenF() et setRgb().

void QColor::setGreenF ( qreal green )

Définit la composante vert de cette couleur à green. La valeur à virgule flottante doit être comprise entre 0.0 et 1.0.

Voir aussi greenF(), green() et setRgbF().

void QColor::setHsl ( int h, int s, int l, int a = 255 )

Définit la couleur aux valeurs HSL; h correspond à la teinte, s à la saturation, l à la luminosité et a à la composante alpha de la couleur au format HSL.

Les saturation, luminosité et alpha doivent être comprises entre 0 et 255, la teinte doit être supérieure à -1.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi getHsl() et setHslF().

void QColor::setHslF ( qreal h, qreal s, qreal l, qreal a = 1.0 )

Définit la couleur aux valeurs HSL; h correspond à la teinte, s à la saturation, l à la luminosité et a à la composante alpha de la couleur au format HSL.

Toutes les valeurs doivent être comprises entre 0.0 et 1.0.

Cette fonction a été introduite dans Qt 4.6.

Voir aussi getHslF() et setHsl().

void QColor::setHsv ( int h, int s, int v, int a = 255 )

Définit la couleur aux valeurs HSV; h correspond à la teinte, s, à la saturation, v, à la valeur et a à la composante alpha de la couleur au format HSV.

Les saturation, valeur et alpha doivent être comprises entre 0 et 255, la teinte doit être supérieure à -1.

Voir aussi hsv(), getHsv(), setHsvF() et le format de couleur HSV.

void QColor::setHsvF ( qreal h, qreal s, qreal v, qreal a = 1.0 )

Définit la couleur aux valeurs HSV; h correspond à la teinte, s, à la saturation, v, à la valeur et a à la composante alpha de la couleur au format HSV.

Toutes les valeurs doivent être comprises entre 0.0 et 1.0.

Voir aussi getHsvF(), setHsv() et le format de couleur HSV.

void QColor::setNamedColor ( const QString & name )

Définit cette QColor aux valeurs RGB à name, qui peut être dans l'un de ces formats :

• #RGB (chaque R, G et B est un simple chiffre hexadécimal) ;
• #RRGGBB ;
• #RRRGGGBBB ;
• #RRRRGGGGBBBB ;
• un nom venant de la liste de couleurs définies dans les noms de couleur SVG fournie par le World Wide Web Consortium ; par exemple, « steelblue » ou « gainsboro ». Ces noms de couleur fonctionnent sur toutes les plateformes. Notez que ces noms de couleur ne sont pas les mêmes que définis dans l'enum Qt::GlobalColor, par exemple, « green » et Qt::green ne correspondent pas à la même couleur ;
• transparent - représente l'absence de couleur ;
• X11 only : si allowX11ColorNames() retourne true, les noms venant de X11 sont valides. Voir la documentation pour la fonction XParseColor() pour avoir des informations sur les noms de couleur X11 valides.

La couleur est invalide si name ne peut être analysé.

Voir aussi QColor(), name(), isValid() et allowX11ColorNames().

void QColor::setRed ( int red )

Définit la composante rouge de cette couleur à red. La valeur entière doit être comprise entre 0 et 255.

Voir aussi red(), redF() et setRgb().

void QColor::setRedF ( qreal red )

Définit la composante rouge de cette couleur à red. La valeur à virgule flottante doit être comprise entre 0.0 et 1.0.

Voir aussi redF(), red() et setRgbF().

void QColor::setRgb ( int r, int g, int b, int a = 255 )

Définit les valeurs RBG à r, g, b et la composante alpha à a.

Toutes les valeurs doivent être comprises entre 0 et 255.

Voir aussi rgb(), getRgb() et setRgbF().

void QColor::setRgb ( QRgb rgb )

Il s'agit d'une fonction surchargée.

Définit les valeurs RGB à rgb. La composante alpha est définie comme opaque.

void QColor::setRgbF ( qreal r, qreal g, qreal b, qreal a = 1.0 )

Définit les canaux de couleur de cette couleur à r (rouge), g (vert), b (bleu) et a (alpha, transparence).

Toutes les valeurs doivent être comprises entre 0.0 et 1.0.

Voir aussi rgb(), getRgbF() et setRgb().

void QColor::setRgba ( QRgb rgba )

Définit les valeurs RGB à rgba, en incluant son alpha.

Voir aussi rgba() et rgb().

Spec QColor::spec () const

Retourne le format dans lequel la couleur a été spécifiée.

Voir aussi Spec et convertTo().

QColor QColor::toCmyk () const

Crée et retourne un QColor au format CMYK de cette couleur.

Voir aussi fromCmyk(), convertTo(), isValid() et le format de couleur CMYK.

QColor QColor::toHsl () const

Crée et retourne un QColor au format HSL de cette couleur.

Voir aussi fromHsl(), convertTo() et isValid().

QColor QColor::toHsv () const

Crée et retourne un QColor au format HSV de cette couleur.

Voir aussi fromHsv(), convertTo(), isValid() et le format de couleur HSV.

QColor QColor::toRgb () const

Crée et retourne un QColor au format RGB de cette couleur.

Voir aussi fromRgb(), convertTo() et isValid().

int QColor::value () const

Retourne la composante valeur de cette couleur.

Voir aussi valueF(), getHsv() et le format de couleur HSV.

qreal QColor::valueF () const

Retourne la composante valeur de cette couleur.

Voir aussi value(), getHsvF() et le format de couleur HSV.

int QColor::yellow () const

Retourne la composante jaune de cette couleur.

Voir aussi yellowF(), getCmyk() et le format de couleur CMYK.

qreal QColor::yellowF () const

Retourne la composante jaune de cette couleur.

Voir aussi yellow(), getCmykF() et le format de couleur CMYK.

QColor::operator QVariant () const

Retourne la couleur comme un QVariant.

bool QColor::operator!= ( const QColor & color ) const

Retourne true si cette couleur à une valeur RGB et alpha différents de color ; sinon retourne false.

QColor & QColor::operator= ( const QColor & color )

Assigne une copie de color à cette couleur et retourne une référence sur celle-ci.

QColor & QColor::operator= ( Qt::GlobalColor color )

Il s'agit d'une fonction surchargée.

Assigne une copie de color et retourne une référence sur celle-ci.

bool QColor::operator== ( const QColor & color ) const

Retourne true si cette couleur a les mêmes valeurs RGB et alpha que color; sinon retourne false.

En relation mais non membres de la classe

typedef QRgb

Un quadruplet ARGB au format #AARRGGBB, équivalent à un unsigned int.

Le type contient aussi un emplacement pour le canal alpha. La valeur par défaut pour l'alpha est ff, c'est-à-dire, opaque. Pour plus d'information, voir la section sur le Dessin transparent.

Voir aussi QColor::rgb() et QColor::rgba().

int qAlpha ( QRgb rgba )

Retourne la composante alpha du quadruplet ARGB rgba.

Voir aussi qRgb() et QColor::alpha().

int qBlue ( QRgb rgb )

Retourne la composante bleu du quadruplet ARGB rgb.

Voir aussi qRgb() et QColor::blue().

int qGray ( int r, int g, int b )

Retourne une nuance de gris (0 à 255) du triplet (r, g, b).

La nuance de gris est calculée suivant la formule (r * 11 + g * 16 + b * 5)/32.

int qGray ( QRgb rgb )

Il s'agit d'une fonction surchargée.

Retourne une nuance de gris (0 à 255) à partir du quadruplet rgb donné.

La nuance de gris est calculée suivant la formule (R * 11 + G * 16 + B * 5)/32 ; le canal alpha est ignoré.

int qGreen ( QRgb rgb )

Retourne la composante vert du quadruplet ARGB rgb.

Voir aussi qRgb() et QColor::green().

int qRed ( QRgb rgb )

Retourne la composante rouge du quagruplet ARGB rgb.

Voir aussi qRgb() et QColor::red().

QRgb qRgb ( int r, int g, int b )

Retourne le quadruplet ARGB (255, r, g, b).

Voir aussi qRgba(), qRed(), qGreen() et qBlue().

QRgb qRgba ( int r, int g, int b, int a )

Retourne le quadruplet ARGB (a, r, g, b).

Voir aussi qRgb(), qRed(), qGreen() et qBlue().

QDataStream & operator<< ( QDataStream & stream, const QColor & color )

Écrit la couleur color sur le flux stream.

Voir aussi sérialisation des types de donnée Qt.

QDataStream & operator>> ( QDataStream & stream, QColor & color )

Lit la couleur color à partir du flux stream.

Voir aussi sérialisation des types de donnée Qt.

Remerciements

Merci à Alexandre Laurent pour la traduction ainsi qu'à Emmanuel Di Clemente, Jonathan Courtois et Claude Leloup pour leur relecture !