Bitmap, classe

Une bitmap est composée des données de pixels d'une image graphique et de ses attributs. Vous pouvez enregistrer un bitmap dans un fichier selon plusieurs formats standard. GDI+ prend en charge les formats de fichiers suivants : BMP, GIF, EXIF, JPG, PNG et TIFF. Pour plus d'informations sur les formats pris en charge, consultez la page Types de bitmaps.

Vous pouvez créer des images à partir de fichiers, de flux de données et d'autres sources en utilisant l'un des constructeurs Bitmap et vous pouvez les enregistrer dans un flux de données ou dans le système de fichiers à l'aide de la méthode Save. Pour dessiner des images à l'écran ou dans la mémoire, utilisez la méthode DrawImage de l'objet Graphics. Pour une liste de rubriques sur l'utilisation de fichiers image, consultez la page Utilisation des images, bitmaps, icônes et métafichiers.

Remarque

La classe Bitmap n'est pas accessible entre domaines d'application. Par exemple, si vous créez un domaine dynamique AppDomain et créez plusieurs pinceaux, stylets et bitmaps dans ce domaine, puis passez ces objets au domaine d'application principal, vous pourrez utiliser les stylets et pinceaux. Cependant, si vous appelez la méthode DrawImage pour dessiner l'objet Bitmapmarshalé, l'exception suivante s'affiche. La communication à distance ne peut pas trouver le champ "image native" sur le type "System.Drawing.Image".

L'exemple de code suivant montre comment construire un nouveau Bitmap à partir d'un fichier, en utilisant les méthodes GetPixel et SetPixel pour recolorier l'image. Il utilise également les propriétés PixelFormat, Width et Height.

Cet exemple a été conçu pour être utilisé avec un Windows Form qui contient un Label, un PictureBox et un Button nommés respectivement Label1, PictureBox1 et Button1. Collez le code dans le formulaire et associez la méthode Button1_Click à l'événement Click du bouton.

Bitmap image1;

private void Button1_Click(System.Object sender, System.EventArgs e)
{

    try
    {
        // Retrieve the image.
        image1 = new Bitmap(@"C:\Documents and Settings\All Users\" 
            + @"Documents\My Music\music.bmp", true);

        int x, y;

        // Loop through the images pixels to reset color.
        for(x=0; x<image1.Width; x++)
        {
            for(y=0; y<image1.Height; y++)
            {
                Color pixelColor = image1.GetPixel(x, y);
                Color newColor = Color.FromArgb(pixelColor.R, 0, 0);
                image1.SetPixel(x, y, newColor);
            }
        }

        // Set the PictureBox to display the image.
        PictureBox1.Image = image1;

        // Display the pixel format in Label1.
        Label1.Text = "Pixel format: "+image1.PixelFormat.ToString();

    }
    catch(ArgumentException)
    {
        MessageBox.Show("There was an error." +
            "Check the path to the image file.");
    }
}

.NET Framework

.NET Framework Client Profile

Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (rôle principal du serveur non pris en charge), Windows Server 2008 R2 (rôle principal du serveur pris en charge avec SP1 ou version ultérieure ; Itanium non pris en charge)

Référence

Autres ressources