ColorMatrix Classe

Definição

Namespace:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Pacote:

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

Origem:

ColorMatrix.cs

Define uma matriz 5 x 5 que contém as coordenadas para o espaço RGBAW. Vários métodos da classe ImageAttributes ajustam as cores da imagem usando uma matriz de cores. Essa classe não pode ser herdada.

public ref class ColorMatrix sealed

public sealed class ColorMatrix

type ColorMatrix = class

Public NotInheritable Class ColorMatrix

Herança

Object

ColorMatrix

Exemplos

O exemplo a seguir usa uma imagem que é toda uma cor (0.2, 0.0, 0.4, 1.0) e aplica a transformação descrita nos parágrafos anteriores.

A ilustração a seguir mostra a imagem original à esquerda e a imagem transformada à direita.

cores de cores

O código no exemplo a seguir usa as seguintes etapas para executar a recoloração:

1. Inicialize um objeto ColorMatrix.

2. Crie um objeto ImageAttributes e passe o objeto ColorMatrix para o método SetColorMatrix do objeto ImageAttributes.

3. Passe o objeto ImageAttributes para o método DrawImage de um objeto Graphics.

O exemplo anterior foi projetado para uso com o Windows Forms e requer PaintEventArgse, que é um parâmetro do manipulador de eventos 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)

Comentários

Os coeficientes de matriz constituem uma transformação linear 5 x 5 usada para transformar valores homogêneos ARGB. Por exemplo, um vetor ARGB é representado como vermelho, verde, azul, alfa e w, onde w é sempre 1.

Por exemplo, suponha que você queira começar com a cor (0.2, 0.0, 0.4, 1.0) e aplicar as seguintes transformações:

1. Dobrar o componente vermelho

2. Adicionar 0.2 aos componentes vermelho, verde e azul

A multiplicação de matriz a seguir executará o par de transformações na ordem listada.

Os elementos de uma matriz de cores são indexados (baseado em zero) por linha e coluna. Por exemplo, a entrada na quinta linha e terceira coluna da matriz M é indicada por M[4][2].

A matriz de identidade 5×5 (mostrada na ilustração a seguir) tem 1s na diagonal e 0s em todos os outros lugares. Se você multiplicar um vetor de cor pela matriz de identidade, o vetor de cor não será alterado. Uma maneira conveniente de formar a matriz de uma transformação de cores é começar com a matriz de identidade e fazer uma pequena alteração que produza a transformação desejada.

Para obter uma discussão mais detalhada sobre matrizes e transformações, consulte sistemas de coordenadas e transformações.

Construtores

ColorMatrix()	Inicializa uma nova instância da classe ColorMatrix.
ColorMatrix(Single[][])	Inicializa uma nova instância da classe ColorMatrix usando os elementos na matriz especificada newColorMatrix.

Propriedades

Item[Int32, Int32]	Obtém ou define o elemento na linha e coluna especificadas no ColorMatrix.
Matrix00	Obtém ou define o elemento na linha 0 (zero) e 0 coluna deste ColorMatrix.
Matrix01	Obtém ou define o elemento na linha 0 (zero) e na primeira coluna deste ColorMatrix.
Matrix02	Obtém ou define o elemento na linha 0 (zero) e na segunda coluna deste ColorMatrix.
Matrix03	Obtém ou define o elemento na linha 0 (zero) e na terceira coluna deste ColorMatrix. Representa o componente alfa.
Matrix04	Obtém ou define o elemento na linha 0 (zero) e quarta coluna deste ColorMatrix.
Matrix10	Obtém ou define o elemento na primeira linha e 0 (zero) coluna deste ColorMatrix.
Matrix11	Obtém ou define o elemento na primeira linha e na primeira coluna deste ColorMatrix.
Matrix12	Obtém ou define o elemento na primeira linha e na segunda coluna deste ColorMatrix.
Matrix13	Obtém ou define o elemento na primeira linha e terceira coluna deste ColorMatrix. Representa o componente alfa.
Matrix14	Obtém ou define o elemento na primeira linha e quarta coluna deste ColorMatrix.
Matrix20	Obtém ou define o elemento na segunda linha e 0 (zero) coluna deste ColorMatrix.
Matrix21	Obtém ou define o elemento na segunda linha e na primeira coluna deste ColorMatrix.
Matrix22	Obtém ou define o elemento na segunda linha e na segunda coluna deste ColorMatrix.
Matrix23	Obtém ou define o elemento na segunda linha e terceira coluna deste ColorMatrix.
Matrix24	Obtém ou define o elemento na segunda linha e quarta coluna deste ColorMatrix.
Matrix30	Obtém ou define o elemento na terceira linha e 0 (zero) coluna deste ColorMatrix.
Matrix31	Obtém ou define o elemento na terceira linha e na primeira coluna deste ColorMatrix.
Matrix32	Obtém ou define o elemento na terceira linha e na segunda coluna deste ColorMatrix.
Matrix33	Obtém ou define o elemento na terceira linha e terceira coluna deste ColorMatrix. Representa o componente alfa.
Matrix34	Obtém ou define o elemento na terceira linha e quarta coluna deste ColorMatrix.
Matrix40	Obtém ou define o elemento na quarta linha e 0 (zero) coluna deste ColorMatrix.
Matrix41	Obtém ou define o elemento na quarta linha e na primeira coluna deste ColorMatrix.
Matrix42	Obtém ou define o elemento na quarta linha e na segunda coluna deste ColorMatrix.
Matrix43	Obtém ou define o elemento na quarta linha e terceira coluna deste ColorMatrix. Representa o componente alfa.
Matrix44	Obtém ou define o elemento na quarta linha e quarta coluna deste ColorMatrix.

Métodos

Equals(Object)	Determina se o objeto especificado é igual ao objeto atual. (Herdado de Object)
GetHashCode()	Serve como a função de hash padrão. (Herdado de Object)
GetType()	Obtém o Type da instância atual. (Herdado de Object)
MemberwiseClone()	Cria uma cópia superficial do Objectatual. (Herdado de Object)
ToString()	Retorna uma cadeia de caracteres que representa o objeto atual. (Herdado de Object)

Confira também

• recolorir imagens