ColorMatrix Classe

Définition

Espace de noms:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v9.0.0-preview.7.24405.4

Source:

ColorMatrix.cs

Définit une matrice de 5 x 5 qui contient les coordonnées de l’espace RVBAW. Plusieurs méthodes de la classe ImageAttributes ajustent les couleurs d’image à l’aide d’une matrice de couleurs. Cette classe ne peut pas être héritée.

public ref class ColorMatrix sealed

public sealed class ColorMatrix

type ColorMatrix = class

Public NotInheritable Class ColorMatrix

Héritage

Object

ColorMatrix

Exemples

L’exemple suivant prend une image qui est toute une couleur (0.2, 0.0, 0.4, 1.0) et applique la transformation décrite dans les paragraphes précédents.

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

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

1. Initialisez un objet ColorMatrix.

2. Créez un objet ImageAttributes et transmettez l’objet ColorMatrix à la méthode SetColorMatrix de l’objet ImageAttributes.

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

L’exemple précédent est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint

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

Les coefficients de matrice constituent une transformation linéaire de 5 x 5 utilisée pour transformer des valeurs homogènes ARGB. Par exemple, un vecteur ARGB est représenté comme rouge, vert, bleu, alpha et w, où w est toujours 1.

Par exemple, supposons que vous voulez commencer par la couleur (0.2, 0.0, 0.4, 1.0) et appliquer les transformations suivantes :

1. Double du composant rouge

2. Ajouter 0.2 aux composants rouges, verts et bleus

La multiplication de matrices suivante effectue la paire de transformations dans l’ordre indiqué.

Les éléments d’une matrice de couleur sont indexés (de base zéro) par ligne, puis colonne. Par exemple, l’entrée dans la cinquième ligne et la troisième colonne de matrice M est indiquée par M[4][2].

La matrice d’identité 5×5 (illustrée dans l’illustration suivante) comporte 1 sur la diagonale et les 0 partout ailleurs. Si vous multipliez un vecteur de couleur par la matrice d’identité, le vecteur de couleur ne change pas. Un moyen pratique de former la matrice d’une transformation de couleur consiste à commencer par la matrice d’identité et à apporter une petite modification qui produit la transformation souhaitée.

Pour une présentation plus détaillée des matrices et des transformations, consultez Systèmes de coordonnées et transformations.

Constructeurs

ColorMatrix()	Initialise une nouvelle instance de la classe ColorMatrix.
ColorMatrix(Single[][])	Initialise une nouvelle instance de la classe ColorMatrix à l’aide des éléments de la matrice spécifiée newColorMatrix.

Propriétés

Item[Int32, Int32]	Obtient ou définit l’élément à la ligne et à la colonne spécifiées dans le ColorMatrix.
Matrix00	Obtient ou définit l’élément à la ligne 0 (zéro) et à la colonne 0 de cette ColorMatrix.
Matrix01	Obtient ou définit l’élément à la ligne 0 (zéro) et la première colonne de cette ColorMatrix.
Matrix02	Obtient ou définit l’élément à la ligne 0 (zéro) et la deuxième colonne de cette ColorMatrix.
Matrix03	Obtient ou définit l’élément à la ligne 0 (zéro) et à la troisième colonne de cette ColorMatrix. Représente le composant alpha.
Matrix04	Obtient ou définit l’élément à la ligne 0 (zéro) et à la quatrième colonne de cette ColorMatrix.
Matrix10	Obtient ou définit l’élément à la première ligne et 0 (zéro) colonne de cette ColorMatrix.
Matrix11	Obtient ou définit l’élément à la première ligne et à la première colonne de cette ColorMatrix.
Matrix12	Obtient ou définit l’élément à la première ligne et à la deuxième colonne de cette ColorMatrix.
Matrix13	Obtient ou définit l’élément à la première ligne et à la troisième colonne de cette ColorMatrix. Représente le composant alpha.
Matrix14	Obtient ou définit l’élément à la première ligne et à la quatrième colonne de cette ColorMatrix.
Matrix20	Obtient ou définit l’élément à la deuxième ligne et 0 (zéro) colonne de cette ColorMatrix.
Matrix21	Obtient ou définit l’élément à la deuxième ligne et à la première colonne de cette ColorMatrix.
Matrix22	Obtient ou définit l’élément à la deuxième ligne et à la deuxième colonne de cette ColorMatrix.
Matrix23	Obtient ou définit l’élément à la deuxième ligne et à la troisième colonne de cette ColorMatrix.
Matrix24	Obtient ou définit l’élément à la deuxième ligne et à la quatrième colonne de cette ColorMatrix.
Matrix30	Obtient ou définit l’élément à la troisième ligne et 0 (zéro) colonne de cette ColorMatrix.
Matrix31	Obtient ou définit l’élément à la troisième ligne et à la première colonne de cette ColorMatrix.
Matrix32	Obtient ou définit l’élément à la troisième ligne et à la deuxième colonne de cette ColorMatrix.
Matrix33	Obtient ou définit l’élément à la troisième ligne et à la troisième colonne de cette ColorMatrix. Représente le composant alpha.
Matrix34	Obtient ou définit l’élément à la troisième ligne et à la quatrième colonne de cette ColorMatrix.
Matrix40	Obtient ou définit l’élément à la quatrième ligne et 0 (zéro) colonne de cette ColorMatrix.
Matrix41	Obtient ou définit l’élément à la quatrième ligne et à la première colonne de cette ColorMatrix.
Matrix42	Obtient ou définit l’élément à la quatrième ligne et à la deuxième colonne de cette ColorMatrix.
Matrix43	Obtient ou définit l’élément à la quatrième ligne et à la troisième colonne de cette ColorMatrix. Représente le composant alpha.
Matrix44	Obtient ou définit l’élément à la quatrième ligne et à la quatrième colonne de cette ColorMatrix.

Méthodes

Equals(Object)	Détermine si l’objet spécifié est égal à l’objet actuel. (Hérité de Object)
GetHashCode()	Sert de fonction de hachage par défaut. (Hérité de Object)
GetType()	Obtient la Type de l’instance actuelle. (Hérité de Object)
MemberwiseClone()	Crée une copie superficielle du Objectactuel. (Hérité de Object)
ToString()	Retourne une chaîne qui représente l’objet actuel. (Hérité de Object)

Voir aussi

• recoloriage d’images