Partager via

CurveAdjustments, énumération (gdipluseffects.h)

  • Article

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)