ColorMatrix Classe

Definição

public ref class ColorMatrix sealed

public sealed class ColorMatrix

type ColorMatrix = class

Public NotInheritable Class ColorMatrix

Herança

Object

ColorMatrix

Exemplos

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

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

O código no exemplo seguinte utiliza os seguintes passos para realizar a recoloração:

1. Inicializar um ColorMatrix objeto.

2. Cria um ImageAttributes objeto e passa o ColorMatrix objeto para o SetColorMatrix método do objeto ImageAttributes .

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

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

Observações

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

Por exemplo, suponha que quer começar pela cor (0,2, 0,0, 0,4, 1,0) e aplicar as seguintes transformações:

1. Dobro o componente vermelho

2. Adicione 0,2 aos componentes vermelho, verde e azul

A seguinte multiplicação de matrizes realizará o par de transformações na ordem listada.

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

A matriz identidade 5×5 (mostrada na ilustração seguinte) tem 1s na diagonal e 0s em todo o resto. Se multiplicar um vetor de cor pela matriz identidade, o vetor de cor não muda. Uma forma conveniente de formar a matriz de uma transformação de cor é começar pela matriz identidade e fazer uma pequena alteração que produza a transformação desejada.

Para uma discussão mais detalhada sobre matrizes e transformações, veja Sistemas de Coordenadas e Transformações.

Ver também

• Recolorir imagens