ColorAdjustLuma, fonction (shlwapi.h)

Modifie la luminosité d’une valeur RVB. La teinte et la saturation ne sont pas affectées.

Syntaxe

COLORREF ColorAdjustLuma(
  COLORREF clrRGB,
  int      n,
  BOOL     fScale
);

Paramètres

clrRGB

Type : COLORREF

Valeur RVB initiale.

n

Type : int

Luminosité en unités de 0,1 % de la plage totale. Par exemple, la valeur n = 50 correspond à 5 % de la luminosité maximale.

fScale

Type : BOOL

Si fScale a la valeur TRUE, n spécifie la quantité d’incrémentation ou de décrémentation de la luminance actuelle. Si fScale a la valeur FALSE, n spécifie la luminance absolue.

Valeur retournée

Type : COLORREF

Retourne la valeur RVB modifiée.

Remarques

Si fScale a la valeur TRUE, n peut aller de -1000 à +1000.

Si fScale a la valeur FALSE, n peut être comprise entre 0 et 1 000. Les valeurs de luminance disponibles sont comprises entre 0 et un maximum. Si la valeur demandée est négative ou dépasse la valeur maximale, la luminance est définie sur zéro ou la valeur maximale, respectivement.

Configuration requise