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 |