CurveAdjustments, énumération (gdipluseffects.h)

La classe ColorCurve englobe les huit ajustements bitmap répertoriés dans l’énumération CurveAdjustments .

Pour appliquer l’un des huit ajustements à une bitmap, procédez comme suit.

1. Créez une structure ColorCurveParams et définissez son membre d’ajustement sur l’un des éléments de l’énumération CurveAdjustments .
2. Définissez les deux autres membres (adjustValue et channel) de la structure ColorCurveParams .
3. Passez l’adresse de la structure ColorCurveParams à la méthode ColorCurve ::SetParameters d’un objet ColorCurve .
4. Transmettez l’adresse de l’objet ColorCurve à la méthode Graphics ::D rawImage ou à la méthode Bitmap ::ApplyEffect .

Syntax

typedef enum CurveAdjustments {
  AdjustExposure,
  AdjustDensity,
  AdjustContrast,
  AdjustHighlight,
  AdjustShadow,
  AdjustMidtone,
  AdjustWhiteSaturation,
  AdjustBlackSaturation
} ;

Constantes

AdjustExposure Simule l’augmentation ou la diminution de l’exposition d’une photographie. Lorsque vous définissez le membre d’ajustement d’un objet ColorCurveParams sur AdjustExposure, vous devez définir le membre adjustValue sur un entier compris entre -255 et 255. La valeur 0 ne spécifie aucune modification de l’exposition. Les valeurs positives spécifient une exposition accrue et les valeurs négatives spécifient une exposition réduite.
AdjustDensity Simule l’augmentation ou la diminution de la densité du film d’une photographie. Lorsque vous définissez le membre d’ajustement d’un objet ColorCurveParams sur AdjustDensity, vous devez définir le membre adjustValue sur un entier compris entre -255 et 255. La valeur 0 ne spécifie aucune modification de la densité. Les valeurs positives spécifient une densité accrue (image plus claire) et les valeurs négatives spécifient une densité réduite (image plus sombre).
AdjustContrast Augmente ou diminue le contraste d’une bitmap. Lorsque vous définissez le membre d’ajustement d’un objet ColorCurveParams sur AdjustContrast, vous devez définir le membre adjustValue sur un entier compris entre -100 et 100. La valeur 0 ne spécifie aucune modification du contraste. Les valeurs positives spécifient un contraste accru et les valeurs négatives spécifient un contraste réduit.
AdjustHighlight Augmente ou diminue la valeur d’un canal de couleur si ce canal a déjà une valeur supérieure à la moitié de l’intensité. Vous pouvez utiliser cet ajustement pour obtenir plus de définition dans les zones claires d’une image sans affecter les zones sombres. Lorsque vous définissez le membre d’ajustement d’un objet ColorCurveParams sur AdjustHighlight, vous devez définir le membre adjustValue sur un entier compris entre -100 et 100. La valeur 0 ne spécifie aucune modification. Les valeurs positives spécifient que les zones claires sont rendues plus claires, et les valeurs négatives indiquent que les zones claires sont rendues plus sombres.
AdjustShadow Augmente ou diminue la valeur d’un canal de couleurs si ce canal a déjà une valeur inférieure à la moitié d’intensité. Vous pouvez utiliser cet ajustement pour obtenir plus de définition dans les zones sombres d’une image sans affecter les zones claires. Lorsque vous définissez le membre d’ajustement d’un objet ColorCurveParams sur AdjustShadow, vous devez définir le membre adjustValue sur un entier compris entre -100 et 100. La valeur 0 ne spécifie aucune modification. Les valeurs positives spécifient que les zones sombres sont rendues plus claires, et les valeurs négatives indiquent que les zones sombres sont rendues plus sombres.
AdjustMidtone Éclaircit ou assombrit 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. Lorsque vous définissez le membre d’ajustement d’un objet ColorCurveParams sur AdjustMidtone, vous devez définir le membre adjustValue sur un entier compris entre -100 et 100. 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.
AdjustWhiteSaturation Lorsque vous définissez le membre d’ajustement d’un objet ColorCurveParams sur AdjustWhiteSaturation, vous devez définir le membre adjustValue sur un entier compris entre 0 et 255. Une valeur de t spécifie que l’intervalle [0, t] est mappé linéairement à l’intervalle [0, 255]. Par exemple, si adjustValue est égal à 240, les valeurs du canal de couleur dans l’intervalle [0, 240] sont ajustées de sorte qu’elles soient réparties sur l’intervalle [0, 255]. Les valeurs de canal de couleur supérieures à 240 sont définies sur 255.
AdjustBlackSaturation Lorsque vous définissez le membre d’ajustement d’un objet ColorCurveParams sur AdjustBlackSaturation, vous devez définir le membre adjustValue sur un entier compris entre 0 et 255. La valeur t spécifie que l’intervalle [t, 255] est mappé linéairement à l’intervalle [0, 255]. Par exemple, si adjustValue est égal à 15, les valeurs du canal de couleur dans l’intervalle [15, 255] sont ajustées de sorte qu’elles soient réparties sur l’intervalle [0, 255]. Les valeurs de canal de couleur inférieures à 15 sont définies sur 0.

Configuration requise

Condition requise	Valeur
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)