ImageAttributes Classe

Definizione

Contiene informazioni relative alla modalità di manipolazione dei colori di bitmap e metafile durante il rendering.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
Ereditarietà
ImageAttributes
Implementazioni

Esempi

Nell'esempio seguente viene accettata un'immagine che corrisponde a tutti i colori (0,2, 0,0, 0,4, 1,0) e raddoppia il componente rosso che aggiunge 0,2 ai componenti rosso, verde e blu.The 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

Nell'illustrazione seguente viene mostrata l'immagine originale a sinistra e l'immagine trasformata a destra.The following illustration shows the original image on the left and the transformed image on the right.

![Colori] (~/add/media/colortrans1.png "Colori")Colors

Il codice nell'esempio seguente usa i passaggi seguenti per eseguire il ricoloring:The code in the following example uses the following steps to perform the recoloring:

  1. Inizializzare ColorMatrix un oggetto.Initialize a ColorMatrix object.

  2. Creare un ImageAttributes oggetto e passare l' ColorMatrix oggetto ImageAttributes al SetColorMatrix metodo dell'oggetto.Create an ImageAttributes object and pass the ColorMatrix object to the SetColorMatrix method of the ImageAttributes object.

  3. Passare l' ImageAttributes oggetto DrawImage al metodo di un Graphics oggetto.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)

Commenti

Un ImageAttributes oggetto gestisce diverse impostazioni di regolazione del colore, incluse le matrici di regolazione del colore, le matrici di regolazione delle gradazioni di grigio, i valori di correzione gamma, le tabelle con mappa colori e i valori di soglia di colore.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 il rendering, i colori possono essere corretti, scuriti, schiariti e rimossi.During rendering, colors can be corrected, darkened, lightened, and removed. Per applicare tali modifiche, inizializzare un ImageAttributes oggetto e passare il percorso di tale ImageAttributes oggetto, insieme al percorso DrawImage di un Imageoggetto, al metodo.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.

Costruttori

ImageAttributes()

Inizializza una nuova istanza della classe ImageAttributes.Initializes a new instance of the ImageAttributes class.

Metodi

ClearBrushRemapTable()

Cancella la tabella di modifica del mapping dei colori del pennello di questo oggetto ImageAttributes.Clears the brush color-remap table of this ImageAttributes object.

ClearColorKey()

Cancella la chiave di colore (intervallo di trasparenza) per la categoria predefinita.Clears the color key (transparency range) for the default category.

ClearColorKey(ColorAdjustType)

Cancella la chiave di colore (intervallo di trasparenza) per una categoria specificata.Clears the color key (transparency range) for a specified category.

ClearColorMatrix()

Cancella la matrice di regolazione del colore per la categoria predefinita.Clears the color-adjustment matrix for the default category.

ClearColorMatrix(ColorAdjustType)

Cancella la matrice di regolazione del colore per una categoria specificata.Clears the color-adjustment matrix for a specified category.

ClearGamma()

Disabilita la correzione gamma per la categoria predefinita.Disables gamma correction for the default category.

ClearGamma(ColorAdjustType)

Disabilita la correzione gamma per una categoria specificata.Disables gamma correction for a specified category.

ClearNoOp()

Cancella l'impostazione NoOp per la categoria predefinita.Clears the NoOp setting for the default category.

ClearNoOp(ColorAdjustType)

Cancella l'impostazione NoOp per una categoria specificata.Clears the NoOp setting for a specified category.

ClearOutputChannel()

Cancella l'impostazione del canale di output CMYK per la categoria predefinita.Clears the CMYK (cyan-magenta-yellow-black) output channel setting for the default category.

ClearOutputChannel(ColorAdjustType)

Cancella l'impostazione del canale di output CMYK per una categoria specificata.Clears the (cyan-magenta-yellow-black) output channel setting for a specified category.

ClearOutputChannelColorProfile()

Cancella l'impostazione del profilo del colore del canale di output per la categoria predefinita.Clears the output channel color profile setting for the default category.

ClearOutputChannelColorProfile(ColorAdjustType)

Cancella l'impostazione del profilo del colore del canale di output per una categoria specificata.Clears the output channel color profile setting for a specified category.

ClearRemapTable()

Cancella la tabella di modifica del mapping dei colori per la categoria predefinita.Clears the color-remap table for the default category.

ClearRemapTable(ColorAdjustType)

Cancella la tabella di modifica del mapping dei colori per una categoria specificata.Clears the color-remap table for a specified category.

ClearThreshold()

Cancella il valore soglia per la categoria predefinita.Clears the threshold value for the default category.

ClearThreshold(ColorAdjustType)

Cancella il valore soglia per una categoria specificata.Clears the threshold value for a specified category.

Clone()

Crea una copia esatta dell'oggetto ImageAttributes.Creates an exact copy of this ImageAttributes object.

Dispose()

Rilascia tutte le risorse usate dall'oggetto ImageAttributes.Releases all resources used by this ImageAttributes object.

Equals(Object)

Determina se l'oggetto specificato è uguale all'oggetto corrente.Determines whether the specified object is equal to the current object.

(Ereditato da Object)
Finalize()

Consente a un oggetto di effettuare un tentativo di liberare risorse ed eseguire altre operazioni di pulizia prima che venga recuperato da Garbage Collection.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetAdjustedPalette(ColorPalette, ColorAdjustType)

Regola i colori in una tavolozza in base alle impostazioni di regolazione di una categoria specificata.Adjusts the colors in a palette according to the adjustment settings of a specified category.

GetHashCode()

Funge da funzione hash predefinita.Serves as the default hash function.

(Ereditato da Object)
GetType()

Ottiene l'oggetto Type dell'istanza corrente.Gets the Type of the current instance.

(Ereditato da Object)
MemberwiseClone()

Crea una copia superficiale dell'oggetto Object corrente.Creates a shallow copy of the current Object.

(Ereditato da Object)
SetBrushRemapTable(ColorMap[])

Imposta la tabella di modifica del mapping dei colori per la categoria pennello.Sets the color-remap table for the brush category.

SetColorKey(Color, Color)

Imposta la chiave di colore per la categoria predefinita.Sets the color key for the default category.

SetColorKey(Color, Color, ColorAdjustType)

Imposta la chiave di colore (intervallo di trasparenza) per una categoria specificata.Sets the color key (transparency range) for a specified category.

SetColorMatrices(ColorMatrix, ColorMatrix)

Imposta la matrice di regolazione del colore e la matrice di regolazione delle gradazioni di grigio per la categoria predefinita.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag)

Imposta la matrice di regolazione del colore e la matrice di regolazione delle gradazioni di grigio per la categoria predefinita.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Imposta la matrice di regolazione del colore e la matrice di regolazione delle gradazioni di grigio per una categoria specificata.Sets the color-adjustment matrix and the grayscale-adjustment matrix for a specified category.

SetColorMatrix(ColorMatrix)

Imposta la matrice di regolazione del colore per la categoria predefinita.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag)

Imposta la matrice di regolazione del colore per la categoria predefinita.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Imposta la matrice di regolazione del colore per una categoria specificata.Sets the color-adjustment matrix for a specified category.

SetGamma(Single)

Imposta il valore gamma per la categoria predefinita.Sets the gamma value for the default category.

SetGamma(Single, ColorAdjustType)

Imposta il valore gamma per una categoria specificata.Sets the gamma value for a specified category.

SetNoOp()

Disattiva la regolazione del colore per la categoria predefinita.Turns off color adjustment for the default category. È possibile chiamare il metodo ClearNoOp per ripristinare le impostazioni di regolazione del colore precedenti alla chiamata al metodo 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)

Disattiva la regolazione del colore per una categoria specificata.Turns off color adjustment for a specified category. È possibile chiamare il metodo ClearNoOp per ripristinare le impostazioni di regolazione del colore precedenti alla chiamata al metodo 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)

Imposta il canale di output CMYK per la categoria predefinita.Sets the CMYK (cyan-magenta-yellow-black) output channel for the default category.

SetOutputChannel(ColorChannelFlag, ColorAdjustType)

Imposta il canale di output CMYK per una categoria specificata.Sets the CMYK (cyan-magenta-yellow-black) output channel for a specified category.

SetOutputChannelColorProfile(String)

Imposta il file del profilo del colore del canale di output per la categoria predefinita.Sets the output channel color-profile file for the default category.

SetOutputChannelColorProfile(String, ColorAdjustType)

Imposta il file del profilo dei colori del canale di output per una categoria specificata.Sets the output channel color-profile file for a specified category.

SetRemapTable(ColorMap[])

Imposta la tabella di modifica del mapping dei colori per la categoria predefinita.Sets the color-remap table for the default category.

SetRemapTable(ColorMap[], ColorAdjustType)

Imposta la tabella di modifica del mapping dei colori per una categoria specificata.Sets the color-remap table for a specified category.

SetThreshold(Single)

Imposta la soglia (intervallo di trasparenza) per la categoria predefinita.Sets the threshold (transparency range) for the default category.

SetThreshold(Single, ColorAdjustType)

Imposta la soglia (intervallo di trasparenza) per una categoria specificata.Sets the threshold (transparency range) for a specified category.

SetWrapMode(WrapMode)

Imposta la modalità di disposizione utilizzata per decidere come inserire una trama all'interno di una forma o entro i limiti di quest'ultima.Sets the wrap mode that is used to decide how to tile a texture across a shape, or at shape boundaries. Una trama viene inserita all'interno di una forma per riempirla quando è di dimensioni minori rispetto alla forma.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)

Imposta la modalità di disposizione e il colore usati per decidere come affiancare una trama all'interno di una forma o nei limiti di quest'ultima.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Una trama viene inserita all'interno di una forma per riempirla quando è di dimensioni minori rispetto alla forma.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)

Imposta la modalità di disposizione e il colore usati per decidere come affiancare una trama all'interno di una forma o nei limiti di quest'ultima.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Una trama viene inserita all'interno di una forma per riempirla quando è di dimensioni minori rispetto alla forma.A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.

ToString()

Restituisce una stringa che rappresenta l'oggetto corrente.Returns a string that represents the current object.

(Ereditato da Object)

Si applica a

Vedi anche