技术文章

PDFlibPas EMF 导入:PolyDraw、折线与贝塞尔规则

选着黄色画刷用 Canvas.Polyline 画一个三点的 V 形,把元文件转成 PDF,天真的转换器交回来的是一个实心黄三角。同一个转换器还可能把贝塞尔掰向错误的控制点,或者给 PolyDraw 矩形只留三条边。每个案例都能追到一条 [MS-EMF] 规则:EMR_POLYBEZIER 从点 0 开始,折线是开放的、只描边,PT_CLOSEFIGURE 是个标志位,点数必须装得进记录尺寸

设备上下文有 PDF 路径没有的状态

增强型元文件是对设备上下文发起的一串 GDI 调用的录制,Poly* 记录的含义有一半活在点之外:图形开放还是闭合、是否从当前位置起步、选中了哪支笔哪个刷、点从哪个字节偏移开始。PDF 没有这些,它只有一条路径、路径内的当前点,和一个选择描边(S)、填充(f)或两者都来(B)的绘制操作符。Delphi PDF 库 PDFlibPas 的矢量 EMF 导入器在重放坐标的同时重放设备上下文状态,下面的规则讲它如何映射每种记录

Poly* 家族还有两种宽度。每个 32 位记录(如 EMR_POLYLINE)都有一个 16 位孪生(如 EMR_POLYLINE16),后者把点存成 SmallInt 对;只要每个坐标都装得下,GDI 就记紧凑形式。日常绘图因此很少走到转换器的 32 位处理分支。把同样的点分别喂两种宽度再比较路径,是最便宜的一次审计。本文覆盖的所有记录都属于 [MS-EMF] 2.3.5 的绘图记录组

记录起始于闭合?当前位置
EMR_POLYBEZIER点 0否不使用,不更新
EMR_POLYLINE点 0否(只用笔)不使用,不更新
EMR_POLYLINETO当前位置否(只用笔)使用并更新
EMR_POLYPOLYLINE每条折线的首点否(只用笔)不使用,不更新
EMR_POLYDRAW首个 PT_MOVETO,或当前位置仅设了 PT_CLOSEFIGURE 处使用并更新

EMR_POLYBEZIER 曲线到底从哪开始?

EMR_POLYBEZIER 曲线从点 0 开始,只有索引 1 起的点才按三个一组分成控制点、控制点、终点。7 个点的记录画两段三次曲线:点 0 是起点,1 到 3 组成第一段,4 到 6 组成第二段。若从点 0 开始分组,起点就被当成第一个控制点吃掉了,之后每段都错位一个点。输出仍是光滑曲线,只是画错了对象。PDFlibPas 在两种记录宽度下都以 m 从点 0 开路径,其后每凑满一组三元写一个 c

PDFlibPas 图示:七点的 EMR_POLYBEZIER 记录,点 0 以 m 开路径,点 1 到 3 与 4 到 6 各组成一段三次曲线 c,正确分组与把起点当成控制点的错误分组对照
点 0 是起点,其后只有完整三元组才成为三次曲线段,七点 PolyBezier 因此渲染成 m 加两个 c

点数不是 1 加 3 的倍数怎么办?记录畸形了。我们的立场是丢弃尾部多余的一两个点。靠发明一个缺失的控制点把它们缝进曲线,得到的是任何 GDI 设备都没画过的形状,拿 PDF 与原件对照的读者也无从判断曲线哪一半是编造的

PolyDraw 的类型字节 3 和 5

在 EMR_POLYDRAW 里,PT_CLOSEFIGURE(值 1)是一个按位或进 PT_LINETO(2)或 PT_BEZIERTO(4)的位,所以完全合法的类型字节可以是 3 或 5。点的类型是这个字节掩掉标志位后的值;标志本身的含义是「在以该点结束的线段之后闭合图形」。拿字节在 Pascal case 语句里对单值匹配的处理分支永远碰不上 3 或 5,这些点被直接跳过:PolyDraw 画的矩形丢掉收口那条边,末点带标志的贝塞尔三元组丢掉那个点,后续每组三元组随之错位一个

PDFlibPas 按 Types[i] and not PT_CLOSEFIGURE 分派,并且只在线段完整之后才闭合图形:闭合的 PT_LINETO 就在这条线之后,贝塞尔组则在第三个点之后。因此对三元组第一或第二个点设标志的畸形文件不会在曲线半途闭合图形。同一个处理分支里还有两条规矩:

  • 只有记录里首个 PT_MOVETO 开启路径,其后的 move 开新子路径。装着三个图形的 16 位 EMR_POLYDRAW16 必须产出三个子路径;每次 move 都重启路径的处理分支只会留下最后一个
  • 不以 PT_MOVETO 开头的 PolyDraw 记录按记录定义从当前位置起步。前面没有 m 就写 l 或 c 操作符是内容流错误,各家 PDF 阅读器各有各的解法
PDFlibPas 剖析 EMR_POLYDRAW 类型字节:PT_CLOSEFIGURE 是按位或进 PT_LINETO 或 PT_BEZIERTO 的标志位 0,合法类型字节 3 和 5 因此必须先 and not PT_CLOSEFIGURE 屏蔽再分派;朴素的 case 语句两个都跳过,闭合图形丢掉最后一条边
分派前先屏蔽闭合标志,只在一条线段或一组贝塞尔三元组完成之后才发闭合,否则 PolyDraw 会悄悄丢点

黄三角:折线为什么永不填充

EMR_POLYLINE 与 EMR_POLYPOLYLINE 是只用笔画出来的开放图形,而在 PDF 里,填充操作符会在绘制前闭合任何开口子路径(ISO 32000-1 §8.5.3)。给三点的折线发 B 或 f,阅读器就按当前画刷颜色涂出一个实心三角——正是开篇那个黄色的 V,或者图表趋势线下方的楔形。PDFlibPas 对两种折线宽度都以 S 收尾、从不碰画刷,GDI 语义因此原封不动:Polygon 闭合并填充,Polyline 两样都不做

PDFlibPas 对比从 EMR_POLYLINE 导出的开口 V 形折线:正确的转换器以描边操作符 S 收尾并不理会选中的画刷;发出 f 或 B 则在 ISO 32000-1 8.5.3 下隐式闭合开口子路径,把图表线下方的楔形涂满
填充操作符会在绘制前闭合任何开口子路径,折线必须以 S 收尾,子路径上不带 h、f 或 B

PolylineTo 与它不得碰的笔

EMR_POLYLINETO 从当前位置起、穿过记录里的每个点,保持开放,并把当前位置留在最后一个点上。笔的状态归 EMR_SELECTOBJECT 和 EMR_CREATEPEN 管,永远不归绘图记录的处理分支管。在单个记录内部把笔关掉的特例,没有任何东西负责把它再打开,之后的每条记录都失去轮廓。单点形式就老老实实读记录里那么几个点,到此为止

PolyPolyline 的点在计数数组之后

32 位的 EMR_POLYPOLYLINE 先存 nPolys 个计数再存 cptl 个点,点从字节偏移 32 + nPolys * 4 开始。坑在 Delphi RTL 里:Windows 单元把 TEMRPolyPolyline 的 aPolyCounts 和 aptl 声明成单元素数组,这意味着只有 nPolys 为 1 时 aptl[0] 才是第一个点。直接索引 aptl,每条多线记录都把计数值当成坐标读;更糟的是,基于这个布局的尺寸检查会直接拒收合法的多线记录。PDFlibPas 按与 PolyPolygon 相同的方式计算偏移,把每条折线画成自己的开放子路径,最后统一描边一次。16 位孪生遵循同样模式;逐段绘制会破坏线段连接,也无视选中的 NULL_PEN

默认对象与路径括号

  • 全新的 GDI 设备上下文已经选着 BLACK_PEN 和 WHITE_BRUSH。一条 EMR_SELECTOBJECT 都没有的元文件是合法的,照样得到黑色轮廓;以无笔状态起步的转换器对这些记录写出 n(结束路径,什么都不画)
  • 在 BeginPath / EndPath 括号内,Polyline 既不使用也不更新当前位置,所以它在自己的首点开新子路径,而不是接上前一个图形。括号被描边或填充之前什么都不画

用 TMetafileCanvas 录制测试元文件

让转换器把这些规则过一遍,最快的办法是用 TMetafileCanvas 把三个高风险调用录进一个增强型元文件。下面的过程先用空心刷画曲线,然后刻意在折线之前选中实心黄刷。正确的转换器无视那把刷;输出 PDF 里出现任何黄色都说明折线被填充了。PolyDraw 没有 TCanvas 包装,只能经 Windows API 在画布句柄上调用,类型字节 3 和 5 正好练到闭合标志

uses
  Winapi.Windows, System.Types, Vcl.Graphics;

procedure BuildPolyTestEmf(const FileName: string);
const
  // 一个闭合的正方形(3 = LINETO + CLOSEFIGURE),然后一个闭合的贝塞尔
  // 图形,其最后一组控制三元组以 5 = BEZIERTO + CLOSEFIGURE 收尾
  DrawPts: array[0..7] of TPoint = (
    (X: 300; Y: 40), (X: 380; Y: 40), (X: 380; Y: 120), (X: 300; Y: 120),
    (X: 420; Y: 120), (X: 440; Y: 40), (X: 520; Y: 40), (X: 540; Y: 120));
  DrawTypes: array[0..7] of Byte = (
    PT_MOVETO, PT_LINETO, PT_LINETO, PT_LINETO or PT_CLOSEFIGURE,
    PT_MOVETO, PT_BEZIERTO, PT_BEZIERTO, PT_BEZIERTO or PT_CLOSEFIGURE);
var
  Mf: TMetafile;
  Canvas: TMetafileCanvas;
begin
  Mf := TMetafile.Create;
  try
    Mf.Enhanced := True;
    Mf.Width := 600;
    Mf.Height := 260;
    Canvas := TMetafileCanvas.Create(Mf, 0);
    try
      Canvas.Pen.Color := clNavy;
      Canvas.Pen.Width := 2;
      Canvas.Brush.Style := bsClear;    // 曲线只描边
      // 点 0 是起点;1..3 与 4..6 是两段三次曲线
      Canvas.PolyBezier([Point(20, 120), Point(60, 20), Point(100, 220),
        Point(140, 120), Point(180, 20), Point(220, 220), Point(260, 120)]);
      PolyDraw(Canvas.Handle, DrawPts[0], DrawTypes[0], Length(DrawPts));
      // 选中实心画笔画开口的 V 形:只描边,绝不闭合成
      // 黄色三角形
      Canvas.Brush.Style := bsSolid;
      Canvas.Brush.Color := clYellow;
      Canvas.Polyline([Point(20, 240), Point(120, 160), Point(220, 240)]);
    finally
      Canvas.Free;   // 结束录制
    end;
    Mf.SaveToFile(FileName);
  finally
    Mf.Free;
  end;
end;

这里的每个坐标都装得进 SmallInt,GDI 通常因此存 16 位变体。要走 32 位处理分支,得靠肯写它们的生成方,或手工拼装的记录。手工拼的文件另有坑,表现是 VCL 的「Metafile is not valid」错误:TMetafile.LoadFromStream 只有在剩余长度严格大于 108 字节的 TEnhMetaHeader 时才把流当 EMF。短了头的,或恰好 108 字节的空 EMF,都被当成 WMF 拒收。第一条测试记录之前,把完整的 108 字节头连同扩展字段一起写全

用 ImportEMFFromFile 导入元文件

PDFlibPas 经 ImportEMFFromFile 或 ImportEMFFromStream 导入 EMF,成功返回非零图像 ID,失败返回 0。GeneralOptions = 0 走本文关心的矢量路径,1 则把元文件栅格化成位图。FontOptions = 1 加入元文件用到的字体并作为子集嵌入。流变体在加载前回卷到位置 0,所以递给它的流里除了元文件别的一概没有

uses
  System.SysUtils, PDFlibrary;

procedure EmfToPdf(const EmfFile, PdfFile: WideString);
var
  PDF: TPDFlib;
  ImageID: Integer;
  PageOps: AnsiString;
begin
  PDF := TPDFlib.Create;
  try
    PDF.SetOrigin(1);              // DrawImage 用左上角原点
    PDF.SetMeasurementUnits(0);    // 点
    // FontOptions 1 = 把元文件字体作为嵌入子集加入
    // GeneralOptions 0 = 矢量导入,1 = 位图
    ImageID := PDF.ImportEMFFromFile(EmfFile, 1, 0);
    if ImageID = 0 then
      raise Exception.Create('The metafile could not be imported');
    PDF.SelectImage(ImageID);
    // 对 EMF,ImageWidth / ImageHeight 是框架尺寸,单位点
    PDF.DrawImage(36, 36, PDF.ImageWidth, PDF.ImageHeight);

    // 页面内容只是调用导入的 form:q ... cm /Name Do Q
    // (可选的健全性检查,可加进你自己的代码)
    PageOps := PDF.GetPageContentToString;
    if Pos(AnsiString(' Do'), PageOps) = 0 then
      raise Exception.Create('Expected a form XObject invocation');

    if PDF.SaveToFile(PdfFile) <> 1 then
      raise Exception.Create('The PDF could not be saved');
  finally
    PDF.Free;
  end;
end;

矢量 EMF 导入变成一个 form XObject,GetPageContentToString 返回的只有保存、变换、Do、恢复这一串。由 Poly* 记录生成的 m、l、c、h、S 操作符住在压缩的 form XObject 流里。用 PDF 对象检查器打开存出的文件,解开那个流,对照上面的测试文件查三件事:折线以 S 结尾且前面没有 h;PolyDraw 图形里每个闭合标志都产出了一个 h;这些子路径上没有出现任何 f 或 B。DrawImage 按 Width 与 Height 中较小者等比缩放导入的 EMF,传入的框不匹配时图形也保持宽高比

Free Pascal 用户可以读PDFlibPas EMF 矢量导入器如何在 Free Pascal 下构建;导入器在哪里编译,记录语义都一样

EMF 文件里的点数是不受信任的输入

元文件里的每个点数都该在拷贝第一个点之前对着记录尺寸核一遍。EnumEnhMetaFile 只保证每条记录的 nSize 不越过文件边界,从不检查 cptl 与 nSize 是否相符。用 Move 拷 cptl 个点的处理分支,一旦计数被伪造或损坏,就乐意一路读进后续记录、甚至越过元文件末尾。PDFlibPas 对 PolyDraw、PolyBezier、PolyBezierTo、Polyline、PolylineTo、Polygon 两种宽度都比较「固定头 + 计数 × 每点字节数」与 nSize,PolyDraw 的类型数组每点另加一字节。PolyPoly 系记录还要各图形计数之和不越过声明的总数,零点的图形直接跳过

记录没过这项检查时,我们宁可跳过它,也不把计数钳到装得下的值。被钳过的记录照样画,报表里一幅画了一半的图形比缺了的更难被发现。这项检查很短,可以直接放进你自己的解析器;下面这个版本校验 32 位 EMR_POLYPOLYLINE 并返回指向真实点数组的指针:

uses
  Winapi.Windows;

// 加进你自己 EMF 解析器的检查(不是库例程)。
// 除非记录真的持有它声明的那些点,否则返回 nil。
// 点在计数数组之后开始:偏移 32 + nPolys * 4 字节处,
// 不是 aptl[0]——RTL 把它声明成了单元素数组
function PolyPolylinePoints(Rec: PEnhMetaRecord): PPoint;
var
  P: PEMRPolyPolyline;
  Count: PDWORD;
  PointsOffset, Total: Int64;
  I: Cardinal;
begin
  Result := nil;
  if (Rec^.iType <> EMR_POLYPOLYLINE) or (Rec^.nSize < 32) then
    Exit;
  P := PEMRPolyPolyline(Rec);
  if P^.nPolys = 0 then
    Exit;
  PointsOffset := 32 + Int64(P^.nPolys) * SizeOf(DWORD);
  if PointsOffset + Int64(P^.cptl) * SizeOf(TPoint) > Rec^.nSize then
    Exit;                         // 伪造或被截断的计数
  Total := 0;
  Count := @P^.aPolyCounts[0];    // 指针走数组:[0..0] 会触发范围检查
  for I := 1 to P^.nPolys do
  begin
    Inc(Total, Count^);
    Inc(Count);
  end;
  if Total > P^.cptl then
    Exit;                         // 各图形声明的点数比存在的还多
  Result := PPoint(NativeUInt(Rec) + NativeUInt(PointsOffset));
end;

这里的顺序有讲究:点数装得下的测试先跑,循环去走计数数组之前就证明了它躺在记录之内。算术用 Int64,因为按 32 位算 nPolys * 4 和 cptl * 8 可能回绕成一个小数字、把比较蒙混过去

无论哪个组件渲染你的报表,记录语义都是这一套。HotPDF EMF 与 WMF 矢量导入讲那个组件如何把渐变与阴影线画刷变成 PDF 图案;PDFlibPas 里的矢量图形、shader 与渐变演示完全绕开元文件、直接用库 API 画同样的形状

想把你自己的报表元文件交给这个导入器,PDFlibPas Delphi PDF library 页面有产品详情和试用下载