StitchPagesVertically

Манипуляция страницами

Описание

Складывает последовательность страниц вертикально в одну новую высокую страницу (постерная композиция). Каждая исходная страница захватывается в векторный Form XObject и рисуется сверху вниз, каждая масштабируется к TargetWidth с сохранением пропорций, между соседними страницами вставляется Gap

Страницы захватываются в порядке убывания номеров страниц, поэтому индексы более ранних страниц остаются стабильными при скрытии более поздних страниц; высота новой страницы автоматически вычисляется как сумма всех масштабированных исходных высот плюс Gap, умноженное на (количество - 1); все исходные страницы потребляются и скрываются

Синтаксис

Delphi

Function TPDFlib.StitchPagesVertically(Const PageRanges: WideString; Gap, TargetWidth: Double): Integer;

Параметры

PageRangesСтрока стандартного диапазона страниц (например, "1-3,5"); пустое значение означает все страницы
GapВертикальное пространство, вставляемое между соседними страницами, в текущих единицах измерения
TargetWidthШирина новой выходной страницы; каждая исходная страница масштабируется (с сохранением пропорций) до этой ширины

Возвращаемые значения

0Не удалось выполнить объединение (пустой диапазон, неположительное значение TargetWidth или сбой захвата)
>= 1Номер новой вертикально сшитой страницы, начиная с 1