ImageAttributes ImageAttributes ImageAttributes ImageAttributes Class

Definition

Enthält Informationen darüber, wie Bitmap- und Metadateifarben während des Renderns bearbeitet werden.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
Vererbung
ImageAttributesImageAttributesImageAttributesImageAttributes
Implementiert

Beispiele

Im folgenden Beispiel wird ein Bild, das alle eine Farbe ("0.2", "0.0", "0,4", "1.0") ist und die Rotkomponente verdoppelt die Komponenten roten, grünen und blauen 0,2 hinzugefügtThe 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

Die folgende Abbildung zeigt das ursprüngliche Bild auf der linken Seite und die transformierten auf der rechten Seite an.The following illustration shows the original image on the left and the transformed image on the right.

FarbenColors

Der Code im folgenden Beispiel verwendet die folgenden Schritte aus, um die über erneutes Einfärben auszuführen:The code in the following example uses the following steps to perform the recoloring:

  1. Initialisiert eine ColorMatrix Objekt.Initialize a ColorMatrix object.

  2. Erstellen einer ImageAttributes Objekt, und übergeben die ColorMatrix -Objekt an die SetColorMatrix -Methode der der ImageAttributes Objekt.Create an ImageAttributes object and pass the ColorMatrix object to the SetColorMatrix method of the ImageAttributes object.

  3. Übergeben der ImageAttributes -Objekt an die DrawImage Methode eine Graphics Objekt.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)

Hinweise

Ein ImageAttributes -Objekt verwaltet mehrere Farbanpassungsmatrizen-Einstellungen, einschließlich der Farbanpassungsmatrizen Matrizen, Anpassungsmatrix für Graustufenwerte Matrizen, Gammakorrektur Werte, Farbkarte Tabellen und Color-Schwellenwerte gelten sollen.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. Farben können während des Renderns, wurde korrigiert, abgedunkelt, aufgehellt und entfernt werden.During rendering, colors can be corrected, darkened, lightened, and removed. Um solche Manipulationen anzuwenden, initialisieren eine ImageAttributes Objekt, und übergeben Sie den Pfad der ImageAttributes Objekt (zusammen mit dem Pfad des ein Image) auf die DrawImage Methode.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.

Konstruktoren

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

Initialisiert eine neue Instanz der ImageAttributes-Klasse.Initializes a new instance of the ImageAttributes class.

Methoden

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

Löscht die Pinsel-Farbumwandlungstabelle dieses ImageAttributes-Objekts.Clears the brush color-remap table of this ImageAttributes object.

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

Löscht den Colorkey (Transparenzbereich) für die Standardkategorie.Clears the color key (transparency range) for the default category.

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

Löscht den Colorkey (Transparenzbereich) für eine angegebene Kategorie.Clears the color key (transparency range) for a specified category.

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

Löscht die Farbanpassungsmatrix für die Standardkategorie.Clears the color-adjustment matrix for the default category.

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

Löscht die Farbanpassungsmatrix für eine angegebene Kategorie.Clears the color-adjustment matrix for a specified category.

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

Deaktiviert die Gammakorrektur für die Standardkategorie.Disables gamma correction for the default category.

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

Deaktiviert die Gammakorrektur für eine angegebene Kategorie.Disables gamma correction for a specified category.

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

Löscht die NoOp-Einstellung für die Standardkategorie.Clears the NoOp setting for the default category.

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

Löscht die NoOp-Einstellung für eine angegebene Kategorie.Clears the NoOp setting for a specified category.

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

Löscht die CMYK-Ausgabekanaleinstellung für die Standardkategorie.Clears the CMYK (cyan-magenta-yellow-black) output channel setting for the default category.

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

Löscht die CMYK-Ausgabekanaleinstellung für eine angegebene Kategorie.Clears the (cyan-magenta-yellow-black) output channel setting for a specified category.

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

Löscht die Einstellung des Ausgabekanal-Farbprofils für die Standardkategorie.Clears the output channel color profile setting for the default category.

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

Löscht die Einstellung des Ausgabekanal-Farbprofils für eine angegebene Kategorie.Clears the output channel color profile setting for a specified category.

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

Löscht die Farbumwandlungstabelle für die Standardkategorie.Clears the color-remap table for the default category.

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

Löscht die Farbumwandlungstabelle für eine angegebene Kategorie.Clears the color-remap table for a specified category.

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

Löscht den Schwellenwert für die Standardkategorie.Clears the threshold value for the default category.

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

Löscht den Schwellenwert für eine angegebene Kategorie.Clears the threshold value for a specified category.

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

Erstellt eine genaue Kopie dieses ImageAttributes-Objekts.Creates an exact copy of this ImageAttributes object.

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

Gibt alle von diesem ImageAttributes-Objekt verwendeten Ressourcen frei.Releases all resources used by this ImageAttributes object.

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

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

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

Gibt einem Objekt Gelegenheit zu dem Versuch, Ressourcen freizugeben und andere Bereinigungen durchzuführen, bevor es von der Garbage Collection freigegeben wird.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)

Passt die Farben in einer Palette entsprechend den Anpassungseinstellungen einer angegebenen Kategorie an.Adjusts the colors in a palette according to the adjustment settings of a specified category.

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

Fungiert als Standardhashfunktion.Serves as the default hash function.

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

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

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

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

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

Legt die Farbumwandlungstabelle für die Pinselkategorie fest.Sets the color-remap table for the brush category.

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

Legt den Colorkey für die Standardkategorie fest.Sets the color key for the default category.

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

Legt den Colorkey (Transparenzbereich) für eine angegebene Kategorie fest.Sets the color key (transparency range) for a specified category.

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

Legt die Farbanpassungsmatrix und die Anpassungsmatrix für Graustufenwerte für die Standardkategorie fest.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)

Legt die Farbanpassungsmatrix und die Anpassungsmatrix für Graustufenwerte für die Standardkategorie fest.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)

Legt die Farbanpassungsmatrix und die Anpassungsmatrix für Graustufenwerte für eine angegebene Kategorie fest.Sets the color-adjustment matrix and the grayscale-adjustment matrix for a specified category.

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

Legt die Farbanpassungsmatrix für die Standardkategorie fest.Sets the color-adjustment matrix for the default category.

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

Legt die Farbanpassungsmatrix für die Standardkategorie fest.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)

Legt die Farbanpassungsmatrix für eine angegebene Kategorie fest.Sets the color-adjustment matrix for a specified category.

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

Legt den Gammawert für die Standardkategorie fest.Sets the gamma value for the default category.

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

Legt den Gammawert für eine angegebene Kategorie fest.Sets the gamma value for a specified category.

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

Deaktiviert die Farbanpassung für die Standardkategorie.Turns off color adjustment for the default category. Durch Aufruf der ClearNoOp-Methode können Sie die vor dem Aufruf der SetNoOp-Methode gültigen Farbanpassungseinstellungen erneut aktivieren.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)

Deaktiviert die Farbanpassung für eine angegebene Kategorie.Turns off color adjustment for a specified category. Durch Aufruf der ClearNoOp-Methode können Sie die vor dem Aufruf der SetNoOp-Methode gültigen Farbanpassungseinstellungen erneut aktivieren.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)

Legt den CMYK-Ausgabekanal für die Standardkategorie fest.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)

Legt den CMYK-Ausgabekanal für eine angegebene Kategorie fest.Sets the CMYK (cyan-magenta-yellow-black) output channel for a specified category.

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

Legt die Ausgabekanal-Farbprofildatei für die Standardkategorie fest.Sets the output channel color-profile file for the default category.

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

Legt die Ausgabekanal-Farbprofildatei für eine angegebene Kategorie fest.Sets the output channel color-profile file for a specified category.

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

Legt die Farbumwandlungstabelle für die Standardkategorie fest.Sets the color-remap table for the default category.

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

Legt die Farbumwandlungstabelle für eine angegebene Kategorie fest.Sets the color-remap table for a specified category.

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

Legt den Schwellenwert (Transparenzbereich) für die Standardkategorie fest.Sets the threshold (transparency range) for the default category.

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

Legt den Schwellenwert (Transparenzbereich) für eine angegebene Kategorie fest.Sets the threshold (transparency range) for a specified category.

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

Legt den Umbruchmodus fest, mit dem bestimmt wird, wie eine Struktur in einer Form oder an den Begrenzungen der Form gekachelt werden soll.Sets the wrap mode that is used to decide how to tile a texture across a shape, or at shape boundaries. Wenn eine Struktur kleiner als eine Form ist, wird sie in der Form gekachelt, um sie auszufüllen.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)

Legt den Umbruchmodus und die Farbe fest, mit denen festgelegt wird, wie eine Struktur in einer Form oder an den Begrenzungen der Form gekachelt werden soll.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Wenn eine Struktur kleiner als eine Form ist, wird sie in der Form gekachelt, um sie auszufüllen.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)

Legt den Umbruchmodus und die Farbe fest, mit denen festgelegt wird, wie eine Struktur in einer Form oder an den Begrenzungen der Form gekachelt werden soll.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Wenn eine Struktur kleiner als eine Form ist, wird sie in der Form gekachelt, um sie auszufüllen.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()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Gilt für:

Siehe auch