Bitmap Sınıf

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Kaynak:

Bitmap.cs

Bir grafik görüntüsü için piksel verilerinden ve özniteliklerinden oluşan GDI+ bit eşlemini kapsüller. A Bitmap , piksel verileriyle tanımlanan görüntülerle çalışmak için kullanılan bir nesnedir.

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

Devralma

Object

MarshalByRefObject

Image

Bitmap

Öznitelikler

SerializableAttribute

Örnekler

Aşağıdaki kod örneği, görüntüyü yeniden renklendirmek için ve SetPixel yöntemlerini kullanarak GetPixel bir dosyadan yeni Bitmap oluşturma işlemini gösterir. Ayrıca , Widthve Height özelliklerini de kullanırPixelFormat.

Bu örnek, sırasıyla , ve adlandırılmış Label1, PictureBoxPictureBox1ve ButtonButton1içeren bir LabelWindows Forms ile kullanılmak üzere tasarlanmıştır. Kodu forma yapıştırın ve yöntemini düğmenin Click olayıyla ilişkilendirinButton1_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

Açıklamalar

Bit eşlem, grafik görüntüsünün piksel verilerinden ve özniteliklerinden oluşur. Bit eşlemi dosyaya kaydetmek için birçok standart biçim vardır. GDI+ şu dosya biçimlerini destekler: BMP, GIF, EXIF, JPG, PNG ve TIFF. Desteklenen biçimler hakkında daha fazla bilgi için bkz . Bit Eşlem Türleri.

Oluşturuculardan birini kullanarak dosyalardan, akışlardan ve diğer kaynaklardan Bitmap görüntüler oluşturabilir ve bunları yöntemiyle Save bir akışa veya dosya sistemine kaydedebilirsiniz. Görüntüler, nesnenin yöntemi Graphics kullanılarak DrawImage ekrana veya belleğe çizilir. Görüntü dosyalarıyla çalışma hakkındaki konuların listesi için bkz. Resimler, Bit Eşlemler, Simgeler ve Meta Dosyalarla Çalışma.

Not

.NET 6 ve sonraki sürümlerde, bu türü içeren System.Drawing.Common paketi yalnızca Windows işletim sistemlerinde desteklenir. Platformlar arası uygulamalarda bu türün kullanılması derleme zamanı uyarılarına ve çalışma zamanı özel durumlarına neden olur. Daha fazla bilgi için bkz . System.Drawing.Common yalnızca Windows'ta desteklenir.

Not

Bitmap Sınıfına uygulama etki alanları arasında erişilemez. Örneğin, bir dinamik AppDomain oluşturur ve bu etki alanında birkaç fırça, kalem ve bit eşlem oluşturursanız, sonra bu nesneleri ana uygulama etki alanına geri geçirirseniz, kalemleri ve fırçaları başarıyla kullanabilirsiniz. Ancak, sıralanmış Bitmapçizmek için yöntemini çağırırsanız DrawImage aşağıdaki özel durumu alırsınız:

uzaktan iletişim "System.Drawing.Image" türünde "yerel görüntü" alanını bulamıyor.

Oluşturucular

Bitmap(Image)	Belirtilen mevcut görüntüden sınıfının yeni bir örneğini Bitmap başlatır.
Bitmap(Image, Int32, Int32)	Belirtilen mevcut görüntüden sınıfın Bitmap yeni bir örneğini başlatır ve belirtilen boyuta ölçeklendirilir.
Bitmap(Image, Size)	Belirtilen mevcut görüntüden sınıfın Bitmap yeni bir örneğini başlatır ve belirtilen boyuta ölçeklendirilir.
Bitmap(Int32, Int32)	Belirtilen boyutta sınıfın Bitmap yeni bir örneğini başlatır.
Bitmap(Int32, Int32, Graphics)	Belirtilen boyuta ve belirtilen nesnenin Bitmap çözünürlüğüne sahip sınıfın yeni bir örneğini Graphics başlatır.
Bitmap(Int32, Int32, Int32, PixelFormat, IntPtr)	Belirtilen boyut, piksel biçimi ve piksel verileriyle sınıfının yeni bir örneğini Bitmap başlatır.
Bitmap(Int32, Int32, PixelFormat)	Belirtilen boyut ve biçime sahip sınıfın Bitmap yeni bir örneğini başlatır.
Bitmap(Stream)	Belirtilen veri akışından sınıfının yeni bir örneğini Bitmap başlatır.
Bitmap(Stream, Boolean)	Belirtilen veri akışından sınıfının yeni bir örneğini Bitmap başlatır.
Bitmap(String)	Belirtilen dosyadan sınıfının yeni bir örneğini Bitmap başlatır.
Bitmap(String, Boolean)	Belirtilen dosyadan sınıfının yeni bir örneğini Bitmap başlatır.
Bitmap(Type, String)	Belirtilen kaynaktan sınıfının yeni bir örneğini Bitmap başlatır.

Özellikler

Flags	Bu Imageöğesinin piksel verileri için öznitelik bayraklarını alır. (Devralındığı yer: Image)
FrameDimensionsList	Bu Imageiçindeki çerçevelerin boyutlarını temsil eden bir GUID dizisini alır. (Devralındığı yer: Image)
Height	Bu Imageöğesinin yüksekliğini piksel cinsinden alır. (Devralındığı yer: Image)
HorizontalResolution	Bunun Imageinç başına piksel cinsinden yatay çözünürlüğünü alır. (Devralındığı yer: Image)
Palette	Bu Imageiçin kullanılan renk paletini alır veya ayarlar. (Devralındığı yer: Image)
PhysicalDimension	Bu görüntünün genişliğini ve yüksekliğini alır. (Devralındığı yer: Image)
PixelFormat	Bunun Imagepiksel biçimini alır. (Devralındığı yer: Image)
PropertyIdList	Bu Imageiçinde depolanan özellik öğelerinin kimliklerini alır. (Devralındığı yer: Image)
PropertyItems	Bu Imageiçinde depolanan tüm özellik öğelerini (meta veri parçaları) alır. (Devralındığı yer: Image)
RawFormat	Bu Imagedosyasının dosya biçimini alır. (Devralındığı yer: Image)
Size	Bu görüntünün genişliğini ve yüksekliğini piksel cinsinden alır. (Devralındığı yer: Image)
Tag	Görüntü hakkında ek veriler sağlayan bir nesneyi alır veya ayarlar. (Devralındığı yer: Image)
VerticalResolution	Bunun Imageinç başına piksel cinsinden dikey çözünürlüğünü alır. (Devralındığı yer: Image)
Width	Bu Imageöğesinin genişliğini piksel cinsinden alır. (Devralındığı yer: Image)

Yöntemler

Clone()	Bu Imageöğesinin tam bir kopyasını oluşturur. (Devralındığı yer: Image)
Clone(Rectangle, PixelFormat)	Bu Bitmap bölümün yapısı tarafından Rectangle tanımlanan ve belirtilen PixelFormat bir sabit listesiyle bir kopyasını oluşturur.
Clone(RectangleF, PixelFormat)	Belirtilen PixelFormat sabit listesiyle tanımlanan bu Bitmap bölümün bir kopyasını oluşturur.
CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Bu Imagetarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Image)
Dispose(Boolean)	Image tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: Image)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
FromHicon(IntPtr)	Bitmap Bir Windows tanıtıcısından simgeye bir oluşturur.
FromResource(IntPtr, String)	Belirtilen Windows kaynağından bir Bitmap oluşturur.
GetBounds(GraphicsUnit)	Belirtilen ünitedeki görüntünün sınırlarını alır. (Devralındığı yer: Image)
GetEncoderParameterList(Guid)	Belirtilen görüntü kodlayıcı tarafından desteklenen parametreler hakkında bilgi döndürür. (Devralındığı yer: Image)
GetFrameCount(FrameDimension)	Belirtilen boyutun çerçeve sayısını döndürür. (Devralındığı yer: Image)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetHbitmap()	Bu Bitmapöğesinden bir GDI bit eşlem nesnesi oluşturur.
GetHbitmap(Color)	Bu Bitmapöğesinden bir GDI bit eşlem nesnesi oluşturur.
GetHicon()	Tutamacı bir simgeye döndürür.
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetPixel(Int32, Int32)	Bu Bitmapiçinde belirtilen pikselin rengini alır.
GetPropertyItem(Int32)	Belirtilen özellik öğesini bu Imageöğesinden alır. (Devralındığı yer: Image)
GetThumbnailImage(Int32, Int32, Image+GetThumbnailImageAbort, IntPtr)	Bu Imageiçin bir küçük resim döndürür. (Devralındığı yer: Image)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
LockBits(Rectangle, ImageLockMode, PixelFormat)	Sistem belleğine kilitler Bitmap .
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Sistem belleğine kilitler Bitmap .
MakeTransparent()	Bu Bitmapiçin varsayılan saydam rengi saydam yapar.
MakeTransparent(Color)	Bu Bitmapiçin belirtilen rengi saydam hale getirir.
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
RemovePropertyItem(Int32)	Belirtilen özellik öğesini bu Imageöğesinden kaldırır. (Devralındığı yer: Image)
RotateFlip(RotateFlipType)	döndürür, çevirir veya döndürür ve çevirir Image. (Devralındığı yer: Image)
Save(Stream, ImageCodecInfo, EncoderParameters)	Bu görüntüyü belirtilen kodlayıcı ve görüntü kodlayıcı parametreleriyle belirtilen akışa kaydeder. (Devralındığı yer: Image)
Save(Stream, ImageFormat)	Bu görüntüyü belirtilen biçimde belirtilen akışa kaydeder. (Devralındığı yer: Image)
Save(String)	Bunu Image belirtilen dosyaya veya akışa kaydeder. (Devralındığı yer: Image)
Save(String, ImageCodecInfo, EncoderParameters)	Bunu Image belirtilen dosyaya, belirtilen kodlayıcı ve görüntü kodlayıcı parametreleriyle kaydeder. (Devralındığı yer: Image)
Save(String, ImageFormat)	Bunu Image belirtilen biçimde belirtilen dosyaya kaydeder. (Devralındığı yer: Image)
SaveAdd(EncoderParameters)	Yöntemine önceki bir çağrıda belirtilen dosyaya veya akışa Save çerçeve ekler. Seçili kareleri çok çerçeveli bir görüntüden başka bir çok çerçeveli görüntüye kaydetmek için bu yöntemi kullanın. (Devralındığı yer: Image)
SaveAdd(Image, EncoderParameters)	Yöntemine önceki bir çağrıda belirtilen dosyaya veya akışa Save çerçeve ekler. (Devralındığı yer: Image)
SelectActiveFrame(FrameDimension, Int32)	Boyut ve dizin tarafından belirtilen çerçeveyi seçer. (Devralındığı yer: Image)
SetPixel(Int32, Int32, Color)	Bu Bitmapiçinde belirtilen pikselin rengini ayarlar.
SetPropertyItem(PropertyItem)	Bu Imageiçinde bir özellik öğesi (meta veri parçası) depolar. (Devralındığı yer: Image)
SetResolution(Single, Single)	Bu Bitmapiçin çözünürlüğü ayarlar.
ToString()	Geçerli nesneyi temsil eden dizeyi döndürür. (Devralındığı yer: Object)
UnlockBits(BitmapData)	Bunun Bitmap kilidini sistem belleğinden açar.

Belirtik Arabirim Kullanımları

ISerializable.GetObjectData(SerializationInfo, StreamingContext)

hedef nesneyi seri hale getirmek için gereken verilerle doldurur SerializationInfo . (Devralındığı yer: Image)

Ayrıca bkz.

• PictureBox
• Resimler, Bit Eşlemler ve Meta Dosyaları
• Resimler, Bit Eşlemler, Simgeler ve Meta Dosyaları ile Çalışma