黄色いブラシを選んだ状態でCanvas.Polylineを使って3点のV字を描き、メタファイルをPDFへ変換すると、素朴なコンバーターは塗りつぶされた黄色い三角形を返してきます。同じコンバーターは、Bezierを間違った制御点のほうへ曲げたり、PolyDrawの長方形を3辺で残したりすることもあります。どのケースも[MS-EMF]の1つのルールに遡ります。EMR_POLYBEZIERは点0から始まる。ポリラインは開いていてストロークだけ。PT_CLOSEFIGUREはフラグビット。そして点数はレコードサイズに収まらなければならない
デバイスコンテキストにはPDFのパスにない状態がある
拡張メタファイルは、デバイスコンテキストに対するGDI呼び出しの記録で、Poly*レコードが意味するものの半分は点の外に住んでいます。図形が開いているか、現在位置から始まるか、どのペンとブラシが選択されているか、点が何バイト目から始まるか。PDFにはそのどれもありません。あるのはパス、パス内の現在点、そしてストローク(S)、塗り(f)、両方(B)を選ぶ描画オペレーターです。Delphi向けPDFライブラリであるlosLabのPDFlibPasが持つベクターEMFインポーターは、座標と並行してそのデバイスコンテキスト状態を再生し、以下のルールが各レコードをどう写像するかを記述します
Poly*ファミリーには2つの幅があります。EMR_POLYLINEのような各32ビットレコードには、点をSmallIntペアとして格納するEMR_POLYLINE16のような16ビットの双子があり、すべての座標が収まる限り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以降の点だけが、制御点、制御点、終点の3つ組にグループ化されます。7点のレコードは2つの3次セグメントを描きます。点0が始点、点1〜3が最初のセグメント、点4〜6が2つ目です。点0からグループ化を始めると、始点が最初の制御点として消費され、以降のすべてのセグメントが1つずれます。出力はそれでも滑らかな曲線です。ただし間違った曲線です。PDFlibPasは両方のレコード幅で、点0にmでパスを開き、その後の完全な3つ組ごとにcを1つ書きます
1足す3の倍数でない点数はどうなるのか。そのレコードは不正です。私たちの立場は、末尾の1、2点を落とすべきだというものです。存在しない制御点をでっち上げて曲線に縫い合わせると、GDIデバイスが決して描かなかった形が生まれ、PDFとオリジナルを比較する読み手には、曲線のどちら半分がでっち上げか見分ける術がありません
PolyDrawの型バイト3と5
EMR_POLYDRAWでは、PT_CLOSEFIGURE(値1)はPT_LINETO(2)やPT_BEZIERTO(4)にOR込みされるビットなので、完全に妥当な型バイトは3や5になり得ます。点型はそのビットをマスクしたバイトで、フラグ自体は「この点で終わるセグメントの後に図形を閉じる」を意味します。Pascalのcase文でバイトを単一値と照合するハンドラは、3や5が何にも一致しないのを見るだけです。それらの点はスキップされます。PolyDrawで描かれた長方形は閉じ側の辺を失い、フラグを運ぶ最終点を持つベジェ3つ組はその点を失い、以降のすべての3つ組が1つずれます
PDFlibPasはTypes[i] and not PT_CLOSEFIGUREで振り分け、セグメントが完了したときにだけ図形を閉じます。閉じたPT_LINETOなら線の直後、ベジェグループなら3点目の後です。だから3つ組の1点目や2点目にフラグを立てる不正なファイルは、曲線の途中で図形を閉じません。同じハンドラに属するルールがもう2つあります:
- レコード内の最初の
PT_MOVETOだけがパスを開始します。後のmoveは新しいサブパスを開きます。3つの図形を保持する16ビットのEMR_POLYDRAW16は3つのサブパスを生まなければならず、すべてのmoveでパスをやり直すハンドラは最後の1つしか残しません PT_MOVETOで始まらないPolyDrawレコードは、レコード定義のとおり現在位置から始まります。先行するmなしにlやc演算子を書くのはコンテンツストリームエラーで、PDFビューアごとに解決が違います
黄色い三角形:ポリラインが塗られることは決してない
EMR_POLYLINEとEMR_POLYPOLYLINEは、ペンだけで描かれる開いた図形で、PDFでは塗りオペレータが描画の前に開いたサブパスを閉じます(ISO 32000-1 §8.5.3)。3点のポリラインにBやfを出すと、ビューアは現在のブラシ色で塗りつぶされた三角形を描きます。冒頭の黄色いV字、チャートのトレンド線の下のくさびの正体です。PDFlibPasは両方のポリライン幅をSで終え、ブラシに触れません。GDIのセマンティクスがそのまま保たれます。Polygonは閉じて塗り、Polylineはどちらもしない
PolylineToと、触れてはならないペン
EMR_POLYLINETOは現在位置からレコード内のすべての点を通って描き、開いたまま、現在位置を最後の点に置きます。ペンの状態を所有するのはEMR_SELECTOBJECTとEMR_CREATEPENであって、描画レコードハンドラでは決してありません。1つのレコードの内側でペンをオフにする特別扱いには、オンに戻すものがないので、以降のすべてのレコードが輪郭を失います。1点形では、レコードが保持する点を正確に読み、そこで止まります
PolyPolylineの点はカウント配列の後に座る
32ビットのEMR_POLYPOLYLINEはnPolys個のカウントを格納し、それからcptl個の点を格納するので、点はバイトオフセット32 + nPolys * 4から始まります。罠はDelphi RTLの中にあります。WindowsユニットはTEMRPolyPolylineを、aPolyCountsとaptlが1要素配列であると宣言しています。つまりaptl[0]が最初の点であるのはnPolysが1のときだけです。aptlを直接インデックスすると、すべての複数ライン レコードがカウント値を座標として読みます。さらに、そのレイアウトに基づくサイズチェックは、妥当な複数ライン レコードをまるごと拒否します。PDFlibPasはPolyPolygonと同じやり方でオフセットを計算し、各ポリラインを独立した開いたサブパスとして描き、最後に1回ストロークします。16ビットの双子も同じパターンに従います。セグメントごとに描くと線の接合が壊れ、選択されたNULL_PENが無視されます
デフォルトオブジェクトとパス括弧
- 新しいGDIデバイスコンテキストには、最初から
BLACK_PENとWHITE_BRUSHが選択されています。EMR_SELECTOBJECTを1つも使わずに描くメタファイルは合法で、それでも黒い輪郭を得ます。ペンなしで始めるコンバーターは、そういうレコードにn(パスを終え、何も描かない)を書きます BeginPath/EndPath括弧の内側では、Polylineは現在位置を使わず更新もしません。だから最初の点で新しいサブパスを開き、前の図形には合流しません。括弧がストロークか塗りされるまで、何も描かれません
TMetafileCanvasでテストメタファイルを記録する
コンバーターをこれらのルールに通すいちばん手っ取り早い方法は、危険な3つの呼び出しをTMetafileCanvasで1つの拡張メタファイルに記録することです。下のプロシージャは、中空のブラシで曲線を描き、それからポリラインの前にわざとソリッドの黄色いブラシを選びます。正しいコンバーターはそのブラシを無視します。出力PDFに黄色があれば、ポリラインが塗られた証拠です。PolyDrawにはTCanvasラッパーがないので、キャンバスハンドルでWindows APIを通します。型バイト3と5が閉じフラグを鍛えます
uses
Winapi.Windows, System.Types, Vcl.Graphics;
procedure BuildPolyTestEmf(const FileName: string);
const
// 閉じた正方形(3 = LINETO + CLOSEFIGURE)、続いて閉じたBezier図形
// 最後の制御3つ組が 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が2つの3次セグメント
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);
// ページは取り込んだフォームを呼ぶだけ: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が返すのは保存、変換、Do、復元の列だけです。Poly*レコードから生成されたm、l、c、h、Sの各演算子は、圧縮されたフォームXObjectストリームの中に住んでいます。保存されたファイルをPDFオブジェクトインスペクタで開き、そのストリームを解凍し、上のテストファイルについて3つのことを確認してください。ポリラインはSで終わり、前にhがない。PolyDraw図形の各閉じフラグがhを生んだ。そしてそれらのサブパスにfやBが現れない。DrawImageは取り込んだEMFをWidthとHeightの小さいほうで一様に拡大縮小するので、渡した箱が合わなくても図面はアスペクト比を保ちます
Free Pascalユーザーは、PDFlibPasのEMFベクターインポーターがFree Pascalの下でどうビルドされるかを読めます。レコードのセマンティクスは、インポーターがコンパイルされる場所に関係なく同一です
EMFファイルの点数は信頼できない入力
メタファイルの点数はすべて、1点でもコピーされる前にレコードサイズに対して確認すべきです。EnumEnhMetaFileが保証するのは、各レコードのnSizeがファイル内に収まることだけです。cptlがnSizeと一致するかは決して確認しません。Moveでcptl点をコピーするハンドラは、カウントが偽造・破損していれば、喜んで後続のレコードの中へ、またはメタファイルの終端を越えて読み進めます。PDFlibPasは、PolyDraw、PolyBezier、PolyBezierTo、Polyline、PolylineTo、Polygonについて両幅で、固定ヘッダー+カウント×点あたりバイト数をnSizeと比較し、PolyDrawの型配列には点あたり1バイトを加算します。PolyPolyレコードでは、図形ごとのカウントの合計も宣言された総数を超えてはならず、0点の図形はスキップされます
私たちは、カウントを収まる分に切り詰めるより、このテストに失敗したレコードをスキップするほうを好みます。切り詰められたレコードはそれでも描かれ、レポートの中の部分的に描かれた図形は、欠けた図形より目につきにくい。チェックは自分のパーサーに落とし込める長さです。この版は32ビットのEMR_POLYPOLYLINEを検証し、本当の点配列へのポインタを返します:
uses
Winapi.Windows;
// 自前のEMFパーサーに足すチェック(ライブラリルーチンではない)。
// レコードが宣言どおりの点を本当に保持する場合を除きnilを返す
// 点はカウント配列の後から始まる:32 + nPolys * 4 バイト先であり
// RTLが要素1つの配列と宣言するaptl[0]ではない
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のベクターグラフィックス、シェーダ、グラデーションは、メタファイルを完全にスキップしてライブラリAPIで直接同じ図形を描く方法を示します
自分のレポートメタファイルをこのインポーターに通すには、PDFlibPas Delphi PDF libraryページに製品詳細とトライアルダウンロードがあります