ColorMatrix Classe

Definição

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
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.

recolorir

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.

recolorir

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(ReadOnlySpan<Single>)

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.

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)

Aplica-se a

Confira também