ImageAttributes Klasa

Definicja

Zawiera informacje o sposobie manipulowania kolorami bitmap i metaplików podczas renderowania.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
Dziedziczenie
ImageAttributes
Implementuje

Przykłady

Poniższy przykład pobiera obraz, który jest pojedynczym kolorem (0,2, 0,0, 0,4, 1,0) i podwaja składnik czerwony dodaje 0,2 do składników czerwony, zielony i niebieskiThe 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

Na poniższej ilustracji przedstawiono oryginalny obraz po lewej stronie i przekształcony obraz po prawej stronie.The following illustration shows the original image on the left and the transformed image on the right.

KoloryColors

Kod w poniższym przykładzie używa następujących kroków, aby wykonać Ponowne kolorowanie:The code in the following example uses the following steps to perform the recoloring:

  1. Zainicjuj obiekt ColorMatrix.Initialize a ColorMatrix object.

  2. Utwórz obiekt ImageAttributes i przekaż obiekt ColorMatrix do metody SetColorMatrix obiektu ImageAttributes.Create an ImageAttributes object and pass the ColorMatrix object to the SetColorMatrix method of the ImageAttributes object.

  3. Przekaż obiekt ImageAttributes do metody DrawImage obiektu 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)

Uwagi

Obiekt ImageAttributes utrzymuje kilka ustawień dopasowania koloru, w tym macierze dopasowania koloru, macierze korekty w skali szarości, wartości korekcji gamma, tabele mapy kolorów i wartości progowe koloru.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. Podczas renderowania kolory można skorygować, przyciemnić, rozjaśnić i usunąć.During rendering, colors can be corrected, darkened, lightened, and removed. Aby zastosować takie manipulacje, zainicjuj obiekt ImageAttributes i przekaż ścieżkę tego obiektu ImageAttributes (wraz ze ścieżką Image) do metody 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.

Konstruktory

ImageAttributes()

Inicjuje nowe wystąpienie klasy ImageAttributes.Initializes a new instance of the ImageAttributes class.

Metody

ClearBrushRemapTable()

Czyści tabelę zamapuj kolor pędzla tego obiektu ImageAttributes.Clears the brush color-remap table of this ImageAttributes object.

ClearColorKey()

Czyści klucz koloru (zakres przezroczystości) dla kategorii domyślnej.Clears the color key (transparency range) for the default category.

ClearColorKey(ColorAdjustType)

Czyści klucz koloru (zakres przezroczystości) dla określonej kategorii.Clears the color key (transparency range) for a specified category.

ClearColorMatrix()

Czyści macierz dopasowania kolorów dla kategorii domyślnej.Clears the color-adjustment matrix for the default category.

ClearColorMatrix(ColorAdjustType)

Czyści macierz dopasowania kolorów dla określonej kategorii.Clears the color-adjustment matrix for a specified category.

ClearGamma()

Wyłącza korekcję gamma dla kategorii domyślnej.Disables gamma correction for the default category.

ClearGamma(ColorAdjustType)

Wyłącza korekcję gamma dla określonej kategorii.Disables gamma correction for a specified category.

ClearNoOp()

Czyści ustawienie NoOp dla kategorii domyślnej.Clears the NoOp setting for the default category.

ClearNoOp(ColorAdjustType)

Czyści ustawienie NoOp dla określonej kategorii.Clears the NoOp setting for a specified category.

ClearOutputChannel()

Czyści ustawienie kanału wyjściowego CMYK (błękitny-amarantowy-Yellow-Black) dla kategorii domyślnej.Clears the CMYK (cyan-magenta-yellow-black) output channel setting for the default category.

ClearOutputChannel(ColorAdjustType)

Czyści ustawienie kanału wyjściowego (błękitny-amarantowy-Yellow-Black) dla określonej kategorii.Clears the (cyan-magenta-yellow-black) output channel setting for a specified category.

ClearOutputChannelColorProfile()

Czyści ustawienie profilu koloru kanału wyjściowego dla kategorii domyślnej.Clears the output channel color profile setting for the default category.

ClearOutputChannelColorProfile(ColorAdjustType)

Czyści ustawienie profilu koloru kanału wyjściowego dla określonej kategorii.Clears the output channel color profile setting for a specified category.

ClearRemapTable()

Czyści tabelę z mapowaniem kolorów dla kategorii domyślnej.Clears the color-remap table for the default category.

ClearRemapTable(ColorAdjustType)

Czyści tabelę z mapowaniem kolorów dla określonej kategorii.Clears the color-remap table for a specified category.

ClearThreshold()

Czyści wartość progową kategorii domyślnej.Clears the threshold value for the default category.

ClearThreshold(ColorAdjustType)

Czyści wartość progową dla określonej kategorii.Clears the threshold value for a specified category.

Clone()

Tworzy dokładną kopię tego obiektu ImageAttributes.Creates an exact copy of this ImageAttributes object.

Dispose()

Zwalnia wszystkie zasoby używane przez ten obiekt ImageAttributes.Releases all resources used by this ImageAttributes object.

Equals(Object)

Określa, czy określony obiekt jest równy bieżącemu obiektowi.Determines whether the specified object is equal to the current object.

(Odziedziczone po Object)
Finalize()

Umożliwia obiektowi podjęcie próby zwolnienia zasobów i wykonywanie innych operacji czyszczenia przed odinstalowaniem ich przez wyrzucanie elementów bezużytecznych.Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetAdjustedPalette(ColorPalette, ColorAdjustType)

Dostosowuje kolory w palecie zgodnie z ustawieniami dopasowania określonej kategorii.Adjusts the colors in a palette according to the adjustment settings of a specified category.

GetHashCode()

Służy jako domyślna funkcja skrótu.Serves as the default hash function.

(Odziedziczone po Object)
GetType()

Pobiera Type bieżącego wystąpienia.Gets the Type of the current instance.

(Odziedziczone po Object)
MemberwiseClone()

Tworzy skróconą kopię bieżącego Object.Creates a shallow copy of the current Object.

(Odziedziczone po Object)
SetBrushRemapTable(ColorMap[])

Ustawia tabelę z mapowaniem kolorów dla kategorii pędzla.Sets the color-remap table for the brush category.

SetColorKey(Color, Color)

Ustawia klucz koloru dla kategorii domyślnej.Sets the color key for the default category.

SetColorKey(Color, Color, ColorAdjustType)

Ustawia klucz koloru (zakres przezroczystości) dla określonej kategorii.Sets the color key (transparency range) for a specified category.

SetColorMatrices(ColorMatrix, ColorMatrix)

Ustawia macierz dopasowania koloru i macierz dopasowania w skali szarości dla kategorii domyślnej.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag)

Ustawia macierz dopasowania koloru i macierz dopasowania w skali szarości dla kategorii domyślnej.Sets the color-adjustment matrix and the grayscale-adjustment matrix for the default category.

SetColorMatrices(ColorMatrix, ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Ustawia macierz dopasowania koloru i macierz dopasowania w skali szarości dla określonej kategorii.Sets the color-adjustment matrix and the grayscale-adjustment matrix for a specified category.

SetColorMatrix(ColorMatrix)

Ustawia macierz dopasowania koloru dla kategorii domyślnej.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag)

Ustawia macierz dopasowania koloru dla kategorii domyślnej.Sets the color-adjustment matrix for the default category.

SetColorMatrix(ColorMatrix, ColorMatrixFlag, ColorAdjustType)

Ustawia macierz dopasowania koloru dla określonej kategorii.Sets the color-adjustment matrix for a specified category.

SetGamma(Single)

Ustawia wartość gamma dla kategorii domyślnej.Sets the gamma value for the default category.

SetGamma(Single, ColorAdjustType)

Ustawia wartość gamma dla określonej kategorii.Sets the gamma value for a specified category.

SetNoOp()

Wyłącza korektę koloru dla kategorii domyślnej.Turns off color adjustment for the default category. Można wywołać metodę ClearNoOp, aby przywrócić ustawienia dostosowania koloru, które były stosowane przed wywołaniem metody 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)

Wyłącza korektę koloru dla określonej kategorii.Turns off color adjustment for a specified category. Można wywołać metodę ClearNoOp, aby przywrócić ustawienia dostosowania koloru, które były stosowane przed wywołaniem metody 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)

Ustawia kanał wyjściowy CMYK (błękitny-amarantowy-żółty-czarny) dla kategorii domyślnej.Sets the CMYK (cyan-magenta-yellow-black) output channel for the default category.

SetOutputChannel(ColorChannelFlag, ColorAdjustType)

Ustawia kanał wyjściowy CMYK (błękitny-amarantowy-żółty-czarny) dla określonej kategorii.Sets the CMYK (cyan-magenta-yellow-black) output channel for a specified category.

SetOutputChannelColorProfile(String)

Ustawia plik profilu kolorów kanału wyjściowego dla kategorii domyślnej.Sets the output channel color-profile file for the default category.

SetOutputChannelColorProfile(String, ColorAdjustType)

Ustawia plik profilu kolorów kanału wyjściowego dla określonej kategorii.Sets the output channel color-profile file for a specified category.

SetRemapTable(ColorMap[])

Ustawia tabelę z mapowaniem kolorów dla kategorii domyślnej.Sets the color-remap table for the default category.

SetRemapTable(ColorMap[], ColorAdjustType)

Ustawia tabelę mapowania kolorów dla określonej kategorii.Sets the color-remap table for a specified category.

SetThreshold(Single)

Ustawia próg (zakres przezroczystości) dla kategorii domyślnej.Sets the threshold (transparency range) for the default category.

SetThreshold(Single, ColorAdjustType)

Ustawia próg (zakres przezroczystości) dla określonej kategorii.Sets the threshold (transparency range) for a specified category.

SetWrapMode(WrapMode)

Ustawia tryb zawijania używany do decydowania o sposobie kafelka tekstury w obrębie kształtu lub w granicach kształtu.Sets the wrap mode that is used to decide how to tile a texture across a shape, or at shape boundaries. Tekstura jest rozmieszczana w obrębie kształtu, aby wypełnić go, gdy tekstura jest mniejsza niż wypełniany kształt.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)

Ustawia tryb zawijania i kolor używany do decydowania o sposobie kafelka tekstury w obrębie kształtu lub w granicach kształtu.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Tekstura jest rozmieszczana w obrębie kształtu, aby wypełnić go, gdy tekstura jest mniejsza niż wypełniany kształt.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)

Ustawia tryb zawijania i kolor używany do decydowania o sposobie kafelka tekstury w obrębie kształtu lub w granicach kształtu.Sets the wrap mode and color used to decide how to tile a texture across a shape, or at shape boundaries. Tekstura jest rozmieszczana w obrębie kształtu, aby wypełnić go, gdy tekstura jest mniejsza niż wypełniany kształt.A texture is tiled across a shape to fill it in when the texture is smaller than the shape it is filling.

ToString()

Zwraca ciąg, który reprezentuje bieżący obiekt.Returns a string that represents the current object.

(Odziedziczone po Object)

Dotyczy

Zobacz też