PDFium Delphi Component Docs

ImportImposed Метод

Компонент: TPdf  ·  Модуль: PDFium
Создаёт новый документ N-up или booklet через пакетную собственную компоновку и возвращает детерминированные факты выполнения

Syntax

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, когда собственная компоновка не удалась

Description

BuildPdfImpositionPlan проверяет все лимиты, заранее выделяет точное количество слотов и определяет каждый исходный и пустой слот до начала создания документа

Режим booklet дополняет страницы до числа, кратного четырём, и создаёт порядок лицевых и оборотных сторон; режим N-up с дуплексом дополняет неполные физические листы, чтобы переворачивание листов не теряло и не переназначало исходные страницы

Каждый слот фиксирует свои пригодные Left, Bottom, Width и Height после применения внешнего bleed, межъячеечного gutter и подписного creep

Задания с нулевой геометрией импортируют все упорядоченные непустые страницы одним вызовом FPDF_ImportPagesByIndex, вставляют запланированные пустые страницы и используют FPDF_ImportNPagesToOne как быстрый путь

Задания с gutter, bleed или creep кэшируют один нативный XObject страницы на каждую уникальную исходную страницу и создают независимые объекты форм с точными матрицами размещения

Оба пути сохраняют текущую страницу исходного документа; перегрузка с отчётом раскрывает счётчики выполнения, нужные для диагностики и регрессионных тестов производительности

Вызывающий код должен освободить возвращённый документ

See Also

ImportNPagesToOne, ImportPagesByIndex, CompareWith