C# 使用 GDI+ 画图

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

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

废话很少说，开始进入正题。

---

须要用到的类

使用 GDI+ 画图会用到的几个经常使用的类有：Graphics、Bitmap、Image。
其中 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);

其中的参数能够传入 Image 或 Bitmap，由于 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： Bitmap 的 Save 方法是直接继承自 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 的方式，这样即便遇到代码运行报错也能及时释放资源，更加保险。

• try..catch...finally：把释放资源的代码写到 finally 代码段里。

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

• using：使用 using 语句建立的资源会在离开 using 代码段时自动释放该资源。

/// <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+ 实现添加中心旋转(任意角度)的文字