공급자 PDF가 화면에서는 완벽한데 PDF/A 검증기가 한 줄로 거부합니다. 00030 At least one font is not embedded. 뷰어는 줄곧 여러분 머신에서 폰트를 빌려 쓰고 있었던 것입니다. 파일 안의 폰트 디스크립터를 열어 보면 내장 폰트에 필요한 것들이 stem 폭과 bounding box까지 이미 다 있는데, 빠진 것은 폰트 프로그램 자체를 들고 있는 스트림 참조 하나입니다
이것의 배치 버전은 아카이브 유입 파이프라인을 돌려 본 사람에게 익숙합니다. 송장, 계약서, 스캔 양식이 공급자와 대행사에서 도착하고 건물의 모든 자리에서 잘 렌더링되는데 검증기는 그 한 줄로 파일을 연달아 거부합니다. 상류에서 무언가를 다시 만들어 주지는 않을 겁니다. 파이프라인이 받은 것을 고쳐야 하고 그것이 이 글이 다루는 일입니다. 짝 글인 프리플라이트 리포트로 PDF/A·PDF/UA 위반 탐지하기는 어떤 파일이 깨졌는지 알려주고, 이 글은 그들이 깨지는 가장 잦은 방식 하나를 다룹니다
오류 00030이 실제로 요구하는 것
ISO 19005-1 §6.3.4는 규격 파일이 쓰는 모든 폰트가 그 파일 안에 폰트 프로그램을 실어야 한다고 요구합니다. 근거는 평범한 아카이브 논리입니다. 50년 뒤에 열리는 문서는 생산한 기계와 폰트를 하나도 공유하지 않는 기계에서도 똑같이 렌더링돼야 하고, 미내장 폰트는 그저 읽고 있는 시스템에서 아무리 찾아도 Arial이라 불리는 무언가를 찾아 보라는 지시일 뿐입니다. 대체품이 가진 글리프와 메트릭이 곧 리더가 보는 것입니다
미내장 습관은 Standard 14 관습으로 거슬러 올라갑니다. 초기 PDF는 모든 뷰어가 Helvetica, Times, Courier, Symbol, ZapfDingbats를 실어 나른다고 약속했고 생성기들은 그것들을 이름으로 참조하고 아무것도 내장하지 않는 법을 배웠습니다. 아직도 그러는 도구가 많습니다. PDF/A는 그 면제를 철회하고 losLab PDF Library for Delphi는 기록기 쪽에서 그것을 적용합니다. PDF/A나 PDF/X 모드가 활성이면 AddStandardFont는 폰트를 선택하지 않은 채 0을 돌려줍니다. 라이브러리는 Standard 14 외곽선을 번들하지 않으므로 프로그램으로 뒷받침할 수 없는 참조를 쓰지 않겠다는 것입니다. Embed=0인 AddTrueTypeFont는 PDF/A 모드에서 완전 내장으로 승격되고, Embed=2(서브셋)는 서브셋도 여전히 내장된 프로그램이므로 그대로 통과합니다
그건 직접 쓰는 파일을 커버합니다. 공급자의 파일은 더 어렵습니다. 폰트 딕셔너리를 남의 생성기가 썼고 두 번째 시도를 부탁할 방법이 없습니다. 그런 파일을 위해 라이브러리는 EmbedMissingFonts를 제공합니다. 로드된 문서를 제자리에서 고쳐 빠진 프로그램마다 설치된 폰트에서 복사해 문서가 이미 들고 있는 디스크립터에 붙입니다
미내장 폰트는 왜 키 하나만 더 필요한가
미내장 TrueType 폰트를 쓰는 생성기도 완전한 FontDescriptor를 냅니다. FontName, FontBBox, Flags, Ascent, Descent, StemV, CapHeight까지요. 빠뜨리는 것은 폰트 프로그램을 담은 스트림뿐인데, 디스크립터에서 TrueType 외곽선은 /FontFile2로, CFF 기반 CID 폰트는 /FontFile3으로 참조됩니다. 그래서 EmbedMissingFonts는 정확히 그것만 더합니다. 프로그램 바이트를 읽어 /Length1 항목을 단 새 Flate 압축 스트림으로 쓰고 이미 있는 디스크립터에 참조를 붙입니다
물려받은 파일에는 이 제자리 방식이 맞는 기본값이라고 생각하는데 이유는 Widths 배열입니다. PDF 콘텐츠 스트림 안의 텍스트 위치는 이미 고정돼 있고 뷰어는 원본 생성기가 기록한 폭으로 전진합니다. 설치된 폰트에서 폰트 딕셔너리를 재건하면 그 폭들이 갓 잰 것으로 갈아치워지고, 설치된 폰트 버전이 저자의 것과 조금이라도 다르면 보존하려던 문서를 바꿔 버린 셈입니다. 딕셔너리, 인코딩, 폭, 모든 콘텐츠 스트림을 그대로 두면 페이지들은 여전히 같은 메트릭의 같은 리소스 이름을 가리킵니다
이 걷기는 파일의 모든 Font 딕셔너리를 커버합니다. 페이지 리소스에서 도달 가능한 것들만이 아니라 주석 appearance에서만 쓰이거나 페이지 사이에 공유되는 폰트도 집어 올립니다. CJK 텍스트와 대부분의 현대 Unicode 출력을 위해 만들어지는 복합 Type0 폰트는 후손 CIDFont를 통해 처리됩니다. 전체 수리는 로드된 문서에 대한 호출 하나입니다:
var
PDF: TPDFlib;
Repaired: Integer;
begin
PDF := TPDFlib.Create;
try
if PDF.LoadFromFile('supplier-invoice.pdf', '') <> 1 then
raise Exception.Create('Could not load PDF');
// 프로그램을 얻은 폰트가 몇 개인지 돌려준다. 이미 내장된
// 폰트는 그대로 두고 설치된 매치가 없는 폰트는
// 건너뛰어 그냥 셈하지 않는다.
Repaired := PDF.EmbedMissingFonts;
Writeln(Format('%d font program(s) embedded', [Repaired]));
PDF.SaveToFile('supplier-invoice-repaired.pdf');
finally
PDF.Free;
end;
end;
설치 폰트 조회가 이름을 맞추는 방식
실제 파일의 BaseFont 이름은 Windows가 아는 패밀리 이름과 거의 맞지 않습니다. EmbedMissingFonts는 조회 전에 각 이름을 정규화합니다:
- 서브셋 접두사(여섯 개의 대문자와 플러스 기호,
KQBWTE+Calibri처럼)는 떼어 낸다 - 첫 콤마나 하이픈 뒤의 모든 것은 스타일로 읽힌다. 그래서
Arial,BoldItalic과Arial-BoldMT는 둘 다 볼드 폰트를 청하고Italic이나Oblique는 이탤릭을 청한다 - 끝의
MT와PS접미사는 떨어져 나가므로ArialMT는Arial로 resolve된다 - 폰트가 TrueType Collection(.ttc) 안에 살면 테이블 오프셋이 조정돼 내장 프로그램이 유효한 독립 폰트가 된다
더 어려운 문제는 Windows 폰트 매퍼가 절대 거절하지 않는다는 것입니다. 설치되지 않은 패밀리를 GDI에 청하면 불평 없이 대체 폰트를 돌려주고, regular 폰트만 있는 패밀리에 볼드를 청하면 화면에서 외곽선을 뚱뚱하게 그려 보입니다. 어느 결과든 완벽히 로드 가능하지만 엉터리 폰트인 프로그램을 줍니다. 그래서 조회는 GDI가 실제로 고른 폰트를 요청된 패밀리와, 공백과 대소문자를 무시하고 비교하고, 폰트 자체의 볼드·이탤릭 비트를 요청된 스타일과 비교합니다. 어느 쪽이든 어긋나면 그 폰트는 건너뛰어집니다
이것은 의도된 거래입니다. 더 관대한 조회는 모든 배치에서 수리 개수를 올리고 그 "수리" 일부는 문서가 Arial,Bold라고 부르는 폰트 아래 Arial Regular를 내장할 것입니다. ISO 19005-1 §6.3.6은 폰트 딕셔너리의 폭이 내장 프로그램과 일치하길 요구하므로 아슬아슬한 근접은 오류 00030을 폭 일치 오류와 맞바꾸고, 최악에는 저자의 의도와 살짝 다르게 렌더링하면서 검증을 통과합니다. 우리는 추측을 아카이브에 넣기보다 건너뛰기를 보고하는 편입니다
조회는 Windows GDI를 통해 설치 폰트를 읽습니다. Linux나 macOS 빌드에서 시스템 경로는 아무것도 돌려주지 않고 다음 절의 파일 기반 호출이 프로그램을 공급하는 길입니다
폰트가 설치돼 있지 않으면 무엇이 벌어지는가
반환값이 말해 줍니다. EmbedMissingFonts가 여러분이 아는 미내장 수보다 적게 보고하면 그 차이는 이 머신이 갖고 있지 않거나 올바른 스타일로는 갖고 있지 않은 폰트들입니다. 그 폰트들을 위해 EmbedFontProgramFromFile(FontName, FileName)이 여러분이 제공하는 .ttf나 .otf 파일에서 프로그램을 붙입니다. 파이프라인이 맞닥뜨릴 것으로 예상하는 회사 폰트를 실어 나르고 의도적으로 그것들로 폴백하게 해 줍니다
실무에서 가장 잘 통하는 패턴은 두 패스입니다. EmbedMissingFonts를 돌리고 저장한 다음 결과를 로드해 아직 미내장인 것을 열거하고 남은 이름 각각을 자체 폰트 폴더에 건넵니다. 다시 로드가 중요합니다. GetFontIsEmbedded가 열거된 폰트에 대해 보고하는 내장 플래그는 FindFonts가 돌았을 시점의 파일을 반영하므로 수리와 같은 세션에서 열거하면 낡은 답이 보입니다
function FontFileFor(const BaseFont: string): string;
begin
// 자체 헬퍼(라이브러리 외부). 문서 폰트 이름을 앱이 실어 나르는
// 폰트 파일로 대응시킨다.
// 빈 결과는 EmbedFontProgramFromFile이 파일 시스템을
// 건드리지 않고 0을 돌려주게 만든다.
if Pos('CorporateSans', BaseFont) > 0 then
Result := ExtractFilePath(ParamStr(0)) + 'fonts\CorporateSans.ttf'
else
Result := '';
end;
procedure EmbedFromShippedFonts(const InFile, OutFile: string);
var
PDF: TPDFlib;
I, FontID: Integer;
Name: string;
begin
PDF := TPDFlib.Create;
try
if PDF.LoadFromFile(InFile, '') <> 1 then
Exit;
PDF.FindFonts;
for I := 1 to PDF.FontCount do
begin
FontID := PDF.GetFontID(I);
if (FontID > 0) and (PDF.SelectFont(FontID) = 1) and
(PDF.GetFontIsEmbedded = 0) then
begin
// 이름은 서브셋 접두사까지 저장된 그대로 넘긴다
Name := PDF.FontName;
if PDF.EmbedFontProgramFromFile(Name, FontFileFor(Name)) = 0 then
Writeln('Still not embedded: ', Name);
end;
end;
PDF.SaveToFile(OutFile);
finally
PDF.Free;
end;
end;
그 루프의 성패를 가르는 디테일이 셋 있습니다. 이름 기반 호출, 곧 설치 폰트의 EmbedFontProgram과 파일의 EmbedFontProgramFromFile은 BaseFont를 문서가 저장한 그대로 비교하고 그 이름을 가진 첫 Font 딕셔너리에 작용합니다. 그래서 루프가 정리된 패밀리 이름 대신 PDF.FontName을 그대로 넘기는 것입니다. 프로그램 포맷은 폰트 타입에 맞아야 합니다. TrueType이나 CIDFontType2 폰트에는 글리프 외곽선 TrueType 데이터, CIDFontType0 폰트에는 OpenType CFF 프로그램(OTTO 태그로 시작하는 것)이 필요한데 이것은 서브타입 OpenType의 /FontFile3으로 기록됩니다. TrueType 폰트에 CFF 파일을 주면 호출은 0을 돌려줍니다. 그리고 수리 경로는 TrueType과 CID 폰트를 커버합니다. Type1 폰트의 /FontFile은 명시적 길이 키를 가진 3세그먼트 PFB 배치가 필요해 Type1 참조는 건너뛰어지고 반환 개수에 표시를 맡깁니다. Standard 14 참조는 보통 Type1로 쓰이므로 그 남은 목록에서 만나게 될 겁니다
라이브러리가 대신 답해 주지 못하는 질문도 있습니다. TrueType 폰트의 내장 권한은 그 foundry의 것인데 조직을 떠나는 문서에 라이선스 프로그램을 기록하는 파이프라인은 라이선스가 그것을 허용하는지 누군가 확인해야 합니다. 코드는 여러분이 가리키는 무엇이든 내장합니다. 허락되는지는 법적 질문입니다
CreatePreflightReport로 루프 닫기
파일을 거부한 감사가 그것을 통과시키는 감사여야 합니다. ComplianceTests = 1을 준 CreatePreflightReport가 PDF/A 검사를 돌리고 발견 00030은 파일 전체에 대해 한 번 보고되므로 단 하나의 놓친 폰트가 리포트에 계속 남습니다. 소스에 대해 돌리고 수리·저장한 다음 출력에 대해 다시 도세요
function HasFontEmbeddingViolation(PDF: TPDFlib;
const FileName: string): Boolean;
var
Report: string;
begin
// ComplianceTests = 1이 PDF/A 검사를 고른다
Report := PDF.CreatePreflightReport(FileName, '', 1, 0);
Result := Pos('00030', Report) > 0;
end;
첫 번째는 사람을 놀라게 하는 결과가 있습니다. 폰트 검사는 콘텐츠가 텍스트 렌더링 모드 3으로만 보이지 않게 그리는 폰트를 무시하는데, 대부분의 OCR 엔진이 스캔 이미지 위에 검색 가능한 텍스트 레이어를 까는 방식이 바로 그것입니다. 그래서 스캔 파일은 FindFonts가 여전히 미내장 폰트를 나열하는 동안 00030을 통과할 수 있습니다. PDF/A가 보이지 않는 텍스트를 다루는 방식과 일치하며, 폰트별 나열과 파일별 판정이 같은 문서 위에서 정당하게 어긋날 수 있다는 뜻입니다
어떤 파일의 어떤 폰트가 미내장으로 남았는지 정확히 이름 대야 하는 배치 로그라면 폰트별 나열이 더 나은 도구입니다. 출력을 로드하고 FindFonts를 부른 다음 항목마다 SelectFont와 GetFontIsEmbedded를 부르세요. 로드된 PDF에서 텍스트·이미지·폰트 추출하기 글은 같은 열거를 수리가 아니라 추출의 먹이로 씁니다
내장은 발견 하나를 지우고, 직접 쓰는 출력은 애초에 필요 없어야
폰트 내장은 오류 00030만 지웁니다. 암호화, 빠진 XMP 메타데이터, OutputIntent 없는 장치 의존 색 공간, ToUnicode 맵이 없는 폰트로도 실패하는 파일은 프로그램이 전부 제자리에 놓인 뒤에도 여전히 실패하므로 수리는 프리플라이트 루프 안에 있고 리포트가 이름 대는 것들을 처리해 나가야 합니다. 크기가 또 하나의 비용입니다. CJK 폰트 프로그램 하나가 몇 메가바이트에 이를 수 있고 그중 몇 개를 내장하면 한 페이지짜리 송장이 원래 크기의 배로 불어납니다. PDF 파일 크기 최적화와 폰트 서브셋팅 글이 각 내장 프로그램을 페이지가 실제로 쓰는 글리프만 남게 깎는 방법을 다룹니다
기록기 쪽에서 SetEmbedAllFonts(1)은 여러분 코드가 이 글이 수리하는 파일을 만들지 않게 막습니다. PDF/A 모드가 쓰는 것과 같은 승격을 평범한 문서에 적용합니다. 이후 Embed=0인 AddTrueTypeFont 호출은 전체 프로그램을 내장합니다. 이 설정은 선택된 문서에 속하고 호출 뒤에 추가되는 폰트에 적용되므로 NewDocument 직후에 두세요. 권고는 아카이브에 끝날지도 모르는 것이라면 PDF/A 여부와 무관하게 켜는 것입니다. 오늘 만드는 파일이야말로 나중에 읽는 사람의 물려받은 파일이니까요
PDF.NewDocument;
PDF.SetEmbedAllFonts(1);
// 여기서부터 AddTrueTypeFont('Segoe UI', 0)는
// AddTrueTypeFont('Segoe UI', 1)와 똑같이 전체 프로그램을 내장한다
PDF.AddTrueTypeFont('Segoe UI', 0);
로드-수리-저장 경로, 파일 기반 폴백, 기록기 쪽 방어는 모두 Delphi·C#·VB.NET용 losLab PDF Library에 실려 나가며 위에서 결과를 확인하는 데 쓴 프리플라이트 엔진도 함께입니다. 제품 페이지는 폰트별 검사와 서브셋팅을 포함해 나머지 폰트 API를 문서화합니다