Техническая статья

Вариативные шрифты в PDF: статические экземпляры

Дизайнеры задали для заголовков отчёта Inter с насыщенностью 620 и шириной 87,5, генератор отчётов встраивает файл шрифта, а PDF открывается с заголовками обычного Regular. Поищите в файле число 620 — не найдёте его нигде. И это ожидаемо: словарь шрифта в PDF (ISO 32000-1, §9.6 и §9.8) описывает фиксированную программу глифов с фиксированными ширинами, и ни в одной записи для координат осей места не предусмотрено, поэтому ридер, получивший вариативный шрифт, рисует контуры, сохранённые в файле, — то есть экземпляр по умолчанию. Чтобы насыщенность 620 попала на бумагу, координаты нужно запечь в контуры ещё до того, как шрифт доберётся до PDF

Запекание — это больше, чем вписать число в заголовок. Речь о создании нового самодостаточного статического шрифта, у которого контуры, ширины, ограничивающие рамки и таблицы разметки согласованы с выбранной точкой пространства дизайна, — и о встраивании в документ именно его, а не исходного файла

Что приходится пересобирать ради статического экземпляра

HotPDF собирает этот статический экземпляр при регистрации шрифта, и для вариативного шрифта с TrueType-начинкой работа задевает почти каждую таблицу файла. Вариативный шрифт OpenType хранит по одному контуру по умолчанию на глиф плюс дельты в таблице gvar, где каждый набор дельт привязан к области пространства дизайна. Для каждого глифа библиотека вычисляет, с каким весом каждая область действует в ваших координатах, суммирует взвешенные дельты в плавающей точке по всем кортежам и лишь в конце один раз округляет каждую точку. Округление по каждому кортежу отдельно позволило бы ошибкам накапливаться на глифах, попавших сразу в несколько перекрывающихся областей

Затем заново генерируется всё, что выведено из смещённых точек. Таблица glyf переписывается, loca выдаётся в длинном формате смещений; hmtx (и vmtx, если он есть) получает по полной записи на каждый глиф; общий ограничивающий прямоугольник в head и сводные поля hhea и vhea — максимальная ширина продвижения, минимальные боковые интервалы, максимальный вынос — пересчитываются по итоговым метрикам; контрольные суммы sfnt строятся заново. Вслед за ними обновляются и общешрифтовые значения: дельты cvar переносятся в таблицу cvt, MVAR поправляет верхний и нижний выносные элементы и подобные метрики, а данные вариаций в GDEF, GPOS и вариациях функций GSUB разрешаются в выбранной точке

Даже описательные метаданные сдвигаются. В OS/2 поле usWeightClass принимает значение из wght, поэтому насыщенность 620 записывается как 620; usWidthClass отображается из процентов wdth, и 87,5 попадает ровно в класс 4, полуузкий; ось slnt записывает свой угол в post.italicAngle. Наконец, из шрифта выходят таблицы вариаций: fvar, avar, gvar, HVAR, VVAR, MVAR, STAT и cvar, плюс DSIG, чья подпись покрывала байты, которых больше не существует. Шрифт, оставивший fvar после смещения контуров, приглашал бы любого потребителя, умеющего работать с вариациями, применить те же дельты повторно

Диаграмма конвейера инстанцирования вариативного шрифта HotPDF: дельты gvar интерполируются по выбранным координатам wght и wdth, метрики и таблицы пересобираются, таблицы вариаций срезаются до статического встраиваемого экземпляра
HotPDF интерполирует дельты gvar в выбранных вами координатах, перестраивает контуры и метрики и вычищает каждую таблицу вариаций, чтобы встроенная гарнитура читалась как обычный статический TrueType-шрифт

Вариативные шрифты с CFF2-начинкой идут отдельным маршрутом. Их чарстринги несут операторы blend, которые статическая программа шрифта выразить не может, поэтому HotPDF преобразует шрифт CFF2 в статический экземпляр при каждой регистрации, даже когда все оси стоят на значениях по умолчанию. Об этом преобразовании и его встраивании как CID-keyed CFF рассказано в статье о встраивании вариативных шрифтов CFF2

Фантомные точки и ловушка двойного применения

Самое тонкое правило касается метрик, и спецификация OpenType позволяет ошибиться в нём проще простого. В gvar число точек глифа — это точки его контура (или его компонентов, для составного глифа) плюс четыре фантомные точки, кодирующие левый боковой интервал, ширину продвижения и их вертикальные аналоги. Эти фантомные точки получают дельты наравне с любыми другими точками

У шрифта с gvar очень часто в комплекте есть и HVAR, потому что HVAR позволяет ридеру находить ширины продвижения без декодирования контуров. Применить обе таблицы — и каждое продвижение сдвинется дважды; выключенный по формату текст при этом уплывает вправо ещё на чуть-чуть с каждым глифом. Когда gvar присутствует, HotPDF выводит горизонтальные и вертикальные метрики из интерполированных фантомных точек и игнорирует HVAR и VVAR. Только шрифт без gvar получает своё хранилище вариаций метрик, запечённое прямо в hmtx и vmtx. Такой приоритет безопаснее: gvar — единственная таблица, которая двигает контуры и метрики одной операцией, поэтому её ответ не может разойтись с описываемым глифом

Ещё два правила удерживают геометрию честной. Точки, не перечисленные в разреженном наборе дельт, достраиваются по контуру с помощью IUP (интерполяция нетронутых точек), и фантомные точки в этой интерполяции никогда не участвуют. У составных глифов дельты сдвигают смещения компонентов, только если компонент позиционируется значениями XY; компоненты, сопоставленные по точкам, берут позицию из точек привязки. Затем границы дочерних глифов пересчитываются рекурсивно, причём вложенность ограничена 64 уровнями, чтобы испорченный граф компонентов, ссылающийся сам на себя, закончился отклонённым шрифтом, а не бесконечной рекурсией

Диаграмма HotPDF: фантомные точки gvar несут левый боковой интервал и ширину продвижения, плюс ловушка двойного применения, расширяющая каждое продвижение, когда HVAR применяется поверх метрик, выведенных из фантомных точек
При наличии gvar метрики приходят из интерполированных фантомных точек, поэтому наложение HVAR или VVAR сверху считает ту же вариацию дважды, и текст уплывает вправо по строке

Чтение пространства дизайна с помощью InspectVariableFont

InspectVariableFont — первый вызов, с которого стоит начать, потому что он сообщает, какие оси существуют и какой диапазон каждая принимает. Для отсутствующего файла или шрифта без fvar он вернёт False; для коллекции .ttc читается первый член. Каждая запись THPDFVariableFontAxis несёт четырёхбайтовый Tag, MinimumValue, DefaultValue, MaximumValue, Flags и NameID. Каждый именованный экземпляр несёт SubfamilyNameID, Flags, PostScriptNameID и по одной записи в Coordinates на ось, в порядке осей

// ClampToAxis — вспомогательная функция, которую вы добавляете сами; HotPDF не ограничивает значения за вас
function ClampToAxis(const Axis: THPDFVariableFontAxis; Value: Single): Single;
begin
  Result := Value;
  if Result < Axis.MinimumValue then Result := Axis.MinimumValue;
  if Result > Axis.MaximumValue then Result := Axis.MaximumValue;
end;

procedure ListDesignSpace(Pdf: THotPDF; const FontPath: string);
var
  Axes: THPDFVariableFontAxisArray;
  Instances: THPDFVariableFontNamedInstanceArray;
  I, J: Integer;
  Coords: string;
begin
  if not Pdf.InspectVariableFont(FontPath, Axes, Instances) then
  begin
    Writeln('static font: register it without axis selections');
    Exit;
  end;
  for I := 0 to High(Axes) do
    Writeln(Format('%s  min=%.1f default=%.1f max=%.1f',
      [string(Axes[I].Tag), Axes[I].MinimumValue,
       Axes[I].DefaultValue, Axes[I].MaximumValue]));
  for I := 0 to High(Instances) do
  begin
    Coords := '';
    for J := 0 to High(Instances[I].Coordinates) do
      Coords := Coords + Format('%s=%g ',
        [string(Axes[J].Tag), Instances[I].Coordinates[J]]);
    Writeln(Format('named instance %d: %s', [I, Coords]));
  end;
end;

Диапазон важен, потому что HotPDF отвергает значения вне диапазона. Выбор насыщенности 1000 для шрифта, чья ось wght заканчивается на 900, заставит регистрацию выбросить исключение с именем оси, запрошенным значением и допустимым диапазоном. Молчаливое ограничение выдало бы PDF, расходящийся с экранным предпросмотром, так что проверка — дело вашего интерфейса, где лимиты ползунка можно брать прямо из MinimumValue и MaximumValue

Почему выбор осей должен предшествовать RegisterUnicodeTTF?

Выбор осей считывается один раз, когда RegisterUnicodeTTF загружает файл шрифта, поэтому задавать его нужно заранее. SetVariableFontAxis принимает четырёхбайтовый тег из печатаемых ASCII-символов и конечное значение; всё остальное вызывает немедленное исключение, а повторная установка того же тега заменяет прежнее значение. GetVariableFontAxisSelections возвращает ожидающие применения выборы, а ClearVariableFontAxes опустошает список. После регистрации GetRegisteredVariableFontAxes сообщает полный набор координат, замороженный в последней зарегистрированной гарнитуре, причём оси без выбора заполняются значениями по умолчанию

var
  Pdf: THotPDF;
  Frozen: THPDFVariableFontAxisValueArray;
  I: Integer;
begin
  Pdf := THotPDF.Create(nil);
  try
    Pdf.FileName := 'quarterly.pdf';
    Pdf.BeginDoc;

    Pdf.SetVariableFontAxis('wght', 620);   // полужирный, но не именованный экземпляр
    Pdf.SetVariableFontAxis('wdth', 87.5);  // слегка уплотнённый
    Pdf.RegisterUnicodeTTF('C:\Fonts\Inter.ttf');
    Pdf.ClearVariableFontAxes;              // для следующего шрифта не остаётся отложенных выборов

    Frozen := Pdf.GetRegisteredVariableFontAxes;
    for I := 0 to High(Frozen) do
      Writeln(Format('%s = %g', [string(Frozen[I].Tag), Frozen[I].Value]));

    Pdf.CurrentPage.SetFont('Inter', [], 14, DEFAULT_CHARSET);
    Pdf.CurrentPage.UnicodeTextOut(60, 70, 0, 'Quarterly results');

    Pdf.EndDoc;
  finally
    Pdf.Free;
  end;
end;

Вызов ClearVariableFontAxes сразу после регистрации — та самая строка, которую все забывают. Выборы остаются отложенными, пока их не сбросят, поэтому если следующий вызов RegisterUnicodeTTF загрузит статический шрифт, он выбросит исключение: выборы осей были переданы для невариативного шрифта; а если он загрузит другое вариативное семейство без оси wdth, исключение случится из-за отсутствующей оси. Обе ошибки всплывают далеко от кода, задававшего оси. Сбрасывайте после каждой регистрации — и выбор останется привязан к тому единственному шрифту, для которого предназначался

Когда каждое вычисленное значение равно значению оси по умолчанию, TrueType-вариативный шрифт регистрируется как есть: его сохранённые контуры уже являются экземпляром по умолчанию. Описанная выше пересборка запускается только для координат, отличных от значений по умолчанию, или для контуров CFF2

Подключение собственного инстансера через OnVariableFontInstance

OnVariableFontInstance срабатывает при регистрации всякий раз, когда хотя бы одна ось отклонилась от значения по умолчанию, и получает исходные байты шрифта вместе с вычисленными координатами. Обработчик может оставить Handled равным False и позволить встроенному инстансеру продолжить, а может выставить True и вернуть собственный статический шрифт в InstanceFontBytes. HotPDF проверяет возвращённый шрифт перед использованием: меньше 12 байт или шрифт, в котором всё ещё сидит fvar, — исключение вместо встраивания

procedure TReportBuilder.VariableFontInstance(Sender: TObject;
  const SourceFontBytes: TBytes;
  const AxisValues: THPDFVariableFontAxisValueArray;
  out InstanceFontBytes: TBytes; out Handled: Boolean);
var
  I: Integer;
  Coords: string;
begin
  InstanceFontBytes := nil;
  Handled := False;   // оставляем встроенный инстансер
  Coords := '';
  for I := 0 to High(AxisValues) do
    Coords := Coords + Format('%s=%g ',
      [string(AxisValues[I].Tag), AxisValues[I].Value]);
  // FLog — ваш собственный журнал; записывайте, что окажется в этом PDF
  FLog.Add(Format('instancing %d-byte font at %s',
    [Length(SourceFontBytes), Coords]));
end;

// подключение: Pdf.OnVariableFontInstance := VariableFontInstance;

Большинству приложений обработчик нужен чисто для журналирования, как в примере выше. Замена инстансера имеет смысл, когда шрифтовой конвейер вне приложения уже выпускает утверждённые статические экземпляры и PDF обязан побайтово им соответствовать; иначе встроенный путь удерживает метрики, таблицы разметки и метаданные согласованными друг с другом, и именно эта согласованность — весь смысл инстансирования

Как инстансирование взаимодействует с подмножествами и шейпингом

Инстансирование выполняется до построения подмножества, поэтому сборщик подмножества видит обычный статический шрифт: он вычисляет замыкание глифов, оставляет глифы, которые использует документ, и отбрасывает остальные, как описано в статье о замыкании подмножества шрифта и шейпированных глифах. Идентичность, которую HotPDF использует для кеширования, выводится из байтов экземпляра, так что два набора координат одного семейства никогда не разделят запись кеша

Шейпинг читает уже инстансированные таблицы разметки. GSUB и GPOS переживают инстансирование с уже разрешёнными данными вариаций, поэтому лигатуры и альтернаты, описанные в статье о стилистических альтернатах OpenType GSUB, продолжают работать, а шрифт, использующий вариации функций для подмены глифа выше определённой насыщенности, получит подмену, соответствующую 620. Ошибается же код разметки на позиционировании. У полуузкого экземпляра продвижения уже, чем у экземпляра по умолчанию, а GetWideTextWidth измеряет с ширинами той гарнитуры, которая реально зарегистрирована. Меряйте после RegisterUnicodeTTF — и вычисленные вами переносы строк совпадут с напечатанными

Инстансирование вариативных шрифтов живёт в одном конвейере со встраиванием, построением подмножеств и шейпингом, а полный набор типографических возможностей для Delphi и C++Builder перечислен на странице компонента HotPDF для Delphi PDF