ImageAttributes Classe

Référence

Définition

Espace de noms:: System.Drawing.Imaging

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

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 toute une couleur (0.2, 0.0, 0.4, 1.0) et double le composant rouge ajoute 0,2 aux composants rouges, verts et bleus.

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

Couleurs

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

Initialisez un ColorMatrix objet.
Créez un ImageAttributes objet et transmettez l’objet ColorMatrix à la SetColorMatrix méthode de l’objet ImageAttributes .
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 conserve plusieurs paramètres d’ajustement de couleur, notamment les matrices d’ajustement des couleurs, les matrices d’ajustement des nuances de gris, les valeurs de correction gamma, les tables de carte de couleurs et les valeurs de seuil de couleur. Pendant le rendu, les couleurs peuvent être corrigées, assombrées, éclaircies et supprimées. Pour appliquer ces manipulations, initialisez un ImageAttributes objet et passez le chemin de cet ImageAttributes objet (ainsi que 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 comprend ce type, est uniquement pris en charge sur les systèmes d’exploitation Windows. L’utilisation de ce type dans les applications multiplateforme provoque 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)

S’applique à