기술 문서

PDFlibPas EMF 임포트: PolyDraw·Polyline·Bezier

노란 브러시가 선택된 상태에서 Canvas.Polyline으로 세 점짜리 V를 그리고 메타파일을 PDF로 변환하면, 순진한 변환기는 솔리드 노란 삼각형을 돌려줍니다. 같은 변환기가 Bezier를 엉뚱한 제어점 쪽으로 휘게 하고 PolyDraw 사각형에서 한 변을 빼먹을 수도 있습니다. 각 사례는 [MS-EMF] 규칙 하나로 거슬러 올라갑니다. EMR_POLYBEZIER는 포인트 0에서 시작하고, 폴리라인은 열려 있으며 스트로크만 하고, PT_CLOSEFIGURE는 플래그 비트이며, 포인트 개수는 레코드 크기에 맞아야 합니다

디바이스 컨텍스트에는 PDF 경로가 갖지 않은 상태가 있습니다

확장 메타파일은 디바이스 컨텍스트를 상대로 한 GDI 호출의 녹화이고, Poly* 레코드가 의미하는 것의 절반은 포인트 밖에 삽니다. 피겨가 열려 있는지, 현재 위치에서 시작하는지, 어떤 펜과 브러시가 선택돼 있는지, 포인트가 몇 바이트 오프셋에서 시작하는지가 그것입니다. PDF에는 그런 것이 없습니다. 경로와 경로 안의 현재 점, 스트로크(S)와 채움(f), 둘 다(B)를 고르는 페인팅 연산자가 있을 뿐입니다. Delphi용 losLab PDF 라이브러리인 PDFlibPas의 벡터 EMF 임포터는 좌표와 함께 그 디바이스 컨텍스트 상태를 재생하고, 아래 규칙들이 각 레코드를 어떻게 매핑하는지 기술합니다

Poly* 계열은 두 폭으로 옵니다. 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 이후의 포인트만 셋씩 묶어 제어점, 제어점, 끝점으로 삼습니다. 포인트 7개짜리 레코드는 두 개의 3차 세그먼트를 그립니다. 포인트 0이 시작이고, 포인트 1~3이 첫 세그먼트, 4~6이 두 번째 세그먼트입니다. 그룹핑을 포인트 0에서 시작하면 시작점이 첫 제어점으로 소비됩니다. 그 뒤의 모든 세그먼트가 하나씩 밀려나고, 출력은 여전히 매끈한 곡선이지만 엉뚱한 곡선입니다. PDFlibPas는 두 레코드 폭 모두에서 포인트 0을 m으로 경로를 열고, 그 뒤의 완성된 트리플마다 c를 하나씩 씁니다

일곱 포인트짜리 EMR_POLYBEZIER 레코드의 PDFlibPas 다이어그램. 포인트 0이 m으로 경로를 열고 포인트 1~3과 4~6이 각각 하나의 3차 c 세그먼트를 이루며, 올바른 그룹핑과 시작점을 제어점으로 소비하는 그룹핑을 대비한다
포인트 0이 시작점이고 그 뒤의 완성된 트리플만 3차 세그먼트가 되므로, 일곱 포인트 PolyBezier는 m과 c 두 개로 렌더링됩니다

1 더하기 3의 배수가 아닌 개수라면? 레코드가 기형입니다. 우리의 입장은 뒤에 남는 한두 포인트를 버려야 한다는 것입니다. 없는 제어점을 지어내 곡선에 이어 붙이면 어떤 GDI 디바이스도 그린 적 없는 모양이 되고, PDF와 원본을 비교하는 읽는 이는 곡선의 어느 절반이 지어진 것인지 알 도리가 없습니다

PolyDraw 타입 바이트 3과 5

EMR_POLYDRAW에서 PT_CLOSEFIGURE(값 1)는 PT_LINETO(2)나 PT_BEZIERTO(4)에 OR로 묻히는 비트이므로, 완전히 유효한 타입 바이트는 3이나 5일 수 있습니다. 포인트 타입은 그 비트를 마스크해 낸 바이트이고, 플래그 자체는 "이 포인트에서 끝나는 세그먼트 뒤에 피겨를 닫는다"는 뜻입니다. Pascal case문에서 바이트를 단일 값과 맞춰 보는 핸들러는 3이나 5가 무엇과도 일치하는 것을 보지 못하고 그 포인트들을 건너뜁니다. PolyDraw로 그린 사각형은 닫는 변을 잃고, 마지막 포인트가 플래그를 받은 Bezier 트리플은 그 포인트를 잃으며, 뒤의 모든 트리플이 하나씩 어긋납니다

PDFlibPas는 Types[i] and not PT_CLOSEFIGURE로 디스패치하고 세그먼트가 완성됐을 때만 피겨를 닫습니다. 닫힌 PT_LINETO라면 그 선 바로 뒤에, Bezier 그룹이라면 세 번째 포인트 뒤에 닫습니다. 따라서 트리플의 첫째나 둘째 포인트에 플래그를 설정한 기형 파일이 곡선 한가운데서 피겨를 닫는 일은 없습니다. 같은 핸들러에 속하는 규칙이 둘 더 있습니다:

  • 레코드의 첫 PT_MOVETO만 경로를 시작합니다. 뒤의 move는 새 서브패스를 엽니다. 피겨 셋을 담은 16비트 EMR_POLYDRAW16은 서브패스 셋을 만들어야 하고, move마다 경로를 다시 시작하는 핸들러는 마지막 하나만 남깁니다
  • PT_MOVETO로 시작하지 않는 PolyDraw 레코드는 레코드 정의가 말하듯 현재 위치에서 시작합니다. 앞서는 m 없이 l이나 c 연산자를 쓰는 것은 콘텐츠 스트림 오류이고 각 PDF 뷰어마다 다르게 해석합니다
EMR_POLYDRAW 타입 바이트의 PDFlibPas 해부도. PT_CLOSEFIGURE는 PT_LINETO나 PT_BEZIERTO에 OR로 묻히는 플래그 비트 0이라 유효한 타입 바이트 3과 5는 디스패치 전에 and not PT_CLOSEFIGURE로 마스크해야 하며, 단순 case문은 두 바이트를 모두 건너뛰고 닫힌 피겨는 마지막 변을 잃는다
디스패치 전에 닫기 플래그를 마스크로 걷어 내고, 닫기는 완성된 선이나 Bezier 트리플 뒤에만 내보내세요. 그렇지 않으면 PolyDraw가 포인트를 조용히 떨어뜨립니다

노란 삼각형: 폴리라인은 결코 채워지지 않는다

EMR_POLYLINE과 EMR_POLYPOLYLINE은 펜만으로 그리는 열린 피겨이고, PDF에서 채움 연산자는 그리기 전에 열린 서브패스를 닫습니다(ISO 32000-1 §8.5.3). 세 점 폴리라인에 B나 f를 내보내면 뷰어는 현재 브러시 색으로 채워진 삼각형을 칠합니다. 첫 문단의 노란 V가 바로 그것이고, 차트 추세선 아래의 쐐기도 그렇습니다. PDFlibPas는 두 폴리라인 폭 모두를 S로 끝내고 브러시를 건드리지 않으므로 GDI 의미론이 그대로 유지됩니다. Polygon은 닫고 채우고, Polyline은 둘 다 하지 않습니다

EMR_POLYLINE에서 내보낸 열린 V 폴리라인의 PDFlibPas 비교. 올바른 변환기는 경로를 스트로크 연산자 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로 테스트 메타파일 녹화하기

변환기를 이 규칙들로 통과시키는 가장 빠른 길은 위험한 호출 셋을 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로 끝나는 닫힌 Bezier 피겨
  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이 두 개의 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를 임포트합니다. 둘 다 성공 시 0이 아닌 이미지 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 임포트는 form XObject가 되므로, GetPageContentToString은 save와 transform, Do, restore 시퀀스만 돌려줍니다. Poly* 레코드에서 만들어진 m, l, c, h, S 연산자는 압축된 form XObject 스트림 안에 삽니다. 저장된 파일을 PDF 객체 인스펙터로 열어 그 스트림을 압축 해제하고 위 테스트 파일에 대해 세 가지를 확인하세요. 폴리라인이 앞에 h 없이 S로 끝나는지, PolyDraw 피겨의 각 닫기 플래그가 h를 낳았는지, 그 서브패스 어디에도 f나 B가 없는지입니다. DrawImage는 임포트된 EMF를 Width와 Height 중 작은 쪽으로 균등하게 스케일하므로, 넘긴 박스가 비율을 맞추지 않아도 그림은 종횡비를 유지합니다

Free Pascal 사용자는 PDFlibPas EMF 벡터 임포터가 Free Pascal에서 빌드되는 방식을 읽을 수 있습니다. 레코드 의미론은 임포터가 컴파일되는 곳 어디서나 같습니다

EMF 파일의 포인트 카운트는 신뢰할 수 없는 입력입니다

메타파일의 모든 포인트 카운트는 포인트 하나를 복사하기 전에 레코드 크기와 대조돼야 합니다. EnumEnhMetaFile이 보장하는 것은 각 레코드의 nSize가 파일 안에 머문다는 것뿐입니다. cptl이 nSize와 들어맞는지는 검사하지 않습니다. Move로 cptl개 포인트를 복사하는 핸들러는 카운트가 위조되거나 깨진 순간 기꺼이 뒤의 레코드로, 메타파일 끝을 넘어 읽어 들입니다. PDFlibPas는 고정 헤더 더하기 카운트 곱 포인트당 바이트를 nSize와 비교하는 검사를 PolyDraw, PolyBezier, PolyBezierTo, Polyline, PolylineTo, Polygon의 두 폭에 대해 수행하고, PolyDraw 타입 배열에는 포인트당 1바이트를 더합니다. PolyPoly 레코드에는 피겨별 카운트의 합이 선언된 총계를 넘지 않아야 한다는 조건이 더 요구되고, 포인트 0짜리 피겨는 건너뜁니다

우리는 이 검사를 실패한 레코드를 카운트에 맞춰 잘라 쓰는 것보다 건너뛰는 편을 택합니다. 잘린 레코드도 그리기는 하고, 리포트의 부분적으로 그려진 피겨는 사라진 피겨보다 발견하기 어렵습니다. 검사는 여러분 파서에 바로 넣을 만큼 짧습니다. 다음 버전은 32비트 EMR_POLYPOLYLINE을 검증하고 실제 포인트 배열 포인터를 돌려줍니다:

uses
  Winapi.Windows;

// 여러분 고유 EMF 파서에 추가할 검사(라이브러리 루틴이 아니다).
// 레코드가 선언한 포인트를 실제로 담고 있지 않으면 nil을 돌려준다.
// 포인트는 카운트 배열 뒤에서 시작한다. 32 + nPolys * 4바이트 들어간
// 자리이지 RTL이 한 요소 배열로 선언한 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 page에 제품 정보와 평가판 다운로드가 있습니다