Structure LevelsParams (gdipluseffects.h)

La structure LevelsParams contient des membres qui spécifient des ajustements aux zones claires, moyennes ou sombres d’une bitmap.

Vous pouvez ajuster les zones claires, moyennes ou sombres d’une bitmap en procédant comme suit.

1. Créez et initialisez une structure LevelsParams .
2. Passez l’adresse de la structure LevelsParams à la méthode Levels::SetParameters d’un objet Levels .
3. Transmettez l’adresse de l’objet Levels à la méthode Graphics::D rawImage ou à la méthode Bitmap::ApplyEffect .

Syntaxe

struct LevelsParams {
  INT highlight;
  INT midtone;
  INT shadow;
};

Membres

highlight

Type : INT

Entier compris entre 0 et 100 qui spécifie les pixels à éclaircir. Vous pouvez utiliser ce réglage pour éclaircir les pixels qui sont déjà plus légers qu’un certain seuil. La définition de surbrillance sur 100 ne spécifie aucune modification. La définition de surbrillance sur t spécifie qu’une valeur de canal de couleur est augmentée si elle est déjà supérieure à t pour cent de l’intensité totale. Par exemple, la définition de 90 surbrillance spécifie que toutes les valeurs de canal de couleur supérieures à 90 % de l’intensité totale sont augmentées.

midtone

Type : INT

Entier dans la plage -100 à 100 qui spécifie la quantité à éclaircir ou assombrir une image. Les valeurs de canal de couleur au milieu de la plage d’intensité sont modifiées plus que les valeurs de canal de couleur proches de l’intensité minimale ou maximale. Vous pouvez utiliser cet ajustement pour éclaircir (ou assombrir) une image sans perdre le contraste entre les parties les plus sombres et les plus claires de l’image. La valeur 0 ne spécifie aucune modification. Les valeurs positives spécifient que les tons moyens sont rendus plus clairs, et les valeurs négatives spécifient que les tons moyens sont rendus plus foncés.

shadow

Type : INT

Entier compris entre 0 et 100 qui spécifie les pixels à assombrir. Vous pouvez utiliser cet ajustement pour assombrir les pixels qui sont déjà plus foncés qu’un certain seuil. L’attribution de la valeur 0 à l’ombre ne spécifie aucune modification. La définition de l’ombre sur t spécifie qu’une valeur de canal de couleur est réduite si elle est déjà inférieure à t pour cent de l’intensité totale. Par exemple, la définition de l’ombre sur 10 spécifie que toutes les valeurs de canal de couleur inférieures à 10 % de l’intensité totale sont réduites.

Configuration requise

Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
En-tête	gdipluseffects.h (include Gdiplus.h)