Bitmap Sınıf

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v11.0.0-preview.5.26302.115

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 verileri tarafından 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 Bitmap yöntemlerini kullanarak GetPixel bir dosyadan yeni SetPixel oluşturma işlemini gösterir. Ayrıca , PixelFormatve Width özelliklerini de kullanırHeight.

Bu örnek, sırasıyla , Labelve adlı PictureBoxButton, ve Label1PictureBox1içeren bir Button1Windows Forms ile kullanılacak şekilde tasarlanmıştır. Kodu forma yapıştırın ve yöntemini düğmenin Button1_Click olayıyla ilişkilendirinClick.

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

Note

.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.

Note

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, bu nesneleri ana uygulama etki alanına geri geçirirseniz, kalemleri ve fırçaları başarıyla kullanabilirsiniz. Ancak, sıralanmış DrawImageçizmek için yöntemini çağırırsanız Bitmap 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

Name	Description
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(Image)	Belirtilen mevcut görüntüden sınıfının yeni bir örneğini Bitmap 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)	Sınıfın Bitmap belirtilen boyut ve biçime sahip yeni bir örneğini başlatır.
Bitmap(Int32, Int32)	Sınıfın belirtilen boyuta Bitmap sahip yeni bir örneğini başlatır.
Bitmap(Stream, Boolean)	Belirtilen veri akışından sınıfının yeni bir örneğini Bitmap başlatır.
Bitmap(Stream)	Belirtilen veri akışından 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(String)	Belirtilen dosyadan sınıfının yeni bir örneğini Bitmap başlatır.
Bitmap(Type, String)	Belirtilen kaynaktan sınıfın Bitmap yeni bir örneğini başlatır.

Özellikler

Name	Description
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 dizisi alır. (Devralındığı yer: Image)
Height	Bunun Imageyüksekliğini piksel cinsinden alır. (Devralındığı yer: Image)
HorizontalResolution	Bunun Imageyatay çözünürlüğünü inç başına piksel cinsinden 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	Bu Imageiçin piksel 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 nesne 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

Name	Description
ApplyEffect(Effect, Rectangle)	Verilen effectöğesini uygulayarak bit eşlemi değiştirir.
Clone()	Bu Imagetam bir kopyasını oluşturur. (Devralındığı yer: Image)
Clone(Rectangle, PixelFormat)	Bu Bitmap bölümün yapısına Rectangle göre tanımlanan ve belirtilen PixelFormat bir numaralandırmayla bir kopyasını oluşturur.
Clone(RectangleF, PixelFormat)	Belirtilen Bitmap sabit listesiyle tanımlanan bu PixelFormat bölümün bir kopyasını oluşturur.
ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)	bit eşlemini verilen formatkullanarak belirtilene ditherType dönüştürür. Özgün piksel verileri yeni biçimle değiştirilir.
ConvertFormat(PixelFormat)	Bit eşlemi belirtilen formatdeğerine dönüştürür. Özgün piksel verileri yeni biçimle değiştirilir.
Dispose()	Bu Imagetarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Image)
Dispose(Boolean)	tarafından Image kullanılan yönetilmeyen kaynakları serbest bırakır ve isteğe bağlı olarak yönetilen kaynakları serbest bırakır. (Devralındığı yer: Image)
FromHicon(IntPtr)	Bitmap Bir Windows tutamacı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)
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.
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)
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Bir Bitmap sistem belleğine kilitler.
LockBits(Rectangle, ImageLockMode, PixelFormat)	Bir Bitmap sistem belleğine kilitler.
MakeTransparent()	Bu Bitmapiçin varsayılan saydam rengi saydam yapar.
MakeTransparent(Color)	Bu Bitmapiçin belirtilen rengi saydam yapar.
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, ImageCodecInfo, EncoderParameters)	Bunu Image , belirtilen kodlayıcı ve görüntü kodlayıcı parametreleriyle belirtilen dosyaya kaydeder. (Devralındığı yer: Image)
Save(String, ImageFormat)	Bunu Image belirtilen biçimde belirtilen dosyaya kaydeder. (Devralındığı yer: Image)
Save(String)	Bunu Image belirtilen dosyaya veya akışa 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.
UnlockBits(BitmapData)	Bunun Bitmap kilidini sistem belleğinden açar.

Belirtik Arabirim Kullanımları

Name	Description
ISerializable.GetObjectData(SerializationInfo, StreamingContext)	hedef nesneyi seri hale getirmek için gereken verilerle doldurur SerializationInfo . (Devralındığı yer: Image)

Ayrıca bkz.

• PictureBox
• Görüntüler, Bit Eşlemleri ve Meta Dosyalar
• Resimler, Bit Eşlemler, Simgeler ve Meta Dosyalarla Çalışma