2004년에 스캔한 계약서는 %PDF-1.3으로 시작하는데, 임베디드 OpenType 폰트와 16비트 사진을 실은 브로슈어 페이지 둘을 무식하게 병합한 뒤에도 pdfinfo는 여전히 PDF 1.3을 보고합니다. 필요한 버전은 추가된 revision의 catalog에 /Version /1.6으로 들어가며, ISO 32000-1 §7.5.6이 이를 허용하고 HotPDF page import가 복사하는 객체들에서 이를 기록합니다
증분 저장은 왜 %PDF-1.3을 다시 쓰지 못하는가
오래된 바이트들이 새 파일의 접두사로 남기 때문입니다. 증분 update는 마지막 %%EOF 뒤에 새 body와 새 cross-reference section, 새 trailer를 덧붙이고 그 이전의 모든 바이트는 건드리지 않습니다. 서명 검증기가 그에 의존합니다. 기존 서명의 /ByteRange가 오래된 header를 덮으니까요. revision diff 도구는 더 나아가 "원본 파일이 새 파일의 접두사다"를 증분 저장의 정의로 삼습니다. 오프셋 0의 여덟 바이트를 고치면 모든 cross-reference 오프셋은 여전히 유효하지만 접두사는 깨집니다. 스펙은 이를 예견했습니다. PDF 1.4부터 writer는 catalog의 Version 항목으로 header를 겹어 쓸 수 있고, §7.5.6 NOTE 4는 증분 update 중에 버전이 바뀔 수 있도록 그 항목이 존재한다고 말합니다. 표 28이 읽기 규칙을 더합니다. 값은 name 객체(/1.6, 숫자 1.6이 아님)이며, header보다 나중일 때만 적용됩니다. header가 더 나중이거나 항목이 없으면 header가 이깁니다. 유효 버전은 둘 중 큰 쪽입니다. 파일의 첫 줄만 검사하는 reader는 증분으로 업그레이드된 모든 문서를 과소 보고합니다
필요 버전을 올리는 복사 객체들
필요 버전은 기능에서 나오며, 소스 파일의 header에서 나오는 것이 아닙니다. THPDFHeadlessDocument.AppendImportedPages는 클론하는 페이지 딕셔너리와 리소스를 훑으면서 복사된 non-null 항목이 요구하는 가장 높은 버전을 기록합니다. 태그는 기능 검사와 함께 정확한 PDF 버전으로 저장하기에서 쓰는 것들과 같습니다. 다만 여기서는 위로 올라가 선언된 레벨을 올립니다. 각 행은 import가 적용하는 검사 하나와 ISO 32000-1이 항목 옆에 적어 둔 버전을 짝지어 놓았습니다:
| 복사되는 내용 | 필요 버전 | 스펙이 말하는 곳 |
|---|---|---|
투명성 group, soft mask(/SMask) 또는 transparent ExtGState 매개변수 | PDF 1.4 | 투명성 모델, §11 |
XMP metadata stream(/Type /Metadata /Subtype /XML) | PDF 1.4 | §14.3.2 |
JBIG2Decode로 압축된 이미지 데이터 | PDF 1.4 | §7.4.7 |
JPXDecode로 압축된 이미지 데이터 | PDF 1.5 | §7.4.9 |
| 16비트 이미지, 이미지 XObject든 content stream 안의 inline 이미지든 | PDF 1.5 | Table 89, §8.9.7 |
non-null /PresSteps, 또는 Fly, Push, Cover, Uncover, Fade 스타일의 /Trans, 또는 /SS나 /B를 지닌 것 | PDF 1.5 | Table 30, Table 162 |
| 페이지와 함께 따라오는 optional content | PDF 1.5 | §8.11 |
/Subtype /OpenType인 /FontFile3 | PDF 1.6 | Table 126 |
페이지 /UserUnit, 잠긴 레이어, 또는 OCMD visibility expression /VE | PDF 1.6 | Table 30, §8.11 |
Dissolve, Wipe, Split 같은 오래된 transition 스타일은 PDF 1.1부터 있었고 아무것도 올리지 않으므로, import는 transition 딕셔너리의 /S 값을 읽습니다. /Trans가 존재한다는 것만으로는 아무것도 증명되지 않습니다. 기록은 훑기가 끝난 뒤에 옵니다. 필요 버전이 존재하고 그것이 대상의 header 버전과 catalog가 이미 지닌 임의의 /Version보다 모두 클 때 새 revision에 /Version 이름이 들어가고, 그렇지 않으면 catalog는 /Version 항목을 얻지 못합니다. header는 결코 편집되지 않습니다. §7.5.6의 같은 단락은 update가 developer extension을 더하거나 뺄 때 writer가 catalog의 /Extensions 딕셔너리를 갱신하길 요청합니다. Page import는 페이지 수준 객체만 복사하므로 /Extensions는 대상이 지닌 그대로 남습니다
uses
SysUtils, HPDFHeadlessDocument;
procedure AppendBrochurePages(const ContractFile, BrochureFile, OutputFile: string);
var
Target, Source: THPDFHeadlessDocument;
Options: THPDFHeadlessPageImportOptions;
Outcome: THPDFHeadlessPageImportResult;
begin
Target := THPDFHeadlessDocument.Create;
Source := THPDFHeadlessDocument.Create;
try
Target.LoadFromFile(ContractFile); // header: %PDF-1.3
Source.LoadFromFile(BrochureFile); // PDF 1.7 내보내기: /FontFile3 /OpenType + 16비트 사진
Options := THPDFHeadlessPageImportOptions.Default;
// 페이지 인덱스는 0 기준입니다: 표지와 스펙 시트를 복사합니다
Outcome := Target.AppendImportedPages(Source, [0, 2], Options);
// 증분 update로 저장됩니다: 오래된 바이트는 접두사로 남습니다.
// 기대 결과: 새 catalog revision이 /Version /1.6을 실어 나르고,
// 파일의 첫 줄은 여전히 %PDF-1.3으로 읽힙니다
Target.SaveToFile(OutputFile);
WriteLn(Format('%d pages added, %d annotations flattened',
[Outcome.AddedPages, Outcome.FlattenedAnnotations]));
finally
Source.Free;
Target.Free;
end;
end;
이 짝에서 OpenType 폰트 프로그램이 필요 버전을 1.6으로 정하고, 16비트 사진만으로는 1.5에서 멈췄을 것입니다. 소스와 대상은 서로 다른 두 로드된 문서여야 합니다. 이미 서명되거나 인증된 대상은 거부됩니다. 페이지를 덧붙이면 서명이 증명하는 내용이 바뀌니까요
inline 이미지는 content stream 안에 삽니다
inline 이미지는 결코 객체가 아닙니다. ISO 32000-1 §8.9.7은 이를 content stream에 곧장 적힌 BI … ID … EI 시퀀스로 정의하고, /BitsPerComponent의 /BPC 같은 축약 키를 쓰며, 이 형식은 4 KB 이하의 작은 이미지에만 쓰라고 권합니다. 여기서 16비트 깊이는 이미지 XObject에서와 마찬가지로 PDF 1.5를 필요로 하지만, 객체 훑기는 결코 그것을 만나지 못합니다. 그 바이트들은 복사된 /Contents 안을 함께 타고 가니까요. 그래서 import는 복사된 각 페이지의 content stream과 클론하는 모든 Form XObject와 tiling pattern의 content stream도 디코딩하고, 깊이 16인 BI header를 한 번 스캔합니다. 텍스트 검색이면 오작동합니다. show-text 연산자의 피연산자는 literal (BI /BPC 16 ID)를 담을 수 있고, 주석 줄은 % BI /BPC 16으로 읽힐 수 있습니다. ID 다음에는 공백 바이트 하나가 날 binary 샘플에게 자리를 내주는데, 그 샘플은 양쪽에 공백을 둔 EI 토큰까지 이어집니다. 그리고 그 샘플 바이트들은 우연히 BI를 이룰 수 있죠. 그래서 스캐너는 literal과 hexadecimal string, 주석, inline 샘플 데이터를 넘어가며 진짜 16비트 header가 처음 나타나는 곳에서 멈춥니다. 8비트 inline 이미지나 /BPC 16을 언급만 하는 string은 버전을 그 자리에 둡니다
소스 파일의 header가 버전을 정하는가
아닙니다. 선택된 페이지들이 정합니다. 그 페이지들이 PDF 1.3 드로잉 연산자 이상을 쓰지 않는 한, 브로슈어의 1.7을 병합 결과에 도장 찍듯 옮기는 것은 결과를 과대 보고합니다. 과대 보고된 버전은 버전으로 파일을 분류하는 인쇄 워크플로나 아카이브 게이트웨이에서 평범한 문서를 잘못된 길로 보낼 수 있습니다. 값을 무시한 채 키만 맞추는 것도 같은 방향의 오류입니다. /Mask null, /PresSteps null, /S /Dissolve를 지닌 /Trans 딕셔너리는 모두 눈길을 끄는 키를 담고 있지만 어느 것도 더 새 버전을 필요로 하지 않으며, 키 이름에 반응하는 스캐너는 필요 없는 파일의 버전을 올려 놓습니다
PDF 1.2 파일 속의 PDF 1.3 기능은 1.4로 선언됩니다
미묘한 사례는 버전 범위의 맨 아래에 있습니다. explicit과 color-key 이미지 마스크(표 89의 /Mask)는 PDF 1.3으로 태그됩니다. 그런 이미지를 %PDF-1.2 문서에 복사하면 엄격한 요구는 1.3입니다. 그런데 /Version은 PDF 1.4부터 존재합니다. 1.2 파일에 /Version /1.3을 쓰는 것은 선언된 레벨이 지니지 못한 메커니즘을 쓰는 일이라 엄격한 reader는 이를 존중할 이유가 없습니다. HotPDF는 그 경우 1.4를 선언합니다. header가 1.3 아래인 문서에 들어오는 이미지 마스크는 필요 버전을 곧장 1.4, 즉 override가 합법인 첫 버전으로 올립니다. 이미 1.3인 대상은 같은 이미지에 어떤 override도 필요로 하지 않습니다
유효 버전은 어떻게 다시 읽어 오는가
header 버전을 잡고 catalog의 /Version 이름을 찾아 둘 중 나중 것을 씁니다. 완전한 parser는 trailer의 /Root를 통해 catalog에 도달합니다. 배치 작업의 빠른 게이트에는 바이트 스캔이면 충분할 때가 많은데, 한 가지 단서를 미리 밝힙니다. 이 스캔은 가장 새로운 catalog revision이 압축 object stream 바깥의 평범한 객체로 적혀 있을 때만 항목을 찾습니다. 끝에서부터 검색하세요. 증분 update된 파일은 revision마다 catalog 하나를 지닐 수 있습니다. 원본에 이어 각 update마다 완전한 교체 복사본이죠. reader는 모든 객체의 가장 최근 복사본을 씁니다(§7.5.6). 그래서 파일의 마지막 /Version은 보통 살아 있는 catalog의 것입니다. 빈 결과는 이 스캔이 평문 override를 찾지 못했다는 뜻이며, parser는 object stream 안에서 여전히 찾을 수 있습니다. 함수는 유효 버전을 1.6 같은 string으로 반환하고, 뒤의 게이트는 PDF/A-1 채널을 지킵니다. 그 기반 표준 ISO 19005-1은 PDF 1.4 위에 세워졌습니다:
uses
SysUtils, IOUtils;
function EffectivePdfVersion(const FileName: string): string;
const
Key: RawByteString = '/Version';
var
Bytes: TBytes;
Text: RawByteString;
P, Q: Integer;
Declared: string;
begin
Result := '';
Bytes := TFile.ReadAllBytes(FileName);
if Length(Bytes) < 8 then
Exit; // '%PDF-1.x'에는 너무 짧습니다
SetString(Text, PAnsiChar(@Bytes[0]), Length(Bytes));
if Copy(Text, 1, 5) <> '%PDF-' then
Exit;
Result := string(Copy(Text, 6, 3)); // '%PDF-1.3' -> '1.3'
// 가장 새로운 revision은 끝에 있으므로 뒤에서부터 검색합니다
P := Length(Text) - Length(Key) + 1;
while (P > 0) and (Copy(Text, P, Length(Key)) <> Key) do
Dec(P);
if P = 0 then
Exit; // 평문 override를 찾지 못했습니다
Q := P + Length(Key);
while (Q <= Length(Text)) and (Text[Q] in [#0, #9, #10, #12, #13, #32]) do
Inc(Q);
if (Q < Length(Text)) and (Text[Q] = '/') then
begin
Declared := string(Copy(Text, Q + 1, 3)); // name 객체: /1.6
if Declared > Result then // header가 더 나중이면 header가 이깁니다
Result := Declared;
end;
end;
procedure RequirePdfA1Channel(const FileName: string);
var
Version: string;
begin
Version := EffectivePdfVersion(FileName);
if Version > '1.4' then
raise Exception.CreateFmt(
'%s declares PDF %s; the PDF/A-1 channel takes PDF 1.4 at most',
[ExtractFileName(FileName), Version]);
end;
string 비교가 통하는 이유는 발표된 모든 PDF 버전이 한 자릿수 minor 번호를 지니고, 2.0조차 모든 1.x 값 위로 정렬되기 때문입니다. 게이트가 건드리지 않는 것도 눈여겨보세요. 파일을 몰래 통과시키려고 /Version을 뜯어 내지 않고, header 하나만으로는 결코 믿지 않습니다. header만 보는 검사라면 병합된 계약서를 통과시켰겠죠. 파일은 여전히 PDF 1.6 폰트 형식을 실어 나르고 있습니다
1.4 전용 파이프라인을 위한 거부 또는 다운그레이드
override를 지워 버리는 것은 잘못된 수리입니다. 1.6을 요구한 객체들은 여전히 파일 안에 있으므로 버전을 아는 reader는 1.6 폰트 형식을 쓰는 1.3 문서를 보게 되고, preflight 도구는 그 불일치를 보고합니다. 실제로 1.4로 한정된 채널에는 온전한 선택지가 둘 있습니다. 저장되기 전에 유효 버전을 검사로 삼아 병합을 거부하거나, 먼저 소스 페이지를 대상 레벨로 내리는 것 — 저작 도구에서 폰트와 이미지 content를 변환한 뒤 결과를 import하면 됩니다. 일찍 거부하는 것이 더 나은 기본값입니다. 작업이 아직 돌아가는 동안 오류가 파일과 버전을 이름으로 말해 주니, 일주일 뒤에 아무도 설명 못 하는 검증 실패보다 지원 비용이 훨씬 쌉니다. 요구 하나는 import 시점에서 떼어 낼 수 있습니다. Options.RemovePresentationSteps := True로 두면 복사된 페이지가 /PresSteps를 빼고 나오므로 하위 페이지 내비게이션은 필요 버전에 아무것도 더하지 않습니다. 결정이 저장 시점에 속하는 곳에서는 저장 전 버전 사전 검사가 바이트 하나 쓰이기 전에 작업을 멈춥니다
2004년 계약서에서 찾아야 할 숫자는 1.6입니다. HotPDF Delphi PDF component의 AppendImportedPages를 실행한 같은 서비스에서 병합된 출력에 EffectivePdfVersion을 호출하세요. 그러면 1.4 전용 채널은 오류가 아직 원인이 된 브로슈어 페이지들을 이름으로 부르는 동안 그 작업을 돌려 보낼 수 있습니다