ImageAttributes Classe

Definição

Contém informações sobre como as cores do bitmap e do metarquivo são manipuladas durante a renderização.Contains information about how bitmap and metafile colors are manipulated during rendering.

public ref class ImageAttributes sealed : ICloneable, IDisposable
public sealed class ImageAttributes : ICloneable, IDisposable
type ImageAttributes = class
    interface ICloneable
    interface IDisposable
Public NotInheritable Class ImageAttributes
Implements ICloneable, IDisposable
Herança
ImageAttributes
Implementações

Exemplos

O exemplo a seguir usa uma imagem que é toda uma cor (0,2, 0,0, 0,4, 1,0) e dobra o componente vermelho adiciona 0,2 aos componentes vermelho, verde e azulThe following example takes an image that is all one color (0.2, 0.0, 0.4, 1.0) and doubles the red component adds 0.2 to the red, green, and blue components

A ilustração a seguir mostra a imagem original à esquerda e a imagem transformada à direita.The following illustration shows the original image on the left and the transformed image on the right.

CoresColors

O código no exemplo a seguir usa as seguintes etapas para recolorir:The code in the following example uses the following steps to perform the recoloring:

  1. Inicializar um objeto ColorMatrix.Initialize a ColorMatrix object.

  2. Crie um objeto ImageAttributes e passe o objeto ColorMatrix para o método SetColorMatrix do objeto ImageAttributes.Create an ImageAttributes object and pass the ColorMatrix object to the SetColorMatrix method of the ImageAttributes object.

  3. Passe o objeto ImageAttributes para o método DrawImage de um objeto Graphics.Pass the ImageAttributes object to the DrawImage method of a Graphics object.

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

Um objeto ImageAttributes mantém várias configurações de ajuste de cor, incluindo matrizes de ajuste de cor, matrizes de ajuste de escala de cinza, valores de correção de gama, tabelas de mapa de cores e valores de limite de cor.An ImageAttributes object maintains several color-adjustment settings, including color-adjustment matrices, grayscale-adjustment matrices, gamma-correction values, color-map tables, and color-threshold values. Durante a renderização, as cores podem ser corrigidas, escurecedas, clareadas e removidas.During rendering, colors can be corrected, darkened, lightened, and removed. Para aplicar tais manipulações, inicialize um objeto ImageAttributes e passe o caminho do objeto ImageAttributes (juntamente com o caminho de um Image) para o método DrawImage.To apply such manipulations, initialize an ImageAttributes object and pass the path of that ImageAttributes object (along with the path of an Image) to the DrawImage method.

Construtores

ImageAttributes()

Inicializa uma nova instância da classe ImageAttributes.Initializes a new instance of the ImageAttributes class.

Métodos

ClearBrushRemapTable()

Limpa a tabela de remapeamento de cores do pincel deste objeto ImageAttributes.Clears the brush color-remap table of this ImageAttributes object.

ClearColorKey()

Limpa a chave de cores (intervalo de transparência) para a categoria padrão.Clears the color key (transparency range) for the default category.

ClearColorKey(ColorAdjustType)

Limpa a chave de cores (intervalo de transparência) para uma categoria especificada.Clears the color key (transparency range) for a specified category.

ClearColorMatrix()

Limpa a matriz de ajuste de cores para a categoria padrão.Clears the color-adjustment matrix for the default category.

ClearColorMatrix(ColorAdjustType)

Limpa a matriz de ajuste de cores de uma categoria especificada.Clears the color-adjustment matrix for a specified category.

ClearGamma()

Desabilita a correção gama para a categoria padrão.Disables gamma correction for the default category.

ClearGamma(ColorAdjustType)

Desabilita a correção gama para uma categoria especificada.Disables gamma correction for a specified category.

ClearNoOp()

Limpa a configuração NoOp para a categoria padrão.Clears the NoOp setting for the default category.

ClearNoOp(ColorAdjustType)

Limpa a configuração NoOp para uma categoria especificada.Clears the NoOp setting for a specified category.

ClearOutputChannel()

Limpa a configuração de canal de saída CMYK (ciano-magenta-amarelo-preto) para a categoria padrão.Clears the CMYK (cyan-magenta-yellow-black) output channel setting for the default category.

ClearOutputChannel(ColorAdjustType)

Limpa a configuração de canal de saída (ciano-magenta-amarelo-preto) para uma categoria especificada.Clears the (cyan-magenta-yellow-black) output channel setting for a specified category.

ClearOutputChannelColorProfile()

Limpa a configuração do perfil de cor do canal de saída para a categoria padrão.Clears the output channel color profile setting for the default category.

ClearOutputChannelColorProfile(ColorAdjustType)

Limpa a configuração do perfil de cor do canal de saída para uma categoria especificada.Clears the output channel color profile setting for a specified category.

ClearRemapTable()

Limpa a tabela de remapeamento de cores para a categoria padrão.Clears the color-remap table for the default category.

ClearRemapTable(ColorAdjustType)

Limpa a tabela de remapeamento de cores para uma categoria especificada.Clears the color-remap table for a specified category.

ClearThreshold()

Limpa o valor do limite para a categoria padrão.Clears the threshold value for the default category.

ClearThreshold(ColorAdjustType)

Limpa o valor do limite para uma categoria especificada.Clears the threshold value for a specified category.

Clone()

Cria uma cópia exata desse objeto ImageAttributes.Creates an exact copy of this ImageAttributes object.

Dispose()

Libera todos os recursos usados por esse objeto ImageAttributes.Releases all resources used by this ImageAttributes object.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.Determines whether the specified object is equal to the current object.

(Herdado de Object)
Finalize()

Permite que um objeto tente liberar recursos e executar outras operações de limpeza antes de ser recuperado pela coleta de lixo.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetAdjustedPalette(ColorPalette, ColorAdjustType)

Ajusta as cores em uma paleta de acordo com as configurações de ajuste de uma categoria especificada.Adjusts the colors in a palette according to the adjustment settings of a specified category.

GetHashCode()

Serve como a função de hash padrão.Serves as the default hash function.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.Gets the Type of the current instance.

(Herdado de Object)
MemberwiseClone()

Cria uma cópia superficial do Object atual.Creates a shallow copy of the current Object.

(Herdado de Object)
SetBrushRemapTable(ColorMap[])

Define a tabela de remapeamento de cores para a categoria de pincel.Sets the color-remap table for the brush category.

SetColorKey(Color, Color)

Define o valor de cor para a categoria padrão.Sets the color key for the default category.

SetColorKey(Color, Color, ColorAdjustType)

Define a chave de cores (intervalo de transparência) para uma categoria especificada.Sets the color key (transparency range) for a specified category.

SetColorMatrices(ColorMatrix, ColorMatrix)

Define a matriz de ajuste de cores e a matriz de ajuste de escala de cinza para a categoria padrão.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag)

Define a matriz de ajuste de cores e a matriz de ajuste de escala de cinza para a categoria padrão.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Define a matriz de ajuste de cores e a matriz de ajuste de escala de cinza para uma categoria especificada.Sets the color-adjustment matrix and the grayscale-adjustment matrix for a specified category.

SetColorMatrix(ColorMatrix)

Define a matriz de ajuste de cores para a categoria padrão.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag)

Define a matriz de ajuste de cores para a categoria padrão.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Define a matriz de ajuste de cores de uma categoria especificada.Sets the color-adjustment matrix for a specified category.

SetGamma(Single)

Define o valor de gama para a categoria padrão.Sets the gamma value for the default category.

SetGamma(Single, ColorAdjustType)

Define o valor gama para uma categoria especificada.Sets the gamma value for a specified category.

SetNoOp()

Desativa o ajuste de cores para a categoria padrão.Turns off color adjustment for the default category. Você pode chamar o método ClearNoOp para reaplicar as configurações de ajuste de cores que estavam em vigor antes da chamada para o método SetNoOp.You can call the ClearNoOp method to reinstate the color-adjustment settings that were in place before the call to the SetNoOp method.

SetNoOp(ColorAdjustType)

Desativa o ajuste de cores para uma categoria especificada.Turns off color adjustment for a specified category. Você pode chamar o método ClearNoOp para reaplicar as configurações de ajuste de cores que estavam em vigor antes da chamada para o método SetNoOp.You can call the ClearNoOp method to reinstate the color-adjustment settings that were in place before the call to the SetNoOp method.

SetOutputChannel(ColorChannelFlag)

Define o canal de saída CMYK (ciano-magenta-amarelo-preto) para a categoria padrão.Sets the CMYK (cyan-magenta-yellow-black) output channel for the default category.

SetOutputChannel(ColorChannelFlag, ColorAdjustType)

Define o canal de saída CMYK (ciano-magenta-amarelo-preto) para uma categoria especificada.Sets the CMYK (cyan-magenta-yellow-black) output channel for a specified category.

SetOutputChannelColorProfile(String)

Define o arquivo do perfil de cor do canal de saída para a categoria padrão.Sets the output channel color-profile file for the default category.

SetOutputChannelColorProfile(String, ColorAdjustType)

Define o arquivo do perfil de cor do canal de saída para uma categoria especificada.Sets the output channel color-profile file for a specified category.

SetRemapTable(ColorMap[])

Define a tabela de remapeamento de cores para a categoria padrão.Sets the color-remap table for the default category.

SetRemapTable(ColorMap[], ColorAdjustType)

Define a tabela de remapeamento de cores para uma categoria especificada.Sets the color-remap table for a specified category.

SetThreshold(Single)

Define o limite (intervalo de transparência) para a categoria padrão.Sets the threshold (transparency range) for the default category.

SetThreshold(Single, ColorAdjustType)

Define o limite (intervalo de transparência) para uma categoria especificada.Sets the threshold (transparency range) for a specified category.

SetWrapMode(WrapMode)

Define o modo de quebra automática de linha que é usado para decidir como organizar lado a lado uma textura em uma forma ou nos limites da forma.Sets the wrap mode that is used to decide how to tile a texture across a shape, or at shape boundaries. Uma textura organizada lado a lado em uma forma para preenchê-la quando a textura é menor do que a forma que está preenchendo.A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.

SetWrapMode(WrapMode, Color)

Define o modo de encapsulamento e a cor usadas para decidir como organizar lado a lado uma textura em uma forma ou nos limites da forma.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Uma textura organizada lado a lado em uma forma para preenchê-la quando a textura é menor do que a forma que está preenchendo.A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.

SetWrapMode(WrapMode, Color, Boolean)

Define o modo de encapsulamento e a cor usadas para decidir como organizar lado a lado uma textura em uma forma ou nos limites da forma.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Uma textura organizada lado a lado em uma forma para preenchê-la quando a textura é menor do que a forma que está preenchendo.A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.

ToString()

Retorna uma cadeia de caracteres que representa o objeto atual.Returns a string that represents the current object.

(Herdado de Object)

Aplica-se a

Veja também