ImageAttributes Klass

Definition

Namnområde:
System.Drawing.Imaging
Sammansättning:
System.Drawing.dll

Innehåller information om hur bitmapps- och metafilfärger manipuleras under återgivningen.

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
Arv
Object
ImageAttributes
Implementeringar
ICloneable IDisposable

Exempel

I följande exempel tas en bild som är helt en färg (0.2, 0.0, 0.4, 1.0) och dubblar den röda komponenten lägger till 0.2 till de röda, gröna och blå komponenterna.

Följande bild visar den ursprungliga bilden till vänster och den transformerade bilden till höger.

Färger

Koden i exemplet använder följande steg för att utföra omfärgningen:

  1. Initiera ett ColorMatrix objekt.

  2. Skapa ett ImageAttributes objekt och skicka objektet ColorMatrix till SetColorMatrix -metoden för ImageAttributes objektet.

  3. Skicka objektet ImageAttributes till -metoden för DrawImage ett Graphics objekt.

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)

Kommentarer

Ett ImageAttributes objekt har flera inställningar för färgjustering, inklusive färgjusteringsmatriser, matriser för gråskalejustering, gammakorrigeringsvärden, färgkartatabeller och färgtröskelvärden. Under återgivningen kan färger korrigeras, mörkas, ljusare och tas bort. Om du vill använda sådana manipuleringar initierar du ett ImageAttributes objekt och skickar sökvägen för objektet ImageAttributes (tillsammans med sökvägen till en Image) till DrawImage metoden.

Note

I .NET 6 och senare versioner stöds endast System.Drawing.Common-paketet, som innehåller den här typen, på Windows-operativsystem. Användning av den här typen i plattformsoberoende appar orsakar kompileringstidsvarningar och körningsfel. Mer information finns i System.Drawing.Common som endast stöds i Windows.

Konstruktorer

Name Description
ImageAttributes()

Initierar en ny instans av ImageAttributes klassen.

Metoder

Name Description
ClearBrushRemapTable()

Rensar tabellen med penselfärgskartan för det här ImageAttributes objektet.
ClearColorKey()

Rensar färgnyckeln (genomskinlighetsintervallet) för standardkategorin.
ClearColorKey(ColorAdjustType)

Rensar färgnyckeln (transparensintervallet) för en angiven kategori.
ClearColorMatrix()

Rensar färgjusteringsmatrisen för standardkategorin.
ClearColorMatrix(ColorAdjustType)

Rensar färgjusteringsmatrisen för en angiven kategori.
ClearGamma()

Inaktiverar gammakorrigering för standardkategorin.
ClearGamma(ColorAdjustType)

Inaktiverar gammakorrigering för en angiven kategori.
ClearNoOp()

Rensar NoOp inställningen för standardkategorin.
ClearNoOp(ColorAdjustType)

Rensar inställningen NoOp för en angiven kategori.
ClearOutputChannel()

Rensar CMYK-utdatakanalinställningen (cyan-magenta-yellow-black) för standardkategorin.
ClearOutputChannel(ColorAdjustType)

Rensar utdatakanalinställningen (cyan-magenta-yellow-black) för en angiven kategori.
ClearOutputChannelColorProfile()

Rensar färgprofilinställningen för utdatakanalen för standardkategorin.
ClearOutputChannelColorProfile(ColorAdjustType)

Rensar färgprofilinställningen för utdatakanalen för en angiven kategori.
ClearRemapTable()

Rensar tabellen color-remap för standardkategorin.
ClearRemapTable(ColorAdjustType)

Rensar tabellen color-remap för en angiven kategori.
ClearThreshold()

Rensar tröskelvärdet för standardkategorin.
ClearThreshold(ColorAdjustType)

Rensar tröskelvärdet för en angiven kategori.
Clone()

Skapar en exakt kopia av det här ImageAttributes objektet.
Dispose()

Frigör alla resurser som används av det här ImageAttributes objektet.
Equals(Object)

Avgör om det angivna objektet är lika med det aktuella objektet.

(Ärvd från Object)
Finalize()

Tillåter att ett objekt försöker frigöra resurser och utföra andra rensningsåtgärder innan det frigörs av skräpinsamling.
GetAdjustedPalette(ColorPalette, ColorAdjustType)

Justerar färgerna i en palett enligt justeringsinställningarna för en angiven kategori.
GetHashCode()

Fungerar som standard-hash-funktion.

(Ärvd från Object)
GetType()

Hämtar den aktuella instansen Type .

(Ärvd från Object)
MemberwiseClone()

Skapar en ytlig kopia av den aktuella Object.

(Ärvd från Object)
SetBrushRemapTable(ColorMap[])

Anger tabellen color-remap för penselkategorin.
SetColorKey(Color, Color, ColorAdjustType)

Anger färgnyckeln (transparensintervall) för en angiven kategori.
SetColorKey(Color, Color)

Anger färgnyckeln för standardkategorin.
SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Anger färgjusteringsmatrisen och matrisen för gråskalejustering för en angiven kategori.
SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag)

Anger färgjusteringsmatrisen och matrisen grayscale-adjustment för standardkategorin.
SetColorMatrices(ColorMatrix, ColorMatrix)

Anger färgjusteringsmatrisen och matrisen grayscale-adjustment för standardkategorin.
SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Anger färgjusteringsmatrisen för en angiven kategori.
SetColorMatrix(ColorMatrix, ColorMatrixFlag)

Anger färgjusteringsmatrisen för standardkategorin.
SetColorMatrix(ColorMatrix)

Anger färgjusteringsmatrisen för standardkategorin.
SetGamma(Single, ColorAdjustType)

Anger gammavärdet för en angiven kategori.
SetGamma(Single)

Anger gammavärdet för standardkategorin.
SetNoOp()

Inaktiverar färgjustering för standardkategorin. Du kan anropa ClearNoOp metoden för att återställa de färgjusteringsinställningar som fanns före anropet till SetNoOp metoden.
SetNoOp(ColorAdjustType)

Inaktiverar färgjustering för en angiven kategori. Du kan anropa ClearNoOp metoden för att återställa de färgjusteringsinställningar som fanns före anropet till SetNoOp metoden.
SetOutputChannel(ColorChannelFlag, ColorAdjustType)

Anger CMYK-utdatakanalen (cyan-magenta-yellow-black) för en angiven kategori.
SetOutputChannel(ColorChannelFlag)

Anger CMYK-utdatakanalen (cyan-magenta-yellow-black) för standardkategorin.
SetOutputChannelColorProfile(String, ColorAdjustType)

Anger färgprofilfilen för utdatakanalen för en angiven kategori.
SetOutputChannelColorProfile(String)

Anger färgprofilfilen för utdatakanalen för standardkategorin.
SetRemapTable(ColorMap[], ColorAdjustType)

Anger tabellen color-remap för en angiven kategori.
SetRemapTable(ColorMap[])

Anger tabellen color-remap för standardkategorin.
SetThreshold(Single, ColorAdjustType)

Anger tröskelvärdet (transparensintervall) för en angiven kategori.
SetThreshold(Single)

Anger tröskelvärdet (transparensintervall) för standardkategorin.
SetWrapMode(WrapMode, Color, Boolean)

Anger omslutningsläget och färgen som används för att bestämma hur en textur ska panelas över en form eller vid formgränser. En struktur är kaklad över en form för att fylla i den när strukturen är mindre än formen den fyller.
SetWrapMode(WrapMode, Color)

Anger omslutningsläget och färgen som används för att bestämma hur en textur ska panelas över en form eller vid formgränser. En struktur är kaklad över en form för att fylla i den när strukturen är mindre än formen den fyller.
SetWrapMode(WrapMode)

Anger det omslutningsläge som används för att bestämma hur en struktur ska paneleras över en form eller vid formgränser. En struktur är kaklad över en form för att fylla i den när strukturen är mindre än formen den fyller.
ToString()

Returnerar en sträng som representerar det aktuella objektet.

(Ärvd från Object)

Gäller för

Se även