Поставщицкий PDF выглядит на экране идеально, но валидатор PDF/A отвергает его одной строкой: 00030 At least one font is not embedded. Просмотрщик всё это время занимал шрифты у вашей машины. Откройте дескриптор шрифта внутри файла — почти всё, что нужно встроенному шрифту, уже там, вплоть до ширины штока и bounding box; не хватает одной ссылки на поток, держащей саму программу шрифта
Пакетная версия этого знакома всякому, кто гоняет конвейер приёма архива. Счета, договоры и отсканированные формы приезжают от поставщиков и бюро, каждый стол в здании рендерит их без проблем, а валидатор отвергает файл за файлом той же строкой. Никто сверху ничего перегенерировать не станет. Конвейер обязан чинить то, что получает, и это работа, которую разбирает статья. Её компаньон, статья об обнаружении нарушений PDF/A и PDF/UA по preflight-отчёту, говорит, какие файлы сломаны; эта разбирает самый частый способ поломки
О чём на самом деле просит ошибка 00030
ISO 19005-1 §6.3.4 требует, чтобы каждый шрифт, используемый соответствующим файлом, нёс свою программу шрифта внутри этого файла. Рассуждение — простая архивная логика. Документ, открытый через пятьдесят лет на машине, не делящей ни одного шрифта с производившей его, обязан рендериться одинаково, а невстроенный шрифт — это просто инструкция пойти поискать что-то по имени Arial на той системе, что случилась читать. Какие бы глифы и метрики ни были у замены — то читатель и увидит
Привычка не встраивать тянется от конвенции Standard 14. Ранний PDF обещал, что каждый просмотрщик поставляется с Helvetica, Times, Courier, Symbol и ZapfDingbats, поэтому генераторы научились ссылаться на них по имени и не встраивать ничего. Инструментов, которые так делают, хватает до сих пор. PDF/A отзывает ту льготу, и losLab PDF Library for Delphi применяет это на стороне писателя: при активном режиме PDF/A или PDF/X AddStandardFont возвращает 0, не выбрав шрифт, потому что библиотека не тащит контуры Standard 14 и не запишет ссылку, которую не может подкрепить программой. AddTrueTypeFont с Embed=0 в режиме PDF/A повышается до полного встраивания, тогда как Embed=2 (сабсет) проходит без изменений, ведь сабсет — всё ещё встроенная программа
Это покрывает файлы, которые вы пишете сами. Файл поставщика тяжелее, потому что словари шрифтов писал чужой генератор, и попросить его о второй попытке некому. Для таких файлов библиотека даёт EmbedMissingFonts, который чинит загруженный документ на месте, копируя каждую недостающую программу из установленных шрифтов в дескриптор, который документ уже несёт
Почему невстроенному шрифту нужен всего один лишний ключ?
Генератор, пишущий невстроенный TrueType-шрифт, всё равно выдаёт полный FontDescriptor: FontName, FontBBox, Flags, Ascent, Descent, StemV, CapHeight. За бортом остаётся лишь поток с программой шрифта, на который дескриптор ссылается как /FontFile2 для TrueType-контуров или /FontFile3 для CID-шрифтов на CFF. Так что EmbedMissingFonts добавляет ровно это. Он читает байты программы, пишет их новым Flate-сжатым потоком с записью /Length1 и вешает ссылку на дескриптор, который уже стоит там
Мы считаем этот подход на месте правильным дефолтом для унаследованных файлов, и причина — массив Widths. Позиции текста в потоке контента PDF уже зафиксированы; просмотрщик продвигается на ширины, записанные исходным генератором. Перестроить словарь шрифта из установленного шрифта — значит заменить те ширины свежеизмеренными, и если установленная версия начертания отличается хоть чуть-чуть от авторской, вы изменили документ, который обязаны были сохранить. Оставить словарь, кодировку, ширины и каждый поток контента нетронутыми — значит страницы продолжат указывать на те же имена ресурсов с теми же метриками
Обход покрывает каждый словарь Font в файле, не только достижимые из ресурсов страниц, поэтому шрифты, живущие лишь в appearance аннотаций или разделяемые между страницами, тоже подхватываются. Составные Type0-шрифты — порода для CJK-текста и большей части современного Unicode-вывода — обрабатываются через их потомка 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 - Когда начертание живёт внутри TrueType Collection (.ttc), смещения таблиц подгоняются так, что встроенная программа — валидный самостоятельный шрифт
Тяжелее то, что маппер шрифтов Windows никогда не говорит «нет». Попросите у GDI семейство, которого нет, — оно молча вернёт замещающее начертание; попросите жирное у семейства, у которого есть только прямое, — оно наэкранно подожмёт контуры. Любой из результатов даст вам идеально загружаемую программу не того шрифта. Поэтому поиск сверяет начертание, которое GDI реально выбрало, с запрошенным семейством — игнорируя пробелы и регистр, — и биты bold и italic самого начертания с запрошенным стилем. Несовпадение по любому из них значит, что шрифт пропускается
То — нарочный трейд. Более снисходительный поиск поднял бы счёт починки на каждой партии, и часть таких «починок» встроила бы Arial Regular под шрифт, который документ зовёт Arial,Bold. 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-данные с контурами глифов для TrueType или CIDFontType2, программа OpenType CFF (начинающаяся с тега OTTO) для CIDFontType0, которая затем пишется как /FontFile3 с подтипом OpenType. Сунуть CFF-файл TrueType-шрифту — вызов вернёт 0. И путь починки покрывает TrueType и CID шрифты; /FontFile шрифта Type1 требует трёхсегментную раскладку PFB с явными ключами длины, поэтому Type1-ссылки пропускаются и остаются на совести возвращаемого счёта. Standard 14-ссылки обычно пишутся как Type1, так что ждите их в том списке остатков
Есть и вопрос, на который библиотека не ответит за вас. Права встраивания TrueType-шрифта принадлежат его foundry, и конвейер, пишущий лицензированные программы в документы, покидающие организацию, нуждается в ком-то, кто подтвердит: лицензии это позволяют. Код встроит любой файл, на который вы его нацелите. А можно ли вам — вопрос юридический
Замыкаем цикл с CreatePreflightReport
Аудит, отвергший файл, должен быть и тем, что его пропустит. CreatePreflightReport с ComplianceTests = 1 гоняет проверки 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-движков кладёт поисковый текстовый слой поверх отсканированного изображения. Поэтому отсканированный файл может пройти 00030, пока FindFonts всё ещё перечисляет невстроенное начертание. Это согласуется с тем, как PDF/A обращается с невидимым текстом, и значит по-шрифтовый список и вердикт по файлу могут легитимно расходиться на одном документе
Для пакетных логов, которым надо называть точно, какое начертание в каком файле осталось невстроенным, лучше по-шрифтовый инструмент: загрузите вывод, вызовите FindFonts, затем SelectFont и GetFontIsEmbedded для каждой записи. Статья об извлечении текста, изображений и шрифтов из загруженных PDF пользуется тем же перечислением, чтобы кормить извлечение вместо починки
Встраивание закрывает одну находку, а вашему собственному выводу она не нужна вовсе
Встраивание шрифтов убирает ошибку 00030 и больше ничего. Файл, который также проваливается на шифровании, отсутствующих XMP-метаданных, зависящем от устройства цветовом пространстве без OutputIntent или шрифтах без карт ToUnicode, продолжит проваливаться после встраивания всех программ, поэтому починке место внутри preflight-цикла, и работать она должна через то, что называет отчёт. Цена номер два — размер. Полная CJK-программа шрифта может тянуть несколько мегабайтов, и встраивание пары таких сделает одностраничный счёт во много раз крупнее исходного; статья об оптимизации размера PDF и сабсеттинге шрифтов разбирает обрезку каждой встроенной программы до глифов, которые страницы реально используют
На стороне записи SetEmbedAllFonts(1) не даёт вашему коду производить файлы, которые чинит эта статья. Он применяет к обычному документу то же повышение, что использует режим PDF/A: любой последующий вызов AddTrueTypeFont с Embed=0 встраивает полную программу. Настройка принадлежит выбранному документу и касается шрифтов, добавленных после вызова, поэтому ставьте её сразу после NewDocument. Наш совет — включать её для всего, что может оказаться в архиве, PDF/A или нет: файлы, которые вы создаёте сегодня, — унаследованные файлы того, кто будет читать их позже
PDF.NewDocument;
PDF.SetEmbedAllFonts(1);
// Отсюда и дальше AddTrueTypeFont('Segoe UI', 0) встраивает
// полную программу, ровно как AddTrueTypeFont('Segoe UI', 1)
PDF.AddTrueTypeFont('Segoe UI', 0);
Путь загрузка-починка-сохранение, файловый fallback и строж на стороне записи едут в losLab PDF Library для Delphi, C# и VB.NET вместе с preflight-движком, использованным выше для подтверждения результата; страница продукта документирует остальной шрифтовой API, включая по-шрифтовую инспекцию и сабсеттинг