Bitmap Kelas

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Sumber:

Bitmap.cs

Merangkum bitmap GDI+, yang terdiri dari data piksel untuk gambar grafis dan atributnya. Bitmap adalah objek yang digunakan untuk bekerja dengan gambar yang ditentukan oleh data piksel.

public ref class Bitmap sealed : System::Drawing::Image

[System.Serializable]
public sealed class Bitmap : System.Drawing.Image

[<System.Serializable>]
type Bitmap = class
    inherit Image

Public NotInheritable Class Bitmap
Inherits Image

Warisan

Object

MarshalByRefObject

Image

Bitmap

Atribut

SerializableAttribute

Contoh

Contoh kode berikut menunjukkan cara membuat baru Bitmap dari file, menggunakan GetPixel metode dan SetPixel untuk mewarnai ulang gambar. Ini juga menggunakan PixelFormatproperti , Width, dan Height .

Contoh ini dirancang untuk digunakan dengan Formulir Windows yang masing-masing berisi Label, , PictureBoxdan Button bernama Label1, PictureBox1, dan Button1. Tempelkan kode ke dalam formulir dan kaitkan Button1_Click metode dengan peristiwa tombol Click .

private:
   Bitmap^ image1;
   void Button1_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      try
      {
         
         // Retrieve the image.
         image1 = gcnew Bitmap( "C:\\Documents and Settings\\All Users\\"
         "Documents\\My Music\\music.bmp",true );
         int x;
         int 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 = String::Format( "Pixel format: {0}", image1->PixelFormat );
      }
      catch ( ArgumentException^ ) 
      {
         MessageBox::Show( "There was an error."
         "Check the path to the image file." );
      }

   }

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.");
    }
}

Dim image1 As Bitmap

Private Sub Button1_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button1.Click

    Try
        ' Retrieve the image.
        image1 = New Bitmap( _
            "C:\Documents and Settings\All Users\Documents\My Music\music.bmp", _
            True)

        Dim x, y As Integer

        ' Loop through the images pixels to reset color.
        For x = 0 To image1.Width - 1
            For y = 0 To image1.Height - 1
                Dim pixelColor As Color = image1.GetPixel(x, y)
                Dim newColor As Color = _
                    Color.FromArgb(pixelColor.R, 0, 0)
                image1.SetPixel(x, y, newColor)
            Next
        Next

        ' Set the PictureBox to display the image.
        PictureBox1.Image = image1

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

    Catch ex As ArgumentException
        MessageBox.Show("There was an error." _
            & "Check the path to the image file.")
    End Try
End Sub

Keterangan

Bitmap terdiri dari data piksel untuk gambar grafis dan atributnya. Ada banyak format standar untuk menyimpan bitmap ke file. GDI+ mendukung format file berikut: BMP, GIF, EXIF, JPG, PNG, dan TIFF. Untuk informasi selengkapnya tentang format yang didukung, lihat Jenis Bitmap.

Anda dapat membuat gambar dari file, aliran, dan sumber lain dengan menggunakan salah Bitmap satu konstruktor dan menyimpannya ke aliran atau ke sistem file dengan Save metode . Gambar digambar ke layar atau ke memori dengan menggunakan DrawImage metode Graphics objek . Untuk daftar topik tentang bekerja dengan file gambar, lihat Bekerja dengan Gambar, Bitmap, Ikon, dan Metafiles.

Catatan

Dalam .NET 6 dan versi yang lebih baru, paket System.Drawing.Common, yang mencakup jenis ini, hanya didukung pada sistem operasi Windows. Penggunaan jenis ini dalam aplikasi lintas platform menyebabkan peringatan waktu kompilasi dan pengecualian run-time. Untuk informasi selengkapnya, lihat System.Drawing.Common hanya didukung di Windows.

Catatan

Kelas Bitmap tidak dapat diakses di seluruh domain aplikasi. Misalnya, jika Anda membuat dinamis AppDomain dan membuat beberapa kuas, pena, dan bitmap di domain tersebut, kemudian meneruskan objek ini kembali ke domain aplikasi utama, Anda dapat berhasil menggunakan pena dan kuas. Namun, jika Anda memanggil DrawImage metode untuk menggambar marshaled Bitmap, Anda menerima pengecualian berikut:

Jarak jauh tidak dapat menemukan bidang "gambar asli" pada jenis "System.Drawing.Image".

Konstruktor

Bitmap(Image)	Menginisialisasi instans Bitmap baru kelas dari gambar yang ada yang ditentukan.
Bitmap(Image, Int32, Int32)	Menginisialisasi instans Bitmap baru kelas dari gambar yang ada yang ditentukan, diskalakan ke ukuran yang ditentukan.
Bitmap(Image, Size)	Menginisialisasi instans Bitmap baru kelas dari gambar yang ada yang ditentukan, diskalakan ke ukuran yang ditentukan.
Bitmap(Int32, Int32)	Menginisialisasi instans Bitmap baru kelas dengan ukuran yang ditentukan.
Bitmap(Int32, Int32, Graphics)	Menginisialisasi instans Bitmap baru kelas dengan ukuran yang ditentukan dan dengan resolusi objek yang ditentukan Graphics .
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	Menginisialisasi instans Bitmap baru kelas dengan ukuran, format piksel, dan data piksel yang ditentukan.
Bitmap(Int32, Int32, PixelFormat)	Menginisialisasi instans Bitmap baru kelas dengan ukuran dan format yang ditentukan.
Bitmap(Stream)	Menginisialisasi instans Bitmap baru kelas dari aliran data yang ditentukan.
Bitmap(Stream, Boolean)	Menginisialisasi instans Bitmap baru kelas dari aliran data yang ditentukan.
Bitmap(String)	Menginisialisasi instans Bitmap baru kelas dari file yang ditentukan.
Bitmap(String, Boolean)	Menginisialisasi instans Bitmap baru kelas dari file yang ditentukan.
Bitmap(Type, String)	Menginisialisasi instans Bitmap baru kelas dari sumber daya tertentu.

Properti

Flags	Mendapatkan bendera atribut untuk data piksel ini Image. (Diperoleh dari Image)
FrameDimensionsList	Mendapatkan array GUID yang mewakili dimensi bingkai dalam ini Image. (Diperoleh dari Image)
Height	Mendapatkan tinggi, dalam piksel, dari ini Image. (Diperoleh dari Image)
HorizontalResolution	Mendapatkan resolusi horizontal, dalam piksel per inci, dari ini Image. (Diperoleh dari Image)
Palette	Mendapatkan atau mengatur palet warna yang digunakan untuk ini Image. (Diperoleh dari Image)
PhysicalDimension	Mendapatkan lebar dan tinggi gambar ini. (Diperoleh dari Image)
PixelFormat	Mendapatkan format piksel untuk ini Image. (Diperoleh dari Image)
PropertyIdList	Mendapatkan ID item properti yang disimpan dalam ini Image. (Diperoleh dari Image)
PropertyItems	Mendapatkan semua item properti (potongan metadata) yang disimpan dalam ini Image. (Diperoleh dari Image)
RawFormat	Mendapatkan format file dari ini Image. (Diperoleh dari Image)
Size	Mendapatkan lebar dan tinggi, dalam piksel, dari gambar ini. (Diperoleh dari Image)
Tag	Mendapatkan atau mengatur objek yang menyediakan data tambahan tentang gambar. (Diperoleh dari Image)
VerticalResolution	Mendapatkan resolusi vertikal, dalam piksel per inci, dari ini Image. (Diperoleh dari Image)
Width	Mendapatkan lebar, dalam piksel, dari ini Image. (Diperoleh dari Image)

Metode

Clone()	Membuat salinan yang tepat dari ini Image. (Diperoleh dari Image)
Clone(Rectangle, PixelFormat)	Membuat salinan bagian ini Bitmap yang ditentukan oleh Rectangle struktur dan dengan enumerasi tertentu PixelFormat .
Clone(RectangleF, PixelFormat)	Membuat salinan bagian ini Bitmap yang ditentukan dengan enumerasi tertentu PixelFormat .
CreateObjRef(Type)	Membuat objek yang berisi semua informasi relevan yang diperlukan untuk menghasilkan proksi yang digunakan untuk berkomunikasi dengan objek jarak jauh. (Diperoleh dari MarshalByRefObject)
Dispose()	Merilis semua sumber daya yang digunakan oleh ini Image. (Diperoleh dari Image)
Dispose(Boolean)	Merilis sumber daya tidak terkelola yang digunakan oleh Image dan secara opsional merilis sumber daya terkelola. (Diperoleh dari Image)
Equals(Object)	Menentukan apakah objek yang ditentukan sama dengan objek saat ini. (Diperoleh dari Object)
FromHicon(IntPtr)	Membuat dari handel Bitmap Windows ke ikon.
FromResource(IntPtr, String)	Bitmap Membuat dari sumber daya Windows yang ditentukan.
GetBounds(GraphicsUnit)	Mendapatkan batas gambar di unit yang ditentukan. (Diperoleh dari Image)
GetEncoderParameterList(Guid)	Mengembalikan informasi tentang parameter yang didukung oleh encoder gambar yang ditentukan. (Diperoleh dari Image)
GetFrameCount(FrameDimension)	Mengembalikan jumlah bingkai dimensi yang ditentukan. (Diperoleh dari Image)
GetHashCode()	Berfungsi sebagai fungsi hash default. (Diperoleh dari Object)
GetHbitmap()	Membuat objek bitmap GDI dari ini Bitmap.
GetHbitmap(Color)	Membuat objek bitmap GDI dari ini Bitmap.
GetHicon()	Mengembalikan handel ke ikon.
GetLifetimeService()	Mengambil objek layanan seumur hidup saat ini yang mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
GetPixel(Int32, Int32)	Mendapatkan warna piksel yang ditentukan dalam ini Bitmap.
GetPropertyItem(Int32)	Mendapatkan item properti yang ditentukan dari ini Image. (Diperoleh dari Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Mengembalikan gambar mini untuk ini Image. (Diperoleh dari Image)
GetType()	Mendapatkan dari instans Type saat ini. (Diperoleh dari Object)
InitializeLifetimeService()	Mendapatkan objek layanan seumur hidup untuk mengontrol kebijakan seumur hidup untuk instans ini. (Diperoleh dari MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)	Bitmap Mengunci ke dalam memori sistem.
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Bitmap Mengunci ke dalam memori sistem.
MakeTransparent()	Membuat warna transparan default transparan untuk ini Bitmap.
MakeTransparent(Color)	Membuat warna yang ditentukan transparan untuk ini Bitmap.
MemberwiseClone()	Membuat salinan dangkal dari saat ini Object. (Diperoleh dari Object)
MemberwiseClone(Boolean)	Membuat salinan dangkal objek saat ini MarshalByRefObject . (Diperoleh dari MarshalByRefObject)
RemovePropertyItem(Int32)	Menghapus item properti yang ditentukan dari ini Image. (Diperoleh dari Image)
RotateFlip(RotateFlipType)	Memutar, membalik, atau memutar dan membalik Image. (Diperoleh dari Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	Menyimpan gambar ini ke aliran yang ditentukan, dengan parameter encoder dan encoder gambar yang ditentukan. (Diperoleh dari Image)
Save(Stream, ImageFormat)	Menyimpan gambar ini ke aliran yang ditentukan dalam format yang ditentukan. (Diperoleh dari Image)
Save(String)	Menyimpan ini Image ke file atau aliran yang ditentukan. (Diperoleh dari Image)
Save(String, ImageCodecInfo, EncoderParameters)	Menyimpan ini Image ke file yang ditentukan, dengan parameter encoder dan image-encoder yang ditentukan. (Diperoleh dari Image)
Save(String, ImageFormat)	Simpan ini Image ke file yang ditentukan dalam format yang ditentukan. (Diperoleh dari Image)
SaveAdd(EncoderParameters)	Menambahkan bingkai ke file atau aliran yang ditentukan dalam panggilan sebelumnya ke Save metode . Gunakan metode ini untuk menyimpan bingkai yang dipilih dari gambar multi-bingkai ke gambar multi-bingkai lainnya. (Diperoleh dari Image)
SaveAdd(Image, EncoderParameters)	Menambahkan bingkai ke file atau aliran yang ditentukan dalam panggilan sebelumnya ke Save metode . (Diperoleh dari Image)
SelectActiveFrame(FrameDimension, Int32)	Memilih bingkai yang ditentukan oleh dimensi dan indeks. (Diperoleh dari Image)
SetPixel(Int32, Int32, Color)	Mengatur warna piksel yang ditentukan dalam ini Bitmap.
SetPropertyItem(PropertyItem)	Menyimpan item properti (bagian metadata) di ini Image. (Diperoleh dari Image)
SetResolution(Single, Single)	Mengatur resolusi untuk ini Bitmap.
ToString()	Mengembalikan string yang mewakili objek saat ini. (Diperoleh dari Object)
UnlockBits(BitmapData)	Membuka kunci ini Bitmap dari memori sistem.

Implementasi Antarmuka Eksplisit

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

Mengisi dengan data yang SerializationInfo diperlukan untuk membuat serialisasi objek target. (Diperoleh dari Image)

Lihat juga

• PictureBox
• Gambar, bitmap, dan metafile
• Bekerja dengan Gambar, Bitmap, Ikon, dan Metafiles