ImageAttributes.SetRemapTable Metoda

Definicja

Przestrzeń nazw:

System.Drawing.Imaging

Zestaw:

System.Drawing.Common.dll

Pakiet:

System.Drawing.Common v8.0.0

Ustawia tabelę mapowania kolorów.

Przeciążenia

SetRemapTable(ColorMap[])	Ustawia tabelę mapowania kolorów dla kategorii domyślnej.
SetRemapTable(ColorMap[], ColorAdjustType)	Ustawia tabelę mapowania kolorów dla określonej kategorii.

SetRemapTable(ColorMap[])

Źródło:

ImageAttributes.cs

Ustawia tabelę mapowania kolorów dla kategorii domyślnej.

public:
 void SetRemapTable(cli::array <System::Drawing::Imaging::ColorMap ^> ^ map);

public void SetRemapTable (System.Drawing.Imaging.ColorMap[] map);

member this.SetRemapTable : System.Drawing.Imaging.ColorMap[] -> unit

Public Sub SetRemapTable (map As ColorMap())

Parametry

map

ColorMap[]

Tablica par kolorów typu ColorMap. Każda para kolorów zawiera istniejący kolor (pierwszą wartość) i kolor, do którego zostanie on zamapowany (druga wartość).

Przykłady

Poniższy przykład kodu jest przeznaczony do użycia z Windows Forms i wymaga PaintEventArgseparametru Paint programu obsługi zdarzeń. Kod wykonuje następujące akcje:

1. Tworzy obraz (czerwony okrąg), zapisuje go jako Circle2.jpg, otwiera ten obraz i rysuje go na ekranie.

2. Tworzy mapę kolorów, która mapuje kolor czerwony na kolor zielony.

3. Rysuje obraz utworzony wcześniej na ekranie, ale tym razem przy użyciu mapy kolorów.

private:
   void SetRemapTableExample( PaintEventArgs^ e )
   {
      // Create a filled, red image, and save it to Circle2.jpg.
      Bitmap^ myBitmap = gcnew Bitmap( 50,50 );
      Graphics^ g = Graphics::FromImage( myBitmap );
      g->Clear( Color::White );
      g->FillEllipse( gcnew SolidBrush( Color::Red ), Rectangle(0,0,50,50) );
      myBitmap->Save( "Circle2.jpg" );

      // Create an Image object from the Circle2.jpg file, and draw it to
      // the screen.
      Image^ myImage = Image::FromFile( "Circle2.jpg" );
      e->Graphics->DrawImage( myImage, 20, 20 );

      // Create a color map.
      array<ColorMap^>^myColorMap = gcnew array<ColorMap^>(1);
      myColorMap[ 0 ] = gcnew ColorMap;
      myColorMap[ 0 ]->OldColor = Color::Red;
      myColorMap[ 0 ]->NewColor = Color::Green;

      // Create an ImageAttributes object, and then pass the
      // myColorMap object to the SetRemapTable method.
      ImageAttributes^ imageAttr = gcnew ImageAttributes;
      imageAttr->SetRemapTable( myColorMap );

      // Draw the image with the remap table set.
      Rectangle rect = Rectangle(150,20,50,50);
      e->Graphics->DrawImage( myImage, rect, 0, 0, 50, 50, GraphicsUnit::Pixel, imageAttr );
   }

private void SetRemapTableExample(PaintEventArgs e)
{
             
    // Create a filled, red image, and save it to Circle2.jpg.
    Bitmap myBitmap = new Bitmap(50, 50);
    Graphics g = Graphics.FromImage(myBitmap);
    g.Clear(Color.White);
    g.FillEllipse(new SolidBrush(Color.Red),
        new Rectangle(0, 0, 50, 50));
    myBitmap.Save("Circle2.jpg");
             
    // Create an Image object from the Circle2.jpg file, and draw it to
             
    // the screen.
    Image myImage = Image.FromFile("Circle2.jpg");
    e.Graphics.DrawImage(myImage, 20, 20);
             
    // Create a color map.
    ColorMap[] myColorMap = new ColorMap[1];
    myColorMap[0] = new ColorMap();
    myColorMap[0].OldColor = Color.Red;
    myColorMap[0].NewColor = Color.Green;
             
    // Create an ImageAttributes object, and then pass the
   // myColorMap object to the SetRemapTable method.
    ImageAttributes imageAttr = new ImageAttributes();
    imageAttr.SetRemapTable(myColorMap);
             
    // Draw the image with the remap table set.
    Rectangle rect = new Rectangle(150, 20, 50, 50);
    e.Graphics.DrawImage(myImage, rect, 0, 0, 50, 50, 
        GraphicsUnit.Pixel, imageAttr);    
}

Public Sub SetRemapTableExample(ByVal e As PaintEventArgs)

    ' Create a filled, red image and save it to Circle2.jpg.
    Dim myBitmap As New Bitmap(50, 50)
    Dim g As Graphics = Graphics.FromImage(myBitmap)
    g.Clear(Color.White)
    g.FillEllipse(New SolidBrush(Color.Red), New Rectangle(0, 0, _
    50, 50))
    myBitmap.Save("Circle2.jpg")

    ' Create an Image object from the Circle2.jpg file, and draw

    ' it to the screen.
    Dim myImage As Image = Image.FromFile("Circle2.jpg")
    e.Graphics.DrawImage(myImage, 20, 20)

    ' Create a color map.
    Dim myColorMap(0) As ColorMap
    myColorMap(0) = New ColorMap
    myColorMap(0).OldColor = Color.Red
    myColorMap(0).NewColor = Color.Green

    ' Create an ImageAttributes object, and then pass the

    ' myColorMap object to the SetRemapTable method.
    Dim imageAttr As New ImageAttributes
    imageAttr.SetRemapTable(myColorMap)

    ' Draw the image with the remap table set.
    Dim rect As New Rectangle(150, 20, 50, 50)
    e.Graphics.DrawImage(myImage, rect, 0, 0, 50, 50, _
    GraphicsUnit.Pixel, imageAttr)
    ' Image
End Sub

Uwagi

Tabela mapowania kolorów jest tablicą ColorMap struktur. Każda ColorMap struktura ma dwa Color obiekty: jeden, który określa stary kolor i jeden, który określa odpowiedni nowy kolor. Podczas renderowania każdy kolor, który pasuje do jednego ze starych kolorów w tabeli ponownej mapy, zostanie zmieniony na odpowiedni nowy kolor.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekt: domyślne, mapy bitowe, pędzle, pióro i tekst. Można na przykład określić ponownie mapę kolorów dla kategorii domyślnej, tabelę mapy kolorów dla kategorii mapy bitowej i nadal inną tabelę ponownego mapowania kolorów dla kategorii pióra.

Domyślne ustawienia dostosowania kolorów i skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień regulacji. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą miały zastosowanie do kategorii pióra.

SetRemapTable(ColorMap[], ColorAdjustType)

Źródło:

ImageAttributes.cs

Ustawia tabelę mapowania kolorów dla określonej kategorii.

public:
 void SetRemapTable(cli::array <System::Drawing::Imaging::ColorMap ^> ^ map, System::Drawing::Imaging::ColorAdjustType type);

public void SetRemapTable (System.Drawing.Imaging.ColorMap[] map, System.Drawing.Imaging.ColorAdjustType type);

member this.SetRemapTable : System.Drawing.Imaging.ColorMap[] * System.Drawing.Imaging.ColorAdjustType -> unit

Public Sub SetRemapTable (map As ColorMap(), type As ColorAdjustType)

Parametry

map

ColorMap[]

Tablica par kolorów typu ColorMap. Każda para kolorów zawiera istniejący kolor (pierwszą wartość) i kolor, do którego zostanie on zamapowany (druga wartość).

type

ColorAdjustType

Element ColorAdjustType tego elementu określa kategorię, dla której ustawiono tabelę color-remap.

Przykłady

Aby zapoznać się z przykładem kodu, zobacz metodę SetRemapTable(ColorMap[]) .

Uwagi

Tabela mapowania kolorów jest tablicą ColorMap struktur. Każda ColorMap struktura ma dwa Color obiekty: jeden, który określa stary kolor i jeden, który określa odpowiedni nowy kolor. Podczas renderowania każdy kolor, który pasuje do jednego ze starych kolorów w tabeli ponownej mapy, zostanie zmieniony na odpowiedni nowy kolor.

Obiekt ImageAttributes zachowuje ustawienia koloru i skali szarości dla pięciu kategorii korekt: domyślne, mapy bitowe, pędzle, pióro i tekst. Można na przykład określić ponownie mapę kolorów dla kategorii domyślnej, tabelę mapy kolorów dla kategorii mapy bitowej i nadal inną tabelę ponownego mapowania kolorów dla kategorii pióra.

Domyślne ustawienia dostosowania kolorów i skali szarości mają zastosowanie do wszystkich kategorii, które nie mają własnych ustawień regulacji. Jeśli na przykład nigdy nie określisz żadnych ustawień korekty dla kategorii pióra, ustawienia domyślne będą miały zastosowanie do kategorii pióra.

Gdy tylko określisz ustawienie korekty koloru lub skali szarości dla określonej kategorii, domyślne ustawienia korekty nie będą już stosowane do tej kategorii. Załóżmy na przykład, że określisz kolekcję ustawień korekty dla kategorii domyślnej. Jeśli ustawisz tabelę color-remap dla kategorii pióra, przekazując Pen do SetRemapTable metody , żadne z domyślnych ustawień korekty nie będzie miało zastosowania do piór.