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
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
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