ImageAttributes.SetRemapTable Método

Definición

Establece la tabla de reasignación de colores.

Sobrecargas

SetRemapTable(ColorMap[])

Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
Source:
ImageAttributes.cs

Establece la tabla de reasignación de colores para la categoría predeterminada.

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

Parámetros

map
ColorMap[]

Matriz de pares de color de tipo ColorMap. Cada par de colores contiene un color existente (el primer valor) y el color al que se asignará (el segundo valor).

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

  1. Crea una imagen (un círculo rojo), la guarda como Circle2.jpg, abre esa imagen y la dibuja en la pantalla.

  2. Crea un mapa de colores que asigna el color rojo al color verde.

  3. Dibuja la imagen creada anteriormente en la pantalla de nuevo, pero esta vez con el mapa de colores.

C#
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);    
}

Comentarios

Una tabla de reasignación de colores es una matriz de estructuras ColorMap. Cada estructura ColorMap tiene dos objetos Color: uno que especifica un color antiguo y otro que especifica un nuevo color correspondiente. Durante la representación, cualquier color que coincida con uno de los colores antiguos de la tabla de reasignación se cambia al nuevo color correspondiente.

Un objeto ImageAttributes mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar un mapa de color para la categoría predeterminada, una tabla de remapa de color para la categoría de mapa de bits y una tabla de reasignación de color diferente para la categoría de lápiz.

La configuración predeterminada de ajuste de color y ajuste de escala de grises se aplica a todas las categorías que no tienen valores de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

SetRemapTable(ReadOnlySpan<ColorMap>)

Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
C#
public void SetRemapTable (scoped ReadOnlySpan<System.Drawing.Imaging.ColorMap> map);

Parámetros

Se aplica a

.NET 9 y Windows Desktop 9
Producto Versiones
.NET 9
Windows Desktop 9

SetRemapTable(ReadOnlySpan<ValueTuple<Color,Color>>)

Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
C#
public void SetRemapTable (scoped ReadOnlySpan<(System.Drawing.Color OldColor, System.Drawing.Color NewColor)> map);

Parámetros

Se aplica a

.NET 9 y Windows Desktop 9
Producto Versiones
.NET 9
Windows Desktop 9

SetRemapTable(ColorAdjustType, ReadOnlySpan<ColorMap>)

Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
C#
public void SetRemapTable (System.Drawing.Imaging.ColorAdjustType type, scoped ReadOnlySpan<System.Drawing.Imaging.ColorMap> map);

Parámetros

Se aplica a

.NET 9 y Windows Desktop 9
Producto Versiones
.NET 9
Windows Desktop 9

SetRemapTable(ColorAdjustType, ReadOnlySpan<ValueTuple<Color,Color>>)

Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
C#
public void SetRemapTable (System.Drawing.Imaging.ColorAdjustType type, scoped ReadOnlySpan<(System.Drawing.Color OldColor, System.Drawing.Color NewColor)> map);

Parámetros

Se aplica a

.NET 9 y Windows Desktop 9
Producto Versiones
.NET 9
Windows Desktop 9

SetRemapTable(ColorMap[], ColorAdjustType)

Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
Source:
ImageAttributes.cs
Source:
ImageAttributes.cs

Establece la tabla de reasignación de color para una categoría especificada.

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

Parámetros

map
ColorMap[]

Matriz de pares de color de tipo ColorMap. Cada par de colores contiene un color existente (el primer valor) y el color al que se asignará (el segundo valor).

type
ColorAdjustType

Elemento de ColorAdjustType que especifica la categoría para la que se establece la tabla de reasignación de colores.

Ejemplos

Para obtener un ejemplo de código, consulte el método SetRemapTable(ColorMap[]).

Comentarios

Una tabla de reasignación de colores es una matriz de estructuras ColorMap. Cada estructura ColorMap tiene dos objetos Color: uno que especifica un color antiguo y otro que especifica un nuevo color correspondiente. Durante la representación, cualquier color que coincida con uno de los colores antiguos de la tabla de reasignación se cambia al nuevo color correspondiente.

Un objeto ImageAttributes mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar un mapa de color para la categoría predeterminada, una tabla de remapa de color para la categoría de mapa de bits y una tabla de reasignación de color diferente para la categoría de lápiz.

La configuración predeterminada de ajuste de color y ajuste de escala de grises se aplica a todas las categorías que no tienen valores de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.

En cuanto especifique un ajuste de color o ajuste de escala de grises para una determinada categoría, la configuración de ajuste predeterminada ya no se aplica a esa categoría. Por ejemplo, supongamos que especifica una colección de opciones de ajuste para la categoría predeterminada. Si establece la tabla de reasignación de color para la categoría de lápiz pasando Pen al método SetRemapTable, no se aplicará ninguna de las opciones de ajuste predeterminadas a los lápices.

Se aplica a

.NET 9 y otras versiones
Producto Versiones
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9