Vertikálny japonský a čínsky text v PDF s Delphi

PDF Library for Delphi kreslí japonský a čínsky text zhora nadol po strane. SetVerticalWritingMode zapne vertikálny zápis, bežné volania DrawText následne bežia nadol a GetVerticalWritingMode hlási aktuálny stav. Kým toto existovalo, znamenalo vertikálne nastavenie textu umiestniť každý znak ručne a dúfať, že rozostupy budú vyzerať správne

Vertikálny zápis nie je horizontálny text otočený o deväťdesiat stupňov. Znaky zostávajú vzpriamené, postup beží nadol namiesto vodorovne a viacero znakov mení tvar úplne — čo je časť, ktorá oddeľuje dokument čitateľný prirodzene od dokumentu, ktorý japonský čitateľ okamžite rozpozná ako strojovo vyrobený

Čo sa mení vo vnútri PDF

Text kreslený týmto spôsobom prechádza Type0 fontom v režime vertikálneho zápisu, ktorý nesie vlastné vertikálne metriky rezu. To je dôležité v oboch smeroch. Čítačka posúva každý znak o vzdialenosť, ktorú navrhol jeho autor, a nie o jednotný krok, takže stĺpec má rytmus, pre ktorý bol typografický rez navrhnutý. A skopírovanie textu von vráti pôvodné znaky, pretože vertikálny beh je stále skutočný text so správnym mapovaním a nie sekvencia umiestnených glyphov

Rez, ktorý nenesie žiadne vlastné vertikálne metriky, posúva sa o jeden em na znak, čo je to, čo by urobila čítačka s predvolenou hodnotou. Tento fallback sa oplatí poznať, pretože je to rozdiel, ktorý uvidíte, keď dokument renderuje správne s riadnym CJK rezom a pôsobí mechanicky rozmiestneným s latinským rezom, ktorý sa náhodou obsahuje niekoľko kana

var
  Lib: TPDFlib;
  H: Double;
begin
  Lib := TPDFlib.Create;
  try
    Lib.SetOrigin(1);
    Lib.AddTrueTypeFont('MS Mincho', 1);      // 1 = vlož rez písma
    Lib.SetTextSize(12);
    Lib.SetVerticalWritingMode(1);            // bežný DrawText teraz beží zvislo nadol
    H := Lib.GetVerticalTextHeight('MS Mincho', 12, '第三章 保守点検');
    Lib.DrawText(480, 72, '第三章 保守点検');
    Lib.SetVerticalWritingMode(0);            // späť na vodorovné
    Lib.DrawText(72, 72 + H, 'Chapter 3');
    Lib.SaveToFile('manual-ja.pdf');
  finally
    Lib.Free;
  end;
end;

Prečo zátvorky v vertikálnom texte vyzerajú zle?

Pretože zátvorka má dve formy a v stĺpci patrí iba jedna z nich. Zátvorky, značka dlhej samohlásky a malé kana sa kreslia odlišne, keď text beží nadol po strane — zátvorka sa otočí, aby sedela pozdĺž stĺpca namiesto toho, aby ležala naprieč, a značka dlhej samohlásky sa stane vertikálnou čiarou. Nakreslite horizontálne formy do vertikálneho stĺpca a každá z nich bude ležať na boku

PDF Library for Delphi berie formy z vlastnej vertikálnej vlastnosti fontu, takže každý rez dodáva to, čo nakreslil jeho autor, a nie substitúciu hádanú zo znaku. Toto rozlíšenie je dôležité pre správnosť: hádací tabuľka substitúcií má pravdu v bežných prípadoch a mýli sa pri rezoch, ktoré so znakom zaobchádzajú inak, a rez, ktorý neuvedie žiadne vertikálne formy, je kreslený presne tak ako predtým, namiesto toho, aby bol pretlačený tabuľkou, o ktorú nežiadal

GetVerticalTextHeight meria formy, ktoré budú skutočne nakreslené, takže stĺpec, ktorého znaky menia tvar, je stále nameraný správne. Meranie horizontálnych foriem a kreslenie vertikálnych je klasickým zdrojom stĺpcov, ktoré o niekoľko znakov presahujú svoj rámec

Kreslenie jedného behu bez zmeny režimu

DrawVerticalText kreslí jeden beh vertikálne, prijíma pozíciu, názov fontu, veľkosť a text a nechá režim zápisu na pokoji. Použite ho pre vertikálnu výnimku vo vnútri horizontálneho dokumentu — chrbtovú etiketu, pečiatku, jeden stĺpec mien — kde zapínanie a vypínanie globálneho režimu okolo každého volania prináša viac stavu, než si úloha zaslúži

Horizontálne a vertikálne formy jedného rezu sa vnútorne držia oddelene, takže jedna strana môže niesť obe bez toho, aby sa navzájom ovplyvňovali. To je to, čo robí zmiešanú stranu praktickou: japonská knižná strana s vertikálnym telom textu a horizontálnymi hlavičkami, alebo čínsky certifikát s vertikálnym titulom nad horizontálnymi detailnými riadkami

// Jeden zvislý úsek na inak vodorovnej strane
Lib.DrawVerticalText(520, 96, 'MS Mincho', 14, '保守点検記録');
// Vodorovný text okolo neho nie je ovplyvnený
Lib.DrawText(72, 96, 'Maintenance inspection record');

Správa fontu predovšetkým

Vertikálny zápis závisí celkom od rezu. CJK font s riadnymi vertikálnymi metrikami a vertikálnou vlastnosťou produkuje správny výstup bez ďalšej práce; font bez nich produkuje vzpriamené znaky posúvajúce sa o jeden em bez akejkoľvek zmeny tvaru. Ak vertikálny text pôsobí jemne nesprávne, skúmajte najprv font a až potom kód

Vkladanie fontu sleduje bežné pravidlá a bežné náklady. Plný CJK rez je veľký, takže subsetting nie je voliteľný pre dokumenty, ktoré idú hocikam — poznámky k optimalizácii veľkosti PDF a subsettingu fontov popisujú, čo očakávať, a návod k vkladaniu chýbajúcich fontov do existujúceho PDF pokrýva opravný prípad, keď vertikálny dokument príde bez svojich fontov

Kde vertikálny text stále potrebuje vaše rozhodnutie o rozvrhnutí

Poradie stĺpcov. Japonský vertikálny text beží sprava doľava po stĺpcoch, takže dvojstĺpcová strana začína pri pravom okraji a žiadne nastavenie režimu zápisu to nedokáže odvodiť z textu. To isté platí na poradie strán v dokumente, ktorý sa ako celok číta sprava doľava, a na to, kde sedia furigana, poznámky pod čiarou a popisy obrázkov

Čo knižnica garantuje, je, že každý beh je nastavený správne: správne formy, správne postupy, extrahovateľný text. Kam behy na strane smerujú, je problém rozvrhnutia a pre dokumenty zložené z dát je návod k vyhľadávaniu textu a enumerácii elementov strany užitočný na neskoršie overenie, že to, čo skončilo na strane, je to, čo ste zamýšľali

PDF Library for Delphi je natívna Pascal PDF knižnica pre Delphi, C++Builder a Lazarus a vertikálny CJK zápis je súčasťou API kreslenia a nie doplnkom — zoznam textových a fontových funkcií nájdete na produktovej stránke PDF Library for Delphi