Zespół projektowy określa Inter grubością 620 i szerokością 87,5 dla nagłówków raportu, generator raportów osadza plik fontu, a otwarty PDF pokazuje nagłówki zwykłym Regular. Poszukaj w pliku wartości 620, a nie znajdziesz jej nigdzie. To oczekiwane: słownik fontu PDF (ISO 32000-1 §9.6 i §9.8) opisuje stały program glifów o stałych szerokościach i nie ma w nim wpisu, w którym mogłyby zamieszkać współrzędne osi, więc czytnik, który dostanie font zmienny, rysuje kontury zapisane w pliku, czyli instancję domyślną. Żeby grubość 620 trafiła na papier, współrzędne trzeba wypalić w konturach, zanim font w ogóle dotrze do PDF
Wypalanie to więcej niż wpisanie liczby do nagłówka. Chodzi o wyprodukowanie nowego, samodzielnego fontu statycznego, którego kontury, postępy, ramki otaczające i tabele układu zgadzają się z wybranym położeniem w przestrzeni projektowej, a potem o osadzenie tego fontu zamiast oryginału
Co statyczna instancja musi przebudować
HotPDF buduje tę statyczną instancję podczas rejestracji fontu, a dla fontu zmiennego w wariancie TrueType praca sięga niemal każdej tabeli w pliku. Font zmienny OpenType przechowuje jeden domyślny kontur na glif plus delty w tabeli gvar, przy czym każdy zestaw delt jest związany z regionem przestrzeni projektowej. Dla każdego glifu biblioteka oblicza, jak silnie każdy region działa przy twoich współrzędnych, akumuluje ważone delty w arytmetyce zmiennoprzecinkowej ze wszystkich krotek naraz i zaokrągla każdy punkt raz, na samym końcu. Zaokrąglanie per krotka pozwoliłoby błędom kumulować się na glifach siedzących w wielu nakładających się regionach
Potem regenerowane jest wszystko, co wynika z przesuniętych punktów. Tabela glyf jest przepisywana, loca wychodzi w formacie długich offsetów; hmtx (i vmtx, gdy jest obecna) dostaje jeden pełny wpis na glif; globalna ramka otaczająca w head i pola podsumowujące w hhea i vhea — maksymalny postęp, minimalne side bearings, maksymalny zasięg — są wyliczane od nowa z końcowych metryk; sumy kontrolne sfnt są przebudowywane. Wartości całego fontu idą w ślad za nimi: delty cvar trafiają do tabeli cvt, MVAR koryguje ascender, descender i podobne metryki, a dane wariacji w GDEF, GPOS i w wariacjach cech GSUB są rozwiązywane w wybranym położeniu
Przenosi się nawet metadane opisowe. usWeightClass w OS/2 bierze wartość wght, więc grubość 620 jest zapisywana jako 620; usWidthClass jest mapowany z procentu wdth i 87,5 trafia dokładnie na klasę 4, semi-condensed; oś slnt zapisuje swój kąt w post.italicAngle. Na koniec wypadają tabele wariacji: fvar, avar, gvar, HVAR, VVAR, MVAR, STAT i cvar, plus DSIG, którego podpis obejmował bajty, które już nie istnieją. Font, który po przesunięciu konturów zachowałby fvar, zapraszałby każdego konsumenta świadomego wariacji do nałożenia tych samych delt po raz drugi
Fonty zmienne w wariancie CFF2 idą osobną drogą. Ich charstringi niosą operatory blend, których statyczny program fontu nie wyrazi, więc HotPDF zamienia font CFF2 w statyczną instancję przy każdej rejestracji, nawet gdy wszystkie osie stoją na wartościach domyślnych. Tę konwersję i jej osadzanie jako CID-keyed CFF opisuje artykuł osadzanie fontów zmiennych CFF2
Punkty fantomowe i pułapka podwójnego liczenia
Najsubtelniejsza reguła dotyczy metryk, a specyfikacja OpenType sprzyja pomyłkom. W gvar liczba punktów glifu to punkty konturu (lub komponenty, dla glifu złożonego) plus cztery punkty fantomowe, które kodują left side bearing, szerokość postępu i ich pionowe odpowiedniki. Te punkty fantomowe dostają delty jak każdy inny punkt
Font, który ma gvar, bardzo często wozi ze sobą też HVAR, bo HVAR pozwala renderowi znaleźć postępy bez dekodowania konturów. Nałóż oba i każdy postęp ruszy dwa razy; tekst justowany dryfuje wtedy w prawo coraz bardziej z każdym glifem. Gdy jest gvar, HotPDF wyprowadza metryki poziome i pionowe z interpolowanych punktów fantomowych i ignoruje HVAR oraz VVAR. Tylko font bez gvar dostaje swoją wariację metryk wypaloną bezpośrednio w hmtx i vmtx. Ta kolejność jest bezpieczniejsza: gvar to jedyna tabela, która przesuwa kontury i metryki w jednej operacji, więc jej odpowiedź nigdy nie może rozmijać się z glifem, który opisuje
Jeszcze dwie reguły trzymają geometrię w ryzach. Punkty niewymienione w rzadkim zestawie delt są wnioskowane per kontur przez IUP (interpolację nietkniętych punktów), a punkty fantomowe nigdy nie biorą w tej interpolacji udziału. Dla glifów złożonych delty przesuwają offsety komponentów tylko wtedy, gdy komponent jest pozycjonowany wartościami XY; komponenty dopasowane punktowo biorą pozycję z punktów mocowania. Ramki potomków są potem przeliczane rekurencyjnie, przy zagnieżdżeniu ograniczonym do 64 poziomów, więc zniekształcony graf komponentów odwołujący się sam do siebie kończy odrzuconym fontem, a nie nieskończoną rekurencją
Odczytywanie przestrzeni projektowej przez InspectVariableFont
InspectVariableFont to pierwsze wywołanie, jakie należy zrobić, bo mówi, jakie osie istnieją i jaki zakres przyjmuje każda z nich. Zwraca False dla brakującego pliku lub fontu bez fvar; w kolekcji .ttc czyta pierwszego członka. Każdy rekord THPDFVariableFontAxis niesie czterobajtowy Tag, MinimumValue, DefaultValue, MaximumValue, Flags i NameID. Każda nazwana instancja niesie SubfamilyNameID, Flags, PostScriptNameID i po jednym wpisie w Coordinates na oś, w kolejności osi
// ClampToAxis to pomocnik, który dopisujesz sam; HotPDF nie obcina za ciebie
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;
Zakres ma znaczenie, bo HotPDF odmawia wartości spoza zakresu. Wybór grubości 1000 w foncie, którego oś wght kończy się na 900, sprawia, że rejestracja podnosi wyjątek wymieniający oś, żądaną wartość i dozwolony zakres. Ciche przycięcie wyprodukowałoby PDF niezgadzający się z podglądem na ekranie, więc ta kontrola należy do interfejsu użytkownika, gdzie ograniczenia suwaka mogą brać się wprost z MinimumValue i MaximumValue
Dlaczego wybory osi muszą wyprzedzać RegisterUnicodeTTF?
Wybory osi są czytane raz, gdy RegisterUnicodeTTF ładuje plik fontu, więc trzeba je ustawić zawczasu. SetVariableFontAxis przyjmuje czterobajtowy tag z drukowalnego ASCII i wartość skończoną; cokolwiek innego podnosi wyjątek od razu, a ponowne ustawienie tego samego tagu zastępuje wcześniejszą wartość. GetVariableFontAxisSelections zwraca to, co jeszcze wisi, a ClearVariableFontAxes opróżnia listę. Po rejestracji GetRegisteredVariableFontAxes raportuje pełny zestaw współrzędnych zamrożony w ostatnio zarejestrowanym kroju, z niewybranymi osiami uzupełnionymi wartościami domyślnymi
var
Pdf: THotPDF;
Frozen: THPDFVariableFontAxisValueArray;
I: Integer;
begin
Pdf := THotPDF.Create(nil);
try
Pdf.FileName := 'quarterly.pdf';
Pdf.BeginDoc;
Pdf.SetVariableFontAxis('wght', 620); // semibold, nie nazwana instancja
Pdf.SetVariableFontAxis('wdth', 87.5); // semi-condensed
Pdf.RegisterUnicodeTTF('C:\Fonts\Inter.ttf');
Pdf.ClearVariableFontAxes; // nic nie czeka już na kolejny font
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;
Wywołanie ClearVariableFontAxes zaraz po rejestracji to wiersz, który ludzie pomijają. Wybory wciąż wiszą, dopóki nie zostaną wyczyszczone, więc gdy następne RegisterUnicodeTTF ładuje font statyczny, podnosi wyjątek, bo dostarczono wybory osi dla fontu bez wariacji; a gdy ładuje inną zmienną rodzinę bez osi wdth, podnosi wyjątek, bo tej osi nie ma. Obie porażki wychodzą daleko od kodu, który ustawił osie. Czyść po każdej rejestracji, a wybór zostanie przywiązany do tego jednego fontu, dla którego był przeznaczony
Gdy każda rozwiązana wartość równa się domyślnej wartości swojej osi, font zmienny TrueType jest rejestrowany tak, jak leży, bo jego zapisane kontury już są instancją domyślną. Przebudowa opisana powyżej rusza tylko dla współrzędnych innych niż domyślne albo dla konturów CFF2
Podawanie własnego instancjonera przez OnVariableFontInstance
OnVariableFontInstance odpala się podczas rejestracji zawsze, gdy co najmniej jedna oś odstaje od wartości domyślnej, i dostaje oryginalne bajty fontu razem z rozwiązanymi współrzędnymi. Handler może zostawić Handled jako False i pozwolić wbudowanemu instancjonerowi działać dalej albo ustawić True i zwrócić własny font statyczny w InstanceFontBytes. HotPDF sprawdza zwrócony font, zanim go użyje: mniej niż 12 bajtów albo font, który wciąż zawiera fvar, podnosi wyjątek zamiast zostać osadzony
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; // zostaw wbudowany instancjoner
Coords := '';
for I := 0 to High(AxisValues) do
Coords := Coords + Format('%s=%g ',
[string(AxisValues[I].Tag), AxisValues[I].Value]);
// FLog to twój własny logger; zapisz, co ten PDF będzie zawierał
FLog.Add(Format('instancing %d-byte font at %s',
[Length(SourceFontBytes), Coords]));
end;
// podłączenie: Pdf.OnVariableFontInstance := VariableFontInstance;
Większość aplikacji powinna używać handlera czysto do logowania, jak wyżej. Wymiana instancjonera ma sens, gdy potok fontów poza aplikacją już produkuje zaakceptowane instancje statyczne, a PDF musi odpowiadać im bajt w bajt; w przeciwnym razie wbudowana droga trzyma metryki, tabele układu i metadane w zgodzie między sobą, a ta zgoda jest całym sensem instancjonowania
Jak instancjonowanie współdziała z tworzeniem podzbiorów i kształtowaniem
Instancjonowanie działa przed tworzeniem podzbiorów, więc subsetter widzi zwykły font statyczny: oblicza domknięcie glifów, zachowuje glify używane przez dokument i odrzuca resztę, co opisuje artykuł domknięcie podzbioru fontu i kształtowane glify. Tożsamość, której HotPDF używa do cache'owania, jest wyprowadzana z bajtów instancji, więc dwa zestawy współrzędnych tej samej rodziny nigdy nie podzielą wpisu w cache
Kształtowanie czyta zinstancjonowane tabele układu. GSUB i GPOS przechodzą przez instancjonowanie z danymi wariacji już rozwiązanymi, więc ligatury i warianty opisane w artykule warianty stylistyczne OpenType GSUB dalej działają, a font, który używa wariacji cech do zamiany glifu powyżej pewnej grubości, dostaje zamianę pasującą do 620. Na pozycjonowaniu kod układu wywija się najczęściej. Instancja semi-condensed ma węższe postępy niż domyślna, a GetWideTextWidth mierzy postępami kroju faktycznie zarejestrowanego. Mierz po RegisterUnicodeTTF, a łamania wierszy, które wyliczysz, to te, które zostaną wydrukowane
Instancjonowanie fontów zmiennych siedzi w tym samym potoku co osadzanie, tworzenie podzbiorów i kształtowanie, a pełny zestaw cech typograficznych dla Delphi i C++Builder jest wypisany na stronie komponentu PDF HotPDF dla Delphi