Artigo Técnico

Fontes variáveis em PDF: instanciação estática no Delphi

A equipe de design especifica Inter no peso 620 e largura 87,5 para os títulos do relatório, o gerador de relatórios incorpora o arquivo da fonte, e o PDF abre com títulos em Regular simples. Procure pelo 620 no arquivo e você não vai encontrar nada. Isso é o esperado: um dicionário de fontes PDF (ISO 32000-1 §9.6 e §9.8) descreve um programa de glifos fixo com larguras fixas, e não há nenhuma entrada em que coordenadas de eixo possam ficar, então um leitor que recebe uma fonte variável desenha os contornos armazenados no arquivo, que são a instância padrão. Para levar o peso 620 ao papel, as coordenadas precisam ser gravadas nos contornos antes que a fonte chegue ao PDF

Baking é mais do que escrever um número em um cabeçalho: significa produzir uma nova fonte estática autossuficiente, na qual contornos, avanços, caixas delimitadoras e tabelas de layout estão todos de acordo com a posição escolhida no espaço de design, e depois incorporar essa fonte no lugar da original

O que uma instância estática precisa reconstruir

O HotPDF constrói essa instância estática durante o registro da fonte e, em uma fonte variável de sabor TrueType, o trabalho alcança quase todas as tabelas do arquivo. Uma fonte variável OpenType guarda um contorno padrão por glifo, além de deltas na tabela gvar, cada conjunto de deltas ligado a uma região do espaço de design. Para cada glifo, a biblioteca calcula a intensidade com que cada região se aplica nas suas coordenadas, acumula os deltas ponderados em ponto flutuante por todas as tuplas e arredonda cada ponto uma única vez, no final. Arredondar por tupla deixaria os erros se acumularem nos glifos que caem em muitas regiões sobrepostas

Em seguida, tudo o que derivou dos pontos movidos é regenerado. A tabela glyf é reescrita e a loca é emitida no formato de offsets longo; hmtx (e vmtx, quando presente) recebe uma entrada completa por glifo; a caixa delimitadora global em head e os campos de resumo em hhea e vhea — avanço máximo, side bearings mínimos, extensão máxima — são recalculados a partir das métricas finais; e os checksums do sfnt são reconstruídos. Os valores de toda a fonte também acompanham: os deltas de cvar vão para a tabela cvt, o MVAR ajusta ascender, descender e métricas semelhantes, e os dados de variação em GDEF, GPOS e nas variações de features do GSUB são resolvidos na posição escolhida

Até os metadados descritivos mudam. O usWeightClass da OS/2 recebe o valor de wght, então o peso 620 é registrado como 620; o usWidthClass é mapeado do percentual de wdth, e 87,5 cai exatamente na classe 4, semicondensada; um eixo slnt escreve seu ângulo em post.italicAngle. Por fim, as tabelas de variação saem: fvar, avar, gvar, HVAR, VVAR, MVAR, STAT e cvar, além do DSIG, cuja assinatura cobria bytes que não existem mais. Uma fonte que mantivesse o fvar depois de mover os contornos convidaria qualquer consumidor ciente de variações a aplicar os mesmos deltas uma segunda vez

Diagrama HotPDF do pipeline de instanciação de fontes variáveis: deltas do gvar interpolados em coordenadas wght e wdth selecionadas, métricas e tabelas reconstruídas, tabelas de variação removidas para uma instância estática incorporável
HotPDF interpola deltas de gvar nas coordenadas que você escolhe, reconstrói contornos e métricas e remove toda tabela de variação para que a fonte incorporada se leia como uma fonte TrueType estática comum

Fontes variáveis de sabor CFF2 seguem um caminho separado. Os charstrings delas carregam operadores blend que um programa de fonte estático não consegue expressar, então o HotPDF converte uma fonte CFF2 em uma instância estática toda vez que ela é registrada, mesmo com todos os eixos nos valores padrão. Essa conversão e sua incorporação como CFF com chaveamento CID estão cobertas em incorporação de fontes variáveis CFF2

Pontos fantasmas e a armadilha da contagem dupla

A regra mais sutil diz respeito às métricas, e a especificação OpenType torna fácil errar aqui. Em gvar, a contagem de pontos de um glifo é a dos pontos do contorno (ou dos componentes, no caso de um glifo composto) mais quatro pontos fantasmas que codificam o left side bearing, a largura de avanço e seus equivalentes verticais. Esses pontos fantasmas recebem deltas como qualquer outro ponto

Uma fonte que tem gvar muito frequentemente também traz HVAR, porque o HVAR permite que um renderizador encontre avanços sem decodificar contornos. Aplique os dois e cada avanço move duas vezes; o texto justificado então desliza um pouco mais para a direita a cada glifo. Quando o gvar está presente, o HotPDF deriva as métricas horizontais e verticais dos pontos fantasmas interpolados e ignora HVAR e VVAR. Só uma fonte sem gvar tem a sua loja de variação de métricas gravada diretamente em hmtx e vmtx. Essa precedência é a mais segura: gvar é a única tabela que move contornos e métricas na mesma operação, então a resposta dela nunca pode discordar do glifo que descreve

Mais duas regras mantêm a geometria honesta. Pontos não listados em um conjunto de deltas esparso são inferidos por contorno com IUP (interpolate untouched points), e os pontos fantasmas nunca participam dessa interpolação. Em glifos compostos, os deltas movem os offsets dos componentes apenas quando o componente é posicionado por valores XY; componentes com correspondência de pontos recebem a posição dos attachment points. Os limites dos filhos são então recalculados recursivamente, com aninhamento limitado a 64 níveis, para que um grafo de componentes malformado que se referencie termine em uma fonte rejeitada em vez de recursão infinita

Diagrama HotPDF dos phantom points do gvar carregando o left side bearing e o advance width, e a armadilha de aplicação dupla que alarga cada avanço quando HVAR é aplicado sobre métricas derivadas de phantom
Com gvar presente, as métricas vêm de phantom points interpolados, então aplicar HVAR ou VVAR por cima conta a mesma variação duas vezes e o texto desliza para a direita ao longo da linha

Lendo o espaço de design com InspectVariableFont

InspectVariableFont é a primeira chamada a fazer, porque informa quais eixos existem e qual intervalo cada um aceita. Retorna False para um arquivo ausente ou uma fonte sem fvar; em uma coleção .ttc, lê o primeiro membro. Cada registro THPDFVariableFontAxis carrega o Tag de quatro bytes, MinimumValue, DefaultValue, MaximumValue, Flags e um NameID. Cada instância nomeada carrega um SubfamilyNameID, Flags, um PostScriptNameID e uma entrada em Coordinates por eixo, na ordem dos eixos

// ClampToAxis é um helper que você mesmo adiciona; o HotPDF não limita por você
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;

O intervalo importa porque o HotPDF recusa valores fora da faixa. Uma seleção de peso 1000 em uma fonte cujo eixo wght para em 900 faz o registro disparar uma exceção citando o eixo, o valor pedido e a faixa permitida. Limitar silenciosamente produziria um PDF que discorda da pré-visualização na tela, então a verificação pertence à sua UI, onde os limites do slider podem vir direto de MinimumValue e MaximumValue

Por que as seleções de eixo precisam vir antes de RegisterUnicodeTTF?

As seleções de eixo são lidas uma única vez, quando o RegisterUnicodeTTF carrega o arquivo da fonte, então precisam ser definidas antes. O SetVariableFontAxis recebe uma tag de ASCII imprimível de quatro bytes e um valor finito; qualquer outra coisa dispara imediatamente, e definir a mesma tag de novo substitui o valor anterior. O GetVariableFontAxisSelections retorna o que está pendente, e o ClearVariableFontAxes esvazia a lista. Depois do registro, o GetRegisteredVariableFontAxes informa o conjunto completo de coordenadas que foi congelado na face registrada mais recentemente, com os eixos não selecionados preenchidos nos valores padrão

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

    Pdf.SetVariableFontAxis('wght', 620);   // semibold, não é uma instância nomeada
    Pdf.SetVariableFontAxis('wdth', 87.5);  // semicondensada
    Pdf.RegisterUnicodeTTF('C:\Fonts\Inter.ttf');
    Pdf.ClearVariableFontAxes;              // nada fica pendente para a próxima fonte

    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;

A chamada ClearVariableFontAxes logo após o registro é a linha que as pessoas esquecem. As seleções ficam pendentes até serem limpas, então se a próxima chamada RegisterUnicodeTTF carregar uma fonte estática, dispara porque seleções de eixo foram fornecidas para uma fonte não variável; se carregar uma família variável diferente sem eixo wdth, dispara porque esse eixo não está presente. As duas falhas aparecem longe do código que definiu os eixos. Limpe após cada registro e a seleção fica atada à única fonte a que se destinava

Quando todo valor resolvido é igual ao padrão do seu eixo, uma fonte variável TrueType é registrada como está, já que os contornos armazenados já são a instância padrão. A reconstrução descrita acima só roda para coordenadas fora do padrão ou para contornos CFF2

Fornecendo o seu próprio instanciador via OnVariableFontInstance

O OnVariableFontInstance dispara durante o registro sempre que pelo menos um eixo está fora do padrão, e recebe os bytes originais da fonte junto com as coordenadas resolvidas. Um handler pode deixar Handled como False e deixar o instanciador embutido seguir, ou defini-lo como True e retornar a sua própria fonte estática em InstanceFontBytes. O HotPDF verifica a fonte retornada antes de usá-la: menos de 12 bytes, ou uma fonte que ainda contém fvar, dispara uma exceção em vez de ser incorporada

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;   // mantém o instanciador embutido
  Coords := '';
  for I := 0 to High(AxisValues) do
    Coords := Coords + Format('%s=%g ',
      [string(AxisValues[I].Tag), AxisValues[I].Value]);
  // FLog é o seu próprio logger; registre o que este PDF vai conter
  FLog.Add(Format('instancing %d-byte font at %s',
    [Length(SourceFontBytes), Coords]));
end;

// ligação: Pdf.OnVariableFontInstance := VariableFontInstance;

A maioria das aplicações deve usar o handler puramente para log, como acima. Substituir o instanciador faz sentido quando um pipeline de fontes fora da aplicação já produz instâncias estáticas aprovadas e o PDF precisa bater com elas byte a byte; caso contrário, o caminho embutido mantém métricas, tabelas de layout e metadados consistentes entre si, e essa consistência é todo o ponto da instanciação

Como a instanciação interage com o subconjunto e a formatação (shaping)

A instanciação roda antes do subsetting, então o subsetter vê uma fonte estática comum: ele calcula o glyph closure, mantém os glifos que o documento usa e descarta o restante, como descrito em fechamento de subconjunto de fontes e glifos formatados. A identidade que o HotPDF usa para cache é derivada dos bytes da instância, então dois conjuntos de coordenadas da mesma família nunca podem compartilhar uma entrada de cache

O shaping lê as tabelas de layout instanciadas. GSUB e GPOS sobrevivem à instanciação com os dados de variação já resolvidos, então ligaduras e as alternativas descritas em alternativas estilísticas GSUB do OpenType continuam funcionando, e uma fonte que usa feature variations para trocar um glifo acima de certo peso recebe a troca que corresponde a 620. O posicionamento é onde o código de layout erra. Uma instância semicondensada tem avanços mais estreitos que o padrão, e o GetWideTextWidth mede com os avanços da face realmente registrada. Meça depois do RegisterUnicodeTTF e as quebras de linha que você calcular são as que saem impressas

A instanciação de fontes variáveis ocupa o mesmo pipeline de incorporação, subsetting e shaping, e o conjunto completo de recursos de tipografia para Delphi e C++Builder está listado na página do componente PDF Delphi da HotPDF