Bitmap.LockBits Yöntem

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Sistem belleğine kilitler Bitmap .

Aşırı Yüklemeler

LockBits(Rectangle, ImageLockMode, PixelFormat)	Sistem belleğine kilitler Bitmap .
LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)	Sistem belleğine kilitler Bitmap .

LockBits(Rectangle, ImageLockMode, PixelFormat)

Kaynak:

Bitmap.cs

Sistem belleğine kilitler Bitmap .

public:
 System::Drawing::Imaging::BitmapData ^ LockBits(System::Drawing::Rectangle rect, System::Drawing::Imaging::ImageLockMode flags, System::Drawing::Imaging::PixelFormat format);

public System.Drawing.Imaging.BitmapData LockBits (System.Drawing.Rectangle rect, System.Drawing.Imaging.ImageLockMode flags, System.Drawing.Imaging.PixelFormat format);

member this.LockBits : System.Drawing.Rectangle * System.Drawing.Imaging.ImageLockMode * System.Drawing.Imaging.PixelFormat -> System.Drawing.Imaging.BitmapData

Public Function LockBits (rect As Rectangle, flags As ImageLockMode, format As PixelFormat) As BitmapData

Parametreler

rect

Rectangle

Rectangle Kilit öğesinin bölümünü Bitmap belirten bir yapı.

flags

ImageLockMode

ImageLockMode için Bitmaperişim düzeyini (okuma/yazma) belirten bir numaralandırma.

format

PixelFormat

PixelFormat Bu Bitmapöğesinin veri biçimini belirten bir numaralandırma.

Döndürülenler

BitmapData

BitmapData Bu kilit işlemi hakkında bilgi içeren bir.

Özel durumlar

ArgumentException

PixelFormat belirli bir bit/piksel değeri değildir.

-veya-

Bit eşlem için yanlış PixelFormat geçirilir.

Exception

İşlem başarısız oldu.

Örnekler

Aşağıdaki kod örneği, , , WidthHeightve özelliklerinin, ve UnlockBits yöntemlerinin LockBits ve Scan0 numaralandırmasının ImageLockMode nasıl kullanılacağını PixelFormatgösterir. Bu örnek, Windows Forms ile kullanılacak şekilde tasarlanmıştır. Bu örnek, tüm piksel biçimleriyle doğru çalışacak şekilde değil, yönteminin nasıl kullanılacağına LockBits ilişkin bir örnek sağlamak için tasarlanmıştır. Bu örneği çalıştırmak için bir forma yapıştırın ve yöntemini çağırarak formun PaintLockUnlockBitsExample olayını işleyip e olarak PaintEventArgsgeçirin.

void LockUnlockBitsExample( PaintEventArgs^ e )
{
   // Create a new bitmap.
   Bitmap^ bmp = gcnew Bitmap( "c:\\fakePhoto.jpg" );

   // Lock the bitmap's bits.  
   Rectangle rect = Rectangle(0,0,bmp->Width,bmp->Height);
   System::Drawing::Imaging::BitmapData^ bmpData = bmp->LockBits( rect, System::Drawing::Imaging::ImageLockMode::ReadWrite, bmp->PixelFormat );

   // Get the address of the first line.
   IntPtr ptr = bmpData->Scan0;

   // Declare an array to hold the bytes of the bitmap.
   // This code is specific to a bitmap with 24 bits per pixels.
   int bytes = Math::Abs(bmpData->Stride) * bmp->Height;
   array<Byte>^rgbValues = gcnew array<Byte>(bytes);

   // Copy the RGB values into the array.
   System::Runtime::InteropServices::Marshal::Copy( ptr, rgbValues, 0, bytes );

   // Set every third value to 255.  
   for ( int counter = 2; counter < rgbValues->Length; counter += 3 )
      rgbValues[ counter ] = 255;

   // Copy the RGB values back to the bitmap
   System::Runtime::InteropServices::Marshal::Copy( rgbValues, 0, ptr, bytes );

   // Unlock the bits.
   bmp->UnlockBits( bmpData );

   // Draw the modified image.
   e->Graphics->DrawImage( bmp, 0, 150 );
}

private void LockUnlockBitsExample(PaintEventArgs e)
    {

        // Create a new bitmap.
        Bitmap bmp = new Bitmap("c:\\fakePhoto.jpg");

        // Lock the bitmap's bits.  
        Rectangle rect = new Rectangle(0, 0, bmp.Width, bmp.Height);
        System.Drawing.Imaging.BitmapData bmpData =
            bmp.LockBits(rect, System.Drawing.Imaging.ImageLockMode.ReadWrite,
            bmp.PixelFormat);

        // Get the address of the first line.
        IntPtr ptr = bmpData.Scan0;

        // Declare an array to hold the bytes of the bitmap.
        int bytes  = Math.Abs(bmpData.Stride) * bmp.Height;
        byte[] rgbValues = new byte[bytes];

        // Copy the RGB values into the array.
        System.Runtime.InteropServices.Marshal.Copy(ptr, rgbValues, 0, bytes);

        // Set every third value to 255. A 24bpp bitmap will look red.  
        for (int counter = 2; counter < rgbValues.Length; counter += 3)
            rgbValues[counter] = 255;

        // Copy the RGB values back to the bitmap
        System.Runtime.InteropServices.Marshal.Copy(rgbValues, 0, ptr, bytes);

        // Unlock the bits.
        bmp.UnlockBits(bmpData);

        // Draw the modified image.
        e.Graphics.DrawImage(bmp, 0, 150);
    }

Private Sub LockUnlockBitsExample(ByVal e As PaintEventArgs)

    ' Create a new bitmap.
    Dim bmp As New Bitmap("c:\fakePhoto.jpg")

    ' Lock the bitmap's bits.  
    Dim rect As New Rectangle(0, 0, bmp.Width, bmp.Height)
    Dim bmpData As System.Drawing.Imaging.BitmapData = bmp.LockBits(rect, _
        Drawing.Imaging.ImageLockMode.ReadWrite, bmp.PixelFormat)

    ' Get the address of the first line.
    Dim ptr As IntPtr = bmpData.Scan0

    ' Declare an array to hold the bytes of the bitmap.
    ' This code is specific to a bitmap with 24 bits per pixels.
    Dim bytes As Integer = Math.Abs(bmpData.Stride) * bmp.Height
    Dim rgbValues(bytes - 1) As Byte

    ' Copy the RGB values into the array.
    System.Runtime.InteropServices.Marshal.Copy(ptr, rgbValues, 0, bytes)

    ' Set every third value to 255. A 24bpp image will look red.
    For counter As Integer = 2 To rgbValues.Length - 1 Step 3
        rgbValues(counter) = 255
    Next

    ' Copy the RGB values back to the bitmap
    System.Runtime.InteropServices.Marshal.Copy(rgbValues, 0, ptr, bytes)

    ' Unlock the bits.
    bmp.UnlockBits(bmpData)

    ' Draw the modified image.
    e.Graphics.DrawImage(bmp, 0, 150)

End Sub

Açıklamalar

LockBits Program aracılığıyla değiştirilebilmesi için mevcut bit eşlemi sistem belleğinde kilitlemek için yöntemini kullanın. Yöntemi büyük ölçekli değişiklikler için daha iyi performans sunsa daLockBits, yöntemini kullanarak SetPixel görüntünün rengini değiştirebilirsiniz.

boyutu BitmapData , piksel biçimi, bellekteki piksel verilerinin başlangıç adresi ve her tarama çizgisinin uzunluğu (adım) gibi öğesinin özniteliklerini Bitmapbelirtir.

Bu yöntemi çağırırken, sabit listesinin System.Drawing.Imaging.PixelFormat belirli bir bit/piksel (BPP) değeri içeren bir üyesini kullanmanız gerekir. ve gibi GdiIndexed değerlerin kullanılması System.Drawing.Imaging.PixelFormat bir System.ArgumentExceptionoluşturur. Ayrıca, bit eşlem için yanlış piksel biçimini geçirmek bir System.ArgumentExceptionoluşturur.

LockBits(Rectangle, ImageLockMode, PixelFormat, BitmapData)

Kaynak:

Bitmap.cs

Sistem belleğine kilitler Bitmap .

public:
 System::Drawing::Imaging::BitmapData ^ LockBits(System::Drawing::Rectangle rect, System::Drawing::Imaging::ImageLockMode flags, System::Drawing::Imaging::PixelFormat format, System::Drawing::Imaging::BitmapData ^ bitmapData);

public System.Drawing.Imaging.BitmapData LockBits (System.Drawing.Rectangle rect, System.Drawing.Imaging.ImageLockMode flags, System.Drawing.Imaging.PixelFormat format, System.Drawing.Imaging.BitmapData bitmapData);

member this.LockBits : System.Drawing.Rectangle * System.Drawing.Imaging.ImageLockMode * System.Drawing.Imaging.PixelFormat * System.Drawing.Imaging.BitmapData -> System.Drawing.Imaging.BitmapData

Public Function LockBits (rect As Rectangle, flags As ImageLockMode, format As PixelFormat, bitmapData As BitmapData) As BitmapData

Parametreler

rect

Rectangle

Kilit öğesinin bölümünü Bitmap belirten dikdörtgen yapısı.

flags

ImageLockMode

ImageLockMode için Bitmaperişim düzeyini (okuma/yazma) belirten değerlerden biri.

format

PixelFormat

PixelFormat veri biçimini Bitmapbelirten değerlerden biri.

bitmapData

BitmapData

BitmapData Kilit işlemi hakkında bilgi içeren bir.

Döndürülenler

BitmapData

BitmapData Kilit işlemi hakkında bilgi içeren bir.

Özel durumlar

ArgumentException

PixelFormat değeri belirli bir bit/piksel değeri değildir.

-veya-

Bit eşlem için yanlış PixelFormat geçirilir.

Exception

İşlem başarısız oldu.

Açıklamalar

LockBits Program aracılığıyla değiştirilebilmesi için mevcut bit eşlemi sistem belleğinde kilitlemek için yöntemini kullanın. Yöntemi büyük ölçekli değişiklikler için daha iyi performans sunsa daLockBits, yöntemini kullanarak SetPixel görüntünün rengini değiştirebilirsiniz.

Bu yöntemi çağırırken, sabit listesinin System.Drawing.Imaging.PixelFormat belirli bir bit/piksel (BPP) değeri içeren bir üyesini kullanmanız gerekir. ve Gdigibi Indexed değerlerin kullanılması System.Drawing.Imaging.PixelFormat bir System.ArgumentExceptionoluşturur. Ayrıca, bit eşlem için yanlış piksel biçimini geçirmek bir System.ArgumentExceptionoluşturur.

Yönteminin LockBits bu sürümü değeriyle flagsImageLockMode.UserInputBufferkullanılmak üzere tasarlanmıştır.