PDF 사용자 공간(원점 왼쪽 아래)에서 x = 560, y = 30에 그린 페이지 번호는 Letter 페이지의 오른쪽 아래 구석에 놓입니다. 세로 미디어로 저장된 가로 방향 스캔 페이지, 즉 /MediaBox [0 0 612 792]에 /Rotate 90인 페이지에서 같은 드로잉 호출은 번호를 리더가 보는 것의 왼쪽 가장자리에서 30포인트, 아래쪽에서 52포인트 위에 놓고 숫자는 여백을 따라 곧장 내려갑니다. 스탬핑 코드는 시킨 대로 정확히 했습니다. 누구나 보기 전에 시계 방향으로 90도 돌리는 좌표계에 기록했을 뿐이죠
스캐너와 휴대폰 캡처 앱은 이런 페이지를 늘 만들어 냅니다. 회전 플래그를 설정하는 쪽이 JPEG을 다시 인코딩하는 것보다 훨씬 싸기 때문입니다. 뷰어는 /Rotate를 따르므로 원시 사용자 공간에서 일하는 무언가가 나타나기 전까지 파일은 멀쩡해 보입니다. 스탬핑 루틴, /MediaBox만으로 슬롯 크기를 정하는 조판 단계, 자기만의 방향 관념을 가진 인쇄 RIP이 그 대상입니다. 튼튼한 수리법은 회전을 평탄화하는 것, 즉 회전을 콘텐츠 스트림 안으로 옮기고 /Rotate를 0으로 두어 저장된 지오메트리와 표시되는 지오메트리가 마침내 일치하게 만드는 것입니다. 행렬 하나처럼 들지만 실제로는 다섯 개의 페이지 박스, 세 종류의 주석 지오메트리, 그 페이지를 향한 모든 링크와 구조 트리까지 뻗어 가고, ISO 32000-1은 각각에 대해 별도의 규칙을 둡니다
/Rotate는 PDF 페이지를 어느 쪽으로 돌릴까?
/Rotate는 표시와 인쇄를 위해 페이지를 시계 방향으로, 90도의 배수로 돌립니다(ISO 32000-1 §7.7.3.3, Table 30). 90도에서 미디어의 왼쪽 가장자리가 위가 되고 위쪽 가장자리가 오른쪽이 되어, y-아래 장치 공간에서 매핑은 X = (y - Bottom) * Scale, Y = (x - Left) * Scale입니다. 270도에서는 오른쪽 가장자리가 대신 위가 됩니다. 이 키는 상속 가능하기까지 합니다. /Resources, /MediaBox, /CropBox와 함께 /Pages 조상이 공급할 수 있는 네 페이지 속성 중 하나라서(§7.7.3.4), 자체 /Rotate가 없는 페이지 딕셔너리도 돌아갈 수 있습니다. THotPDF.GetLoadedPageRotation은 /Parent 사슬을 걷고 만나는 첫 /Rotate를 0-359로 정규화하므로, 저장된 -90은 270으로 돌아옵니다
방향은 아무도 눈치채지 못하게 틀어지는 부분입니다. 90도와 270도에서 y 성분을 맞바꾼 페이지-장치 행렬은 페이지를 전혀 돌리지 않습니다. 대각선 기준으로 거울 반사할 뿐이고 행렬식 부호가 바뀝니다. 두 각도 모두 돌아가 보이죠. 비트맵은 맞바뀐 폭과 높이를 갖고, 점을 뷰로 보냈다가 되돌리면 시작점으로 돌아오니 차원 검사와 왕복 테스트는 불평 없이 통과합니다. 실수를 잡는 것은 한 구석에 비대칭 마커를 지닌 페이지를 독립 렌더러와 픽셀 단위로 렌더링해 비교하는 일입니다. 지오메트리 구현을 자기 자신과만 비교하면 여기서는 아무것도 증명되지 않습니다. HotPDF에서 FlattenLoadedPageRotation과 RenderLoadedPageToBitmap은 하나의 시계 방향 관례를 공유하므로, 렌더러가 돌아간 페이지의 왼쪽 위에 그린 구석은 평탄화 후에도 왼쪽 위에 있습니다
FlattenLoadedPageRotation으로 페이지 범위 평탄화하기
THotPDF.FlattenLoadedPageRotation(PageRange, Info)는 PageRange 중 실효 회전이 90, 180, 270인 모든 페이지를 처리하고 평탄화한 페이지 수를 반환합니다. 빈 PageRange는 문서 전체를 뜻하고, 아니면 문자열은 1 기반 '1-3,7' 구문을 쓰며 범위 끝을 넘는 페이지 번호는 조용히 범위에서 빠지는 대신 예외를 발생시킵니다. 원본 콘텐츠 스트림은 바이트 단위로 그대로 남습니다. 메서드는 q와 cm 회전을 담은 새 스트림을 /Contents 앞에 놓고, Q를 담은 스트림을 뒤에 놓은 다음, 페이지 딕셔너리 자체에 /Rotate 0을 기록합니다
| 실효 /Rotate | 접두 스트림 | 새 MediaBox |
|---|---|---|
| 90 | q 0 -1 1 0 -Bottom Width+Left cm | [0 0 Height Width] |
| 180 | q -1 0 0 -1 Width+Left Height+Bottom cm | [0 0 Width Height] |
| 270 | q 0 1 -1 0 Height+Bottom -Left cm | [0 0 Height Width] |
명시적 0은 보이는 것보다 중요합니다. /Rotate 키를 지우는 편이 더 깔끔해 보이고, 90이 /Pages 노드에서 온 모든 페이지를 깨뜨립니다. 페이지가 회전을 다시 상속하고 뷰어는 이미 똑바로 선 콘텐츠를 돌립니다. 페이지 딕셔너리의 /Rotate 0은 그 상속을 막으므로, 기록해도 안전한 유일한 값입니다
var
Pdf: THotPDF;
Info: THPDFRotationFlattenInfo;
Flattened: Integer;
begin
Pdf := THotPDF.Create(nil);
try
if Pdf.LoadFromFile('scanned-batch.pdf') > 0 then
begin
// '' = 모든 페이지. 이미 0도인 페이지는 세어지지만 손대지 않습니다
Flattened := Pdf.FlattenLoadedPageRotation('', Info);
Writeln(Format('Scanned %d, flattened %d pages',
[Info.ScannedPageCount, Info.FlattenedPageCount]));
Writeln(Format('Turned %d annotations, %d destinations, %d tagged geometry entries',
[Info.TransformedAnnotationCount, Info.TransformedDestinationCount,
Info.TransformedStructureGeometryCount]));
if Flattened > 0 then
Pdf.SaveLoadedDocument('scanned-batch-upright.pdf');
end;
finally
Pdf.Free;
end;
end;
THPDFRotationFlattenInfo 레코드는 버리지 말고 기록하세요. ScannedPageCount는 범위 안의 페이지 수, FlattenedPageCount는 반환값과 일치하고, 세 Transformed... 카운터는 링크나 북마크, 태그 지오메트리가 돌아간 페이지를 향했는지 보여 줍니다. 스캐너 배치에서 목적지 0은 정상입니다. 스캐너는 애초에 링크를 거의 쓰지 않으니까요. 그림 경계 상자를 실어 다닐 줄 아는 파일이 구조 지오메트리 0을 보고한다면 손으로 열어 볼 하나입니다
쓰기 전에 모든 페이지 박스를 읽는다
평탄화는 페이지가 이미 갖고 있는 박스만 재작성하고, 첫 박스를 쓰기 전에 전부 읽습니다. 순서가 중요한 이유는 §14.11.2의 기본 사슬 때문입니다. 페이지에 /CropBox가 없으면 GetLoadedPageBox(PageIndex, pbCropBox, ...)가 MediaBox를 돌려주고, /BleedBox, /TrimBox, /ArtBox는 CropBox로 폴백합니다. 읽고, 돌리고, 쓰기를 한 박스씩 도는 루프는 그 사슬에 정면으로 뛰어듭니다. MediaBox를 돌려 저장하고, 'CropBox'를 읽는데 갓 돌아간 MediaBox가 돌아오고, 한 번 더 돌려 페이지가 가진 적 없는 CropBox를 쓰는 거죠. Letter 페이지에서 그 두 번째 회전은 [0 -180 612 612]를 내놓고, 새 MediaBox로 클립되면 보이는 페이지는 612 x 612 정사각형으로 줄어듭니다
상속은 다섯 박스를 두 무리로 가릅니다. MediaBox와 CropBox는 /Parent 사슬을 따라 찾고, BleedBox, TrimBox, ArtBox는 페이지 딕셔너리 자체에 앉아 있을 때만 불니다. FlattenLoadedPageRotation은 어떤 박스가 존재하는지 판단할 때 같은 구분을 따릅니다. 상속된 CropBox는 돌려서 페이지에 기록하고, /Pages 노드에 떨어진 /TrimBox는 없는 것으로 취급해 아래로 복사하지 않습니다
procedure DumpPageGeometry(Pdf: THotPDF; PageIndex: Integer);
var
L, B, R, T: Single;
begin
Writeln('Effective /Rotate: ', Pdf.GetLoadedPageRotation(PageIndex));
if Pdf.GetLoadedPageBox(PageIndex, pbMediaBox, L, B, R, T) then
Writeln(Format('MediaBox [%g %g %g %g]', [L, B, R, T]));
// /TrimBox 키가 없어도 True입니다. 값은 CropBox, 그다음 MediaBox로 폴백합니다
if Pdf.GetLoadedPageBox(PageIndex, pbTrimBox, L, B, R, T) then
Writeln(Format('TrimBox [%g %g %g %g]', [L, B, R, T]));
// Letter 사전 설정. GetLoadedPageVisibleBox는 실패 시 출력을 그대로 둡니다
L := 0; B := 0; R := 612; T := 792;
Pdf.GetLoadedPageVisibleBox(PageIndex, L, B, R, T);
Writeln(Format('Visible [%g %g %g %g]', [L, B, R, T]));
end;
그 헬퍼를 평탄화 전후로 돌려 보세요. MediaBox [0 0 612 792]인 90도 페이지에서 평탄화된 MediaBox는 [0 0 792 612]로 읽힙니다. 재작성된 모든 박스는 원본 MediaBox 원점 기준의 같은 시계 방향 회전을 통과하므로 새 MediaBox는 언제나 0,0에서 시작하고, [18 18 594 774]의 TrimBox는 [18 18 774 594]가 됩니다. 가로 페이지의 모든 가장자리에서 여전히 18포인트 안쪽이죠
GetLoadedPageVisibleBox는 뷰어가 표시하고 프린터가 인쇄하는 영역, 즉 MediaBox로 클립되고 Left가 Right보다, Bottom이 Top보다 작게 정규화된 CropBox를 반환합니다. 페이지 렌더러와 SVG 내보내기는 그 같은 박스로 출력 크기를 정합니다. 사람이 실제로 보는 크기를 원하는 코드는 GetLoadedPageVisibleBox를 불러야 합니다. 그 목적으로 /MediaBox를 읽으면 CropBox가 있는 모든 페이지에서 엉뚱한 답이 나옵니다
/Rect만 돌리면 주석은 왜 깨질까?
주석이 깨지는 이유는 외관 스트림이 결코 /Rect로 곧장 그려지지 않기 때문입니다. §12.5.5 아래에서 뷰어는 먼저 폼의 /BBox를 /Matrix로 변환한 다음, 결과의 경계 상자를 /Rect로 스케일하고 평행 이동합니다. /Rect만 돌리면 200 x 40 스탬프가 40 x 200 슬롯으로 짜부라져 아무도 읽지 못합니다. 그래서 FlattenLoadedPageRotation은 페이지의 시계 방향 회전을 각 외관 /Matrix에 오른쪽 곱합니다(행 벡터 관례에서 90도는 [0 -1 1 0 0 0]). /N, /R, /D 외관과 그 안의 모든 상태에 걸쳐서요. 하나의 외관 스트림이 여러 주석이나 상태를 섬길 수 있으므로 각 스트림은 호출당 정확히 한 번 돌고, 회전이 다른 페이지들이 공유하는 스트림은 먼저 닿은 페이지의 회전을 받습니다
두 개의 작은 규칙이 양식 필드와 스티키 노트를 제자리에 지켜 줍니다. 위젯의 /MK /R 항목(§12.5.6.19)은 반시계 방향 각도이므로 페이지의 시계 방향 각도를 360 모듈로로 뺍니다. 두면 다음 외관 재생성이 필드 텍스트를 엉뚱 방향으로 그립니다. NoRotate 플래그(비트 위치 5, 값 16, §12.5.3)를 가진 주석은 돌아간 페이지 위에서도 똑바로 서고 /Rect의 왼쪽 위 구석을 축으로 돕니다. 이들에 대해 메서드는 폭과 높이, 똑바로 선 외관을 유지하고 그 구석만 회전이 놓는 자리로 옮깁니다
주석 딕셔너리 너머로 같은 호출은 /QuadPoints, /Vertices, /L, /InkList를 돌립니다. 페이지를 이름 대는 명시적 목적지를 재작성합니다. /XYZ 점과 /FitR 직사각형은 회전을 통해 매핑되고, 90도나 270도에서는 /FitH와 /FitBH가 /FitV와 /FitBV로, 그 반대로 바뀝니다(§12.3.2.2). /Pg가 그 페이지인 구조 요소의 속성 /BBox 항목 같은 태그 지오메트리도 변환합니다
구조 트리는 단순한 순회가 불쾌하게 어긋나는 자리입니다. 구조 요소의 /Pg는 페이지 객체를 되가리키므로, '이건 페이지 소속이다'를 모든 키 아래로 끌고 다니는 순회자는 /Pg를 따라 페이지로, /Annots로 — 주석 직사각형을 두 번째로 돌리며 — 그리고 /BBox가 폼 공간에 살고 바깥 cm이 이미 커버하는 Form XObject로 들어갑니다. /P를 따르면 트리 루트로 올라가 다른 페이지의 요소를 끌어들입니다. 이것이 발화하는지는 객체가 방문되는 우연한 순서에 달려 있습니다. 카탈로그에서 /Pages가 /StructTreeRoot보다 앞서면 페이지가 먼저 닿는 경향이 있고 피해는 숨어서, 평범한 테스트 파일이 통과할 수 있습니다. FlattenLoadedPageRotation은 페이지 문맥을 /K(자식)과 /A(속성)로만 실어 나르고, 다른 페이지의 자체 /Pg를 가진 자식은 그 페이지에 맡깁니다
배출 전에 결과 검증하기
평탄화된 페이지는 뷰어에서 동일하게 보여야 하고, 유용한 검사는 동일하지 않을 때 알아차려 주는 검사입니다. 검증 방식을 빚는 몇 가지 동작이 있습니다
- 실효 회전이 이미 0이거나 MediaBox가 없거나 폭이나 높이가 0인 페이지는 예외 없이 건너뛰어지므로, 반환값을 바뀌리라 기대한 개수와 비교하세요
- 페이지 리소스가 참조하는 Form XObject는 자기
/BBox와/Matrix를 유지합니다. 바깥cm이 이미 그리는 모든 것을 돌리기 때문입니다 - 목적지는 평탄화된 페이지마다 모든 간접 객체를 한 번씩 걸어 찾습니다. 회전 페이지가 수백인 큰 파일이라면 페이지마다 그 순회 비용을 예산에 넣으세요
RenderLoadedPageToBitmap은 페이지 콘텐츠 스트림만 그리고 주석은 빼므로, 돌아간 스탬프의 시각 검증에는 문서 스크래치 복사본에서FlattenLoadedAnnotations가 먼저 필요합니다
값을 해 주는 테스트 페이지는 표시되는 페이지의 왼쪽 위 채운 정사각형처럼 한 구석에 비대칭인 무언가를 갖습니다. 평탄화 전과 후에 렌더링한 뒤 그 마커 주변 픽셀을 비교하세요. 폭과 높이만은 거울 반사 페이지에서도 똑같이 기분 좋게 일치합니다
// 스크래치 복사본에서만: FlattenLoadedAnnotations는 주석을
// 페이지 콘텐츠에 굽고 페이지에서 제거합니다
Pdf.FlattenLoadedAnnotations('1'); // 1 기반 페이지 범위
Before := Pdf.RenderLoadedPageToBitmap(0, 96); // 0 기반 페이지 인덱스
if Before = nil then
raise Exception.Create('Page 1 did not render');
try
Pdf.FlattenLoadedPageRotation('1', Info);
After := Pdf.RenderLoadedPageToBitmap(0, 96);
if After = nil then
raise Exception.Create('Flattened page 1 did not render');
try
// 라이브러리 호출이 아닌 자체 검사. 크기가 일치해야 하고...
Assert((Before.Width = After.Width) and (Before.Height = After.Height));
// ...왼쪽 위 모서리의 마커 픽셀도 일치해야 합니다
Assert(Before.Canvas.Pixels[8, 8] = After.Canvas.Pixels[8, 8]);
finally
After.Free;
end;
finally
Before.Free;
end;
돌아간 페이지의 스탬프에 아직 외관 스트림이 없다면 평탄화 전에 주석 외관 합성하기가 그 단계를 다룹니다. 구석 비교 뒤의 렌더러는 로드된 PDF 페이지를 비트맵으로 렌더링하기에 설명돼 있고, 로드된 PDF의 리댁션과 N-up 스티칭은 원본을 재인코딩하지 않고 /Contents에 스트림을 더한다는 같은 생각에 기댑니다. FlattenLoadedPageRotation, GetLoadedPageBox, GetLoadedPageVisibleBox는 Delphi와 C++Builder용 HotPDF에 실려 나갑니다. 자세한 것은 HotPDF Delphi PDF 컴포넌트 페이지에 있습니다