Delphi PDF 라이브러리인 PDFlibPas에서 MovePage로 옮겨진 페이지는 예전 Pages 노드에서 물려받은 MediaBox, CropBox, Resources 값의 자기 사본을 얻고, 간접 참조는 참조로 남습니다. 옮겨진 페이지에게 예전 Pages 노드가 쥔 바로 그 객체들을 주는 것이 자명한 구현이고, 그것은 옮겨진 페이지의 이후 SetPageBox나 DrawText가 그 노드와 여전히 그것을 물려받는 모든 형제를 조용히 다시 쓴다는 뜻입니다. 공유가 아니라 복사라는 같은 규칙이 관련된 두 경로도 커버합니다. 여러 페이지가 공유하는 간접 박스에 대한 SetPageBox, 그리고 소스 문서의 페이지들에 물려받은 값을 구체화하는 CopyPageRanges입니다
이런 앨리어싱의 증상은 객체 동일성을 언급하지 않습니다. "7페이지를 크롭했는데 8~12페이지도 같이 크롭됐다", "CropBox를 좁혔는데 MediaBox가 따라 움직였다", 가장 혼란스러운 것은 "한 페이지를 새 문서로 복사했는데 원본 파일이 바뀌었다" 같은 식입니다. 아무것도 크래시하지 않고, 아무것도 누수하지 않고, 저장된 파일은 완벽히 유효한 PDF입니다. 다만 아무도 요청하지 않은 지오메트리를 담고 있을 뿐입니다
한 페이지의 SetPageBox가 어떻게 형제들의 크기를 바꾸나?
두 페이지 트리 항목이 하나의 인메모리 배열을 가리키고 SetPageBox가 그 대상 배열을 제자리에서 편집할 때 일어납니다. 같은 인스턴스를 쥔 모든 페이지나 Pages 노드가 편집을 봅니다. 페이지 트리 편집기의 세 코드 경로가 그 공유를 만들어 낼 수 있습니다:
MovePage는 부모에서 떼어내기 전에 페이지에 물려받을 속성들을 구체화합니다. 조상의 자기 객체들(사본이 아니라)을 붙이면 옮겨진 페이지와 예전 형제들이 박스 배열과 Resources 딕셔너리를 공유합니다- 간접 참조를 따라 참조된 배열을 편집하는 박스 작성기는
/MediaBox 11 0 R객체 하나를 가리키는 모든 페이지의 크기를 단 한 번의 호출로 바꿉니다.MovePage가 관여했는지와 무관합니다 CopyPageRanges는 소스 페이지를 대상 문서로 복제하기 전에 그 페이지에 물려받은 값을 구체화합니다. Pages 노드 인스턴스들을 소스 페이지에 붙이고, MediaBox 인스턴스 자체를 기본 CropBox로 붙이면 그 전부가 한데 묶입니다
구체화 자체는 선택 사항이 아닙니다. /Resources만 넘기면 다른 부모 아래로 옮겨진 페이지가 조용히 그 부모의 크기와 회전을 뒤집어쓰므로, MovePage는 MediaBox, CropBox, Rotate도 함께 나릅니다. 페이지를 재정렬하는 CollateDocumentsEx가 의존하는 바로 그것입니다. 유일한 질문은 그 값들이 사본으로 오는지 공유 인스턴스로 오는지입니다
직접 값, 간접 참조, 페이지 속성 상속
물려받은 페이지 속성의 올바른 복사는 직접 값을 복제하고 간접 참조는 참조로 유지합니다. 그것이 ISO 32000-1 자신이 긋는 구분이기 때문입니다. 딕셔너리 안에 쓰인 [0 0 400 300] 같은 직접 객체는 그 딕셔너리만의 것입니다. 11 0 obj로 한 번 정의되고 11 0 R로 인용되는 간접 객체는 설계상 공유됩니다. ISO 32000-1 §7.3.10이 파일의 어디에서든 주소 지정 가능하게 만들고, 모든 11 0 R이 같은 객체를 의미합니다
페이지 속성 상속, ISO 32000-1 §7.7.3.4는 세 번째 사례를 얹습니다. Resources, MediaBox, CropBox, Rotate는 Pages 노드에 앉아 자신의 것을 정의하지 않는 모든 자손 페이지에 적용될 수 있습니다. 페이지는 값을 쥐지 않고 /Parent를 통해 값을 찾아봅니다. 페이지가 부모를 바꾸는 순간 그 룩업 사슬은 끊기므로, MovePage와 BalancePageTree가 먼저 유효 값들을 페이지 자신에게 써야 하는 이유입니다. 질문은 오직 어떻게 쓰느냐입니다
객체 풀이 실수를 감추는 이유
PDFlibPas에서 파싱되거나 만들어진 모든 PDF 객체는 문서의 TPDFStructure 풀이 소유하고, 딕셔너리와 배열은 자기 항목에 대해 맨 포인터를 저장합니다. TPDFDictionary.Add는 포인터만 기록합니다. 따라서 하나의 인스턴스를 두 부모 컨테이너에 추가하는 것은 런타임이 검사할 수 있는 모든 수준에서 합법입니다. 해체 시 이중 해제도 없고, 잘못될 참조 카운트도 없으며, 예외도 없습니다. 직렬화도 똑같이 관대합니다. 각 컨테이너가 공유 인스턴스의 현재 값을 인라인으로 기록하므로, 편집 전 출력은 올바른 복사가 만들 것과 바이트 단위로 동일합니다
앨리어싱은 누군가 공유 인스턴스를 제자리에서 변이할 때만 모습을 드러냅니다. SetPageBox는 기존 배열 위의 사각형 래퍼를 통해 정확히 그것을 하고, 페이지에 그리는 것은 폰트나 이미지가 등록될 때 Resources 딕셔너리에 대해 그것을 합니다. 편집은 조용히, 그 포인터를 쥔 다른 모든 컨테이너에 떨어집니다
PDFlibPas가 공유 대신 복사하는 방법
PDFlibPas는 양쪽 끝에서 문제를 다룹니다. 구체화는 사본을 붙이고, 박스 기록은 페이지가 소유한 배열만 편집합니다. 각 규칙이 상대가 커버하지 못하는 사례를 맡습니다
구체화 헬퍼 PLInheritPageAttributes는 Value 자신이 아니라 Page.Owner.Decode(Value.Output)를 붙입니다. 직렬화기를 거쳐 왕복하는 것은 무뚝뚝하지만 정확한 방법으로 PDF 의미론을 공짜로 얻는 길입니다. 직접 배열이나 딕셔너리는 리터럴 텍스트로 직렬화되어 새롭고 독립적인 인스턴스로 디코딩됩니다. 간접 참조는 11 0 R로 직렬화되어 같은 객체 11을 가리키는 새 참조 객체로 디코딩되므로, 페이지는 인라인화된 사본을 받는 대신 여전히 공유 객체를 참조합니다. 사본은 직접 구조만큼만 깊습니다. 복사된 딕셔너리 안의 참조를 통해 닿는 것은 파일 형식이 의도한 대로 공유로 남습니다. BalancePageTree는 부모를 바꾸는 모든 페이지에 같은 헬퍼를 호출하므로, 거기서 구체화된 페이지들도 별개의 인스턴스를 얻습니다
복사만으로는 부족합니다. 참조 사례는 여전히 공유 객체를 가리키기 때문입니다. SetPageBox가 그 참조를 따라 객체 11을 편집하면 옮겨진 페이지는 다시 예전 부모와 그 다른 자식들의 크기를 바꿉니다. 그래서 박스 작성기는 copy-on-write를 적용합니다. 페이지 자신의 항목이 직접 배열일 때만 제자리에서 편집하고, 간접이거나 없는 박스는 새 직접 배열로 대체합니다. 객체 11은 그것을 인용하는 다른 모든 페이지를 위해 손대지 않은 채 남습니다
| 코드 경로 | 인스턴스 공유(함정) | PDFlibPas |
|---|---|---|
MovePage 구체화 | 페이지가 조상 자신의 직접 인스턴스를 쥠 | 페이지가 디코딩된 사본을 쥠. 참조는 참조로 유지 |
SetPageBox | 참조를 따라 공유 배열을 편집 | 페이지의 직접 배열만 편집하고, 그 외에는 새 배열을 기록 |
CopyPageRanges 소스 페이지 | Pages 노드 박스를 공유. CropBox가 MediaBox 인스턴스 | 소스 페이지에 구체화된 모든 값이 사본 |
| 페이지 리소스 복제 시의 기본 박스 | CropBox, BleedBox, TrimBox, ArtBox가 하나의 배열을 공유 | 기본 박스마다 자기 배열을 얻음 |
마지막 행이 미묘한 곳입니다. 라이브러리가 페이지 캡처나 병합을 위해 페이지의 리소스를 복제할 때 누락된 CropBox, BleedBox, TrimBox, ArtBox 항목을 채워 넣는데, 넷을 하나의 배열 인스턴스에서 채우면 그중 하나를 편집하는 첫 호출자를 기다리는 앨리어스가 남습니다. 그 기본 박스 값들이 어떻게 고르는지는 별개의 주제이며 TrimBox, BleedBox, CropBox 기본값에 관한 PDFlibPas 안내에서 다룹니다
손으로 만든 PDF로 MovePage 앨리어싱 재현하기
페이지 트리 편집 코드의 앨리어싱을 시험하는 가장 빠른 길은 LoadFromString으로 로드하는 작은 손작성 PDF입니다. 모든 객체 번호를 미리 알 수 있습니다. 아래 헬퍼는 정확히 계산된 바이트 오프셋으로 고전적인 교차 참조 테이블을 쓰므로, 테스트는 손상된 파일에 대한 파서의 복구 동작에 의존하지 않습니다
uses
System.SysUtils, PDFlibrary;
function BuildPdf(const Objects: array of AnsiString): AnsiString;
var
Offsets: array of Integer;
I, XRefPos: Integer;
begin
Result := '%PDF-1.4'#10;
SetLength(Offsets, Length(Objects));
for I := 0 to High(Objects) do
begin
Offsets[I] := Length(Result); // "N 0 obj"의 0 기반 바이트 오프셋
Result := Result + AnsiString(IntToStr(I + 1)) + ' 0 obj'#10 +
Objects[I] + #10'endobj'#10;
end;
XRefPos := Length(Result);
Result := Result + 'xref'#10'0 ' + AnsiString(IntToStr(Length(Objects) + 1)) +
#10'0000000000 65535 f '#10;
for I := 0 to High(Offsets) do // 각 항목은 정확히 20바이트
Result := Result + AnsiString(Format('%.10d 00000 n ', [Offsets[I]])) + #10;
Result := Result + 'trailer'#10'<< /Size ' +
AnsiString(IntToStr(Length(Objects) + 1)) + ' /Root 1 0 R >>'#10 +
'startxref'#10 + AnsiString(IntToStr(XRefPos)) + #10'%%EOF'#10;
end;
function StreamObj(const Content: AnsiString): AnsiString;
begin
Result := '<< /Length ' + AnsiString(IntToStr(Length(Content))) +
' >>'#10'stream'#10 + Content + #10'endstream';
end;
테스트 문서에는 중간 Pages 노드가 둘 있습니다. 노드 3은 간접 MediaBox(객체 11, 400×300 포인트)와 직접 CropBox, 직접 Resources 딕셔너리를 지니고 두 페이지를 소유합니다. 노드 4는 Letter 크기 MediaBox를 지니고 세 번째 페이지를 소유합니다. 페이지 1을 위치 3으로 옮기는 것은 노드 4 아래로 부모를 바꾸는 것인데, 정확히 구체화가 필요한 이동입니다. 없으면 페이지는 Letter 페이지로 변합니다
procedure Check(Condition: Boolean; const Msg: string);
begin
if not Condition then
raise Exception.Create(Msg);
end;
procedure CheckMovedPageIsIsolated;
var
Lib: TPDFlib;
FontID: Integer;
begin
Lib := TPDFlib.Create;
try
Check(Lib.LoadFromString(BuildPdf([
'<< /Type /Catalog /Pages 2 0 R >>',
'<< /Type /Pages /Kids [3 0 R 4 0 R] /Count 3 >>',
'<< /Type /Pages /Parent 2 0 R /Kids [5 0 R 6 0 R] /Count 2 ' +
'/MediaBox 11 0 R /CropBox [10 20 390 280] /Resources << >> >>',
'<< /Type /Pages /Parent 2 0 R /Kids [7 0 R] /Count 1 ' +
'/MediaBox [0 0 612 792] >>',
'<< /Type /Page /Parent 3 0 R /Contents 8 0 R >>',
'<< /Type /Page /Parent 3 0 R /Contents 9 0 R >>',
'<< /Type /Page /Parent 4 0 R /Contents 10 0 R >>',
StreamObj('1 w'), StreamObj('2 w'), StreamObj('3 w'),
'[0 0 400 300]']), '') = 1, 'load failed');
Lib.SelectPage(1);
Check(Lib.MovePage(3) = 1, 'MovePage failed');
Lib.SelectPage(3); // 방금 옮긴 페이지
Check(Abs(Lib.GetPageBox(1, 2) - 400) < 0.001, 'inherited MediaBox lost');
Lib.SetPageBox(1, 0, 200, 200, 200); // MediaBox 200 x 200
Lib.SetPageBox(2, 0, 100, 100, 100); // CropBox 100 x 100
FontID := Lib.AddStandardFont(4); // Helvetica
Lib.SelectFont(FontID);
Lib.SetTextSize(12);
Lib.DrawText(20, 20, 'MOVED');
// 다른 페이지를 선택하기 전에 예전 부모를 검사한다(아래 참조)
Check(Pos(AnsiString('/Font'), Lib.GetObjectToString(3)) = 0,
'font registered in the old Pages node');
Lib.SelectPage(1); // 예전 페이지 2, 여전히 노드 3 아래
Check(Abs(Lib.GetPageBox(1, 2) - 400) < 0.001, 'sibling MediaBox changed');
Check(Abs(Lib.GetPageBox(2, 2) - 380) < 0.001, 'sibling CropBox changed');
Check(Pos(AnsiString('400'), Lib.GetObjectToString(11)) > 0,
'shared object 11 was rewritten');
finally
Lib.Free;
end;
end;
GetPageBox(BoxType, Dimension)은 MediaBox에 상자 타입 1, CropBox에 2를, 폭에 dimension 2를 받습니다. 기본 왼쪽 아래 원점에서 SetPageBox(1, 0, 200, 200, 200)은 왼쪽 0, 위 200, 폭 200, 높이 200을 의미합니다. 인스턴스를 공유하는 구체화기 아래에서는 형제 검사들이 실패합니다. CropBox 편집이 노드 3의 직접 배열에 떨어지고, 참조를 따라가는 박스 작성기는 객체 11을 다시 씁니다
CopyPageRanges는 소스 문서를 바꾸나?
CopyPageRanges는 소스 페이지에 기록하기는 하지만 기록하는 모든 값이 별개의 사본이므로, 이후의 소스 편집은 여러분이 편집하는 페이지에만 머뭅니다. 기록 자체는 의도된 것입니다. 소스 페이지는 그 딕셔너리가 대상으로 복제되기 전에 명시적인 MediaBox, CropBox, Rotate, Resources가 필요합니다. 그렇지 않으면 사본은 물려받은 모든 것을 잃습니다. 페이지의 재번호 매기기와 대상으로의 복사는 PDFlibPas의 문서 간 객체 딥 카피에서 다룹니다. 함정은 소스 쪽에 있습니다. 대부분의 사람은 복사가 소스를 읽기만 한다고 가정합니다
저장 출력에는 절대 드러나지 않습니다. 공유든 복사든 구체화된 값은 동일하게 직렬화되므로, 어느 쪽이든 두 문서는 바이트 단위로 같게 저장됩니다. 복사 뒤의 소스 문서 편집만이 앨리어스를 드러냅니다:
procedure CheckSourceSurvivesCopy;
var
Lib: TPDFlib;
SourceID, TargetID: Integer;
begin
Lib := TPDFlib.Create;
try
Check(Lib.LoadFromString(BuildPdf([
'<< /Type /Catalog /Pages 2 0 R >>',
'<< /Type /Pages /Kids [3 0 R 4 0 R] /Count 2 ' +
'/MediaBox [0 0 400 300] /Resources << >> >>',
'<< /Type /Page /Parent 2 0 R /Contents 5 0 R >>',
'<< /Type /Page /Parent 2 0 R /Contents 6 0 R >>',
StreamObj('1 w'), StreamObj('2 w')]), '') = 1, 'load failed');
SourceID := Lib.SelectedDocument;
TargetID := Lib.NewDocument; // 선택된 문서가 된다
Check(Lib.CopyPageRanges(SourceID, '1') = 1, 'copy failed');
Lib.SelectDocument(SourceID);
Lib.SelectPage(1);
Lib.SetPageBox(2, 50, 250, 100, 100); // CropBox만 좁힌다
Check(Abs(Lib.GetPageBox(1, 2) - 400) < 0.001, 'MediaBox followed CropBox');
Lib.SetPageBox(1, 0, 200, 200, 200);
Lib.SelectPage(2);
Check(Abs(Lib.GetPageBox(1, 2) - 400) < 0.001, 'sibling page resized');
Lib.SelectDocument(TargetID); // 사본은 원래 크기를 유지한다
Lib.SelectPage(Lib.PageCount);
Check(Abs(Lib.GetPageBox(1, 2) - 400) < 0.001, 'copied page resized');
finally
Lib.Free;
end;
end;
여기서 두 페이지 모두 루트 노드의 직접 MediaBox를 물려받습니다. 그 인스턴스를 소스 페이지 1에 붙이고 다시 페이지 1의 CropBox로 붙이는 복사 단계는, CropBox를 좁히는 것이 MediaBox를 좁히고 MediaBox의 크기를 바꾸는 것이 루트 노드를 통해 페이지 2의 크기를 바꾸게 만듭니다. 페이지를 복사해 내고 그 뒤에도 소스를 계속 편집하는 워크플로, 원본을 다듬기 전에 양면 스캔을 하나의 PDF로 콜레이트하는 워크플로에서 이런 앨리어스가 모습을 드러냅니다
인스턴스 앨리어싱은 왜 테스트하기 어려운가?
인스턴스 앨리어싱이 테스트하기 어려운 이유는 관찰 가능한 효과가 특정 순서의 세 단계를 필요로 하기 때문입니다. 앨리어스를 만들고, 한쪽을 변이하고, 다른 무엇도 그것을 건드리기 전에 반대편을 검사합니다. 대부분의 테스트는 첫 단계만 하고 저장 출력을 비교하는데, 앨리어스가 있든 없든 그것은 동일합니다
PDFlibPas에서의 순서 함정은 SelectPage입니다. 페이지를 선택하면 SelectFont를 통해 현재 폰트가 재적용되는데, 그것이 그 폰트를 페이지의 리소스에 등록합니다. 자체 /Resources가 없는 페이지는 부모의 딕셔너리로 해석되므로, 그런 페이지를 단순히 선택하는 것만으로 Pages 노드에 /Font가 합법적으로 추가됩니다. 위의 MovePage 테스트에서 예전 페이지 2를 선택하면 노드 3에 Helvetica 항목이 추가되는데, 이는 올바른 동작이지 누수가 아닙니다. 그래서 GetObjectToString(3) 검사가 SelectPage(1)보다 먼저 돕니다. 둘을 바꾸면 앨리어스가 전혀 없어도 테스트는 실패합니다
이 규칙은 PDFlibPas가 의도적으로 손대지 않는 것도 표시합니다. Resources 딕셔너리를 물려받는 페이지에 리소스를 기록하면 조상의 딕셔너리에 기록되고 모든 형제가 새 항목을 봅니다. 그것은 규격대로 동작하는 상속이지 인스턴스 공유가 아니며, 공유 딕셔너리에 폰트나 이미지 이름을 추가하는 것이 다른 페이지의 렌더링 방식을 바꾸지 않으므로 무해합니다. 페이지가 상속을 멈추게 하려면 먼저 자체 Resources 딕셔너리를 주십시오
PDF 객체 모델 코드를 위한 체크리스트
교훈은 Delphi든 다른 곳이든, 풀과 포인터 컨테이너 위에 세워진 모든 PDF 객체 모델에 일반화됩니다:
- ISO 32000-1 §7.7.3.4대로 물려받은 속성을 구체화할 때는 직접 값을 딥 카피하고 간접 참조는 같은 객체를 가리키는 새 참조로 유지합니다
- 공유가 의도되고 문서화된 것이 아니라면 기존 인스턴스를 두 번째 컨테이너에
Add하지 마십시오. 풀에 의한 소유는 런타임이 결코 불평하지 않는다는 뜻입니다 - 현재 노드가 직접 객체로 소유한 것만 제자리에서 편집합니다. 간접이거나 물려받은 값은 새로운 직접 객체로 대체합니다(copy-on-write)
- MediaBox에서 나온 CropBox처럼 다른 항목에서 유도된 기본값은 자기 인스턴스가 필요합니다
- 앨리어싱은 반대편 보유자에 대한 변이 후 검사 순서로 시험하고, 그 사이에 합법적으로 기록할지도 모르는 호출의 순서도 검사합니다
- 저장 출력 비교는 여기서 아무것도 증명하지 못합니다. 공유된 값과 복사된 값은 첫 편집까지 직렬화가 동일합니다
PDFlibPas는 페이지 트리 편집, 문서 간 복사, 페이지 박스 제어를 Delphi, C++Builder, Free Pascal을 위한 하나의 TPDFlib 클래스로 노출합니다. 에디션, 플랫폼, 전체 API 레퍼런스는 PDFlibPas Delphi PDF 라이브러리 제품 페이지를 보십시오