ImageAttributes ImageAttributes ImageAttributes ImageAttributes Class

Definición

Contiene información acerca de la manipulación de los colores de los mapas de bits y de los metarchivos durante la representación.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
Herencia
ImageAttributesImageAttributesImageAttributesImageAttributes
Implementaciones

Ejemplos

El siguiente ejemplo toma una imagen que es un color (0.2, 0.0, 0.4, 1.0) y duplica el componente rojo, suma 0.2 a los componentes rojos, verde y azulesThe 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

La siguiente ilustración muestra la imagen original a la izquierda y la imagen transformada de la derecha.The following illustration shows the original image on the left and the transformed image on the right.

ColoresColors

El código en el ejemplo siguiente utiliza los siguientes pasos para realizar el cambio de color:The code in the following example uses the following steps to perform the recoloring:

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

  2. Crear un ImageAttributes objeto y pase el ColorMatrix de objeto para el SetColorMatrix método de la ImageAttributes objeto.Create an ImageAttributes object and pass the ColorMatrix object to the SetColorMatrix method of the ImageAttributes object.

  3. Pase el ImageAttributes de objeto para el DrawImage método de un Graphics objeto.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)

Comentarios

Un ImageAttributes objeto tiene varios valores de ajuste de color, como matrices de ajuste de color, matrices de ajuste de escala de grises, valores de corrección gamma, tablas de mapa de colores y los valores de umbral de color.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 la representación, los colores pueden se corregido, oscurecer, aclarar y quitar.During rendering, colors can be corrected, darkened, lightened, and removed. Para aplicar dichas manipulaciones, inicialice un ImageAttributes objeto y pase la ruta de acceso de los que ImageAttributes objeto (junto con la ruta de acceso de un Image) a la DrawImage método.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.

Constructores

ImageAttributes() ImageAttributes() ImageAttributes() ImageAttributes()

Inicializa una nueva instancia de la clase ImageAttributes.Initializes a new instance of the ImageAttributes class.

Métodos

ClearBrushRemapTable() ClearBrushRemapTable() ClearBrushRemapTable() ClearBrushRemapTable()

Borra la tabla de reasignación de colores del pincel de este objeto ImageAttributes.Clears the brush color-remap table of this ImageAttributes object.

ClearColorKey() ClearColorKey() ClearColorKey() ClearColorKey()

Borra la clave de color (intervalo de transparencia) de la categoría predeterminada.Clears the color key (transparency range) for the default category.

ClearColorKey(ColorAdjustType) ClearColorKey(ColorAdjustType) ClearColorKey(ColorAdjustType) ClearColorKey(ColorAdjustType)

Borra la clave de color (intervalo de transparencia) de la categoría predeterminada.Clears the color key (transparency range) for a specified category.

ClearColorMatrix() ClearColorMatrix() ClearColorMatrix() ClearColorMatrix()

Borra la matriz de ajuste de color de la categoría predeterminada.Clears the color-adjustment matrix for the default category.

ClearColorMatrix(ColorAdjustType) ClearColorMatrix(ColorAdjustType) ClearColorMatrix(ColorAdjustType) ClearColorMatrix(ColorAdjustType)

Borra la matriz de ajuste de color de una categoría especificada.Clears the color-adjustment matrix for a specified category.

ClearGamma() ClearGamma() ClearGamma() ClearGamma()

Deshabilita la corrección gamma de la categoría predeterminada.Disables gamma correction for the default category.

ClearGamma(ColorAdjustType) ClearGamma(ColorAdjustType) ClearGamma(ColorAdjustType) ClearGamma(ColorAdjustType)

Deshabilita la corrección gamma de la categoría especificada.Disables gamma correction for a specified category.

ClearNoOp() ClearNoOp() ClearNoOp() ClearNoOp()

Borra la configuración de NoOp para la categoría predeterminada.Clears the NoOp setting for the default category.

ClearNoOp(ColorAdjustType) ClearNoOp(ColorAdjustType) ClearNoOp(ColorAdjustType) ClearNoOp(ColorAdjustType)

Borra la configuración de NoOp para la categoría especificada.Clears the NoOp setting for a specified category.

ClearOutputChannel() ClearOutputChannel() ClearOutputChannel() ClearOutputChannel()

Borra la configuración del canal de salida CMYK (aguamarina-fucsia-amarillo-negro) para la categoría predeterminada.Clears the CMYK (cyan-magenta-yellow-black) output channel setting for the default category.

ClearOutputChannel(ColorAdjustType) ClearOutputChannel(ColorAdjustType) ClearOutputChannel(ColorAdjustType) ClearOutputChannel(ColorAdjustType)

Borra la configuración del canal de salida (aguamarina-fucsia-amarillo-negro) para la categoría especificada.Clears the (cyan-magenta-yellow-black) output channel setting for a specified category.

ClearOutputChannelColorProfile() ClearOutputChannelColorProfile() ClearOutputChannelColorProfile() ClearOutputChannelColorProfile()

Borra la configuración de perfil de color del canal de salida de la categoría predeterminada.Clears the output channel color profile setting for the default category.

ClearOutputChannelColorProfile(ColorAdjustType) ClearOutputChannelColorProfile(ColorAdjustType) ClearOutputChannelColorProfile(ColorAdjustType) ClearOutputChannelColorProfile(ColorAdjustType)

Borra la configuración de perfil de color del canal de salida de la categoría especificada.Clears the output channel color profile setting for a specified category.

ClearRemapTable() ClearRemapTable() ClearRemapTable() ClearRemapTable()

Borra la tabla de reasignación de colores de la categoría predeterminada.Clears the color-remap table for the default category.

ClearRemapTable(ColorAdjustType) ClearRemapTable(ColorAdjustType) ClearRemapTable(ColorAdjustType) ClearRemapTable(ColorAdjustType)

Borra la tabla de reasignación de colores de la categoría especificada.Clears the color-remap table for a specified category.

ClearThreshold() ClearThreshold() ClearThreshold() ClearThreshold()

Borra el valor de umbral de la categoría predeterminada.Clears the threshold value for the default category.

ClearThreshold(ColorAdjustType) ClearThreshold(ColorAdjustType) ClearThreshold(ColorAdjustType) ClearThreshold(ColorAdjustType)

Borra el valor de umbral de la categoría especificada.Clears the threshold value for a specified category.

Clone() Clone() Clone() Clone()

Crea una copia exacta de este objeto ImageAttributes.Creates an exact copy of this ImageAttributes object.

Dispose() Dispose() Dispose() Dispose()

Libera todos los recursos utilizados por este objeto ImageAttributes.Releases all resources used by this ImageAttributes object.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Determina si el objeto especificado es igual al objeto actual.Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

Permite que un objeto intente liberar recursos y realizar otras operaciones de limpieza antes de que sea reclamado por la recolección de elementos no utilizados.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetAdjustedPalette(ColorPalette, ColorAdjustType) GetAdjustedPalette(ColorPalette, ColorAdjustType) GetAdjustedPalette(ColorPalette, ColorAdjustType) GetAdjustedPalette(ColorPalette, ColorAdjustType)

Ajusta los colores de una paleta según los valores de ajuste de una categoría especificada.Adjusts the colors in a palette according to the adjustment settings of a specified category.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Sirve como la función hash predeterminada.Serves as the default hash function.

(Inherited from Object)
GetType() GetType() GetType() GetType()

Obtiene el Type de la instancia actual.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Crea una copia superficial del Object actual.Creates a shallow copy of the current Object.

(Inherited from Object)
SetBrushRemapTable(ColorMap[]) SetBrushRemapTable(ColorMap[]) SetBrushRemapTable(ColorMap[]) SetBrushRemapTable(ColorMap[])

Establece la tabla de reasignación de colores de la categoría de pincel.Sets the color-remap table for the brush category.

SetColorKey(Color, Color) SetColorKey(Color, Color) SetColorKey(Color, Color) SetColorKey(Color, Color)

Establece la clave de color de la categoría predeterminada.Sets the color key for the default category.

SetColorKey(Color, Color, ColorAdjustType) SetColorKey(Color, Color, ColorAdjustType) SetColorKey(Color, Color, ColorAdjustType) SetColorKey(Color, Color, ColorAdjustType)

Establece la clave de color (intervalo de transparencia) de la categoría predeterminada.Sets the color key (transparency range) for a specified category.

SetColorMatrices(ColorMatrix, ColorMatrix) SetColorMatrices(ColorMatrix, ColorMatrix) SetColorMatrices(ColorMatrix, ColorMatrix) SetColorMatrices(ColorMatrix, ColorMatrix)

Establece la matriz de ajuste de color y de escala de grises de la categoría predeterminada.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag)

Establece la matriz de ajuste de color y de escala de grises de la categoría predeterminada.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Establece la matriz de ajuste de color y de escala de grises de la categoría especificada.Sets the color-adjustment matrix and the grayscale-adjustment matrix for a specified category.

SetColorMatrix(ColorMatrix) SetColorMatrix(ColorMatrix) SetColorMatrix(ColorMatrix) SetColorMatrix(ColorMatrix)

Establece la matriz de ajuste de color de la categoría predeterminada.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag) SetColorMatrix(ColorMatrix, ColorMatrixFlag) SetColorMatrix(ColorMatrix, ColorMatrixFlag) SetColorMatrix(ColorMatrix, ColorMatrixFlag)

Establece la matriz de ajuste de color de la categoría predeterminada.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType) SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Establece la matriz de ajuste de color de una categoría especificada.Sets the color-adjustment matrix for a specified category.

SetGamma(Single) SetGamma(Single) SetGamma(Single) SetGamma(Single)

Establece el valor gamma de la categoría predeterminada.Sets the gamma value for the default category.

SetGamma(Single, ColorAdjustType) SetGamma(Single, ColorAdjustType) SetGamma(Single, ColorAdjustType) SetGamma(Single, ColorAdjustType)

Establece el valor gamma de la categoría especificada.Sets the gamma value for a specified category.

SetNoOp() SetNoOp() SetNoOp() SetNoOp()

Desactiva el ajuste de color de la categoría predeterminada.Turns off color adjustment for the default category. Se puede llamar al método ClearNoOp para restaurar los valores de ajuste de color anteriores a la llamada al 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) SetNoOp(ColorAdjustType) SetNoOp(ColorAdjustType) SetNoOp(ColorAdjustType)

Desactiva el ajuste de color de la categoría especificada.Turns off color adjustment for a specified category. Se puede llamar al método ClearNoOp para restaurar los valores de ajuste de color anteriores a la llamada al 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) SetOutputChannel(ColorChannelFlag) SetOutputChannel(ColorChannelFlag) SetOutputChannel(ColorChannelFlag)

Establece la configuración del canal de salida CMYK (aguamarina-fucsia-amarillo-negro) para la categoría predeterminada.Sets the CMYK (cyan-magenta-yellow-black) output channel for the default category.

SetOutputChannel(ColorChannelFlag, ColorAdjustType) SetOutputChannel(ColorChannelFlag, ColorAdjustType) SetOutputChannel(ColorChannelFlag, ColorAdjustType) SetOutputChannel(ColorChannelFlag, ColorAdjustType)

Establece el canal de salida CMYK (aguamarina-fucsia-amarillo-negro) para la categoría especificada.Sets the CMYK (cyan-magenta-yellow-black) output channel for a specified category.

SetOutputChannelColorProfile(String) SetOutputChannelColorProfile(String) SetOutputChannelColorProfile(String) SetOutputChannelColorProfile(String)

Establece el archivo de perfil de color del canal de salida de la categoría predeterminada.Sets the output channel color-profile file for the default category.

SetOutputChannelColorProfile(String, ColorAdjustType) SetOutputChannelColorProfile(String, ColorAdjustType) SetOutputChannelColorProfile(String, ColorAdjustType) SetOutputChannelColorProfile(String, ColorAdjustType)

Establece el archivo de perfil de color del canal de salida de la categoría especificada.Sets the output channel color-profile file for a specified category.

SetRemapTable(ColorMap[]) SetRemapTable(ColorMap[]) SetRemapTable(ColorMap[]) SetRemapTable(ColorMap[])

Establece la tabla de reasignación de colores de la categoría predeterminada.Sets the color-remap table for the default category.

SetRemapTable(ColorMap[], ColorAdjustType) SetRemapTable(ColorMap[], ColorAdjustType) SetRemapTable(ColorMap[], ColorAdjustType) SetRemapTable(ColorMap[], ColorAdjustType)

Establece la tabla de reasignación de colores de la categoría especificada.Sets the color-remap table for a specified category.

SetThreshold(Single) SetThreshold(Single) SetThreshold(Single) SetThreshold(Single)

Establece el umbral (intervalo de transparencia) de la categoría predeterminada.Sets the threshold (transparency range) for the default category.

SetThreshold(Single, ColorAdjustType) SetThreshold(Single, ColorAdjustType) SetThreshold(Single, ColorAdjustType) SetThreshold(Single, ColorAdjustType)

Establece el umbral (intervalo de transparencia) de la categoría especificada.Sets the threshold (transparency range) for a specified category.

SetWrapMode(WrapMode) SetWrapMode(WrapMode) SetWrapMode(WrapMode) SetWrapMode(WrapMode)

Establece el modo de ajuste que se utiliza para decidir el modo de colocar una textura en forma de mosaico dentro de una forma, o en los límites de la misma.Sets the wrap mode that is used to decide how to tile a texture across a shape, or at shape boundaries. Un textura se coloca en mosaico dentro de una forma para rellenarla si la textura es más pequeña que la forma que va a rellenar.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) SetWrapMode(WrapMode, Color) SetWrapMode(WrapMode, Color) SetWrapMode(WrapMode, Color)

Establece el modo y el color de ajuste que se usan para decidir la forma de colocar una textura tipo mosaico a través de una forma, o en los límites de la misma.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Un textura se coloca en mosaico dentro de una forma para rellenarla si la textura es más pequeña que la forma que va a rellenar.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) SetWrapMode(WrapMode, Color, Boolean) SetWrapMode(WrapMode, Color, Boolean) SetWrapMode(WrapMode, Color, Boolean)

Establece el modo y el color de ajuste que se usan para decidir la forma de colocar una textura tipo mosaico a través de una forma, o en los límites de la misma.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Un textura se coloca en mosaico dentro de una forma para rellenarla si la textura es más pequeña que la forma que va a rellenar.A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.

ToString() ToString() ToString() ToString()

Devuelve una cadena que representa el objeto actual.Returns a string that represents the current object.

(Inherited from Object)

Se aplica a

Consulte también: