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 开始的页码 of the newly created vertical-stitch page |