ImageAttributes ::ClearGamma, méthode (gdiplusimageattributes.h)

La méthode ImageAttributes ::ClearGamma désactive la correction gamma pour une catégorie spécifiée.

Syntaxe

Status ClearGamma(
  [in, optional] ColorAdjustType type
);

Paramètres

[in, optional] type

Type : ColorAdjustType

Élément de l’énumération ColorAdjustType qui spécifie la catégorie pour laquelle la correction gamma est désactivée. La valeur par défaut est ColorAdjustTypeDefault.

Valeur retournée

Type : État

Si la méthode réussit, elle retourne Ok, qui est un élément de l’énumération Status .

Si la méthode échoue, elle retourne l’un des autres éléments de l’énumération Status .

Remarques

Un objet ImageAttributes conserve les paramètres de couleurs et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier une valeur gamma pour la catégorie par défaut, une autre valeur gamma pour la catégorie bitmap et une autre valeur gamma pour la catégorie de stylet.

Les paramètres de réglage des couleurs et des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.

Dès que vous spécifiez un paramètre de réglage des couleurs ou des nuances de gris pour une catégorie donnée, les paramètres d’ajustement par défaut ne s’appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez une valeur gamma et une matrice de réglage des couleurs pour la catégorie par défaut. Si vous définissez la valeur gamma pour la catégorie de stylet en appelant ImageAttributes ::SetGamma, la valeur gamma par défaut ne s’applique pas aux stylets. Si vous effacez ultérieurement la valeur gamma du stylet en appelant ImageAttributes ::ClearGamma, la catégorie de stylet ne reprendra pas la valeur gamma par défaut ; au lieu de cela, la catégorie de stylet n’aura aucune valeur gamma. De même, la catégorie de stylet ne revient pas à la matrice de réglage des couleurs par défaut ; au lieu de cela, la catégorie de stylet n’aura pas de matrice de réglage des couleurs.

Configuration requise

Voir aussi

Bitmap

ColorAdjustType

Image

ImageAttributes

ImageAttributes ::SetGamma

Metafile

Recolorisation