ImageAttributes Classe

Définition

Espace de noms:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v8.0.0

Source:

ImageAttributes.cs

Contient des informations sur la manière dont les couleurs de bitmap et de métafichier sont manipulées pendant le rendu.

public ref class ImageAttributes sealed : ICloneable, IDisposable

public sealed class ImageAttributes : ICloneable, IDisposable

type ImageAttributes = class
    interface ICloneable
    interface IDisposable

Public NotInheritable Class ImageAttributes
Implements ICloneable, IDisposable

Héritage

Object

ImageAttributes

Implémente

ICloneable IDisposable

Exemples

L’exemple suivant prend une image qui est d’une seule couleur (0.2, 0.0, 0.4, 1.0) et double le composant rouge ajoute 0,2 aux composants rouge, vert et bleu.

L’illustration suivante montre l’image d’origine à gauche et l’image transformée à droite.

Le code de l’exemple utilise les étapes suivantes pour effectuer la recoloration :

1. Initialiser un ColorMatrix objet.

2. Create un ImageAttributes objet et passez l’objet ColorMatrix à la SetColorMatrix méthode de l’objet ImageAttributes .

3. Passez l’objet ImageAttributes à la DrawImage méthode d’un Graphics objet.

Image image = new Bitmap("InputColor.bmp");
ImageAttributes imageAttributes = new ImageAttributes();
int width = image.Width;
int height = image.Height;

float[][] colorMatrixElements = { 
   new float[] {2,  0,  0,  0, 0},        // red scaling factor of 2
   new float[] {0,  1,  0,  0, 0},        // green scaling factor of 1
   new float[] {0,  0,  1,  0, 0},        // blue scaling factor of 1
   new float[] {0,  0,  0,  1, 0},        // alpha scaling factor of 1
   new float[] {.2f, .2f, .2f, 0, 1}};    // three translations of 0.2

ColorMatrix colorMatrix = new ColorMatrix(colorMatrixElements);

imageAttributes.SetColorMatrix(
   colorMatrix,
   ColorMatrixFlag.Default,
   ColorAdjustType.Bitmap);

e.Graphics.DrawImage(image, 10, 10);

e.Graphics.DrawImage(
   image,
   new Rectangle(120, 10, width, height),  // destination rectangle 
   0, 0,        // upper-left corner of source rectangle 
   width,       // width of source rectangle
   height,      // height of source rectangle
   GraphicsUnit.Pixel,
   imageAttributes);

Dim image As New Bitmap("InputColor.bmp")
Dim imageAttributes As New ImageAttributes()
Dim width As Integer = image.Width
Dim height As Integer = image.Height

' The following matrix consists of the following transformations:
' red scaling factor of 2
' green scaling factor of 1
' blue scaling factor of 1
' alpha scaling factor of 1
' three translations of 0.2
Dim colorMatrixElements As Single()() = { _
   New Single() {2, 0, 0, 0, 0}, _
   New Single() {0, 1, 0, 0, 0}, _
   New Single() {0, 0, 1, 0, 0}, _
   New Single() {0, 0, 0, 1, 0}, _
   New Single() {0.2F, 0.2F, 0.2F, 0, 1}}

Dim colorMatrix As New ColorMatrix(colorMatrixElements)

imageAttributes.SetColorMatrix(colorMatrix, ColorMatrixFlag.Default, ColorAdjustType.Bitmap)

e.Graphics.DrawImage(image, 10, 10)

e.Graphics.DrawImage( _
   image, _
   New Rectangle(120, 10, width, height), _
   0, _
   0, _
   width, _
   height, _
   GraphicsUnit.Pixel, _
   imageAttributes)

Remarques

Un ImageAttributes objet gère plusieurs paramètres d’ajustement des couleurs, notamment des matrices d’ajustement des couleurs, des matrices d’ajustement des nuances de gris, des valeurs de correction gamma, des tables de mappage de couleurs et des valeurs de seuil de couleur. Pendant le rendu, les couleurs peuvent être corrigées, assombries, éclaircies et supprimées. Pour appliquer de telles manipulations, initialisez un ImageAttributes objet et passez le chemin de cet objet (ainsi que ImageAttributes le chemin d’accès d’un Image) à la DrawImage méthode .

Notes

Dans .NET 6 et versions ultérieures, le package System.Drawing.Common, qui inclut ce type, est uniquement pris en charge sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateformes entraîne des avertissements au moment de la compilation et des exceptions au moment de l’exécution. Pour plus d’informations, consultez System.Drawing.Common uniquement pris en charge sur Windows.

Constructeurs

ImageAttributes()

Initialise une nouvelle instance de la classe ImageAttributes.

Méthodes

ClearBrushRemapTable()	Efface la table de remappage des couleurs de pinceau de cet objet ImageAttributes.
ClearColorKey()	Efface la clé de couleur (plage de transparence) pour la catégorie par défaut.
ClearColorKey(ColorAdjustType)	Efface la clé de couleur (plage de transparence) pour une catégorie spécifiée.
ClearColorMatrix()	Efface la matrice de réglage des couleurs pour la catégorie par défaut.
ClearColorMatrix(ColorAdjustType)	Efface la matrice de réglage des couleurs pour une catégorie spécifiée.
ClearGamma()	Désactive la correction gamma pour la catégorie par défaut.
ClearGamma(ColorAdjustType)	Désactive la correction gamma pour une catégorie spécifiée.
ClearNoOp()	Efface le paramètre NoOp pour la catégorie par défaut.
ClearNoOp(ColorAdjustType)	Efface le paramètre NoOp pour une catégorie spécifiée.
ClearOutputChannel()	Efface le paramètre du canal de sortie CMJN (cyan-magenta-jaune-noir) pour la catégorie par défaut.
ClearOutputChannel(ColorAdjustType)	Efface le paramètre du canal de sortie CMJN (cyan-magenta-jaune-noir) pour une catégorie spécifiée.
ClearOutputChannelColorProfile()	Efface le paramètre du profil des couleurs du canal de sortie pour la catégorie par défaut.
ClearOutputChannelColorProfile(ColorAdjustType)	Efface le paramètre du profil des couleurs du canal de sortie pour une catégorie spécifiée.
ClearRemapTable()	Efface la table de remappage des couleurs pour la catégorie par défaut.
ClearRemapTable(ColorAdjustType)	Efface la table de remappage des couleurs pour une catégorie spécifiée.
ClearThreshold()	Efface la valeur de seuil pour la catégorie par défaut.
ClearThreshold(ColorAdjustType)	Efface la valeur de seuil pour une catégorie spécifiée.
Clone()	Crée une copie exacte de cet objet ImageAttributes.
Dispose()	Libère toutes les ressources utilisées par cet objet ImageAttributes.
Equals(Object)	Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object)
Finalize()	Autorise un objet à tenter de libérer des ressources et à exécuter d'autres opérations de nettoyage avant qu'il ne soit récupéré par une opération garbage collection.
GetAdjustedPalette(ColorPalette, ColorAdjustType)	Règle les couleurs dans une palette selon les paramètres de réglage d'une catégorie spécifiée.
GetHashCode()	Fait office de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient le Type de l'instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Object actuel. (Hérité de Object)
SetBrushRemapTable(ColorMap[])	Définit la table de remappage des couleurs pour la catégorie pinceau.
SetColorKey(Color, Color)	Définit la clé de couleur pour la catégorie par défaut.
SetColorKey(Color, Color, ColorAdjustType)	Définit la clé de couleur (plage de transparence) pour une catégorie spécifiée.
SetColorMatrices(ColorMatrix, ColorMatrix)	Définit la matrice de réglage des couleurs et la matrice de réglage des nuances de gris pour la catégorie par défaut.
SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag)	Définit la matrice de réglage des couleurs et la matrice de réglage des nuances de gris pour la catégorie par défaut.
SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType)	Définit la matrice de réglage des couleurs et la matrice de réglage des nuances de gris pour une catégorie spécifiée.
SetColorMatrix(ColorMatrix)	Définit la matrice de réglage des couleurs pour la catégorie par défaut.
SetColorMatrix(ColorMatrix, ColorMatrixFlag)	Définit la matrice de réglage des couleurs pour la catégorie par défaut.
SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType)	Définit la matrice de réglage des couleurs pour une catégorie spécifiée.
SetGamma(Single)	Définit la valeur gamma pour la catégorie par défaut.
SetGamma(Single, ColorAdjustType)	Définit la valeur gamma pour une catégorie spécifiée.
SetNoOp()	Désactive le réglage des couleurs pour la catégorie par défaut. Vous pouvez appeler la méthode ClearNoOp pour rétablir les paramètres de réglage des couleurs qui étaient en vigueur avant l'appel à la méthode SetNoOp.
SetNoOp(ColorAdjustType)	Désactive le réglage des couleurs pour une catégorie spécifiée. Vous pouvez appeler la méthode ClearNoOp pour rétablir les paramètres de réglage des couleurs qui étaient en vigueur avant l'appel à la méthode SetNoOp.
SetOutputChannel(ColorChannelFlag)	Définit le canal de sortie CMJN (cyan-magenta-jaune-noir) pour la catégorie par défaut.
SetOutputChannel(ColorChannelFlag, ColorAdjustType)	Définit le canal de sortie CMJN (cyan-magenta-jaune-noir) pour une catégorie spécifiée.
SetOutputChannelColorProfile(String)	Définit le fichier du profil des couleurs du canal de sortie pour la catégorie par défaut.
SetOutputChannelColorProfile(String, ColorAdjustType)	Définit le fichier du profil des couleurs du canal de sortie pour une catégorie spécifiée.
SetRemapTable(ColorMap[])	Définit la table de remappage des couleurs pour la catégorie par défaut.
SetRemapTable(ColorMap[], ColorAdjustType)	Définit la table de remappage des couleurs pour une catégorie spécifiée.
SetThreshold(Single)	Définit le seuil (plage de transparence) pour la catégorie par défaut.
SetThreshold(Single, ColorAdjustType)	Définit le seuil (plage de transparence) pour une catégorie spécifiée.
SetWrapMode(WrapMode)	Définit le mode habillage qui est utilisé pour décider comment placer une texture en mosaïque sur une forme ou au niveau des limites d'une forme. Une texture est placée en mosaïque sur une forme pour remplir celle-ci quand la texture est plus petite que la forme qu'elle remplit.
SetWrapMode(WrapMode, Color)	Spécifie le mode habillage et la couleur utilisés pour décider comment placer une texture en mosaïque sur une forme ou au niveau des limites d'une forme. Une texture est placée en mosaïque sur une forme pour remplir celle-ci quand la texture est plus petite que la forme qu'elle remplit.
SetWrapMode(WrapMode, Color, Boolean)	Spécifie le mode habillage et la couleur utilisés pour décider comment placer une texture en mosaïque sur une forme ou au niveau des limites d'une forme. Une texture est placée en mosaïque sur une forme pour remplir celle-ci quand la texture est plus petite que la forme qu'elle remplit.
ToString()	Retourne une chaîne qui représente l'objet actuel. (Hérité de Object)

Voir aussi

• Guide pratique pour utiliser une matrice de couleurs pour transformer une couleur unique
• Recoloriage des images