Bitmap.LockBits Yöntem

Kaynak:

Bitmap.cs

Kaynak:

Bitmap.cs

Kaynak:

Bitmap.cs

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

Döndürülenler

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

Özel durumlar

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

Kaynak:

Bitmap.cs

Kaynak:

Bitmap.cs

Kaynak:

Bitmap.cs

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

Döndürülenler

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

Özel durumlar

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.