PDFSharp - Graphics

Graphics - PDFsharp and MigraDoc Wiki

所有的 Graphics 类型都设计成模仿来自 System.Drawing 命名空间中的 GDI+ 类型。类型的名称也类似，例如：XColor, XPen, XBrush, XGraphics, XRect, XMatrix, XImage 等等。它们的作用也与 GDI+ 中类似。所有的名称前面都有一个 X 前缀，使得它们在 GDI+ 和 WPF 类型中都可以使用相同的代码。

在 PDFSharp 中的 X 前缀的类型与 System.Drawing 中的类型存在如下区别：

所有的浮点类型都是 double 类型，以防止在 System.Drawing 中乏味的 float 类型转换
X 前缀的类型和功能仅仅在 PDFSharp 中存在

在 WPF 版本的 PDFSharp 中，X 前缀的类型与 GDI+ 版本有着非常类似的接口，内部却基于 WPF 来实现。

1. Graphics 概念

XGraphics 类型表示绘图界面的接口。使用如下代码可以在 PDF 页面上绘图。

XGraphics gfx = XGraphics.FromPdfPage(page);

如果页面上已经存在内容 ( 例如页面来自已经存在的 PDF 文件 )，你可以选择使用 XGraphicsPdfPageOptions 来决定新绘制的对象是位于现有内容的上层还是下层。

在 GDI+ 版本的 PDFSharp 上，XGraphics 对象还可以在 System.Drawing.Graphics 对象上绘制。

XGraphics gfx = XGraphics.FromGraphics(graphics, size);

在 WPF 版本上，XGraphics 对象也可以在 System.Windows.Media.DrawingContext 对象上绘制。

XGraphics gfx = XGraphics.FromDrawingContext(drawingContext, size);

这使得使用 PDFSharp 有可能使用同样的函数在窗口、打印机、位图、或者 PDF 页面上进行绘制。

2. Coordinates 坐标系统

当前的 PDFSharp 实现只有一种图形布局系统。原点位于左上角，X 向右增长，Y 向下增长。测量的单位总是使用 point ( 1/72 英寸)。

这样并没有实际的局限，因为使用转换矩阵可以转换原点位置，或者缩放比例，你可以在 Transformation 中看到它的使用。使用 XUnit 类型，你可以在 point、英寸、厘米和毫米之间进行转换。

3. 直线和曲线

类型 XGraphics 提供如下的函数绘制直线和曲线:

DrawLine
DrawLines
DrawBezier
DrawBeziers
DrawCurve
DrawArc

每种函数都使用 XPen 来定义如何绘制.

4. 图形 Shapes

类型 XGraphics 提供如下函数绘制预先定义的图形:

DrawRectangle
DrawRectangles
DrawRoundedRectangle
DrawEllipse
DrawPolygon
DrawPie
DrawClosedCurve

每个函数可以使用 XPen (仅限笔触)，或者画刷 XBrush (仅限填充)，或者同时使用两者。(笔触和填充)。

5. Graphical 路径

类型 XGraphicalPath 表示绘图路径。类型 XGraphics 提供如下函数绘制路径:

DrawPath

该函数可以使用 XPen (仅限笔触)，或者画刷 XBrush (仅限填充)，或者同时使用两者。(笔触和填充)。

6. Fonts 字体

当前的 PDFSharp 实现支持 TrueType 字体和使用 TrueType 轮廓的 OpenType 字体，也就是说，使用 Microsoft Windows 的字体。

使用 XFont 类型来创建字体

XFont font = new XFont("Verdana", 12, XFontStyle.Italic);

类型 XPdfFontOptions 设置 PDF 特定的设置:

使用 ANSI 还是 Unicode 编码
在 PDF 文档内部，使用嵌入字体，还是使用字体的子集

7. Text 文本

类型 XGraphics 提供如下函数来使用文本:

MeasureString
DrawString

函数 DrawString 拥有一个 XStringFormat 参数，可以用来进行文本对齐。 DrawString 函数是一个基本函数，没有用于包装的功能。使用 MigraDoc foundation 可以在段落中使用各种字体、尺寸对文本进行格式化等等。示例见：Mix MigraDoc and PDFsharp

8. Images 图片

类型 XGraphics 提供如下函数绘制图片:

DrawImage

PDFsharp 支持如下图片格式:

BMP
GIF (with optional transparency)
PNG (with optional transparency)
JPEG
TIFF (with optional transparency)

9. Graphics State

类型 XGraphics 提供如下函数来保存和恢复当前的绘制状态：

Save
Restore
BeginContainer
EndContainer

在执行转换和剪切功能之前，使用这些函数来保存绘制状态，并在以后恢复之前的转换和剪切状态。使用 BeginContainer 函数，你可以指定两个额外的矩形来为你计算映射，例如将第一个矩形映射到第二个矩形。这可以使得易于定义新的坐标系统。

10. Transformation

类型 XGraphics 提供如下函数进行坐标系统转换：

TranslateTransform
ScaleTransform
RotateTransform
MultiplyTransform
AddTransform

通过将其与 XMatrix 对象相乘，转换将立即在当前绘图上下文生效。使用 XMatrixOrder 来选择该转换时追加还是插入到当前转换。

使用 Save / Restore 来保持当前的转换。

11. Clipping

类型 XGraphics 提供如下函数来限制当前的剪切区域：

IntersectClip

在剪切区域之外的文本和图形将不会显示。

使用 Save / Restore 来保持当前的转换。

12. Miscellaneous 杂项

类型 XGraphics 提供如下杂项函数：

WriteComment
Internals

原文地址：Graphics - PDFsharp and MigraDoc Wiki