Technisch artikel

Variabele lettertypen in PDF: statische instancing in Delphi

Een designteam kiest voor rapportkoppen Inter op gewicht 620 en breedte 87,5, de rapportgenerator sluit het lettertypebestand in, en de PDF opent met koppen in gewoon Regular. Zoek in het bestand naar 620 en u vindt nergens een spoor. Dat is te verwachten: een PDF-lettertypewoordenboek (ISO 32000-1 §9.6 en §9.8) beschrijft een vast glyphprogramma met vaste breedtes, en er is geen entry waar as-coördinaten onderdak kunnen vinden, dus een lezer die een variabel lettertype ontvangt, tekent de contouren die in het bestand staan, oftewel de standaardinstantie. Om gewicht 620 op papier te krijgen, moeten de coördinaten in de contouren worden gebakken voordat het lettertype de PDF bereikt

Bakken is meer dan een getal in een header schrijven. Het betekent dat er een nieuwe, zelfstandige statische lettertype wordt geproduceerd waarvan contouren, voorschotbreedtes, bounding boxes en layouttabellen allemaal overeenkomen met de gekozen locatie in de ontwerpruimte, en dat vervolgens dat lettertype wordt ingesloten in plaats van het origineel

Wat een statische instantie moet herbouwen

HotPDF bouwt die statische instantie tijdens de lettertyperegistratie, en bij een TrueType-variabel lettertype komt daarbij vrijwel elke tabel in het bestand aan te pas. Een OpenType-variabel lettertype slaat één standaardcontour per glyph op plus deltawaarden in de gvar-tabel, waarbij elke deltaset aan een regio van de ontwerpruimte is gekoppeld. Per glyph berekent de bibliotheek hoe sterk elke regio op uw coördinaten doorwerkt, telt de gewogen delta's in floating point over alle tuples op en rondt elk punt één keer aan het eind af. Per tuple afronden zou fouten laten opstapelen bij glyphs die in veel overlappende regio's liggen

Daarna wordt alles wat van de verplaatste punten is afgeleid opnieuw gegenereerd. De glyf-tabel wordt herschreven en loca wordt in het lange offsetformaat uitgeschreven; hmtx (en vmtx indien aanwezig) krijgt één volledige entry per glyph; de globale bounding box in head en de samenvattende velden in hhea en vhea — maximale voorschotbreedte, minimale zijmarges, maximale omvang — worden opnieuw berekend uit de definitieve metrics; en de sfnt-checksums worden herbouwd. Ook de lettertypebrede waarden volgen: cvar-delta's gaan in de cvt-tabel, MVAR past ascender, descender en vergelijkbare metrics aan, en de variatiedata in GDEF, GPOS en de GSUB-featurevariaties wordt op de gekozen locatie uitgewerkt

Zelfs de beschrijvende metadata verschuift. De usWeightClass in OS/2 krijgt de wght-waarde, dus gewicht 620 wordt ook als 620 vastgelegd; usWidthClass wordt afgeleid van het wdth-percentage, en 87,5 valt exact op klasse 4, semi-condensed; een slnt-as schrijft zijn hoek weg in post.italicAngle. Tenslotte verdwijnen de variatietabellen: fvar, avar, gvar, HVAR, VVAR, MVAR, STAT en cvar, plus DSIG, waarvan de handtekening betrekking had op bytes die niet meer bestaan. Een lettertype dat fvar zou behouden nadat zijn contouren zijn verplaatst, nodigt elke variatiebewuste consument uit om dezelfde delta's een tweede keer toe te passen

HotPDF-diagram van de instancing-pijplijn voor variabele lettertypen: gvar-delta's geïnterpoleerd op gekozen wght- en wdth-coördinaten, metrics en tabellen herbouwd, variatietabellen gestript tot een statische insluitbare instantie
HotPDF interpoleert gvar-delta's op de coördinaten die u kiest, herbouwt contouren en metrics, en stript elke variatietabel zodat het ingesloten lettertype leest als een gewoon statisch TrueType-lettertype

CFF2-variabele lettertypen volgen een aparte route. Hun charstrings bevatten blend-operators die een statisch fontprogramma niet kan uitdrukken, dus HotPDF converteert een CFF2-lettertype bij elke registratie naar een statische instantie, ook als alle assen op hun standaardwaarden staan. Die conversie en het insluiten ervan als CID-keyed CFF worden behandeld in het insluiten van CFF2-variabele lettertypen

Phantoompunten en de valkuil van dubbel toepassen

De subtielste regel betreft de metrics, en de OpenType-specificatie maakt het gemakkelijk om hier de plank mis te slaan. In gvar is het puntenaantal voor een glyph gelijk aan zijn contourpunten (of zijn componenten, voor een samengestelde glyph) plus vier phantoompunten die de linker zijmarge, de voorschotbreedte en hun verticale tegenhangers coderen. Die phantoompunten krijgen delta's zoals elk ander punt

Een lettertype met gvar bevat meestal ook HVAR, omdat HVAR een renderer in staat stelt voorschotbreedtes te vinden zonder contouren te decoderen. Beide toepassen en elke voorschotbreedte schuift twee keer op; uitgevulde tekst drijft dan met elke glyph iets verder naar rechts. Als gvar aanwezig is, leidt HotPDF de horizontale en verticale metrics af uit de geïnterpoleerde phantoompunten en negeert het HVAR en VVAR. Alleen een lettertype zonder gvar krijgt zijn metriekvariatie-opslag rechtstreeks in hmtx en vmtx gebakken. Die voorrang is de veiligere: gvar is de enige tabel die contouren en metrics in dezelfde operatie verplaatst, dus zijn uitkomst kan nooit in tegenspraak zijn met de glyph die het beschrijft

Nog twee regels houden de geometrie eerlijk. Punten die niet in een sparse deltaset zijn opgenomen, worden per contour afgeleid met IUP (interpolate untouched points), en phantoompunten doen nooit mee aan die interpolatie. Bij samengestelde glyphs verplaatsen delta's alleen de componentoffsets wanneer de component via XY-waarden is gepositioneerd; puntgewijze gekoppelde componenten halen hun positie uit de attach-punten. Daarna worden de kind-omhullenden recursief opnieuw berekend, met een nestingslimiet van 64 niveaus, zodat een misvormde componentgraaf die naar zichzelf verwijst eindigt in een geweigerd lettertype in plaats van eindeloze recursie

HotPDF-diagram van gvar-phantoompunten die de linker zijmarge en de voorschotbreedte dragen, en de valkuil van dubbel toepassen die elke voorschotbreedte verbreedt wanneer HVAR bovenop uit phantoompunten afgeleide metrics wordt toegepast
Met gvar aanwezig komen de metrics uit geïnterpoleerde phantoompunten, dus HVAR of VVAR er bovenop toepassen telt dezelfde variatie dubbel en schuift tekst over de regel naar rechts

De ontwerpruimte lezen met InspectVariableFont

InspectVariableFont is de eerste aanroep die u maakt, want hij vertelt welke assen bestaan en welk bereik elke as accepteert. Hij geeft False terug bij een ontbrekend bestand of een lettertype zonder fvar; bij een .ttc-collectie leest hij het eerste lid. Elk THPDFVariableFontAxis-record bevat de vier-byte Tag, MinimumValue, DefaultValue, MaximumValue, Flags en een NameID. Elke benoemde instantie bevat een SubfamilyNameID, Flags, een PostScriptNameID en per as één entry in Coordinates, in asvolgorde

// ClampToAxis is een helper die u zelf toevoegt; HotPDF begrenst niet voor u
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;

Het bereik is belangrijk omdat HotPDF waarden buiten het bereik weigert. Een selectie van gewicht 1000 op een lettertype waarvan de wght-as bij 900 stopt, zorgt ervoor dat de registratie een exception gooit waarin de as, de gevraagde waarde en het toegestane bereik worden genoemd. Stilletjes begrenzen zou een PDF hebben opgeleverd die niet overeenkomt met de preview op het scherm, dus die controle hoort thuis in uw UI, waar de limieten van de schuifregelaar rechtstreeks uit MinimumValue en MaximumValue kunnen komen

Waarom moeten as-selecties aan RegisterUnicodeTTF voorafgaan?

As-selecties worden één keer gelezen, op het moment dat RegisterUnicodeTTF het lettertypebestand laadt, dus ze moeten vooraf zijn ingesteld. SetVariableFontAxis neemt een vier-byte tag van afdrukbare ASCII en een eindige waarde; alles anders gooit direct een exception, en dezelfde tag opnieuw instellen vervangt de eerdere waarde. GetVariableFontAxisSelections geeft terug wat er openstaat, en ClearVariableFontAxes maakt de lijst leeg. Na registratie rapporteert GetRegisteredVariableFontAxes de volledige coördinatenset die in de meest recent geregistreerde face is bevroren, waarbij niet gekozen assen op hun standaardwaarden zijn ingevuld

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

    Pdf.SetVariableFontAxis('wght', 620);   // semibold, geen benoemde instantie
    Pdf.SetVariableFontAxis('wdth', 87.5);  // semi-condensed
    Pdf.RegisterUnicodeTTF('C:\Fonts\Inter.ttf');
    Pdf.ClearVariableFontAxes;              // niets meer openstaan voor het volgende lettertype

    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;

De ClearVariableFontAxes-aanroep direct na de registratie is de regel die mensen overslaan. Selecties blijven openstaan tot ze worden gewist, dus laadt de volgende RegisterUnicodeTTF-aanroep een statisch lettertype, dan volgt een exception omdat er as-selecties zijn opgegeven voor een niet-variabel lettertype; laadt hij een andere variabele familie zonder wdth-as, dan volgt een exception omdat die as ontbreekt. Beide fouten komen ver van de code aan het licht die de assen heeft ingesteld. Wis na elke registratie en de selectie blijft gekoppeld aan het ene lettertype waarvoor hij bedoeld was

Als elke uitgewerkte waarde gelijk is aan de standaardwaarde van zijn as, wordt een TrueType-variabel lettertype geregistreerd zoals het is, want de opgeslagen contouren zijn al de standaardinstantie. De herbouw hierboven draait alleen voor coördinaten die van de standaard afwijken of voor CFF2-contouren

Uw eigen instancer aanreiken via OnVariableFontInstance

OnVariableFontInstance afgaat tijdens de registratie zodra minstens één as van zijn standaardwaarde afwijkt, en het event ontvangt de oorspronkelijke lettertypebytes samen met de uitgewerkte coördinaten. Een handler kan Handled op False laten en de ingebouwde instancer zijn gang laten gaan, of het op True zetten en zijn eigen statische lettertype teruggeven in InstanceFontBytes. HotPDF controleert een teruggegeven lettertype voordat het wordt gebruikt: minder dan 12 bytes, of een lettertype dat nog fvar bevat, levert een exception op in plaats van te worden ingesloten

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;   // de ingebouwde instancer laten doorgaan
  Coords := '';
  for I := 0 to High(AxisValues) do
    Coords := Coords + Format('%s=%g ',
      [string(AxisValues[I].Tag), AxisValues[I].Value]);
  // FLog is uw eigen logger; leg vast wat deze PDF gaat bevatten
  FLog.Add(Format('instancing %d-byte font at %s',
    [Length(SourceFontBytes), Coords]));
end;

// koppeling: Pdf.OnVariableFontInstance := VariableFontInstance;

De meeste toepassingen gebruiken de handler puur voor logging, zoals hierboven. De instancer vervangen is zinvol wanneer een fontpijplijn buiten de toepassing al goedgekeurde statische instanties produceert en de PDF er byte voor byte aan moet voldoen; anders houdt het ingebouwde pad metrics, layouttabellen en metadata onderling consistent, en die consistentie is precies het doel van instancing

Hoe instancing samenwerkt met subsetting en shaping

Instancing draait vóór de subsetting, dus de subsetter ziet een gewoon statisch lettertype: hij berekent de glyph-closure, houdt de glyphs vast die het document gebruikt en laat de rest vallen, zoals beschreven in font-subsetclosure en geshapete glyphs. De identiteit die HotPDF voor caching gebruikt, is afgeleid uit de instantiebytes, dus twee coördinatensets van dezelfde familie kunnen nooit een cache-entry delen

Shaping leest de geïnstantieerde layouttabellen. GSUB en GPOS overleven instancing met hun variatiedata al uitgewerkt, dus ligaturen en de alternatieven uit OpenType GSUB stilistische alternatieven blijven werken, en een lettertype dat featurevariaties gebruikt om boven een bepaald gewicht een glyph te wisselen, krijgt de wissel die bij 620 hoort. Bij de positionering gaat lay-outcode mis. Een semi-condensed instantie heeft smallere voorschotbreedtes dan de standaard, en GetWideTextWidth meet met de voorschotbreedtes van de face die daadwerkelijk is geregistreerd. Meet ná RegisterUnicodeTTF en de regelafbrekingen die u berekent, zijn degene die worden afgedrukt

Instancing van variabele lettertypen zit in dezelfde pijplijn als insluiten, subsetting en shaping, en de volledige typografiefunctieset voor Delphi en C++Builder staat vermeld op de HotPDF Delphi PDF-componentpagina