C#的Bitmap.LockBits 使用说明

 

翻译

英语

转自：Bitmap.LockBits 方法 (Rectangle, ImageLockMode, PixelFormat)

将 Bitmap 锁定到系统内存中。（16.6.15Useful）

命名空间:   System.Drawing
程序集:  System.Drawing（System.Drawing.dll 中）

语法

C#

C++

F#

VB

[SecurityPermissionAttribute(SecurityAction.LinkDemand, Flags = SecurityPermissionFlag.UnmanagedCode)]public BitmapData LockBits(Rectangle rect,ImageLockMode flags,PixelFormat format)

参数

rect

Rectangle 结构，它指定要锁定的 Bitmap 部分。

flags

ImageLockMode 枚举，它指定 Bitmap 的访问级别（读/写）。

format

PixelFormat 枚举，它指定此 Bitmap 的数据格式。

返回值

Type: System.Drawing.Imaging.BitmapData

BitmapData，它包含有关此锁定操作的信息。

异常

ExceptionConditionArgumentException

PixelFormat 不是特定的每像素位数值。

- 或 -

为位图传入了错误的 PixelFormat。

Exception

操作失败。

备注

使用 LockBits 方法，可在系统内存中锁定现有的位图，以便通过编程方式进行更改。尽管用 LockBits 方法进行大规模更改可获得更好的性能，但仍然可以用 SetPixel 方法来更改图像的颜色。

BitmapData 指定 Bitmap 的特性，如大小、像素格式、像素数据在内存中的起始地址以及每个扫描行的长度（步幅）。

调用此方法时，应使用包含特定的每像素位数 (BPP) 值的 System.Drawing.Imaging.PixelFormat 枚举的成员。使用 System.Drawing.Imaging.PixelFormat 值（如 Indexed 和 Gdi）会引发 System.ArgumentException。同样，为位图传递不正确的像素格式也会引发 System.ArgumentException。

示例

下面的代码示例演示如何使用 PixelFormat、Height、Width 和 Scan0 属性；LockBits 和 UnlockBits 方法；以及 ImageLockMode 枚举。此示例是针对使用 Windows 窗体而设计的。此示例不是设计用于像素格式，只是提供一个例子表明如何使用 LockBits 方法。若要运行此示例，请将其粘贴到一个窗体中，然后通过调用 LockUnlockBitsExample 方法处理该窗体的 Paint 事件，并将 e 作为 PaintEventArgs 传递。

C#

C++

VB

    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);        }