最近做一个微信公众号服务,有一些简单的图片处理功能。主要就是用户在页面操作,前端做一些立刻显示的效果,然后提交保存时后端真正修改原图。
我们的后端是 ASP.NET,也就是 C# 语言了,C# 本身处理图片还是比较方便的,使用 GDI+ 就好,只需要添加 System.Drawing 引用,不需要任何第三方库。于是最近也用到一些比较常用的 GDI+ 图片处理方法,就整理一下做个记录了。

这个题目大概会写几篇文章,第一篇先简单介绍一下 GDI+ 的常用对象,以及一些使用时候的注意事项,后面会挑一些项目中做过的比较有用的处理过程来介绍一下。

废话不多说,开始进入正题。


需要用到的类

使用 GDI+ 画图会用到的几个常用的类有:GraphicsBitmapImage
其中 Graphics 是画板。这个类包含了许多画图的方法,包括画图片(DrawImage),画线(DrawLine),画圆(DrawEllipse、FillEllipse),写字(DrawString)等等。简单说使用这个类可以完成我们需要的大部分工作。

生成一个 Graphics 对象需要用到 Image 或者 Bitmap
PS: Winform 下可以直接从窗体或控件的事件中引用 Graphics 对象。 比如:

    private void Form1_Paint(object sender, PaintEventArgs e)
    {
        Graphics g = e.Graphics; // 创建画板,这里的画板是由Form提供的.
    }

不过本文讨论的是其他场景,比如 ASP.NET MVC,或单纯的控制台程序。这些时候是没有控件的,所以要用其他方法。

我一般用以下方法:

//
// 摘要:
//     从指定的 System.Drawing.Image 创建新的 System.Drawing.Graphics。
//
// 参数:
//   image:
//     从中创建新 System.Drawing.Graphics 的 System.Drawing.Image。
//
// 返回结果:
//     此方法为指定的 System.Drawing.Image 返回一个新的 System.Drawing.Graphics。
//
// 异常:
//   T:System.ArgumentNullException:
//     image 为 null。
//
//   T:System.Exception:
//     image 具有索引像素格式,或者格式未定义。
public static Graphics FromImage(Image image);

其中的参数可以传入 ImageBitmap,因为 Bitmap 是继承自 Image 的。


如何创建画板

Image img = Image.FromFile(imgPath);
Graphics graphics = Graphics.FromImage(img);
Bitmap bmp = new Bitmap(width, height);
Graphics graph = Graphics.FromImage(bmp);

PS: Graphics 本身是没有提供构造函数来直接生成的。所以我们可以先创建一个需要保存图片大小的 Bitmap 位图对象,然后再获得画板对象。


如何保存画好的图片

通过调用 img.Save(savePath) 或者 bmp.Save(savePath) 即可保存对象。
PS: BitmapSave 方法是直接继承自 Image 的。


GDI+ 的坐标系

GDI+ 的坐标系是个二维坐标系,不过又有点不一样,它的原点是在左上角的。如下图:


使用 GDI+ 的一些注意事项

这里我忍不住要先吐槽一下,GDI+ 的报错信息不太友好啊。经常只是返回一个“GDI+ 中发生一般性错误。”,不能快速地根据这个错误提示定位问题。比如说没有释放图片资源时想再次访问资源会报这个错误,想要保存图片的文件夹不存在时也是提示这个错误。看不出来区别……

1. 保存到相同路径的文件时要先释放图片资源,否则会报错(GDI+中发生一般性错误)

Image img = Image.FromFile(imgPath);
Bitmap bmp = new Bitmap(img);
Graphics graphics = Graphics.FromImage(bmp);
... // 对图片进行一些处理
img.Dispose(); // 释放原图资源
bmp.Save(imgPath); // 保存到原图
graphics.Dispose(); // 图片处理过程完成,剩余资源全部释放
bmp.Dispose();

2. 使用完的资源记得要释放。可以用 try..catch..finally 或者 using 的方式,这样即使遇到代码运行报错也能及时释放资源,更加保险。

    Image img = Image.FromFile(imgPath);
    Bitmap bmp = new Bitmap(img);
    Graphics graphics = Graphics.FromImage(bmp);

    try
    {
        ...
    }
    catch (System.Exception ex)
    {
        throw ex;
    }
    finally
    {
        graphics.Dispose();
        bmp.Dispose();
        img.Dispose();
    }
    /// <summary>
    /// 缩放图像
    /// </summary>
    /// <param name="originalImagePath">原图路径</param>
    /// <param name="destWidth">目标图宽度</param>
    /// <param name="destHeight">目标图高度</param>
    /// <returns></returns>
    public Bitmap GetThumbnail(string originalImagePath, int destWidth, int destHeight)
    {
        using (Image imgSource = Image.FromFile(originalImagePath))
        {
            return GetThumbnail(imgSource, destWidth, destHeight);
        }
    }

3. 要保存图片的文件夹一定要是已经存在的,否则会报错(GDI+中发生一般性错误)

eg:假设图片要保存到 D:\test\output.png

    string directory = @"D:\test\";
    string fileName = "output.png";

    // 检查文件夹是否存在,不存在则先创建
    if (!Directory.Exists(directory))
    {
        Directory.CreateDirectory(directory);
    }

    bmp.Save(directory + fileName);

系列其他文章:

C# 使用 GDI+ 给图片添加文字,并使文字自适应矩形区域

C# 使用 GDI+ 实现添加中心旋转(任意角度)的文字