Упаковочный лист, отпечатанный на Windows-машине, называет Arial в своём словаре шрифтов, не несёт программы шрифта и отлично выглядит в каждом просмотрщике на той машине. Растеризованный внутри контейнера Debian, тот же файл рисует каждый глиф другим шрифтом без засечек. Текст всё ещё начинается там, где должен, потому что позиции глифов берутся из массива /Widths, сохранённого в PDF, но формы букв меняются, интервал выглядит неровным там, где контуры заменителя уже, чем ширины, в которые они вписаны, а символ, которого у заменителя нет, оставляет дыру. Рендерер не виноват. Документ отдал выбор шрифта тому, кто его рендерит, и этот выбор можно сделать в собственном коде, подсунув байты шрифта, которые вы поставляете вместе с приложением
ISO 32000-1 это разрешает. Стандартные 14 шрифтов из §9.6.2.2 могут всегда ссылаться по имени, и любой другой простой шрифт можно оставить невстроенным, пока его словарь и дескриптор шрифта (§9.8) описывают метрики и флаги. PDF/A запрещает это напрямую (ISO 19005-1 §6.3.4 требует встраивать каждую программу шрифта), что многое говорит о надёжности шрифтов, заданных только именем, после того как файл покидает машину, которая его записала
Почему не установить шрифты прямо на сервере?
Иногда установки шрифтов достаточно. Но она проваливается в трёх типичных ситуациях. Лицензия шрифта может разрешать настольное использование, но не установку на сервер, который рендерит документы автоматически. Образы контейнеров часто пересобираются, и скопированный вручную шрифт исчезает со следующим развёртыванием. Регулируемые процессы хотят воспроизводить стек рендеринга из артефактов под контролем версий, а общесистемная папка шрифтов к таким артефактам не относится
Есть и промежуточный шаг. TPdfLibraryConfiguration.UserFontPaths, передаваемый через ConfigurePdfLibrary до загрузки библиотеки, говорит нативному мапперу PDFium, какие папки сканировать в поисках файлов шрифтов. Список заменяет платформенные умолчания, а не дополняет их, и на Windows заодно отключает перечисление шрифтов GDI, так что включите системную папку шрифтов, если документам всё ещё нужны установленные шрифты. Какой файл выиграет по конкретному запросу, по-прежнему решает маппер по своим правилам соответствия. Когда нужно знать точно, какие байты отвечают на «Arial, bold, Cyrillic charset», это решение должно жить в коде, который вы можете прочитать, — именно это даёт системный поставщик шрифтов
Установка IPdfSystemFontProvider до загрузки PDFium
PDFium Component выставляет сопоставление шрифтов через один интерфейс с одним методом. IPdfSystemFontProvider.ResolveFont получает TPdfSystemFontRequest с FaceName, Weight, Italic, Charset и PitchFamily и отвечает записью TPdfSystemFontData с именем гарнитуры, полными байтами TrueType, OpenType или TrueType Collection, charset и TTCIndex. Возврат False отклоняет запрос
ConfigureSystemFontProvider обязан выполниться до загрузки библиотеки. PDFium берёт свой маппер шрифтов один раз, при инициализации, поэтому компонент поднимает EPdfError ("Configure the system font provider before loading PDFium"), если Loaded уже истинно. Многие вызовы грузят библиотеку по требованию, включая проверки возможностей, так что ставьте конфигурацию в самый верх запуска. Приведённый ниже провайдер строит таблицу и читает все файлы шрифтов в конструкторе; после этого ResolveFont только читает:
uses
System.SysUtils, System.Classes, System.IOUtils, PDFium;
type
TBundledFontProvider = class(TInterfacedObject, IPdfSystemFontProvider)
private
FKeys: TStringList; // сортируется один раз в конструкторе, дальше только чтение
FFonts: array of TBytes;
FFaces: array of WString;
class function KeyFor(const Face: string; Bold, Italic: Boolean): string; static;
procedure AddFont(const Face: string; Bold, Italic: Boolean;
const ReportedFace, FileName, FontDir: string);
public
constructor Create(const FontDir: string);
destructor Destroy; override;
function ResolveFont(const Request: TPdfSystemFontRequest;
out Font: TPdfSystemFontData): Boolean;
end;
class function TBundledFontProvider.KeyFor(const Face: string;
Bold, Italic: Boolean): string;
begin
Result := LowerCase(Face) + '|' + IntToStr(Ord(Bold)) + IntToStr(Ord(Italic));
end;
procedure TBundledFontProvider.AddFont(const Face: string; Bold, Italic: Boolean;
const ReportedFace, FileName, FontDir: string);
var
I: Integer;
begin
I := Length(FFonts);
SetLength(FFonts, I + 1);
SetLength(FFaces, I + 1);
FFonts[I] := TFile.ReadAllBytes(TPath.Combine(FontDir, FileName));
FFaces[I] := WString(ReportedFace);
FKeys.AddObject(KeyFor(Face, Bold, Italic), TObject(NativeInt(I)));
end;
constructor TBundledFontProvider.Create(const FontDir: string);
begin
inherited Create;
FKeys := TStringList.Create;
FKeys.Sorted := True;
FKeys.Duplicates := dupError;
AddFont('Arial', False, False, 'Arial', 'arial.ttf', FontDir);
AddFont('Arial', True, False, 'Arial', 'arialbd.ttf', FontDir);
// Псевдоним: сообщаем реально отдаваемую гарнитуру, чтобы её видела политика
AddFont('Helvetica', False, False, 'Arial', 'arial.ttf', FontDir);
end;
destructor TBundledFontProvider.Destroy;
begin
FKeys.Free;
inherited;
end;
function TBundledFontProvider.ResolveFont(const Request: TPdfSystemFontRequest;
out Font: TPdfSystemFontData): Boolean;
var
Index: Integer;
begin
Font := Default(TPdfSystemFontData);
Result := FKeys.Find(KeyFor(string(Request.FaceName),
Request.Weight >= 600, Request.Italic), Index); // от 600 и выше отдаётся как жирный
if not Result then
Exit;
Index := Integer(NativeInt(FKeys.Objects[Index]));
Font.FaceName := FFaces[Index];
Font.FontData := FFonts[Index];
Font.Charset := Request.Charset;
Font.TTCIndex := 0; // номер гарнитуры внутри .ttc-коллекции
end;
procedure ConfigureFonts(const FontDir: string; Audit: Boolean);
var
Policy: TPdfSystemFontPolicy;
begin
Policy := TPdfSystemFontPolicy.Default;
Policy.AllowDefaultFallback := not Audit;
Policy.AllowFaceSubstitution := not Audit;
Policy.MaxFontBytes := 32 * 1024 * 1024;
Policy.MaxCacheEntries := 64;
ConfigureSystemFontProvider(TBundledFontProvider.Create(FontDir), Policy);
// Только теперь открывайте документы; первый вызов, которому нужен PDFium, загрузит его
end;
Ключи таблицы в этом примере нарочито наивны. Реальные документы пишут одну и ту же гарнитуру несколькими способами, поэтому залогируйте Request.FaceName с представительной партии файлов, прежде чем замораживать таблицу; обёртка-рекордер дальше по тексту выдаёт ровно такой список. Порог жирности тоже выбор: FXFONT_FW_NORMAL — это 400, а FXFONT_FW_BOLD — 700 в модуле FPdfExtensions, и запрос semibold на 600 обязан упасть на одну из сторон
Что на самом деле решают флаги политики
Каждый запрос проходит один и тот же порядок. Компонент сначала проверяет свой кэш, затем вызывает вашего провайдера, затем валидирует ответ. Принятый ответ кэшируется и передаётся PDFium. Отклонённый или отвергнутый ответ уходит платформенному мапперу, возвращаемому FPDF_GetDefaultSystemFontInfo, но только когда включён AllowDefaultFallback; иначе запрос считается проваленным, и PDFium продолжает без вашего шрифта
Сама валидация короткая. Пустой FontData отвергается, как и всё длиннее MaxFontBytes. Пустое FaceName в ответе заполняется запрошенным именем. При выключенном AllowFaceSubstitution отвергается и ответ, чья сообщённая гарнитура отличается от запрошенной (сравнение без учёта регистра). Эта проверка читает только то имя, которое вы сообщаете. Провайдер, отдающий байты Liberation Sans под видом "Arial", проходит насквозь — потому-то пример сообщает реальную гарнитуру для своего псевдонима Helvetica: при выключенном флаге запрос Helvetica, отвечённый "Arial", отвергается и попадает в RejectedProviderResponses
Индекс TTC проверяется в другой точке. PDFium часто спрашивает по одной sfnt-таблице за раз, скажем cmap или glyf, и компонент отвечает на эти запросы, идя по каталогу таблиц в возвращённых вами байтах. Для коллекции он стартует с каталога, выбранного TTCIndex; индекс за пределами числа шрифтов в заголовке ttcf или ненулевой индекс у одношрифтового файла заставляет эти запросы таблиц возвращать пусто. Обход каталога распознаёт TrueType (0x00010000 и true), OpenType с контурами CFF (OTTO) и коллекции (ttcf). Файлы WOFF и WOFF2 должны быть распакованы в чистый sfnt до того, как провайдер их вернёт
TPdfSystemFontPolicy.Default включает оба флага с потолком 64 МБ на шрифт и 32 записями кэша. Это устраивает провайдера, которого раскатывают по несколько гарнитур за раз: всё, что вы ещё не смаппили, продолжает рендериться как раньше. Аудиторская сборка должна выключить оба флага. Тогда дыры проявляются как посчитанные провалы и отвергнутые подстановки, и попадание в откат больше не может спрятать гарнитуру, которую забыл ваш набор шрифтов
Какой поток вызывает ResolveFont?
ResolveFont выполняется на том потоке, который грузит или рендерит страницу, которой понадобился шрифт, а это не обязательно главный поток. Компонент охраняет собственный кэш и счётчики критической секцией, но не держит эту блокировку, пока работает ваш метод. Если приложение рендерит в фоновых потоках, любое состояние, которое провайдер меняет после конструирования, нуждается в собственной охране
Исключения — второе, что стоит держать внутри метода. Компонент ловит всё, что вырывается из ResolveFont, на границе с нативной библиотекой и трактует как отклонённый запрос, так что запрос продолжает путь в откат или провал. Полагаться на это — значит превращать баг в вашем коде сопоставления в шрифт, который тихо отдаёт кто-то другой. Обёртка ниже записывает каждый промах под блокировкой и держит исключения локальными, а заодно даёт вам список гарнитур, которые стоит добавить в таблицу:
uses
System.SysUtils, System.Classes, System.SyncObjs, PDFium;
type
TRecordingFontProvider = class(TInterfacedObject, IPdfSystemFontProvider)
private
FInner: IPdfSystemFontProvider;
FLock: TCriticalSection;
FMisses: TStringList;
public
constructor Create(const Inner: IPdfSystemFontProvider);
destructor Destroy; override;
function ResolveFont(const Request: TPdfSystemFontRequest;
out Font: TPdfSystemFontData): Boolean;
function MissedFaces: string;
end;
constructor TRecordingFontProvider.Create(const Inner: IPdfSystemFontProvider);
begin
inherited Create;
FInner := Inner;
FLock := TCriticalSection.Create;
FMisses := TStringList.Create;
FMisses.Sorted := True;
FMisses.Duplicates := dupIgnore;
end;
destructor TRecordingFontProvider.Destroy;
begin
FMisses.Free;
FLock.Free;
inherited;
end;
function TRecordingFontProvider.ResolveFont(const Request: TPdfSystemFontRequest;
out Font: TPdfSystemFontData): Boolean;
begin
try
Result := FInner.ResolveFont(Request, Font);
except
Result := False; // логируйте здесь; не давайте ему дойти до PDFium
end;
if Result then
Exit;
FLock.Enter;
try
FMisses.Add(Format('%s weight=%d italic=%s charset=%d pitch=%d',
[string(Request.FaceName), Request.Weight,
BoolToStr(Request.Italic, True), Request.Charset, Request.PitchFamily]));
finally
FLock.Leave;
end;
end;
function TRecordingFontProvider.MissedFaces: string;
begin
FLock.Enter;
try
Result := FMisses.Text;
finally
FLock.Leave;
end;
end;
Держите рекордер и через интерфейсную переменную, а не только через объектную. Компонент хранит собственную интерфейсную ссылку, и ClearSystemFontProvider её сбрасывает; если это была последняя ссылка, объект уходит вместе с ней, и голая переменная класса теперь указывает на освобождённую память. Чтобы узнать, на какие шрифты ссылается документ ещё до любого рендеринга, постраничный список в анализе свойств шрифтов PDF показывает встроенные и невстроенные шрифты бок о бок
Размер кэша шрифтов
Запросы сопоставления при рендеринге повторяются постоянно, поэтому принятые ответы кэшируются. Ключ кэша покрывает имя гарнитуры (без учёта регистра), вес, флаг курсива, charset и семейство шага, а при достижении MaxCacheEntries выселяется наименее недавно использованная запись. Значение 0 выключает кэширование, и каждый запрос доходит до вашего провайдера и валидируется заново. Отрицательное значение, или MaxFontBytes равное нулю или меньше, заставляет ConfigureSystemFontProvider поднять "Invalid system font provider policy"
Счётчик записей мало говорит о памяти, когда одна CJK-коллекция может перевалить за 20 МБ. Для бюджета в байтах ConfigureSystemFontCacheGovernor подключает TPdfCacheGovernor из модуля FPdfCache, создаваемый с максимальным количеством байт и разделяемый с другими кэшами компонента. Его тоже нужно устанавливать до загрузки библиотеки. Каждая кэшированная запись списывается на полную длину своих данных шрифта, поэтому коллекция на 20 МБ, отвечающая на запросы четырёх разных charset, считается против бюджета четыре раза, даже если провайдер каждый раз возвращает тот же массив. Когда губернатор отказывает резервированию, шрифт всё равно отдаётся — просто без кэширования. Держите объект губернатора живым, пока не выполнен UnloadLibrary, поскольку кэшированные записи держат против него резервации
Доказательство сопоставления в продакшене
GetSystemFontProviderStatistics возвращает запись TPdfSystemFontStatistics. Configured и Installed говорят, установлен ли провайдер и передан ли он PDFium. MapRequests считает каждый запрос сопоставления, а CacheHits, ProviderHits и DefaultFallbackHits показывают, чем они отвечались. FailedRequests считает те, на которые не ответил никто, и RejectedProviderResponses — ответы, отвергнутые политикой. Остальные поля следят за чтениями на уровне таблиц (FontDataRequests), живыми дескрипторами шрифтов, кэшированными шрифтами, кэшированными байтами и выселениями
Конформный прогон читает счётчики после партии, затем выгружает библиотеку. UnloadLibrary отвязывает провайдера от PDFium, освобождает платформенный маппер и опустошает кэш прежде, чем погасить PDFium, и отказывается выполняться, пока документы ещё открыты. ClearSystemFontProvider идёт последним; он поднимает исключение, если PDFium всё ещё загружен, и сбрасывает счётчики, так что читайте их заранее:
var
Recorder: TRecordingFontProvider;
RecorderRef: IPdfSystemFontProvider; // держит объект живым
Policy: TPdfSystemFontPolicy;
Stats: TPdfSystemFontStatistics;
begin
Recorder := TRecordingFontProvider.Create(TBundledFontProvider.Create(FontDir));
RecorderRef := Recorder;
Policy := TPdfSystemFontPolicy.Default;
Policy.AllowDefaultFallback := False;
Policy.AllowFaceSubstitution := False;
ConfigureSystemFontProvider(RecorderRef, Policy);
// FontDir, SampleFiles и RenderCorpus — ваши собственные; партия обязана
// закрыть каждый открытый документ до того, как выполнится UnloadLibrary
RenderCorpus(SampleFiles);
Stats := GetSystemFontProviderStatistics;
Writeln(Format('requests=%d cache=%d provider=%d fallback=%d',
[Stats.MapRequests, Stats.CacheHits, Stats.ProviderHits,
Stats.DefaultFallbackHits]));
Writeln(Format('rejected=%d failed=%d evictions=%d cachedBytes=%d',
[Stats.RejectedProviderResponses, Stats.FailedRequests,
Stats.CacheEvictions, Stats.CachedFontBytes]));
UnloadLibrary; // отвязывает провайдера, затем гасит PDFium
ClearSystemFontProvider; // допустимо только после выгрузки PDFium
if (Stats.FailedRequests > 0) or (Stats.RejectedProviderResponses > 0) then
raise Exception.Create('Font set incomplete:' + sLineBreak +
Recorder.MissedFaces);
end;
При выключенном откате DefaultFallbackHits держится на нуле, и каждая дыра попадает в FailedRequests, часто рядом с RejectedProviderResponses — когда провайдер ответил, но политика отвергла имя или размер. В производственной сборке с включённым откатом та же дыра переезжает в DefaultFallbackHits, и именно этот счётчик стоит выводить на график: рост после того, как новый клиент начал присылать документы, означает, что гарнитура, не покрытая вашим набором шрифтов, теперь рендерится тем, что предлагает хост. Правила потоков для остального компонента следуют описанной отдельно дисциплине render lock
Тот же экземпляр библиотеки занимается поставкой шрифтов, рендерингом и извлечением текста в Delphi, C++Builder и Lazarus, а на странице PDFium Component для Delphi описаны редакции и развёртывание нативной библиотеки