Техническая статья

Импорт EMF в PDFlibPas: правила PolyDraw, Polyline и Bezier

Нарисуйте трёхточечную V через Canvas.Polyline при выбранной жёлтой кисти, сконвертируйте метафайл в PDF — и наивный конвертер вернёт сплошной жёлтый треугольник. Тот же конвертер может согнуть Безье к неверной контрольной точке и оставить у PolyDraw-прямоугольника три стороны. Каждый случай тянется к одному правилу [MS-EMF]: EMR_POLYBEZIER стартует с точки 0, полилинии открыты и только обводятся, PT_CLOSEFIGURE — битовый флаг, а счётчики точек обязаны влезать в размер записи

У контекста устройства есть состояние, которого нет у пути PDF

Enhanced metafile — запись GDI-вызовов, сделанных против контекста устройства, и половина того, что значит запись Poly*, живёт вне её точек: открыта ли фигура, стартует ли она с текущей позиции, какое перо и кисть выбраны, и с какого смещения в байтах начинаются точки. У PDF ничего этого нет. Там есть путь, текущая точка внутри пути и рисующая операция, выбирающая обводку (S), заливку (f) или обе (B). Векторный импортёр EMF в PDFlibPas, PDF-библиотеке losLab для Delphi, проигрывает то состояние контекста устройства рядом с координатами, и правила ниже описывают, как он отображает каждую запись

Семейство 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 с семью точками: точка ноль открывает путь оператором m, точки один–три и четыре–шесть дают по одному кубическому сегменту c; исправленный 32-битный обработчик начиная с v3.539.41 противопоставлен старой группировке, съедавшей стартовую точку как контрольную
Точка 0 — стартовая, и лишь полные триплеты после неё становятся кубическими сегментами, так что PolyBezier из семи точек превращается в оператор m плюс два оператора c

А как быть со счётчиком, не равным 1 плюс кратное 3? Запись искажена. Наша позиция: завершающие одну или две точки следует отбросить. Сшивать их в кривую, выдумывая недостающую контрольную точку, значит получить форму, которую ни одно устройство GDI никогда не рисовало, а читатель, сравнивающий PDF с оригиналом, никак не скажет, какая половина кривой выдумана

Байты типов PolyDraw 3 и 5

В EMR_POLYDRAW PT_CLOSEFIGURE (значение 1) — бит, вбитый через OR в PT_LINETO (2) или PT_BEZIERTO (4), так что совершенно валидный байт типа может быть 3 или 5. Тип точки — это байт с тем битом, замаскированным прочь; сам флаг означает «замкнуть фигуру после сегмента, кончающегося на этой точке». Обработчик, сопоставляющий байт с одиночными значениями в Pascal-операторе case, никогда не увидит совпадения для 3 и 5. Те точки пропускаются. Прямоугольник, нарисованный PolyDraw, теряет замыкающую сторону, а триплет Безье, чья последняя точка несёт флаг, теряет ту точку, что сбивает каждый последующий триплет на одну позицию

PDFlibPas диспетчеризует по Types[i] and not PT_CLOSEFIGURE и замыкает фигуру только по завершении сегмента: сразу после линии для замкнутого PT_LINETO и после третьей точки группы Безье. Искажённый файл, выставивший флаг на первой или второй точке триплета, поэтому не замыкает фигуру посреди кривой. Ещё два правила принадлежат тому же обработчику:

  • Лишь первый PT_MOVETO в записи стартует путь; последующие открывают новые подпути. 16-битная EMR_POLYDRAW16 с тремя фигурами обязана дать три подпути, а обработчик, перезапускающий путь на каждом move, сохранит только последнюю
  • Запись PolyDraw, не начинающаяся с PT_MOVETO, стартует с текущей позиции, как говорит определение записи. Написать оператор l или c без предшествующего m — ошибка content stream, которую каждый вьюер PDF чинит по-своему
Анатомия байта типа EMR_POLYDRAW в PDFlibPas: бит флага PT_CLOSEFIGURE нулевого разряда вбит через OR в PT_LINETO или PT_BEZIERTO, поэтому корректные байты типов 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 открытой V-образной полилинии из EMR_POLYLINE: корректный конвертер завершает путь оператором обводки 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 как массивы из одного элемента, что означает: aptl[0] — первая точка, лишь когда nPolys равен 1. Индексируйте aptl напрямую — и каждая многосегментная запись прочитает значения счётчиков как координаты. Хуже, проверка размера, срубанная под ту раскладку, отбраковывает корректные многосегментные записи начисто. PDFlibPas вычисляет смещение так же, как для PolyPolygon, и рисует каждую полилинию собственным открытым подпутем с одной обводкой в конце. 16-битный близнец следует той же схеме; рисовать его посегментно значило бы ломать стыки линий и игнорировать выбранный NULL_PEN

Объекты по умолчанию и скобки путей

  • Свежий контекст устройства GDI уже держит выбранными BLACK_PEN и WHITE_BRUSH. Метафайл, рисующий без единого EMR_SELECTOBJECT, легален и всё равно получает чёрные контуры; конвертер, стартующий без пера, напишет n (завершить путь, ничего не нарисовав) для тех записей
  • Внутри скобок BeginPath / EndPath Polyline ни не использует, ни не обновляет текущую позицию, поэтому она открывает новый подпуть со своей первой точки, вместо того чтобы примкнуть к предыдущей фигуре. Ничего не рисуется, пока скобку не обведут или не зальют

Запись тестового метафайла через TMetafileCanvas

Быстрейший способ прогнать конвертер через эти правила — записать три рискованных вызова в один enhanced metafile через 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 считает поток EMF, только когда оставшаяся длина строго больше 108-байтового TEnhMetaHeader. Короткий заголовок, равно как и пустой EMF ровно на 108 байт, принимается за WMF и отбраковывается. Всегда пишите полный 108-байтовый заголовок, включая поля расширений, прежде первой тестовой записи

Импорт метафайла через ImportEMFFromFile

PDFlibPas импортирует EMF через ImportEMFFromFile или ImportEMFFromStream. Оба возвращают при успехе ненулевой image 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);

    // Страница лишь вызывает импортированную форму: 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 становится формой XObject, поэтому GetPageContentToString возвращает только последовательность save, transform, Do и restore. Операторы m, l, c, h и S, порождённые записями Poly*, живут в сжатом потоке формы XObject. Откройте сохранённый файл в инспекторе PDF-объектов, распакуйте тот поток и проверьте по тестовому файлу выше три вещи: полилиния кончается S без h перед ним, каждый флаг закрытия в фигурах PolyDraw породил h, и ни один f или B не появляется на тех подпутях. DrawImage масштабирует импортированный EMF равномерно по меньшему из Width и Height, так что рисунок сохраняет пропорции, даже если переданный ящик им не совпадает

Пользователи Free Pascal могут прочесть как векторный импортёр EMF в PDFlibPas собирается под Free Pascal; семантика записей идентична, где бы импортёр ни компилировался

Счётчики точек в EMF-файле — недоверенный ввод

Каждое число точек в метафайле следует сверять с размером записи, прежде чем копировать хоть одну точку. EnumEnhMetaFile гарантирует лишь то, что nSize каждой записи не вылезает за файл. Он никогда не проверяет, согласуется ли cptl с nSize. Обработчик, копирующий cptl точек через Move, при подделанном или битом счётчике охотно прочитает следующие записи — или уйдёт за конец метафайла. PDFlibPas сверяет фиксированный заголовок плюс счётчик, умноженный на байты на точку, с nSize для PolyDraw, PolyBezier, PolyBezierTo, Polyline, PolylineTo и Polygon в обеих разрядностях, добавляя по байту на точку для массива типов 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] задевает range checks
  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, потому что nPolys * 4 и cptl * 8, посчитанные в 32 битах, могут переполниться до маленького числа и пройти сравнение

Те же семантики записей действуют, какой бы компонент ни рендерил ваши отчёты. Векторный импорт EMF и WMF в HotPDF покрывает то, как тот компонент превращает градиентные и hatch-кисти в PDF-паттерны, а векторная графика, шейдеры и градиенты в PDFlibPas показывает, как нарисовать те же формы напрямую через API библиотеки, минуя метафайл целиком

Чтобы прогнать собственные отчётные метафайлы через этот импортёр, на странице PDFlibPas Delphi PDF library есть детали продукта и пробная загрузка