ドイツ語の製品シートを3本の148ポイント列へ流し込むと、2つのことが同時に起こります。Rechnungsprüfungsausschussのような単語の前の行は、3分の1空のまま終わることがあります。26文字の複合語の前にある空白こそが、割れることのできる唯一の場所だからです。そして最終ページでは、残りのテキストが1本目の列を埋め、2本目の一部を埋め、3本目を空白のままにします。空白しか知らず、残りを数えない改行器は、まさにそのページを作ります
修正は2つの半分からなります。テキストの言語の規則を使って単語の内側で割ること。そして、まだ置くべき行数から最終列の高さを決めることです。どちらの半分も、判断に使う行数が、実際に描かれる改行、ハイフン込みと同じものから来ており、480ポイントの領域ではなく148ポイントの列幅で計上されているときにだけ、機能します
PDF Library for Delphiにおけるハイフネーション付き3段フロー
PDF Library for Delphiは、一節をテキストフローとして保持します。NewTextFlowがハンドルを返し、SetTextFlowLanguageとSetTextFlowHyphenationが単語を割れる場所を制御し、DrawTextFlowColumnsが残りのテキストのうち収まる分を、1から64本の等幅列へ流し込んでフローを進めます。列幅は領域幅からガターを引き、段数で割ったものです。3段で18ポイントのガターを持つ480ポイント領域なら、(480 − 2 × 18) / 3 = 列あたり148ポイントです
呼び出しは描いた行の総数を返します。ゼロは何も収まらなかった意味で、その場合フローは元の位置に留まるため、テキストは失われません。罠は、呼び出しがゼロを返し続けているのに、ページループがNewPageを呼び続けることです。領域が1行より短いときや、最小行数の設定が与えられた空間で満たせないときに起こります。下のループは、回る代わりにゼロをエラーとして扱います
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); // 1行だけが段の足元に取り残されないように
repeat
// Left 66、Top 72、480×620pt領域、3段、ガター18pt、バランス付き
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はフォントを12ptで戻してくる
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は受け入れられ、そのフローでは自動割りが単純に切れます
3つの戻り値が何が起こったかを告げます。言語をユーザーデータから受け取るコードでは、確認する価値があります:
SetTextFlowLanguageが0を返すのは、不正なタグだけです。覆われていない言語の正しい形式のタグは1を返し、自動ハイフネーションは切れたままですEnable = 1でのSetTextFlowHyphenationは、フローの言語に規則がないとき0を返します。改行器が、言語の裏付けなしに割れ目を発明することはありませんGetTextFlowHyphenationは、自動割りが今オンかどうかを報告します。レイアウトがおかしく見えるときにログすべき値です
ここでも順序が効きます。SetTextFlowLanguageは新しい言語からオン/オフ状態を再計算するため、SetTextFlowHyphenation(Flow, 0, …)の後に呼ぶと、サポート言語ではハイフネーションがまた有効になります。言語を設定してから、ハイフネーションのオプションを設定してください
MinPrefixとMinSuffixはハウススタイルの設定である
有効化フラグの後の2つの整数は、割れの前に行に残すべき、そして割れの後に次の行へ移すべき文字数の最小値です。どちらも1から16を受け付けます。言語だけを理由にハイフネーションが有効になるときは両方とも2であり、単語はMinPrefix + MinSuffix + 1以上の文字を持つときにだけ、割りの候補になります
2と2は、ほぼすべての文書で変更を勧める設定です。割り機会は増えますが、行末の2文字の断片は誤字のように読め、ドイツ語やオランダ語では、読み手が付け直すはめになる2文字のプレフィックスのようなものを切り離します。3と3は、ガタつき行をいくつか増やす代わりに、組版らしく見えます。大きな活字では断片が目立つため、さらに最小値を上げてください。2に下げるのは、詰めた字詰めがきれいな字詰めに勝ると判断した、本当に狭い列だけにしてください
どの単語が割れるのか、URLはどうなるのか
行は空白とタブで割れ、行送りは強制的に新しい行を開けます。単語の内側では、自動ハイフネーションは、完全に文字だけでできた単語(Latin、アクセント付きのLatin Extended領域込み、そしてキリル文字)だけを見て、先頭や末尾の句読点は脇に置きます。規則は母音の許される組合せ、合法の子音連鎖、よくある接辞の保守的な組合せであるため、辞書型のハイフネーターが置くより割れ目は少なくなります。数字や内部句読点を含む単語、ISO-32000やv2Betaなど、そして128文字を超える単語は、自動の割れ目を得ません
ソフトハイフン(U+00AD)が上書き手段です。単語に1つでもあれば、それらの位置がその単語の唯一の割れ目になります。その単語では自動規則がスキップされ、ソフトハイフンは、自動ハイフネーションが切れていても、言語に規則がなくても働きます。ブランド名、製品コード、規則が下手に割る用語に使ってください。次の例では、Rechnungsとprüfungsが、この複合語が割れることのできる唯一の2つの場所です
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はソフトハイフンをそのまま返します。素朴な設計がこれを間違える様子は特徴的です。候補を試しているあいだに文字列へハイフンを書き込み、割れが後から動き、迷子のハイフンが行の中央に居残ります
どの行にも収まらないトークン、割れることのできる場所のない長いURLや管理番号は、収まる最長のプレフィックスで切断されます。ハイフンは付きません。切断がサロゲートペアの2つの半分の間や、結合文字の前に着くことはありません。絵文字やアクセント付き文字が行を跨いで割れることはないのです
Balance=1が最終ページで変えること
Balance引数が効くのは、残りすべてが領域内に収まるときだけです。その場合、DrawTextFlowColumnsは残り行数を段数で割って切り上げ、それをすべての列の高さとして使います。3列で残り22行なら、8、8、6になります。残りが収まらないときは、すべての列がフルハイトを保ち、ページは運べるだけ運び、残りは次のページへ続きます
最小行数の設定は、バランス高さを押し上げることがあります。SetTextFlowMinLines(Flow, 3)で残り4行のとき、バランス高さの2は最小を下回るため、列は順番に埋まります。1列目に3行、2列目に1行、3列目は空です。一節のまさに終わりの短い末尾は、必ず置かれます。行き場がほかにないからです。次の列の上端でも少なくとも2行をまとめて保ちたいなら、SetTextFlowPaginationLinesが孤児と未亡人の最小値を1回の呼び出しで受け取ります
連続する記事では、毎回1を渡してください。一節の途中では何も変えません。列はどのみち満杯です。0を渡すとしたら、列領域がフォーム型レイアウトの固定ボックスである場合だけです。43行の列に52行の残りは、18、18、16ではなく、43、9、0として着地すべきです
レイアウト自体が一節の長さに依存するなら、描く前に測ってください。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はどれも、呼ばれた瞬間に選択されているフォントとサイズで行を割ります。同じフローの2つのボックスの間でどちらかを変えると、2つ目のボックスは、1つ目が測ったものと違う割り方をします。行ピッチも一緒に動きます。選択テキスト高さの1.2倍だからです。GetTextHeightがあなたのフェイスに12ポイントを報告するなら、ピッチは14.4ポイントで、620ポイントの列は43行を収めます
これにつまずくいちばん簡単な道は、新しいページです。NewPageは現在のフォントを再選択しますが、12ポイントでです。SelectFontも同じことをします。ページ1で10.5ポイントに設定されたフローは、ループがSetTextSizeをもう一度呼ばない限り、ページ2以降は12ポイントで走ります。より広い単語、より高いピッチ、列あたりより少ない行数、そしてページ1のMeasureTextFlowの結果はもう一致しません。症状が断続的に見えるのは、ページ1が常に正しいからです。すべてのNewPageの後に、フォントを、そしてサイズを、この順で再選択してください。最初の例がそうしているとおりです
スクリプトが混在する一節も、計測でも描画でも、同じ選択フォントの経路を通るため、CJKと絵文字テキストの自動フォントフォールバックが選ぶ代替フェイスが、両者の間に隙間を開けることはありません。フローがヘッダー、フッター、データ駆動ブロックとページを共有するレポートレイアウトでは、データセットレポートエンジンの順序がそのまま使えます。まず測り、固定要素を置き、それから残りの領域をフローへ渡すのです
ここで扱ったテキストフロー呼び出しは、作成と計測から巻き戻しと解放まで、Delphi、C++Builder、Lazarus向けのPDF Library for Delphiの一部です。関数リファレンスとダウンロードはPDF Library for Delphiの製品ページにあります