Ein Designteam legt für Berichtsüberschriften Inter mit Gewicht 620 und Breite 87,5 fest, der Berichtsgenerator bettet die Schriftdatei ein, und das PDF öffnet sich mit Überschriften in schlichtem Regular. Sucht man in der Datei nach 620, findet man es nirgendwo. Das ist zu erwarten: Ein PDF-Font-Dictionary (ISO 32000-1 §9.6 und §9.8) beschreibt ein festes Glyphenprogramm mit festen Breiten, und es gibt keinen Eintrag, in dem Achskoordinaten stehen könnten, also zeichnet ein Reader, der eine variable Schrift erhält, die in der Datei gespeicherten Outlines – die Standardinstanz. Damit Gewicht 620 aufs Papier kommt, müssen die Koordinaten in die Outlines eingebrannt werden, bevor die Schrift überhaupt das PDF erreicht
Einbrennen heißt mehr, als eine Zahl in einen Header zu schreiben. Es bedeutet, eine neue, in sich geschlossene statische Schrift zu erzeugen, deren Outlines, Vorschübe, Bounding Boxes und Layout-Tabellen alle zur gewählten Position im Designraum passen, und dann diese Schrift statt des Originals einzubetten
Was eine statische Instanz alles neu aufbauen muss
HotPDF baut diese statische Instanz während der Font-Registrierung, und bei einer TrueType-variablen Schrift berührt die Arbeit fast jede Tabelle der Datei. Eine OpenType-Variable-Schrift speichert einen Standard-Outline pro Glyphe zuzüglich Deltas in der gvar-Tabelle, jeder Delta-Satz gebunden an eine Region des Designraums. Für jede Glyphe berechnet die Bibliothek, wie stark jede Region an Ihren Koordinaten greift, akkumuliert die gewichteten Deltas in Fließkomma über alle Tupel und rundet jeden Punkt genau einmal am Ende. Rundete man je Tupel, würden sich Fehler auf Glyphen stapeln, die in vielen überlappenden Regionen liegen
Dann wird alles regeneriert, was aus den verschobenen Punkten abgeleitet ist. Die glyf-Tabelle wird neu geschrieben und loca im langen Offset-Format ausgegeben; hmtx (und vmtx, falls vorhanden) bekommt einen vollständigen Eintrag je Glyphe; die globale Bounding-Box in head und die Sammelfelder in hhea und vhea – maximale Vorschubbreite, minimale Seitenabstände, maximale Ausdehnung – werden aus den finalen Metriken neu berechnet; und die sfnt-Prüfsummen werden neu aufgebaut. Den schriftweiten Werten folgt der Rest: cvar-Deltas wandern in die cvt-Tabelle, MVAR passt Ascender, Descender und ähnliche Metriken an, und die Variationsdaten in GDEF, GPOS und den GSUB-Feature-Variationen werden an der gewählten Position aufgelöst
Sogar die beschreibenden Metadaten bewegen sich. OS/2 usWeightClass übernimmt den wght-Wert, also wird Gewicht 620 als 620 vermerkt; usWidthClass wird aus dem wdth-Prozentwert abgebildet, und 87,5 landet exakt auf Klasse 4, semi-condensed; eine slnt-Achse schreibt ihren Winkel in post.italicAngle. Zuletzt fliegen die Variationstabellen raus: fvar, avar, gvar, HVAR, VVAR, MVAR, STAT und cvar, dazu DSIG, dessen Signatur Bytes bezeugte, die nicht mehr existieren. Eine Schrift, die fvar behielt, nachdem ihre Outlines verschoben wurden, würde jeden variationsbewussten Verbraucher einladen, dieselben Deltas ein zweites Mal anzuwenden
CFF2-Variable-Schriften nehmen einen eigenen Weg. Ihre Charstrings tragen Blend-Operatoren, die ein statisches Fontprogramm nicht ausdrücken kann, also wandelt HotPDF eine CFF2-Schrift bei jeder Registrierung in eine statische Instanz um, selbst wenn alle Achsen auf ihren Defaults stehen. Diese Konvertierung und ihre Einbettung als CID-keyed CFF ist in CFF2-Variable-Font-Einbettung beschrieben
Phantompunkte und die Falle der doppelten Zählung
Die subtilste Regel betrifft die Metriken, und die OpenType-Spezifikation macht es leicht, sie falsch zu verstehen. In gvar setzt sich die Punktanzahl einer Glyphe aus ihren Outline-Punkten (beziehungsweise ihren Komponenten bei einer zusammengesetzten Glyphe) plus vier Phantompunkten zusammen, die linke Seitenlast, die Vorschubbreite und deren vertikale Entsprechungen kodieren. Diese Phantompunkte bekommen Deltas wie jeder andere Punkt auch
Eine Schrift mit gvar bringt sehr oft auch HVAR mit, weil HVAR einem Renderer die Vorschübe liefert, ohne dass er Outlines dekodieren muss. Wendet man beide an, wandert jeder Vorschub zweimal; bei Blocksatz driftet der Text mit jeder Glyphe ein Stück mehr nach rechts. Ist gvar vorhanden, leitet HotPDF horizontale und vertikale Metriken aus den interpolierten Phantompunkten ab und ignoriert HVAR und VVAR. Nur eine Schrift ohne gvar bekommt ihren Metrik-Variationsspeicher direkt in hmtx und vmtx eingebrannt. Diese Vorrangregel ist die sichere: gvar ist die einzige Tabelle, die Outlines und Metriken in einem einzigen Vorgang verschiebt, sodass ihre Antwort nie der Glyphe widersprechen kann, die sie beschreibt
Zwei weitere Regeln halten die Geometrie ehrlich. Punkte, die ein spärlicher Delta-Satz nicht aufführt, werden je Kontur per IUP (interpolate untouched points) abgeleitet, und Phantompunkte nehmen an dieser Interpolation nie teil. Bei zusammengesetzten Glyphen verschieben Deltas die Komponenten-Offsets nur, wenn die Komponente per XY-Werten positioniert ist; punktgleiche Komponenten beziehen ihre Position stattdessen aus den Attachment-Punkten. Danach werden die Kind-Bounds rekursiv neu berechnet, wobei die Verschachtelung auf 64 Ebenen begrenzt ist, sodass ein missgestalteter Komponentengraph, der auf sich selbst verweist, mit einer zurückgewiesenen Schrift endet statt mit endloser Rekursion
Den Designraum mit InspectVariableFont lesen
InspectVariableFont ist der erste Aufruf, denn er verrät, welche Achsen existieren und welchen Bereich jede akzeptiert. Für eine fehlende Datei oder eine Schrift ohne fvar liefert er False; bei einer .ttc-Sammlung liest er das erste Mitglied. Jeder THPDFVariableFontAxis-Datensatz trägt das Vier-Byte-Tag, MinimumValue, DefaultValue, MaximumValue, Flags und eine NameID. Jede benannte Instanz trägt eine SubfamilyNameID, Flags, eine PostScriptNameID und je Achse einen Eintrag in Coordinates, in Achsenreihenfolge
// ClampToAxis ist ein Helfer, den Sie selbst ergänzen; HotPDF begrenzt nicht für Sie
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;
Der Bereich ist wichtig, weil HotPDF Werte außerhalb des Bereichs zurückweist. Die Auswahl von Gewicht 1000 bei einer Schrift, deren wght-Achse bei 900 endet, lässt die Registrierung eine Exception auslösen, die Achse, den angeforderten Wert und den erlaubten Bereich nennt. Stillschweigendes Begrenzen hätte ein PDF erzeugt, das der Vorschau auf dem Bildschirm widerspricht, deshalb gehört die Prüfung in Ihre Oberfläche, wo sich die Grenzen des Schiebereglers direkt aus MinimumValue und MaximumValue speisen können
Warum müssen Achsauswahlen vor RegisterUnicodeTTF stehen?
Achsauswahlen werden genau einmal gelesen, wenn RegisterUnicodeTTF die Schriftdatei lädt, also müssen sie vorher gesetzt sein. SetVariableFontAxis nimmt ein Vier-Byte-Tag aus druckbarem ASCII und einen endlichen Wert; alles andere löst sofort eine Exception aus, und dieselbe Marke erneut zu setzen ersetzt den früheren Wert. GetVariableFontAxisSelections meldet, was ansteht, und ClearVariableFontAxes leert die Liste. Nach der Registrierung berichtet GetRegisteredVariableFontAxes den vollständigen Koordinatensatz, der in den zuletzt registrierten Schriftschnitt eingebrannt wurde, wobei nicht gewählte Achsen mit ihren Defaults ergänzt sind
var
Pdf: THotPDF;
Frozen: THPDFVariableFontAxisValueArray;
I: Integer;
begin
Pdf := THotPDF.Create(nil);
try
Pdf.FileName := 'quarterly.pdf';
Pdf.BeginDoc;
Pdf.SetVariableFontAxis('wght', 620); // Semibold, keine benannte Instanz
Pdf.SetVariableFontAxis('wdth', 87.5); // leicht schmal (semi-condensed)
Pdf.RegisterUnicodeTTF('C:\Fonts\Inter.ttf');
Pdf.ClearVariableFontAxes; // nichts mehr anstehend für die nächste Schrift
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;
Der ClearVariableFontAxes-Aufruf direkt nach der Registrierung ist die Zeile, die Leute auslassen. Auswahlen bleiben anstehend, bis sie gelöscht werden: Lädt der nächste RegisterUnicodeTTF-Aufruf eine statische Schrift, löst er eine Exception aus, weil für eine Schrift ohne Variationen Achsauswahlen vorlagen; lädt er eine andere variable Familie ohne wdth-Achse, löst er ebenfalls aus, weil diese Achse nicht vorhanden ist. Beide Fehler tauchen weit entfernt vom Code auf, der die Achsen setzte. Nach jeder Registrierung löschen, und die Auswahl bleibt an die eine Schrift gebunden, für die sie gedacht war
Wenn jeder aufgelöste Wert seinem Achsen-Default entspricht, wird eine TrueType-Variable-Schrift registriert, wie sie ist, denn ihre gespeicherten Outlines sind bereits die Standardinstanz. Der oben beschriebene Neuaufbau läuft nur für Koordinaten abseits der Defaults oder für CFF2-Outlines
Einen eigenen Instanziierer über OnVariableFontInstance liefern
OnVariableFontInstance feuert während der Registrierung, sobald mindestens eine Achse abseits ihres Defaults liegt, und erhält die originalen Font-Bytes zusammen mit den aufgelösten Koordinaten. Ein Handler kann Handled auf False lassen und den eingebauten Instanziierer gewähren lassen, oder ihn auf True setzen und seine eigene statische Schrift in InstanceFontBytes zurückgeben. HotPDF prüft eine zurückgegebene Schrift, bevor er sie verwendet: Weniger als 12 Bytes oder eine Schrift, die noch fvar enthält, lösen eine Exception aus, statt eingebettet zu werden
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; // beim eingebauten Instanziierer bleiben
Coords := '';
for I := 0 to High(AxisValues) do
Coords := Coords + Format('%s=%g ',
[string(AxisValues[I].Tag), AxisValues[I].Value]);
// FLog ist Ihr eigenes Protokoll; halten Sie fest, was dieses PDF enthalten wird
FLog.Add(Format('instancing %d-byte font at %s',
[Length(SourceFontBytes), Coords]));
end;
// Verdrahtung: Pdf.OnVariableFontInstance := VariableFontInstance;
Die meisten Anwendungen sollten den Handler rein für die Protokollierung nutzen, wie oben. Den Instanziierer zu ersetzen ist sinnvoll, wenn eine Font-Pipeline außerhalb der Anwendung bereits freigegebene statische Instanzen erzeugt und das PDF byte-identisch zu ihnen sein muss; sonst hält der eingebaute Pfad Metriken, Layout-Tabellen und Metadaten miteinander konsistent, und diese Konsistenz ist der ganze Sinn der Instanziierung
Wie die Instanziierung mit Subsetting und Shaping zusammenspielt
Die Instanziierung läuft vor dem Subsetting, sodass der Subsetter eine gewöhnliche statische Schrift sieht: Er berechnet die Glyphen-Closure, behält die Glyphen, die das Dokument verwendet, und wirft den Rest weg, wie in Schrift-Subset-Closure und geformte Glyphen beschrieben. Die Identität, die HotPDF für das Caching verwendet, wird aus den Instanz-Bytes abgeleitet, sodass zwei Koordinatensätze derselben Familie nie einen Cache-Eintrag teilen können
Shaping liest die instanziierten Layout-Tabellen. GSUB und GPOS überleben die Instanziierung mit bereits aufgelösten Variationsdaten, sodass Ligaturen und die in OpenType-GSUB-Stilalternativen beschriebenen Alternativen weiter funktionieren, und eine Schrift, die Feature-Variationen nutzt, um über einem bestimmten Gewicht eine Glyphe zu tauschen, bekommt den Tausch, der zu 620 passt. Bei der Positionierung geht Layout-Code schief. Eine halbschmale Instanz hat schmalere Vorschübe als der Default, und GetWideTextWidth misst mit den Vorschüben des Schnitts, der tatsächlich registriert ist. Nach RegisterUnicodeTTF messen, und die Zeilenumbrüche, die Sie berechnen, sind die, die gedruckt werden
Die Instanziierung variabler Schriften sitzt in derselben Pipeline wie Einbettung, Subsetting und Shaping, und der vollständige Typografie-Funktionsumfang für Delphi und C++Builder ist auf der HotPDF-Delphi-PDF-Komponentenseite aufgeführt