PDFium Delphi Component 文件

ImportImposed 方法

组件: TPdf  ·  单元: PDFium
通过批量原生合成创建新的 N-up 或小册子文档,并返回确定性的执行事实

语法

function ImportImposed(const Options: TPdfImpositionOptions; out Plan: TPdfImpositionPlan): TPdf;

function ImportImposed(const Options: TPdfImpositionOptions; out Plan: TPdfImpositionPlan; out Report: TPdfImpositionExecutionReport): TPdf;

OptionsTPdfImpositionOptions。包含 Mode、OutputWidth、OutputHeight、Columns、Rows、Duplex、ReverseSheets、Gutter、Bleed 和 CreepPerSheet 字段,并提供 Default 类函数
PlanTPdfImpositionPlan。包含 SourcePageCount、PaddedPageCount、SheetCount、SideCount、SlotsPerSide、Slots、OutputWidth、OutputHeight、Columns、Rows、Gutter 和 Bleed 字段;每个 TPdfImpositionSlot 携带 SheetIndex、SideIndex、SlotIndex、SourcePageIndex、Creep、Left、Bottom、Width 和 Height
ReportTPdfImpositionExecutionReport。包含 NativeImportCallCount、NativeImportedPageCount、UniqueSourcePageCount、BlankSlotCount、XObjectTemplateCount、FormObjectCount、ContentGenerationCallCount、OutputPageCount 和 UsedNativeNUp 字段
ResultTPdf。由调用方持有的新活动文档;原生合成失败时为 nil

说明

BuildPdfImpositionPlan 会校验全部限制、预分配准确的槽位数量,并在文档创建开始之前确定每个源槽位与空白槽位

小册子模式会补齐到四的倍数并生成正面与背面的页面顺序;N-up 双面模式会补齐不完整的物理印张,因此颠倒印张顺序绝不会丢失或重新分配源页面

每个槽位都记录了应用外出血、单元格间装订间距和带符号爬移之后可用的 Left、Bottom、Width 和 Height

零几何任务通过一次 FPDF_ImportPagesByIndex 调用导入全部有序的非空白页,插入计划中的空白页,并将 FPDF_ImportNPagesToOne 用作快速路径

带装订间距、出血或爬移的任务会为每个唯一的源页面缓存一个原生页面 XObject,并以精确的放置矩阵创建独立的表单对象

两种路径都会保留源文档的当前页;报告重载公开诊断与性能回归测试所需的执行计数

调用方必须释放返回的文档

参见

ImportNPagesToOne, ImportPagesByIndex, CompareWith