Teknik Makale

Delphi'de Heceleme ve Dengeli Metin Sütunları

Bir Alman ürün föyünü 148 puanlık üç sütuna dökün ve iki şey aynı anda bozulur. Rechnungsprüfungsausschuss gibi bir sözcüğün önündeki satır, üçte birini boş bırakarak bitebilir; çünkü o 26 harfli bileşiğin önündeki boşluk, kırılabilen tek yerdi. Ve son sayfada artan metin bir sütunu doldurur, ikincisinin bir kısmını doldurur ve üçüncüyü boş bırakır. Yalnızca boşlukları bilen ve ne kaldığını hiç saymayan bir satır kırıcı, tam olarak o sayfayı üretir

Çözümün iki yarısı var: sözcüklerin içinde, metnin dili için kurallarla kırın ve son sütunları, hâlâ yerleştirilecek satır sayısından boyutlandırın. İki yarı da, karar için kullanılan satır sayısının, çizilecek kırılmalarla — tireler dahil — 480 puanlık bölgeden değil 148 puanlık sütun genişliğinde aynı kırılmadan gelmesiyle çalışır

PDF Library for Delphi'de tireli üç sütunlu akış

PDF Library for Delphi, bir pasajı metin akışı olarak tutar: NewTextFlow bir tanıtıcı döndürür; SetTextFlowLanguage ile SetTextFlowHyphenation, sözcüklerin nerede kırılabileceğini denetler ve DrawTextFlowColumns, kalan metinden sığan kadarını bir ile 64 arası eşit genişlikte sütuna döker ve akışı ilerletir. Sütun genişliği, bölge genişliğinden olukların çıkarılıp sütun sayısına bölünmesiyle bulunur; dolayısıyla üç sütunlu ve 18 puanlık oluklu bir 480 puanlık bölge, sütun başına (480 − 2 × 18) / 3 = 148 puan verir

Çağrı, çizdiği satırların toplam sayısını döndürür. Sıfır, hiçbir şeyin sığmadığı demektir ve o durumda akış olduğu yerde kalır; böylece hiçbir metin kaybolmaz. Tuzak, çağrı sıfır döndürdükçe NewPage çağırmayı sürdüren bir sayfa döngüsüdür. Bölge tek bir satırdan kısa olduğunda ya da bir en az satır ayarı, sunulan alanda karşılanamadığında olur. Aşağıdaki döngü sıfırı dönmek yerine hata sayar

var
  Lib: TPDFlib;
  FontID, Flow, Drawn: Integer;
begin
  Lib := TPDFlib.Create;
  try
    Lib.SetDocumentLanguage('de-DE');      // NewTextFlow öncesi, aşağıya bakın
    FontID := Lib.AddTrueTypeFont('Georgia', 1);
    Lib.SetTextSize(10.5);

    Flow := Lib.NewTextFlow(ArticleBody);
    try
      Lib.SetTextFlowHyphenation(Flow, 1, 3, 3);
      Lib.SetTextFlowMinLines(Flow, 2);   // sütun dibinde sahipsiz tek satır kalmasın

      repeat
        // Sol 66, Üst 72, 480 x 620 pt bölge, 3 sütun, 18 pt oluk, dengeli
        Drawn := Lib.DrawTextFlowColumns(Flow, 66, 72, 480, 620, 3, 18, 1);
        if Lib.TextFlowFinished(Flow) = 1 then
          Break;
        if Drawn = 0 then
          raise Exception.Create('Column region cannot take the next lines');
        Lib.NewPage;
        Lib.SelectFont(FontID);
        Lib.SetTextSize(10.5);            // NewPage, fontu 12 pt ile geri getirir
      until False;
    finally
      Lib.ReleaseTextFlow(Flow);
    end;

    Lib.SaveToFile('newsletter.pdf');
  finally
    Lib.Free;
  end;
end;

Koordinatlar, hangi kökeni ayarlamış olursanız olsun sayfanın sol üst köşesinden ölçülür; çünkü sütun çağrısı satırlarını Top'dan aşağıya doğru dizer. Varsayılan sola hizayla her satır, kendi sütununun sol kenarında başlar; dolayısıyla kötü bir kırılmanın artığı pürüzlü bir sağ kenar olarak görünür. İki yana yaslanmış dizgide aynı artık nehirler olur

PDF Library for Delphi, iki yana yaslanmış dar sütunların heceleme olsun olmasın karşılaştırması; hecelemenin uzun sözcüğü kırması ve beyaz boşluk nehirlerini kaldırması gösterilir
Dil farkında heceleme kırılmayı sözcüğün içine koyar; böylece yaslama artığı hiçbir zaman nehirlere göllenmez

Heceleme dili nereden gelir?

Yeni bir akış, dilini belge Kataloğu'nun /Lang girdisinden, NewTextFlow koştuğu anda alır. O değer, ekran okuyucuların ve arama indeksleyicilerin okuduğu değerin aynısıdır; dolayısıyla dilini hâlihazırda bildiren bir belge — erişilebilir PDF'ler için otomatik etiketlemenin etiketli çıktısı gibi — hecelemeyi bedavaya alır. Yalnızca zamanlama önemlidir. SetDocumentLanguage'i akış var olduktan sonra çağırın ve o akış onu hiç görmez; ilk örnek, tam olarak bu nedenle dili önce ayarlar

Etiket desteklenen bir dili adlandırdığında otomatik heceleme kendiliğinden açılır. Kurallar İngilizce, Almanca, Felemenkçe, Fransızca, İspanyolca, İtalyanca, Portekizce, Rusça, Türkçe, Danca, İsveççe, Fince, Lehçe, Çekçe ve Macarcayı kapsar. Bölge alt etiketleri aramadan önce düşürülür; dolayısıyla de-CH, de-AT ve de hep Almanca gibi hecelenir. Kuralların kapsamadığı bir etiket — ja gibi — kabul edilir ve otomatik kırma o akış için yalnızca kapanır

Üç dönüş değeri ne olduğunu söyler ve dili kullanıcı verisinden alan kodda kontrol etmeye değerdir:

  • SetTextFlowLanguage, yalnızca bozuk bir etiket için 0 döndürür; kapsanmayan bir dilin iyi biçimli etiketi 1 döndürür ve otomatik hecelemeyi kapalı bırakır
  • SetTextFlowHyphenation, Enable = 1 ile akışın dilinin kuralı yokken 0 döndürür; böylece kırıcı, arkasında dil olmayan kırılma noktaları uyduramaz
  • GetTextFlowHyphenation, otomatik kırmanın şu anda açık olup olmadığını raporlar; yerleşim yanlış göründüğünde günlüğe yazılacak değer budur

Sıralama burada da önemlidir. SetTextFlowLanguage, açık/kapalı durumunu yeni dilden yeniden hesaplar; dolayısıyla SetTextFlowHyphenation(Flow, 0, …)'den sonra çağırmak, desteklenen bir dil için hecelemeyi yeniden açar. Önce dili, sonra heceleme seçeneklerini ayarlayın

MinPrefix ve MinSuffix bir ev üslubu ayarıdır

Etkinleştirme bayrağından sonraki iki tam sayı, kırılmadan önce satırda kalmak ve kırılmadan sonra sonraki satıra geçmek zorunda olan en az harf sayısıdır. İkisi de 1 ile 16 kabul eder. Heceleme yalnızca dil nedeniyle açıldığında ikisi de 2'dir ve bir sözcük, en az MinPrefix + MinSuffix + 1 harfi varsa kırılmaya değer sayılır

İki-iki, hemen her belgede değiştireceğimiz ayardır. Daha çok kırılma fırsatı üretir ama satır sonundaki iki harfli bir parça yazım hatası gibi okunur; Almancada ya da Felemenkçede okuyucunun sonra yeniden birleştirmesi gereken iki harfli bir öneki gibi şeyleri koparır. Üç-üç birkaç pürüzlü satıra mal olur ve dizgi gibi görünür. Büyük puntoda her parça göze battığı için en azları daha da yükseltin; yalnızca sıkı ölçünün temiz ölçüyü yendiğine karar verdiğiniz gerçekten dar bir sütun için ikiye inin

Hangi sözcükler kırılabilir ve bir URL'ye ne olur

Satırlar boşluk ve sekmelerde kırılır; satır beslemesi yeni satır zorlar. Sözcüğün içinde otomatik heceleme yalnızca tümüyle harflerden kurulu sözcüklere bakar (Latin; aksanlı Latin Extended aralıkları dahil; ve Kiril), baştaki ya da sondaki noktalamayı kenara ayırarak. Kurallar, ünlülerin tutarlı birleşimleri, geçerli ünsüz kümeleri ve yaygın eklerdir; dolayısıyla bir sözlük heceleyicisinin koyacağından daha az kırılma noktası koyarlar. Rakam ya da iç noktalama taşıyan sözcükler — ISO-32000 ya da v2Beta gibi — ve 128 harften uzun sözcükler otomatik nokta almaz

Yumuşak tireler (U+00AD) geçersiz kılmadır. Bir sözcük herhangi birini taşıyorsa o konumlar onun tek kırılma noktaları olur: o sözcük için otomatik kurallar atlanır ve yumuşak tireler, otomatik heceleme kapalıyken ya da dilin kuralı yokken bile çalışır. Marka adları, ürün kodları ve kuralların kötü böldüğü terimler için onları kullanın; bir sonraki örnekte Rechnungs ile prüfungs, bileşiğin kırılabileceği tek iki yerdir

var
  Flow: Integer;
  Body, Rest: WideString;
begin
  // U+00AD, bu bileşiğin kırılabileceği tek yerleri işaretler
  Body := 'Die Pr' + #$00FC + 'fung erfolgt durch den Rechnungs' + #$00AD +
    'pr' + #$00FC + 'fungs' + #$00AD + 'ausschuss der Gesellschaft';
  Flow := Lib.NewTextFlow(Body);
  try
    if Lib.SetTextFlowLanguage(Flow, CustomerLanguageTag) = 0 then
      raise Exception.Create('Malformed language tag: ' + CustomerLanguageTag);
    if Lib.SetTextFlowHyphenation(Flow, 1, 3, 3) = 0 then
      LogWarning('No hyphenation rules; only soft hyphens will break words');
      // LogWarning sizin kendi günlükleme yordamınızdır

    Lib.DrawTextFlow(Flow, 72, 72, 148, 240);

    // Sığmayan her şey geçirildiği gibi döner,
    // yumuşak tireler dahil
    Rest := Lib.GetTextFlowRemaining(Flow);
  finally
    Lib.ReleaseTextFlow(Flow);
  end;
end;

Tire eksi, yalnızca gerçekten seçilen kırılmada çizilir. Seçilmeyen yumuşak tireler hem ölçümde hem çizimde görünmez ve kırılma, özgün metne karşı kaydedilir; GetTextFlowRemaining'in yumuşak tireleri dokunulmamış olarak geri vermesinin nedeni budur. Naif tasarım bunu tanınabilir biçimde yanlış yapar: bir aday denerken tireyi dizeye yazar, kırılma sonra taşınır ve başıboş bir tire satırın ortasında kalır

Hiçbir satıra sığmayan bir simge — yasal kırılması olmayan uzun bir URL ya da bir erişim numarası — sığan en uzun önekten kesilir ve tire eklenmez. Kesim hiçbir zaman bir vekil çiftin iki yarısının arasına ya da birleştirici bir imin önüne düşmez; böylece bir emoji ya da aksanlı bir harf asla satırlar arasında bölünmez

Balance=1 son sayfada neyi değiştirir

Balance argümanı yalnızca kalan her şey bölgenin içine sığdığında önem taşır. O durumda DrawTextFlowColumns, kalan satır sayısını sütun sayısına böler, yukarı yuvarlar ve bunu her sütunun yüksekliği yapar. Üç sütunda kalan yirmi iki satır 8, 8 ve 6 olarak çıkar. Artan sığmadığında her sütun tam yüksekliğini korur; böylece sayfa alabildiğini taşır ve gerisi sonraki sayfaya devam eder

Bir en az satır ayarı, dengelenmiş yüksekliği yükseltebilir. SetTextFlowMinLines(Flow, 3) ile dört satır kaldığında ikilik dengelenmiş yükseklik minimumun altındadır; dolayısıyla sütunlar sırayla dolar: ilk sütunda üç satır, ikincide bir, üçüncü boş. Pasajın en sonundaki kısa bir kuyruk daima yerleştirilir; gideceği başka yer yoktur. Sonraki sütunun tepesinde de en az iki satırı bir arada tutmak için SetTextFlowPaginationLines, yetim ve dul minimumlarını tek çağrıda alır

PDF Library for Delphi Balance parametresinin önceki sütun bölgelerini dolu tutarken son bölgeyi her sütunda eşit satır sayısına kısalttığı şema
Dengeleme yalnızca bir pasajın sonunda uygulanır ve orada her sütunu aynı satır sayısına kırpar

Kesintisiz yazılar için her seferinde 1 geçirin. Pasajın ortasında hiçbir şeyi değiştirmez; sütunlar zaten doludur. 0'ı yalnızca sütun bölgesinin form benzeri bir yerleşimdeki sabit bir kutu olduğu durumlarda geçiririz: 43 satırlık sütunlarda 52 satırlık bir artan, 18, 18 ve 16 yerine 43, 9 ve 0 olarak düşmeli

Yerleşim, pasajın uzunluğuna bağlıysa çizmeden önce ölçün. MeasureTextFlow, akışın gerisinin verilen genişlikte kaç satır istediğini döndürür; aynı kırma ile — heceleme dahil — ve akışı kıpırdatmadan

var
  Flow, Needed, LinesPerColumn: Integer;
  LinePitch: Double;
begin
  Flow := Lib.NewTextFlow(ArticleBody);
  try
    Lib.SetTextFlowLanguage(Flow, 'fr');
    Lib.SetTextFlowHyphenation(Flow, 1, 3, 3);

    Lib.SelectFont(FontID);
    Lib.SetTextSize(10.5);
    // Sütun çağrısının kullandığı satır aralığı: seçilen metin yüksekliğinin 1.2 katı
    LinePitch := Lib.GetTextHeight * 1.2;
    LinesPerColumn := Trunc(620 / LinePitch);

    Needed := Lib.MeasureTextFlow(Flow, (480 - 2 * 18) / 3);
    if Needed > 3 * LinesPerColumn then
      UseTwoPageSpread      // kendi yerleşim tercihiniz
    else
      UseSinglePage;        // Balance=1 sütunları eşitler

    Lib.DrawTextFlowColumns(Flow, 66, 72, 480, 620, 3, 18, 1);
    if Lib.TextFlowFinished(Flow) <> 1 then
      CarryOver(Lib.GetTextFlowRemaining(Flow));   // bu da sizin
  finally
    Lib.ReleaseTextFlow(Flow);
  end;
end;

Fontu ve boyutu kutudan kutuya özdeş tutmak

DrawTextFlow, DrawTextFlowColumns ve MeasureTextFlow, satırları çağrıldıkları anda seçili font ve boyutla kırar. Aynı akışın iki kutusu arasında bunlardan birini değiştirin ve ikinci kutu, birincinin ölçtüğünden farklı kırar. Satır aralığı da onunla hareket eder; seçilen metin yüksekliğinin 1.2 katıdır. GetTextHeight yüzünüz için 12 puan rapor etsin diyelim: aralık 14.4 puandır ve 620 puanlık bir sütun 43 satır tutar

Buna takılmanın kolay yolu yeni sayfadır. NewPage, geçerli fontu yeniden seçer ama 12 puanda ve SelectFont da aynısını yapar. Birinci sayfada 10.5 puana ayarlı bir akış, döngü SetTextSize'i yeniden çağırmadıkça ikinci sayfadan itibaren 12 puanda koşar: daha geniş sözcükler, daha yüksek bir aralık, sütun başına daha az satır ve birinci sayfadan gelen, artık uyuşmayan bir MeasureTextFlow sonucu. Belirti aralıklı görünür, çünkü birinci sayfa daima doğrudur. Her NewPage'den sonra önce fontu sonra boyutu yeniden seçin; bu sırayla; ilk örneğin yaptığı gibi

PDF Library for Delphi: kutular arasında font değişince satır kırılmalarının sapan uyarı şeması; her yeni sayfadan sonra fontu yeniden seçen kararlı döngüyle karşılaştırılır
Üç akış yöntemi de satırları o anda seçili fontla kırar; dolayısıyla yüz, sayfalar boyunca değişmeden sürmelidir

Betikleri karıştıran pasajlar ölçümde ve çizimde aynı seçili font yolundan geçer; böylece CJK ve emoji metni için otomatik font fallback'ın seçtiği yedek yüzler ikisi arasında boşluk açmaz. Akışın, üst ve alt bilgilerle veriden gelen bloklarla sayfayı paylaştığı rapor yerleşimlerinde veri kümesi rapor motorunun sırası aynen geçer: önce ölçün, sabit öğeleri yerleştirin, sonra akışa kalan bölgeyi verin

Burada kapsanan metin akışı çağrıları — oluşturma ve ölçümden geri sarmaya ve serbest bırakmaya — Delphi, C++Builder ve Lazarus için PDF Library for Delphi'nin parçasıdır. İşlev referansı ve indirme PDF Library for Delphi ürün sayfasındadır