기술 문서

HotPDF로 Delphi에서 PDF 페이지를 SVG로 내보내기

PDF에서 제목을 세팅하는 흔한 방법은 /F1 1 Tf 10 0 0 10 72 700 Tm (Total) Tj ( due) Tj 같은 코드입니다. 폰트 크기는 1로 두고 실제 크기는 텍스트 행렬이 책임집니다. 이것을 손으로 만든 PDF-SVG 컨버터에 먹이면 두 번째 run이 첫 번째 바로 위에 얹히는 일이 자주 벌어집니다. "Total"의 다섯 글리프가 평균 절반 em이라고 하면, 텍스트 원점은 2.5 텍스트 공간 단위 이동해야 하고 행렬은 이를 25포인트로 바꿉니다. 2.5를 행렬 이동 값에 그냥 더해 버리는 컨버터는 펜을 10분의 1만큼만 움직여 " due"가 앞 단어 위에 겹쳐 찍힙니다

ISO 32000-1 §9.4.4는 텍스트 공간에서의 이동이 텍스트 행렬을 거친다고 명시하므로, 갱신은 e += tx*a와 f += tx*b로 이루어져야 하며 e에 단순히 더하는 방식은 안 됩니다. PDF 상태를 요소가 쓰이는 바로 그 시점에 SVG 속성으로 옮겨야 하는 지점이 이곳 하나만이 아니고, 나머지 글에서 차례로 살펴봅니다

BuildLoadedPageSVG로 로드된 페이지 내보내기

HotPDF는 로드된 문서의 어떤 페이지든 독립적인 SVG 1.1 파일로 내보냅니다. THotPDF.BuildLoadedPageSVG는 0 기반 페이지 인덱스를 받아 문서 전체를 AnsiString으로 돌려주고, 페이지를 내보낼 수 없으면 빈 문자열을 돌려줍니다. SaveLoadedPageAsSVG는 같은 마크업을 파일로 쓰고 실패 시 False를 반환합니다. 둘 다 EmbedFonts 플래그를 받는 오버로드가 있으며, 뒤에서 다룹니다

내보낸 페이지의 크기는 crop box에서 옵니다. 너비와 높이는 포인트로 기록되고 viewBox는 PDF 사용자 단위를 쓰므로, SVG의 단위 하나가 PDF의 단위 하나입니다. 경로, 텍스트 run, 이미지 XObject, 인라인 이미지, 셰이딩, 타일링 패턴, 클리핑 경로, Type 3 글리프, 중첩된 Form XObject가 모두 출력에 도달하고, 래스터 콘텐츠는 base64 PNG 데이터 URI로 파일 안을 여행합니다

var
  Pdf: THotPDF;
  I: Integer;
begin
  Pdf := THotPDF.Create(nil);
  try
    if Pdf.LoadFromFile('statements.pdf', '') <= 0 then
      Exit;                  // LoadFromFile은 페이지 수를 반환
    for I := 0 to Pdf.LoadedPageCount - 1 do
      if not Pdf.SaveLoadedPageAsSVG(I, Format('page-%d.svg', [I + 1])) then
        Writeln('Page ', I + 1, ' could not be exported');
  finally
    Pdf.Free;
  end;
end;

컴파일된 Delphi 프로그램 없이 돌려야 하는 빌드 파이프라인을 위해, HotPDF 명령줄 도구가 같은 내보내기를 HotPDFCLI export-svg <pdf-file> [-o prefix] [--pages range]로 노출합니다. SVG는 텍스트이므로 PDF 페이지를 비트맵으로 렌더링하기의 래스터 경로와 좋은 짝이 됩니다. 비트맵은 페이지가 어떻게 보이는지를 보여 주고, SVG는 어떤 객체들이 그렇게 그렸는지 텍스트 diff가 읽을 수 있는 형태로 보여 줍니다

한 번의 페이지 뒤집기가 왜 글리프와 사진을 깨뜨리는가

PDF 사용자 공간은 왼쪽 아래에서 위로 자라고 SVG는 왼쪽 위에서 아래로 자랍니다. 페이지 전체를 한 번 뒤집으면 모든 좌표가 맞지만, 같은 동작으로 모든 글자와 모든 사진이 거울에 비친 것처럼 뒤집힙니다. 나머지 두 불일치는 더 조용합니다. PDF는 상태를 스택으로 관리하고(q가 밀고 Q가 꺼냅니다) SVG는 요소가 조상 그룹이 선언한 것을 물려받게 합니다. 그리고 PDF는 여러 가지를 관례로 표현합니다. 끝 모양과 연결 모양은 정수이고, 폭 0은 "그릴 수 있는 가장 얇은 선"을 뜻하며, 연산자 변형은 와인딩 규칙을 바꿉니다

HotPDF는 Delphi에서 페이지를 내보낼 때 상태 기반 PDF 콘텐츠 스트림을 선언형 SVG 트리에 매핑: y축 원점, 스택 스코핑, 정수 규약을 아울러
상태를 지닌 PDF 콘텐츠 스트림이 선언적인 SVG 트리와 만나며, 세 가지 불일치는 모두 복사가 아니라 번역이 필요합니다

BuildLoadedPageSVG는 뒤집기를 페이지 사전 변환 하나로 처리하고 텍스트와 이미지는 로컬에서 바로잡습니다. 모든 텍스트 요소는 페이지 사전 변환 × CTM × 텍스트 행렬 × matrix(1,0,0,-1,0,0)의 연쇄를 갖습니다. 오른쪽 끝의 인수가 자기 프레임 안에서 글리프를 다시 세워 놓고, 베이스라인은 페이지 뒤집기가 놓아 둔 자리에 그대로 둡니다. 보정이 특수 사례가 아니라 행렬이므로, 회전한 텍스트, 거울로 뒤집힌 텍스트, 기울어진 텍스트에 추가 코드가 필요 없습니다

이미지는 다른 인수를 씁니다. PDF 이미지 공간은 첫 샘플 행을 단위 정사각형의 위에 두는 반면 SVG image 요소는 자기만의 y-아래 프레임을 가지므로, 출력되는 변환은 CTM에 matrix(1,0,0,-1,0,1)을 오른쪽 곱한 것입니다. 부호를 틀리면 페이지의 벡터 콘텐츠는 완벽한데 모든 사진이 거꾸로 매달려 있습니다

/Rotate 항목이 있는 페이지는 뒤집기 앞에 y-위 표시 공간의 회전을 얹습니다. 90도는 (0,-1,1,0,0,W), 180도는 (-1,0,0,-1,W,H), 270도는 (0,1,-1,0,H,0)이며, W와 H는 회전 전 페이지 크기이고 뒤집기는 회전된 캔버스의 높이를 씁니다. 페이지 박스가 원점에서 시작한다는 보장도 없습니다. crop box가 [100 100 712 892]인 페이지에서는 회전 전에 왼쪽 아래 모서리를 (0,0)으로 옮기는데, 이는 래스터 렌더러가 취하는 같은 단계이고, 생략하면 콘텐츠가 캔버스에서 백 단위로 벗어납니다

HotPDF는 /Rotate 90, 180, 270용 페이지 회전 사전 변환을 합성하고 CTM에 matrix(1,0,0,-1,0,1)를 오른쪽 곱해, Delphi PDF to SVG 내보내기가 임베드된 이미지를 똑바로 유지
페이지 회전 사전 변환과 이미지 뒤집기 행렬이 회전된 페이지와 사진을 내보낸 SVG에서 똑바로 유지합니다

텍스트 행렬과 문자별 위치

텍스트 run마다 SVG text 요소 하나가 되고, 그 x 속성이 문자마다 위치 하나를 나열합니다. 위치는 글리프 이동량에 문자 간격 Tc를 더해 누적되고, 단어 간격 Tw는 1바이트 코드 32 뒤에만 붙습니다. 우연히 32와 같은 2바이트 코드는 단어 간격을 받지 않는데, 이는 ISO 32000-1 §9.3.3이 정한 규칙이자 CID 키 폰트가 의존하는 동작입니다. 리가처처럼 하나의 글리프가 여러 문자를 대변할 때는 문자들이 그 이동량을 나눠 갖도록 해서 각자 자기 x 값을 여전히 얻습니다

가로 스케일과 텍스트 라이즈는 §9.4.4를 따라 텍스트 렌더링 행렬에 [Th 0 0 1 0 Trise] × Tm으로 접어 넣으므로, 변환된 텍스트 행렬과 함께 스케일되고 회전합니다. TJ 배열 안의 커닝 숫자는 천분의 일 em이며 다른 가로 이동과 마찬가지로 Th를 곱합니다

XML 관련 세부 사항 두 가지가 중요합니다. 모든 text 요소는 xml:space="preserve"를 갖습니다. 이것이 없으면 뷰어가 공백 나열을 압축해 x 목록이 문자와 어긋납니다. 그리고 파일은 UTF-8이므로 문자가 시스템 코드 페이지를 거치지 않고 명시적으로 UTF-8 인코딩됩니다. XML 1.0이 금지하는 코드 포인트(0x20 아래 제어 문자, 서러게이트, U+FFFE, U+FFFF)는 U+FFFD로 바뀝니다. 복합 스크립트 셰이핑의 텍스트도 같은 경로를 갑니다. 콘텐츠 스트림이 쓰이기 전에 이미 셰이퍼가 클러스터를 위치 잡힌 글리프로 바꿔 두었기 때문입니다

이름으로 쓰는 폰트 또는 임베드된 외곽선

기본값에서 텍스트는 자기 폰트를 이름으로 밝힙니다. 익스포터는 /BaseFont와 폰트 디스크립터에서 패밀리를 유도해 Arial, sans-serif 같은 일반 폴백을 붙이고, 뷰어는 설치된 폰트로 텍스트를 그립니다. 파일이 작게 유지되고 텍스트가 완전히 살아 있지만, 임베드된 사내 서체로 짜인 페이지는 그 서체가 없는 머신에서 대체 폰트로 그려지고, 그 폰트의 폭은 더 이상 문자별 위치와 맞지 않습니다

EmbedFonts에 True를 넘기면 임베드된 폰트 프로그램의 글리프가 defs 블록에 외곽선으로 기록되고, 페이지 안의 모든 등장 장소가 이를 공유합니다. 원본 텍스트는 채우기 불투명도 0으로 그 위에 계속 기록되므로 선택과 검색이 됩니다. SVG를 만든 머신을 떠난다면 True를 쓰세요. 디자인 인계, 아카이브, CI 에이전트의 시각 diff가 그 예입니다. 파일이 폰트를 갖춘 환경 안에 머물고 크기가 중요하다면 기본값을 쓰면 됩니다

procedure ExportOutlined(Pdf: THotPDF);
var
  Svg: AnsiString;
  Output: TFileStream;
begin
  // 임베드된 폰트의 글리프 외곽선, 그 위에 선택 가능한 텍스트
  Svg := Pdf.BuildLoadedPageSVG(0, True);
  if Svg = '' then
    raise Exception.Create('Page 1 could not be exported');
  Output := TFileStream.Create('page-1-outlined.svg', fmCreate);
  try
    Output.WriteBuffer(Svg[1], Length(Svg));
  finally
    Output.Free;
  end;
end;

렌더 모드는 두 경로 모두에서 존중됩니다. 모드 1은 채우지 않고 스트로크하고, 모드 2는 채우고 스트로크하며, 모드 3은 보이지 않지만 펜은 여전히 전진하고, 모드 4부터 7은 글리프를 클리핑 경로에 넣습니다. 스트로크한 글리프에는 보정이 하나 더 필요합니다. 선 폭은 사용자 공간에 살지만 text 요소는 텍스트 공간에서 그리므로, 폭을 텍스트 행렬의 스케일로 나눕니다. 2 Tr 0.25 w로 굵게 만든 텍스트는 4분의 1포인트 외곽선을 유지하고, SVG 기본값인 1단위로 두면 과하게 두꺼워 보입니다

그래픽 상태가 각 요소로 가져오는 것

SVG 표현 속성은 PDF 스코핑을 따라가지 않으므로, 모든 경로는 그 시점에 유효한 전체 스트로크 상태와 함께 기록됩니다. 선 끝 0, 1, 2는 butt, round, square가 되고, 선 연결 0, 1, 2는 miter, round, bevel이 되며, 마이터 한계와 대시 배열, 대시 위상은 설정되어 있을 때 기록됩니다. 음수 항목이 있는 대시 배열, 또는 양수 항목이 하나도 없는 비어 있지 않은 배열은 무시되고 이전 패턴이 유지되며, 빈 배열 []은 실선을 복원합니다. 같은 값들이 ExtGState 딕셔너리로도 들어오는데, 그 LW, LC, LJ, ML, ca, CA 키도 적용됩니다

PDF에서 폭 0은 장치가 그릴 수 있는 가장 얇은 선을 뜻합니다. 그대로 복사하면 보이지 않는 스트로크가 되고 1로 복사하면 줌할 때마다 굵어지는 선이 됩니다. 익스포터는 stroke-width="1"과 함께 vector-effect="non-scaling-stroke"를 기록해, 어떤 배율에서도 헤어라인이 대략 장치 픽셀 하나 폭을 유지하게 합니다. 별표 연산자 f*, B*, b*는 fill-rule="evenodd"를 더하고, 별표 없는 형태는 SVG의 기본 nonzero 와인딩을 유지합니다

Q는 채우기와 스트로크 색, 불투명도, 선 폭, 끝 모양, 연결 모양, 마이터 한계, 대시 배열과 위상, 그리고 텍스트 상태까지 복원합니다. ISO 32000-1 §9.3.1은 텍스트 상태를 그래픽 상태의 일부로 만들므로, q … Q 안에서 설정한 2 Tr이 Q 뒤의 텍스트를 스트로크해서는 안 됩니다. 클리핑은 §8.5.4를 따릅니다. W는 경로를 표시만 하고 클립은 페인팅 연산자 뒤에 적용되므로, re W f는 먼저 사각형을 채우고 나서 클립합니다. 클립마다 clipPath와 감싸는 그룹이 하나씩 생기고, Q가 짝이 맞는 q 이후 열린 그룹을 닫습니다

Form XObject는 암묵적인 q … Q로 동작합니다. 익스포터는 폼을 /BBox로 클립하고 진입 시 상태를 저장하고 출구에서 복원하므로, 스탬프 안의 대시 테두리가 그 뒤의 페이지 콘텐츠로 새어 나갈 수 없습니다. 타일링 패턴은 그 패턴을 쓰는 콘텐츠 스트림(§8.7.2)의 기본 공간, 즉 페이지나 폼에 매핑되며, 패턴이 칠해지는 시점의 CTM과는 무관합니다. EMF 및 WMF 벡터 임포트는 비슷한 상태 모델을 반대 방향으로 돌리고, Form XObject로서의 SVG 임포트는 SVG에서 PDF로 가는 반대 여정을 다룹니다

색상, 셰이딩, 그리고 테스트가 비교하는 문자열

색상은 모든 PDF 색상 연산자를 통해 SVG에 도달합니다. g, rg, k와 그 스트로크 형태, 그리고 페이지나 폼 /ColorSpace 리소스의 이름 공간을 쓰는 cs / scn입니다. Separation, DeviceN, ICCBased, Indexed, Lab 색상은 페이지 렌더러가 쓰는 같은 색상 공간 코드로 RGB로 풀립니다. cs로 공간을 고르면 §8.6.8이 정의한 초기 색에서 시작합니다. 디바이스 공간에서는 검정, Separation과 DeviceN에서는 tint 1.0, Indexed에서는 인덱스 0입니다. SVG에는 잉크 개념이 없으므로 별색은 RGB 모습으로 도착하고 잉크 이름은 PDF에 남습니다. 실제 분판이 필요한 교정 작업은 Separation과 DeviceN 별색 렌더링에서 설명하는 페인팅 모델의 영역입니다

축형과 방사형 셰이딩은 SVG 그라디언트가 됩니다. 스펙은 /Extend의 기본값을 [false false]로 둬서 t0 이전이나 t1 이후에는 아무것도 칠하지 않는 반면, SVG의 pad 스프레드는 끝 색을 바깥으로 펼칩니다. 익스포터는 확장하지 않는 쪽 끝마다 완전히 투명한 stop을 추가해서 이 간극을 메꿉니다. 함수 기반 셰이딩은 단위당 대략 한 샘플 꼴로 이미지로 샘플링되고, 메시 셰이딩은 임베드된 이미지로 렌더링됩니다

16진수 색상은 대문자로 나옵니다. 문자열을 비교하는 회귀 테스트는 #FF0000을 기대해야 하고, 소문자로 작성한 테스트는 완전히 올바른 출력에서 실패합니다. 좌표와 너비는 소수 넷째 자리에서 반올림되고 transform 행렬은 유효숫자 아홉 개를 유지하며, 둘 다 테스트를 돌리는 머신의 로캘과 무관하게 마침표를 소수 구분자로 씁니다

procedure CheckRedRectangle(Pdf: THotPDF);
var
  Svg: AnsiString;
begin
  Svg := Pdf.BuildLoadedPageSVG(0);
  // Assert는 내 테스트에 직접 넣는 검사이지 내보내기 기능이 아님
  Assert(Pos(AnsiString('fill="#FF0000"'), Svg) > 0,
    'expected the red fill in uppercase hex');
  Assert(Pos(AnsiString('xml:space="preserve"'), Svg) > 0,
    'text elements keep their spaces');
end;

이런 문자열 검사는 입력 PDF를 내 코드가 만들고 기대 색상을 알 때 든든히 버텨 줍니다. 바깥에서 온 페이지에는 두 빌드의 SVG를 서로 비교하는 편이 하드코딩한 속성 검사보다 더 많이 잡아 냅니다. 렌더링과 편집부터 내보내기까지, 로드된 문서를 위한 도구 모음의 나머지는 HotPDF Delphi PDF 컴포넌트 페이지에 설명되어 있습니다