Влейте немецкую продуктовую карточку в три колонки по 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 pt, 3 колонки, желоба 18 pt, с балансировкой
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 pt
until False;
finally
Lib.ReleaseTextFlow(Flow);
end;
Lib.SaveToFile('newsletter.pdf');
finally
Lib.Free;
end;
end;
Координаты меряются от левого верхнего угла страницы, какое бы начало вы ни выставили, потому что колоночный вызов раскладывает строки вниз от Top. При выключке по умолчанию влево каждая строка стартует от левого края своей колонки, поэтому слабина от плохого разрыва видна как рваный правый край; в выключенном наборе та же слабина превращается в реки
Откуда перенос берёт язык?
Новый поток берёт язык из записи /Lang каталога документа в момент запуска NewTextFlow. То же значение читают скринридеры и поисковые индексаторы, поэтому документ, уже объявивший язык, — как тегированный вывод из статьи автоматическая разметка для доступных 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 буква
Два и два — настройка, которую мы бы поменяли почти в каждом документе. Она даёт больше возможностей разрыва, но двухбуквенный обломок в конце строки читается как опечатка, а в немецком или нидерландском откалывает такое, как двухбуквенная приставка, которую читатель потом заново приклеивает. Три и три стоит нескольких более рваных строк и выглядит как вёрстка. Поднимайте минимумы дальше для крупного кегля, где каждый обломок на виду; опускайте до двух только для действительно узкой колонки, где вы решили, что плотная мера бьёт чистую
Какие слова ломаются и что происходит с URL
Строки ломаются на пробелах и табуляциях, а перевод строки принуждает новую строку. Внутри слова автоматический перенос смотрит только на слова, целиком состоящие из букв (латиница, включая акцентированные диапазоны 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 возвращает мягкие переносы нетронутыми. Наивный дизайн ошибается узнаваемым образом: он вписывает дефис в строку, пробуя кандидата, разрыв потом переезжает, и бродячий дефис оказывается посреди строки
Токен, не влезающий ни в одну строку, — длинный URL или инвентарный номер без легального разрыва — режется по самому длинному влезающему префиксу, без дефиса. Срез никогда не падает между половинками суррогатной пары или перед диакритикой, поэтому эмодзи или буква с акцентом никогда не режется между строками
Что на самом деле означает «сбалансированность»?
Аргумент Balance играет, только когда всё оставшееся влезает в область. Тогда DrawTextFlowColumns делит оставшееся число строк на число колонок, округляет вверх и берёт это высотой каждой колонки. Двадцать две оставшиеся строки в трёх колонках выходят как 8, 8 и 6. Когда остаток не влезает, каждая колонка держит полную высоту, чтобы страница несла максимум, а остаток продолжался на следующей
Настройка минимальных строк может поднять сбалансированную высоту. При SetTextFlowMinLines(Flow, 3) и четырёх оставшихся строках сбалансированная высота двух ниже минимума, поэтому колонки заполняются по порядку: три строки в первой, одна во второй, третья пуста. Короткий хвост в самом конце фрагмента размещается всегда, ведь идти ему больше некуда. Чтобы держать минимум две строки вместе и в верху следующей колонки, SetTextFlowPaginationLines берёт минимумы сироты и вдовца одним вызовом
Для сплошных статей передавайте 1 каждый раз. В середине фрагмента это ничего не меняет: колонки и так полны. 0 мы бы передавали, только когда колоночная область — фиксированный бокс в формоподобной раскладке, где остаток в 52 строки при колонках в 43 строки должен лечь как 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 x высота выбранного текста
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, в том порядке, как делает первый пример
Фрагменты со смешанными письменностями идут через тот же путь выбранного шрифта в измерении и рисовании, поэтому подставные гарнитуры, выбранные автоматическим fallback шрифтов для текста CJK и эмодзи, не открывают щели между ними. В отчётных раскладках, где поток делит страницу с колонтитулами и блоками на основе данных, порядок из статьи движок отчётов на основе набора данных переносится: сначала мерьте, ставьте фиксированные элементы, потом отдайте потоку что осталось от области
Здесь покрытые вызовы потока текста — от создания и измерения до перемотки и освобождения — часть PDF Library for Delphi для Delphi, C++Builder и Lazarus. Справочник функций и загрузка — на странице продукта PDF Library for Delphi