ImageAttributes.SetRemapTable Méthode

Définition

Espace de noms:

System.Drawing.Imaging

Assembly:

System.Drawing.Common.dll

Paquet:

System.Drawing.Common v9.0.0-preview.7.24405.4

Définit la table de remappage de couleurs.

Surcharges

SetRemapTable(ColorMap[])	Définit la table color-remap pour la catégorie par défaut.
SetRemapTable(ColorMap[], ColorAdjustType)	Définit la table de remappage de couleurs pour une catégorie spécifiée.

SetRemapTable(ColorMap[])

Source:

ImageAttributes.cs

Définit la table color-remap pour la catégorie par défaut.

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

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

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

Public Sub SetRemapTable (ParamArray map As ColorMap())

Paramètres

map

ColorMap[]

Tableau de paires de couleurs de type ColorMap. Chaque paire de couleurs contient une couleur existante (la première valeur) et la couleur à laquelle elle sera mappée (la deuxième valeur).

Exemples

L’exemple de code suivant est conçu pour être utilisé avec Windows Forms et nécessite PaintEventArgse, qui est un paramètre du gestionnaire d’événements Paint. Le code effectue les actions suivantes :

1. Crée une image (un cercle rouge), l’enregistre en tant que Circle2.jpg, ouvre cette image et la dessine à l’écran.

2. Crée une carte de couleurs qui mappe la couleur rouge à la couleur verte.

3. Dessine à nouveau l’image créée précédemment à l’écran, mais cette fois à l’aide de la carte de couleurs.

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

Remarques

Une table de remappage de couleurs est un tableau de structures ColorMap. Chaque structure ColorMap a deux objets Color : un qui spécifie une ancienne couleur et une autre qui spécifie une nouvelle couleur correspondante. Pendant le rendu, toute couleur qui correspond à l’une des anciennes couleurs de la table de remappage est remplacée par la nouvelle couleur correspondante.

Un objet ImageAttributes conserve les paramètres de couleur et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier un remappage de couleur pour la catégorie par défaut, une table de remappage de couleurs pour la catégorie bitmap, et toujours une table de remappage de couleurs différente pour la catégorie de stylet.

Les paramètres d’ajustement de couleur et d’ajustement des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.

SetRemapTable(ColorMap[], ColorAdjustType)

Source:

ImageAttributes.cs

Définit la table de remappage de couleurs pour une catégorie spécifiée.

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)

Paramètres

map

ColorMap[]

Tableau de paires de couleurs de type ColorMap. Chaque paire de couleurs contient une couleur existante (la première valeur) et la couleur à laquelle elle sera mappée (la deuxième valeur).

type

ColorAdjustType

Élément de ColorAdjustType qui spécifie la catégorie pour laquelle la table color-remap est définie.

Exemples

Pour obtenir un exemple de code, consultez la méthode SetRemapTable(ColorMap[]).

Remarques

Une table de remappage de couleurs est un tableau de structures ColorMap. Chaque structure ColorMap a deux objets Color : un qui spécifie une ancienne couleur et une autre qui spécifie une nouvelle couleur correspondante. Pendant le rendu, toute couleur qui correspond à l’une des anciennes couleurs de la table de remappage est remplacée par la nouvelle couleur correspondante.

Un objet ImageAttributes conserve les paramètres de couleur et de nuances de gris pour cinq catégories d’ajustement : par défaut, bitmap, pinceau, stylet et texte. Par exemple, vous pouvez spécifier un remappage de couleur pour la catégorie par défaut, une table de remappage de couleurs pour la catégorie bitmap, et toujours une table de remappage de couleurs différente pour la catégorie de stylet.

Les paramètres d’ajustement de couleur et d’ajustement des nuances de gris par défaut s’appliquent à toutes les catégories qui n’ont pas de paramètres d’ajustement propres. Par exemple, si vous ne spécifiez jamais de paramètres d’ajustement pour la catégorie de stylet, les paramètres par défaut s’appliquent à la catégorie de stylet.

Dès que vous spécifiez un paramètre d’ajustement de couleur ou d’ajustement des nuances de gris pour une certaine catégorie, les paramètres d’ajustement par défaut ne s’appliquent plus à cette catégorie. Par exemple, supposons que vous spécifiez une collection de paramètres d’ajustement pour la catégorie par défaut. Si vous définissez la table de remappage couleur pour la catégorie de stylet en passant Pen à la méthode SetRemapTable, aucun des paramètres d’ajustement par défaut ne s’applique aux stylets.