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
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ırSetTextFlowHyphenation,Enable = 1ile akışın dilinin kuralı yokken 0 döndürür; böylece kırıcı, arkasında dil olmayan kırılma noktaları uyduramazGetTextFlowHyphenation, 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
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
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