공급업체 송장 한 배치의 썸네일 스트립이 언뜻 멀쩡해 보입니다. 표 줄도 있고, 로고도 또렷하고, 열도 맞습니다. 하나를 확대하면 고객 이름이 빈 상자 한 줄이고, 합계 열은 아무 의미 없는 글자들을 담고 있습니다. 깨진 송장 전부가 같은 폰트, ABCDEF+Arial을 쓰고, 전부 같은 머신의 데스크톱 PDF 뷰어에서는 멀쩡히 읽힙니다. 썸네일 코드는 폰트 이름을 받아 여섯 글자짜리 서브셋 태그를 떼어 내고, Windows에 Arial을 요청해 페이지의 날 문자 코드를 넘겼습니다. 그 코드들은 처음부터 Arial의 것이 아니었습니다. PDF 페이지에서 충실한 비트맵을 뽑아내려면 두 가지가 필요합니다. 페이지의 콘텐츠 스트림을 프로그램으로서 실행하는 것과, 텍스트를 렌더링 머신에 우연히 설치된 폰트가 아니라 파일에 저장된 글리프 윤곽선에서 그리는 것
PDF 페이지는 실행하는 것입니다
ISO 32000-1 §8은 페이지를 콘텐츠 스트림으로 기술합니다. cm으로 변환행렬을 바꾸고, q와 Q로 그래픽 상태를 저장·복원하고, 경로를 만들고, Tf로 폰트를 고르고, Tj로 글리프를 놓고, Do로 이미지와 폼을 칠하는 연산자들입니다. 파일은 어떤 픽셀이 어떻게 생겼는지 전혀 기록하지 않습니다. 비트맵을 얻으려면 무언가가 그 스트림을 현재 변환행렬, 상태 스택, 클리핑 경로, 채움과 스트로크 색 공간 쌍에 대해 실행한 다음 나오는 것을 래스터화해야 합니다
HotPDF의 RenderLoadedPageToBitmap이 바로 그 인터프리터입니다. 로드된 페이지의 연산자들을 걷고, 명세가 정의하는 대로 행렬과 그래픽 상태를 유지하고, 색 공간을 해석하고, PDF 경로를 GDI 경로로 바꾸고, 글리프 전진폭을 GDI가 아니라 폰트의 /Widths 배열에서 가져옵니다. 이미지 XObject는 라이브러리가 추출에 쓰는 것과 같은 디코더를 통과하므로, HotPDF가 추출을 위해 디코딩할 수 있는 모든 이미지 필터, JPXDecode로 압축된 JPEG 2000 이미지 포함, 렌더링된 페이지에도 나타납니다
Delphi에서 로드된 페이지를 TBitmap으로 렌더링하기
THotPDF.RenderLoadedPageToBitmap(PageIndex, DPI)는 0 기반 페이지 인덱스와 인치당 도트 수 해상도를 받습니다. 72 DPI에서 PDF 단위 하나가 픽셀 하나입니다. 새 24비트 RGB TBitmap을 반환합니다. 범위 밖 인덱스나 만들 수 없는 페이지는 예외 대신 nil을 반환합니다. 뷰어에 맞는 성격입니다. 하나의 손상된 페이지를 건너뛰고 나머지를 계속해야 하니까요. 비트맵은 호출자의 소유입니다
var
Pdf: THotPDF;
Bmp: TBitmap;
begin
Pdf := THotPDF.Create(nil);
try
if Pdf.LoadFromFile('report.pdf') > 0 then
begin
Bmp := Pdf.RenderLoadedPageToBitmap(0, 144); // 144 DPI의 첫 페이지
if Bmp <> nil then
try
Image1.Picture.Assign(Bmp);
finally
Bmp.Free; // 반환된 비트맵은 호출자가 소유합니다
end;
end;
finally
Pdf.Free;
end;
end;
픽셀 치수는 페이지의 가시 영역에서 따라옵니다. 렌더러는 ISO 32000-1 §14.11.2가 가시 영역으로 정의하는 /MediaBox로 클립한 /CropBox를 가져가고, 쓸 만한 크롭 박스가 없으면 /MediaBox를 쓰며, DPI/72로 스케일하고 올림합니다. 별도 크롭 박스가 없는 US Letter 페이지는 따라서 72 DPI에서 정확히 612×792픽셀로 돌아옵니다. 96 DPI의 A4 페이지(595.28×841.89포인트)는 794×1123이 됩니다. 793.7과 1122.5가 모두 올림되기 때문입니다. 90이나 270의 /Rotate는 폭과 높이를 맞바꾸고, PDF의 왼쪽 아래 원점에서 GDI의 왼쪽 위 원점으로의 뒤집기는 페이지 행렬 안에서 일어나므로, 이미지는 후처리 없이 바로 똑바로 도착합니다
DPI가 유일한 스케일 손잡이고 흔한 일들을 다 커버합니다. 36이나 48 DPI의 썸네일은 작고 빠릅니다. 96이나 144 DPI의 화면 미리보기는 전형적인 표시 밀도에 맞습니다. 300 DPI 내보내기는 인쇄 등급 출력을 주지만, Letter 페이지마다 2550×3300 비트맵, 픽셀당 3바이트로 페이지마다 대략 24 MiB의 값을 치릅니다
대체된 폰트는 왜 틀린 글리프를 그릴까
렌더링된 PDF의 틀린 글리프는 거의 항상 래스터라이저가 파일에 임베디드된 폰트를 설치된 폰트로 바꿨다는 뜻입니다. 송장 예의 지름길은 늘 통하곤 해서 유혹적입니다. /BaseFont에서 서브셋 접두사를 떼고, 남은 이름으로 GDI 폰트를 요청하고, 문자열을 그립니다. 표준 인코딩의 평범한 Arial이나 Times New Roman 텍스트라면 아무도 불평하지 않습니다
서브셋 폰트가 그것을 먼저 깹니다. 서브셋은 문서가 쓰는 마흔 개의 글리프만 담고 있을 수 있고, 그 파일만의 비공개 순서로 번호가 매겨져 있어서 코드 1은 "T", 코드 2는 "h"일 수 있습니다. 설치된 폰트는 그것을 알 방법이 없습니다. 커스텀 인코딩, 심볼 및 바코드 폰트, 렌더링 머신에 없는 모든 서체가 같은 이유로 실패합니다. 그리고 대체 폰트가 모든 문자를 갖고 있어도 전진폭이 임베디드 페이스와 달라서 줄이 늘거나 줄고 오른쪽 정렬 열이 맞지 않습니다
임베디드 폰트 프로그램에서 텍스트 그리기
HotPDF는 PDF에 저장된 폰트 프로그램에서 텍스트를 그립니다. 폰트가 임베디드 TrueType 프로그램(/FontFile2)이나 CFF 프로그램(/FontFile3)을 갖고 있으면 각 글리프는 그 데이터에서 윤곽을 잡아 GDI 경로로 채워지고, 폰트 크기, 텍스트 행렬, 현재 변환행렬은 하나의 변환으로 합성됩니다. 서브셋 폰트, 비공개 인코딩, 머신이 본 적 없는 페이스가 진짜 모양으로 나옵니다. 문자 코드가 글리프에 닿는 경로는 폰트 타입에 달리고, 타입마다 자기 함정이 있습니다:
- TrueType 윤곽선: 컨투어는
glyf와loca테이블에서 옵니다. 2차 세그먼트는 GDI가 그리는 3차 베지어로 올려지는데 이것은 정확한 변환이고, 연속한 두 오프커브 점 사이의 함축된 온커브 점은 재구성되며, 컴포지트 글리프는 각 컴포넌트 변환을 적용하며 컴포넌트로 재귀합니다 - CID 키 TrueType:
CIDFontType2위의Type0폰트는/CIDToGIDMap을 통해 글리프 ID에 도달합니다.Identity(항목이 없을 때의 기본값이기도 합니다)이거나 명시적 맵 스트림이며, 전진폭은/W와/DW에서 가져와서 2바이트Identity-H텍스트가 올바른 만큼 전진합니다. 사전 정의된 CJK CMap과 임베디드 CMap 스트림은 조회 전에 가변 길이 코드를 디코딩합니다 - CFF 프로그램:
Type1C,CIDFontType0C, OpenType 컨테이너에 감싸인 CFF는 Type 2 캐릭터스트링 인터프리터를 통과합니다. 선과 곡선, flex 계열, 힌트 마스크, 서브루틴 바이어스가 적용된 로컬 및 글로벌 서브루틴 호출을 처리합니다. CID 키 프로그램은 각 코드를 폰트의 charset으로 사상하는데, 글리프 순서가 CID 순서와 다른 서브셋에서 중요하고,FDArray와FDSelect로 글리프별 프라이빗 사전을 고릅니다 - 심플 TrueType 폰트: 1바이트 코드는 임베디드
cmap을 통과합니다. 유니코드 서브테이블 (3,1)과 (3,10)을 먼저, 그다음 (3,0) 심볼 서브테이블을 심볼 폰트가 쓰는 U+F000 거울에서 직접과 간접으로, 마지막으로 옛 Macintosh (1,0) 테이블 순입니다
그 위에 규칙 둘이 얹힙니다. 심플 폰트의 /Encoding 사전은 ISO 32000-1 §9.6.6이 정한 순서로 해석됩니다. /Differences가 베이스 인코딩을 덮고, 베이스 인코딩이 프로그램의 내장 사상을 덮습니다. TeX와 그 밖의 PostScript 계열 도구チェ인이 이것에 크게 의존하므로, 순서를 틀리면 틀린 글리프를 알아채기 가장 어려운 바로 그 수식과 기호 텍스트가 뒤섞입니다. 글리프가 자체적으로 작은 콘텐츠 스트림인 Type3 폰트는 폰트 행렬, 폰트 크기, 텍스트 행렬을 합성해 같은 인터프리터로 재생됩니다. 글리프 공간의 /Widths는 §9.6.5가 요구하는 대로 /FontMatrix를 통과하고, d1 바운딩 박스를 선언한 글리프 프로시저는 그것으로 클립되어, 오작동하는 바코드 글리프가 자기 셀 밖에 칠할 수 없습니다
단일 코드가 사상되지 않을 때, 프로그램이 손상됐거나 서브셋에 그 글리프가 없을 때, 그 한 문자만 같은 이름의 설치된 폰트로 그려지고 런의 나머지는 임베디드 윤곽선을 계속 씁니다. 런 전체를 버리면 문제가 숨겨지고, 하나의 이상한 글자는 알아채기 쉽습니다. 쓸 만한 임베디드 프로그램이 없는 폰트는 시스템 페이스로 비임베디드 폰트 렌더링하기에서 기술한 설치 폰트 경로를 따릅니다
반복 렌더링을 빠르게 유지하는 방법은?
대화형이라면 무난한 메서드 대신 RenderLoadedPageToBitmapCached를 호출하세요. 최근 렌더링된 페이지를 페이지 인덱스, DPI, 현재 렌더 설정(색 인텐트, 오버프린트 미리보기, 폴백 정책, 보이는 선택 콘텐츠 레이어)으로 키 잡은 MRU 캐시에 보관하고, 적중하면 콘텐츠 스트림을 다시 해석하지 않고 새 호출자 소유 사본을 돌려줍니다. 두 페이지 사이를 오가거나, 같은 페이지를 같은 DPI로 다시 요청하는 리사이즈는 매번 캐시에 적중합니다. 각 페이지를 한 번씩만 방문하는 일회성 내보내기라면 평범한 RenderLoadedPageToBitmap이 더 낫습니다. 캐시 변형은 반환하는 모든 비트맵을 복사하고 아무도 다시 묻지 않을 페이지를 붙들고 있기 때문입니다
// 썸네일 스트립: 첫 패스가 렌더링하고, 스크롤을 되돌리면 캐시에 적중합니다
Pdf.RenderCacheCapacity := 32; // 항목 한도, 기본값은 8
for I := 0 to Pdf.LoadedPageCount - 1 do
begin
Bmp := Pdf.RenderLoadedPageToBitmapCached(I, 48);
if Bmp <> nil then
try
ThumbList.AddThumbnail(I, Bmp); // 여러분의 자체 UI 코드
finally
Bmp.Free;
end;
end;
// 300 DPI 페이지도 캐싱하나요? 래스터 캐시에 더 큰 바이트 예산을
// 주세요 (Policy: THPDFCacheAdmissionPolicy)
if Pdf.GetCacheAdmissionPolicy(clkRaster, Policy) then
begin
Policy.MaxTotalBytes := Int64(512) * 1024 * 1024;
Pdf.SetCacheAdmissionPolicy(clkRaster, Policy);
end;
// 페이지 콘텐츠를 직접 바꾼 뒤에는:
Pdf.InvalidateRenderedPageCache; // 다음 렌더링이 편집을 반영합니다
RenderCacheCapacity는 두 한도 중 하나일 뿐입니다. 래스터 캐시에는 바이트 예산도 있습니다. 기본 128 MiB, 항목당 64 MiB 천장이며, 예산을 잡을 때 픽셀당 4바이트로 셉니다. 뷰어가 Letter 페이지를 300 DPI로 캐시한다고 치면 항목 하나가 약 32 MiB로 계산되어, RenderCacheCapacity가 뭐라 하든 세 개만 들어갑니다. 같은 페이지가 48 DPI에서는 약 0.82 MiB로 계산되고, 위 루프의 썸네일 32개가 27 MiB 미만으로 상주할 수 있습니다. 캐시가 가득 차면 한 번 요청된 페이지가 자주 요청되는 페이지를 밀어내지 못할 수 있습니다. 그래도 렌더링되어 반환되지만, 보관되지 않을 뿐입니다. 뷰어가 예측 가능한 순서로 페이지를 넘긴다면 PrefetchLoadedPages가 워커 스레드에서 사용자보다 먼저 같은 캐시를 채웁니다
새 문서를 로드하면 캐시가 지워집니다. FlattenLoadedFormFields 같은 라이브러리 자체의 페이지 편집 호출 몇몇은 영향받은 페이지를 스스로 떨어뜨립니다. 페이지 오브젝트나 콘텐츠 스트림을 직접 바꾼 뒤에는 InvalidateRenderedPageCache를 호출하세요. 페이지 뒤의 바이트가 바뀐 것을 캐시는 알 수 없습니다. 그 아래에는 디코딩된 이미지 XObject를 위한 두 번째 저장소가 있고, ImageCacheMaxBytes(기본 32 MiB)로 한계가 정해집니다. 모든 페이지에 반복되는 로고나 레터헤드가 Do 연산자마다가 아니라 문서 로드마다 한 번 디코딩됩니다. InvalidateRenderedPageCache는 그 저장소도 지웁니다. 썸네일이 애플리케이션 재시작을 넘어 살아야 한다면 렌더 캐시의 디스크 계층이 그 경우를 커버합니다
페이지가 근사되었을 때 알아내기
대부분의 페이지는 폴백에 닿지 않습니다. 렌더러가 텍스트와 이미지보다 훨씬 넓게 커버하기 때문입니다. CalGray, CalRGB, Lab, ICC 기반 색 공간은 적용 중인 렌더링 인텐트로 변환되고, RenderColourIntent가 이를 덮을 수 있으며, ConfigureRenderICCWorkflow가 소프트 프루핑용 증명 및 출력 ICC 프로파일을 받습니다. 인덱스 팔레트, Separation과 DeviceN 틴트, 샘플링된 Type 0 함수 색 조회도 커버됩니다. 함수 기반, 축성, 방사형, 메시 셰이딩은 sh 연산자로도 셰이딩 패턴으로도 렌더링되고, 투명도 그룹, knockout 그룹, 알파 또는 휘도 소프트 마스크는 블렌드 모드 그룹과 휘도 마스크에서 기술한 대로 자신의 블렌드 모드로 합성됩니다
그래도 실무 파일에는 정확히 그릴 수 없는 것이 들어 있습니다. 페이지가 이름을 대지만 정의하지 않는 리소스, 데이터 디코딩에 실패하는 이미지, 자기 자신을 그리는 Form XObject. 이때 RenderFallbackPolicy가 무엇이 일어날지 결정합니다. 기본값 rfpIgnore는 가장 가까운 근사를 그리고 넘어갑니다. rfpReport는 같은 일을 하면서 폴백마다 진단을 기록하고, 최대 RenderFallbackDiagnosticLimit 항목(기본 256)까지입니다. rfpStrict은 근사 비트맵을 반환하는 대신 예외를 일으킵니다. 폼 중첩은 32단계에서 멈추고 자기 참조 폼은 건너뛰어지므로, 깨졌거나 적대적인 파일이 무한히 재귀할 수 없습니다
// rfpReport와 THPDFRenderFallbackDiagnostics는 HPDFPageRenderer에 선언됩니다
var
Diags: THPDFRenderFallbackDiagnostics;
J: Integer;
begin
Pdf.RenderFallbackPolicy := rfpReport;
Bmp := Pdf.RenderLoadedPageToBitmap(PageIndex, 150);
try
Diags := Pdf.GetLastRenderFallbackDiagnostics;
for J := 0 to High(Diags) do
Log.Add(Format('page %d: %s %s - %s', [PageIndex + 1,
string(Diags[J].OperatorName), string(Diags[J].ObjectName),
string(Diags[J].Reason)]));
if Pdf.LastRenderFallbackDroppedCount > 0 then
Log.Add(Format('%d more fallbacks not recorded',
[Pdf.LastRenderFallbackDroppedCount]));
finally
Bmp.Free; // nil에 대한 Free는 안전합니다
end;
end;
QA와 수집 빌드는 rfpReport로 돌리세요. 비트맵은 rfpIgnore가 만드는 것과 동일하고, 고객이 14페이지가 이상하다고 말하기 전에 로그가 어떤 페이지가 근사되었는지 왜 근사되었는지를 보여줍니다. rfpStrict은 조용히 근사된 페이지가 실패한 페이지보다 나쁜 아카이브 변환을 위해 남겨 두세요. 캐시 적중은 그 페이지가 처음 렌더링될 때 기록된 진단을 복원하므로, GetLastRenderFallbackDiagnostics는 캐시 변형이 일을 했든 안 했든 같은 답을 줍니다
RenderLoadedPageToBitmap과 캐시 변형, 임베디드 글리프 텍스트 경로는 외부 DLL이 없는 Delphi 및 C++Builder용 네이티브 VCL 라이브러리인 HotPDF Delphi Component의 일부이며, 같은 로드된 문서에서 생성, 편집, 텍스트 추출도 수행합니다