Image.PixelFormat Property


The .NET API Reference documentation has a new home. Visit the .NET API Browser on to see the new experience.

Gets the pixel format for this Image.

Namespace:   System.Drawing
Assembly:  System.Drawing (in System.Drawing.dll)

public PixelFormat PixelFormat { get; }

Property Value

Type: System.Drawing.Imaging.PixelFormat

A PixelFormat that represents the pixel format for this Image.

The following code example demonstrates how to construct a new bitmap from a file, using the GetPixel and SetPixel methods to recolor the image. It also uses the PixelFormat property.

This example is designed to be used with a Windows Form that contains a Label, PictureBox and Button named Label1, PictureBox1, and Button1, respectively. Paste the code into the form and associate the Button1_Click method with the button's Click event.

Bitmap image1;

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

        // 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();

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

.NET Framework
Available since 1.1
Return to top