ColorMatrix Klasse

Definition

public ref class ColorMatrix sealed

public sealed class ColorMatrix

type ColorMatrix = class

Public NotInheritable Class ColorMatrix

Vererbung

Object

ColorMatrix

Beispiele

Im folgenden Beispiel wird ein Bild verwendet, das alle eine Farbe (0,2, 0,0, 0,4, 1.0) aufweist und die in den vorherigen Absätzen beschriebene Transformation anwendet.

Die folgende Abbildung zeigt das ursprüngliche Bild auf der linken Seite und das transformierte Bild auf der rechten Seite.

Der Code im folgenden Beispiel verwendet die folgenden Schritte zum Neufärben:

1. Initialisieren eines ColorMatrix-Objekts.

2. Erstellen Sie ein ImageAttributes-Objekt, und übergeben Sie das ColorMatrix-Objekt an die SetColorMatrix-Methode des ImageAttributes-Objekts.

3. Übergeben Sie das ImageAttributes-Objekt an die DrawImage-Methode eines Graphics-Objekts.

Das vorangehende Beispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt.

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)

Hinweise

Die Matrixkoeffizienten stellen eine lineare Transformation von 5 x 5 dar, die zum Transformieren homogener ARGB-Werte verwendet wird. Beispielsweise wird ein ARGB-Vektor als rot, grün, blau, alpha und w dargestellt, wobei w immer 1 ist.

Angenommen, Sie möchten mit der Farbe (0.2, 0.0, 0.4, 1.0) beginnen und die folgenden Transformationen anwenden:

1. Doppeltippen der roten Komponente

2. Hinzufügen von 0,2 zu den roten, grünen und blauen Komponenten

Die folgende Matrixmultiplikation führt das Transformationspaar in der aufgeführten Reihenfolge aus.

Die Elemente einer Farbmatrix werden nach Zeile und spalte indiziert (nullbasiert). Beispielsweise wird der Eintrag in der fünften Zeile und der dritten Spalte der Matrix M durch M[4][2] bezeichnet.

Die 5×5-Identitätsmatrix (in der folgenden Abbildung dargestellt) hat 1 auf der Diagonale und 0s überall sonst. Wenn Sie einen Farbvektor mit der Identitätsmatrix multiplizieren, ändert sich der Farbvektor nicht. Eine bequeme Möglichkeit, die Matrix einer Farbtransformation zu bilden, besteht darin, mit der Identitätsmatrix zu beginnen und eine kleine Änderung vorzunehmen, die die gewünschte Transformation erzeugt.

Eine ausführlichere Erläuterung von Matrizen und Transformationen finden Sie unter Koordinatensysteme und Transformationen.

Konstruktoren

Eigenschaften

Methoden

Gilt für:

Weitere Informationen

• Neu einfärben von Bildern