Bitmap Sınıf

Tanım

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
public sealed class Bitmap : System.Drawing.Image
[System.Serializable]
public sealed class Bitmap : System.Drawing.Image
[System.Serializable]
[System.Runtime.InteropServices.ComVisible(true)]
public sealed class Bitmap : System.Drawing.Image
type Bitmap = class
    inherit Image
[<System.Serializable>]
type Bitmap = class
    inherit Image
[<System.Serializable>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type Bitmap = class
    inherit Image
Public NotInheritable Class Bitmap
Inherits Image
Devralma
Öznitelikler

Ö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

ApplyEffect(Effect, Rectangle)

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.

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.

ConvertFormat(PixelFormat)

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.

ConvertFormat(PixelFormat, DitherType, PaletteType, ColorPalette, Single)

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.

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()
Geçersiz.

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()
Geçersiz.

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)

Şunlara uygulanır

Ayrıca bkz.