Un team di design specifica Inter a peso 620 e larghezza 87.5 per i titoli dei report, il generatore incorpora il file del font, e il PDF si apre con i titoli in Regular normale. Cercate 620 nel file e non lo trovate da nessuna parte. È il comportamento atteso: un dizionario font PDF (ISO 32000-1 §9.6 e §9.8) descrive un programma di glifi fisso con larghezze fisse, e non esiste alcuna voce in cui le coordinate degli assi possano trovare posto, quindi un reader che riceve un font variabile disegna i contorni memorizzati nel file, che sono l'istanza predefinita. Per portare il peso 620 sulla carta, le coordinate vanno fissate nei contorni prima che il font arrivi al PDF
Fissare le coordinate è più che scrivere un numero in un header. Significa produrre un nuovo font statico autosufficiente i cui contorni, avanzi, bounding box e tabelle di layout concordano tutti con la posizione scelta nello spazio di design, per poi incorporare quel font al posto dell'originale
Cosa deve ricostruire un'istanza statica
HotPDF costruisce quell'istanza statica durante la registrazione del font, e per un font variabile di flavor TrueType il lavoro tocca quasi ogni tabella del file. Un font variabile OpenType memorizza un contorno predefinito per glifo più i delta nella tabella gvar, ogni set di delta legato a una regione dello spazio di design. Per ogni glifo la libreria calcola quanto fortemente ogni regione si applica alle vostre coordinate, accumula i delta ponderati in virgola mobile attraverso tutti i tuple, e arrotonda ogni punto una sola volta alla fine. Arrotondare per tuple lascerebbe accumulare errori sui glifi che stanno in molte regioni sovrapposte
Poi tutto ciò che deriva dai punti spostati viene rigenerato. La tabella glyf viene riscritta e loca viene emessa nel formato a offset lunghi; hmtx (e vmtx quando presente) riceve una voce completa per glifo; il bounding box globale in head e i campi riassuntivi in hhea e vhea — avanzamento massimo, side bearing minimi, estensione massima — vengono ricalcolati dalle metriche finali; e i checksum sfnt vengono ricostruiti. Anche i valori a livello di font seguono: i delta di cvar finiscono nella tabella cvt, MVAR aggiusta ascender, descender e metriche simili, e i dati di variazione in GDEF, GPOS e nelle variazioni di feature di GSUB vengono risolti alla posizione scelta
Pure i metadati descrittivi si spostano. Il OS/2 usWeightClass prende il valore di wght, quindi il peso 620 viene registrato come 620; usWidthClass viene mappato dalla percentuale di wdth, e 87.5 cade esattamente sulla classe 4, semi-condensato; un asse slnt scrive il suo angolo in post.italicAngle. Infine le tabelle di variazione escono dal file: fvar, avar, gvar, HVAR, VVAR, MVAR, STAT e cvar, più DSIG, la cui firma copriva byte che non esistono più. Un font che avesse conservato fvar dopo aver spostato i propri contorni inviterebbe qualunque consumer consapevole delle variazioni ad applicare gli stessi delta una seconda volta
I font variabili di flavor CFF2 seguono una strada separata. I loro charstring contengono operatori blend che un programma font statico non può esprimere, quindi HotPDF converte un font CFF2 in un'istanza statica ogni volta che viene registrato, anche quando tutti gli assi sono sui valori predefiniti. Questa conversione e il suo incorporamento come CFF indicizzato CID sono trattati in incorporamento dei font variabili CFF2
Punti fantasma e la trappola del doppio conteggio
La regola più sottile riguarda le metriche, e la specifica OpenType rende facile sbagliare. In gvar, il numero di punti di un glifo è dato dai suoi punti di contorno (o dai suoi componenti, per un glifo composto) più quattro punti fantasma che codificano il side bearing sinistro, la larghezza di avanzamento e le loro controparti verticali. Quei punti fantasma ricevono delta come qualsiasi altro punto
Un font che ha gvar molto spesso include anche HVAR, perché HVAR permette a un renderer di trovare gli avanzi senza decodificare i contorni. Applicate entrambi e ogni avanzo si sposta due volte; il testo giustificato quindi slitta verso destra un po' di più a ogni glifo. Quando gvar è presente, HotPDF deriva le metriche orizzontali e verticali dai punti fantasma interpolati e ignora HVAR e VVAR. Solo un font senza gvar vede il proprio archivio di variazione delle metriche fissato direttamente in hmtx e vmtx. Questa precedenza è quella più sicura: gvar è l'unica tabella che sposta contorni e metriche nella stessa operazione, quindi la sua risposta non può mai essere in disaccordo con il glifo che descrive
Due altre regole mantengono onesta la geometria. I punti non elencati in un set di delta sparsi vengono dedotti per contorno con IUP (interpolate untouched points), e i punti fantasma non partecipano mai a quell'interpolazione. Per i glifi composti, i delta spostano gli offset dei componenti solo quando il componente è posizionato con valori XY; i componenti con puntamento a punti prendono la posizione dai punti di aggancio. I bounding box dei figli vengono poi ricalcolati ricorsivamente, con l'annidamento limitato a 64 livelli, così un grafo di componenti malformato che rimanda a se stesso finisce con un font rifiutato invece che con una ricorsione infinita
Leggere lo spazio di design con InspectVariableFont
InspectVariableFont è la prima chiamata da fare, perché vi dice quali assi esistono e quale intervallo accetta ciascuno. Restituisce False per un file mancante o un font senza fvar; per una collezione .ttc legge il primo membro. Ogni record THPDFVariableFontAxis porta il Tag a quattro byte, MinimumValue, DefaultValue, MaximumValue, Flags e un NameID. Ogni istanza nominata porta un SubfamilyNameID, Flags, un PostScriptNameID e una voce in Coordinates per asse, in ordine di asse
// ClampToAxis è un helper che aggiungete voi; HotPDF non fa clamping per voi
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;
L'intervallo conta perché HotPDF rifiuta i valori fuori intervallo. Una selezione del peso 1000 su un font il cui asse wght si ferma a 900 fa generare alla registrazione un'eccezione che nomina l'asse, il valore richiesto e l'intervallo consentito. Limitare in silenzio avrebbe prodotto un PDF in disaccordo con l'anteprima a schermo, quindi il controllo sta nella vostra UI, dove i limiti dello slider possono arrivare direttamente da MinimumValue e MaximumValue
Perché le selezioni degli assi devono precedere RegisterUnicodeTTF?
Le selezioni degli assi vengono lette una volta sola, quando RegisterUnicodeTTF carica il file del font, quindi vanno impostate prima. SetVariableFontAxis prende un tag a quattro byte di ASCII stampabile e un valore finito; qualunque altra cosa genera subito un'eccezione, e impostare di nuovo lo stesso tag sostituisce il valore precedente. GetVariableFontAxisSelections restituisce ciò che è in attesa, e ClearVariableFontAxes svuota la lista. Dopo la registrazione, GetRegisteredVariableFontAxes riporta il set completo di coordinate congelato nel font registrato più di recente, con gli assi non selezionati riempiti ai loro valori predefiniti
var
Pdf: THotPDF;
Frozen: THPDFVariableFontAxisValueArray;
I: Integer;
begin
Pdf := THotPDF.Create(nil);
try
Pdf.FileName := 'quarterly.pdf';
Pdf.BeginDoc;
Pdf.SetVariableFontAxis('wght', 620); // semibold, non un'istanza nominata
Pdf.SetVariableFontAxis('wdth', 87.5); // semi-condensato
Pdf.RegisterUnicodeTTF('C:\Fonts\Inter.ttf');
Pdf.ClearVariableFontAxes; // nulla resta in attesa per il font successivo
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;
La chiamata ClearVariableFontAxes subito dopo la registrazione è la riga che la gente dimentica. Le selezioni restano in attesa finché non vengono cancellate, quindi se la successiva chiamata RegisterUnicodeTTF carica un font statico, genera un'eccezione perché sono state fornite selezioni di assi per un font non variabile; se carica una famiglia variabile diversa senza asse wdth, genera un'eccezione perché quell'asse non è presente. Entrambi i fallimenti affiorano lontano dal codice che aveva impostato gli assi. Cancellate dopo ogni registrazione e la selezione resta legata all'unico font per cui era pensata
Quando ogni valore risolto equivale al predefinito del proprio asse, un font variabile TrueType viene registrato così com'è, dato che i suoi contorni memorizzati sono già l'istanza predefinita. La ricostruzione descritta sopra gira solo per coordinate non predefinite o per contorni CFF2
Fornire il proprio instancer tramite OnVariableFontInstance
OnVariableFontInstance scatta durante la registrazione ogni volta che almeno un asse è lontano dal suo predefinito, e riceve i byte del font originale insieme alle coordinate risolte. Un handler può lasciare Handled a False e lasciar proseguire l'instancer integrato, oppure impostarlo a True e restituire il proprio font statico in InstanceFontBytes. HotPDF controlla un font restituito prima di usarlo: meno di 12 byte, o un font che contiene ancora fvar, e si genera un'eccezione invece di incorporarlo
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; // si tiene l'instancer integrato
Coords := '';
for I := 0 to High(AxisValues) do
Coords := Coords + Format('%s=%g ',
[string(AxisValues[I].Tag), AxisValues[I].Value]);
// FLog è il vostro logger; registrate cosa conterrà questo PDF
FLog.Add(Format('instancing %d-byte font at %s',
[Length(SourceFontBytes), Coords]));
end;
// cablaggio: Pdf.OnVariableFontInstance := VariableFontInstance;
La maggior parte delle applicazioni dovrebbe usare l'handler soltanto per il logging, come sopra. Sostituire l'instancer ha senso quando una pipeline di font esterna all'applicazione produce già istanze statiche approvate e il PDF deve corrispondervi byte per byte; altrimenti il percorso integrato mantiene metriche, tabelle di layout e metadati coerenti tra loro, e quella coerenza è il punto centrale dell'instanziazione
Come l'instanziazione interagisce con subsetting e shaping
L'instanziazione gira prima del subsetting, quindi il subsetter vede un font statico ordinario: calcola la chiusura dei glifi, conserva i glifi che il documento usa e scarta il resto, come descritto in chiusura del subset di font e glifi con shaping. L'identità che HotPDF usa per la cache deriva dai byte dell'istanza, quindi due set di coordinate della stessa famiglia non possono mai condividere una voce di cache
Lo shaping legge le tabelle di layout istanziate. GSUB e GPOS sopravvivono all'instanziazione con i loro dati di variazione già risolti, quindi le legature e le alternative descritte in alternative stilistiche OpenType GSUB continuano a funzionare, e un font che usa feature variations per scambiare un glifo sopra un certo peso ottiene lo scambio che corrisponde a 620. Il posizionamento è dove il codice di layout va in errore. Un'istanza semi-condensata ha avanzi più stretti del predefinito, e GetWideTextWidth misura con gli avanzi del font effettivamente registrato. Misurate dopo RegisterUnicodeTTF e le interruzioni di riga che calcolate sono quelle che finiscono stampate
L'instanziazione dei font variabili sta nella stessa pipeline di incorporamento, subsetting e shaping, e il set completo di funzionalità tipografiche per Delphi e C++Builder è elencato nella pagina del componente Delphi PDF HotPDF