把一份德文產品說明倒進三個 148 點寬的欄位,兩件事同時出錯。Rechnungsprüfungsausschuss 這種字前面的一行,可能以三分之一空白收尾,因為那個 26 個字母的複合字之前的那個空格,是唯一能斷的地方。而在最後一頁,剩下的文字塞滿一欄、占了第二欄的一部分、第三欄整個空白。一個只認空格、從不盤點剩餘量的斷行器,產出的正是這樣一頁
解法有兩半:按文字的語言規則在單字內部斷行,以及按還沒放下的行數來決定最後幾欄的高度。兩半要成立,都得靠決策所用的行數來自實際畫出來的那些斷點——連字號算在內——是在 148 點的欄寬下量出來的,而不是在 480 點的整個區域上
PDF Library for Delphi 裡帶斷字的三欄文字流
PDF Library for Delphi 把一段文字當成文字流來管理:NewTextFlow 回傳一個控制代碼,SetTextFlowLanguage 與 SetTextFlowHyphenation 管單字可以在哪裡斷,DrawTextFlowColumns 把剩餘文字盡可能倒進一到 64 個等寬欄位並推進文字流。欄寬是區域寬減去欄間距再除以欄數,所以 480 點區域、三欄、18 點欄間距,得到(480 − 2 × 18)/ 3 = 每欄 148 點
呼叫回傳它畫出的總行數。零代表什麼都沒放下,此時文字流停在原地,沒有文字遺失;陷阱在於頁面迴圈一路呼叫 NewPage、呼叫一路回傳零。區域比一行還矮、或最少行數設定在提供的空間裡無法滿足時,就會這樣。下面的迴圈把零當錯誤處理,而不是空轉
var
Lib: TPDFlib;
FontID, Flow, Drawn: Integer;
begin
Lib := TPDFlib.Create;
try
Lib.SetDocumentLanguage('de-DE'); // 在 NewTextFlow 之前,見下文
FontID := Lib.AddTrueTypeFont('Georgia', 1);
Lib.SetTextSize(10.5);
Flow := Lib.NewTextFlow(ArticleBody);
try
Lib.SetTextFlowHyphenation(Flow, 1, 3, 3);
Lib.SetTextFlowMinLines(Flow, 2); // 不讓任何單行落單在欄底
repeat
// Left 66、Top 72、480 x 620 點區域、3 欄、18 點欄間距、平衡
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 會把字型帶回 12 點
until False;
finally
Lib.ReleaseTextFlow(Flow);
end;
Lib.SaveToFile('newsletter.pdf');
finally
Lib.Free;
end;
end;
不論你設了什麼原點,座標都從頁面左上角量起,因為欄位呼叫從 Top 起往下排。預設左對齊之下,每一行都從所在欄的左緣開始,所以壞斷點的鬆弛量顯示為參差不齊的右緣;齊行排版裡,同樣的鬆弛量變成河流
斷字語言從哪裡來?
新文字流在 NewTextFlow 執行的那一刻,從文件 Catalog 的 /Lang 項目取得語言。那正是螢幕報讀軟體與搜尋索引器讀的同一個值,所以已經聲明語言的文件——例如 無障礙 PDF 自動標記 產出的帶標籤輸出——斷字白拿。但時機要緊:文字流存在之後才呼叫 SetDocumentLanguage,那個文字流永遠看不到它;第一個範例先設語言,正是為此
標籤指到受支援的語言時,自動斷字自行開啟。規則涵蓋英文、德文、荷蘭文、法文、西班牙文、義大利文、葡萄牙文、俄文、土耳其文、丹麥文、瑞典文、芬蘭文、波蘭文、捷克文與匈牙利文。查表前會先剝掉區域子標籤,所以 de-CH、de-AT 與 de 都按德文斷。規則未涵蓋的標籤(例如 ja)會被接受,那個文字流的自動斷行就這麼關著
三個回傳值告訴你發生了什麼,在語言來自使用者資料的程式碼裡值得逐一檢查:
SetTextFlowLanguage只有在標籤格式錯誤時回傳 0;格式正確但規則未涵蓋的語言回傳 1,自動斷字保持關閉SetTextFlowHyphenation帶Enable = 1時,文字流語言沒有規則就回傳 0,斷行器因此無法在沒有語言依據的情況下自創斷點GetTextFlowHyphenation回報自動斷行此刻是否開著,版面看起來不對時,該記錄的就是這個值
這裡順序同樣要緊。SetTextFlowLanguage 會按新語言重算開關狀態,所以在 SetTextFlowHyphenation(Flow, 0, …) 之後呼叫它,受支援語言的斷字又會被打開。先設語言,再設斷字選項
MinPrefix 與 MinSuffix 是版型規範設定
啟用旗標之後的兩個整數,是斷點之前必須留在行上的最少字母數,以及斷點之後必須移到下一行的最少字母數。兩者都接受 1 到 16。只因語言而開啟斷字時,兩者都是 2,而一個單字要被考慮斷行,至少得有 MinPrefix + MinSuffix + 1 個字母
幾乎每一份文件,我們都會改掉二與二這個設定。它給出更多斷點機會,但行尾掛著兩個字母的殘片讀起來像打錯字,德文與荷蘭文裡還會把兩字母前綴之類的東西切出來,讓讀者自己接回去。三與三多付幾行參差不齊,換來的卻是專業排版的樣子。大字級請再往上調,那裡每個殘片都很醒目;只有欄位真的極窄、而你已決定緊湊量度勝過乾淨斷行時,才降回二
哪些字能斷,網址怎麼辦
行在空格與定位點處斷開,換行符強制開新行。單字內部,自動斷字只看完全由字母組成的單字(拉丁字母,含帶變音符號的 Latin Extended 區段,以及西里爾字母),前後的標點先擱一邊。規則是母音組合、合法子音叢與常見詞綴的保守組合,放出的斷點比字典式斷字器少。帶數字或內部標點的字,例如 ISO-32000 或 v2Beta,以及超過 128 個字母的字,一律沒有自動斷點
軟連字號(U+00AD)是覆寫手段。單字裡只要有它,那些位置就成為該字僅有的斷點:自動規則對這個字跳過,而且就算自動斷字關著、語言沒有規則,軟連字號照樣生效。品牌名、產品代碼與規則切不好的術語,用它;下一個範例裡,Rechnungs 與 prüfungs 是這個複合字唯二能斷的地方
var
Flow: Integer;
Body, Rest: WideString;
begin
// U+00AD 標出這個複合字僅有的斷點
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 是你自己的記錄常式
Lib.DrawTextFlow(Flow, 72, 72, 148, 240);
// 沒放下的部分原樣回傳,
// 軟連字號也在內
Rest := Lib.GetTextFlowRemaining(Flow);
finally
Lib.ReleaseTextFlow(Flow);
end;
end;
連字號減號只在實際選中的斷點畫出。沒選中的軟連字號在量測與繪製裡都不可見,斷點對著原文記錄,這正是 GetTextFlowRemaining 把軟連字號原封不動交回的原因。天真的設計會以一種可辨認的方式出錯:嘗試候選時把連字號寫進字串,斷點後來移了位,一個遊離連字號就留在了行中間
完全放不進任何一行的 token——沒有合法斷點的長網址或取號——會在放得下的最長前綴處切斷,不加連字號。切口永遠不會落在代理對兩半之間或結合符號之前,所以 Emoji 或帶變音符號的字母絕不會被切到兩行
Balance=1 在最後一頁改變了什麼
Balance 引數只在剩餘內容全部塞得進區域時才有意義。此時 DrawTextFlowColumns 把剩餘行數除以欄數、進位,拿結果當每一欄的高度。三欄裡剩二十二行,出來是 8、8、6。剩餘放不下時,每一欄保持全高,這頁能裝多少裝多少,其餘延續到下一頁
最少行數設定可以抬高平衡後的高度。設了 SetTextFlowMinLines(Flow, 3) 而只剩四行時,平衡高度 2 低於下限,欄位照順序填:第一欄三行、第二欄一行、第三欄空。段落最末的短尾巴永遠會被放下,因為它沒有別處可去。要讓下一欄頂端也至少保持兩行在一起,SetTextFlowPaginationLines 一次呼叫同時設定孤行與寡行下限
連續型文章每次都傳 1。段落中段它什麼也不改變,欄位反正全滿。只有在欄區是表單式版面裡的固定方框時我們才會傳 0:43 行的欄位裝著 52 行的剩餘,應該落成 43、9、0,而不是 18、18、16
版面本身取決於段落長度時,先量測再繪製。MeasureTextFlow 回傳剩餘文字流在給定寬度下需要幾行,用同一套斷行——連字號算在內——且不移動文字流
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);
// 欄位呼叫使用的行距:所選文字高度的 1.2 倍
LinePitch := Lib.GetTextHeight * 1.2;
LinesPerColumn := Trunc(620 / LinePitch);
Needed := Lib.MeasureTextFlow(Flow, (480 - 2 * 18) / 3);
if Needed > 3 * LinesPerColumn then
UseTwoPageSpread // 你自己的版面選擇
else
UseSinglePage; // Balance=1 會把欄位拉平
Lib.DrawTextFlowColumns(Flow, 66, 72, 480, 620, 3, 18, 1);
if Lib.TextFlowFinished(Flow) <> 1 then
CarryOver(Lib.GetTextFlowRemaining(Flow)); // 同樣是你自己的
finally
Lib.ReleaseTextFlow(Flow);
end;
end;
方框與方框之間,字型與字級保持一致
DrawTextFlow、DrawTextFlowColumns 與 MeasureTextFlow 都以呼叫當下選定的字型與字級斷行。同一個文字流的兩個方框之間改了其中任何一個,第二個方框的斷行就會跟第一個量測的不一樣。行距跟著動,因為它是所選文字高度的 1.2 倍。假設 GetTextHeight 對你的字體回報 12 點:行距 14.4 點,620 點的欄位裝 43 行
最容易在這裡摔跤的是換頁。NewPage 會重選目前的字型,但用 12 點;SelectFont 也一樣。第一頁設成 10.5 點的文字流,從第二頁起就以 12 點在跑,除非迴圈再呼叫一次 SetTextSize:字更寬、行距更高、每欄行數更少,第一頁的 MeasureTextFlow 結果從此對不上。症狀看似間歇性,因為第一頁永遠是對的。每次 NewPage 之後先重選字型、再重設字級,順序如此,第一個範例正是這麼做的
混排文字系統的段落,量測與繪製走同一條所選字型路徑,所以 CJK 與 Emoji 文字的自動字型後援 挑出的替代字型不會在兩者之間打開縫隙。文字流與頁首、頁尾、資料驅動區塊共用頁面的報表版面,資料集報表引擎 的順序照樣適用:先量測,放好固定元素,再把剩下的區域交給文字流
這裡涵蓋的文字流呼叫,從建立、量測到回捲與釋放,都是 PDF Library for Delphi for Delphi、C++Builder 與 Lazarus 的一部分。函式參考與下載在 PDF Library for Delphi 產品頁