PDFium Delphi Component Docs

ImportImposed Methode

Komponente: TPdf  ·  Unit: PDFium
Erzeugt ein neues N-up- oder Booklet-Dokument durch gestaffelte native Komposition und liefert deterministische Ausführungsdaten zurück

Syntax

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

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

OptionsTPdfImpositionOptions. Felder Mode, OutputWidth, OutputHeight, Columns, Rows, Duplex, ReverseSheets, Gutter, Bleed und CreepPerSheet, mit einer Default-Klassenfunktion
PlanTPdfImpositionPlan. Felder SourcePageCount, PaddedPageCount, SheetCount, SideCount, SlotsPerSide, Slots, OutputWidth, OutputHeight, Columns, Rows, Gutter und Bleed; jeder TPdfImpositionSlot trägt SheetIndex, SideIndex, SlotIndex, SourcePageIndex, Creep, Left, Bottom, Width und Height
ReportTPdfImpositionExecutionReport. Felder NativeImportCallCount, NativeImportedPageCount, UniqueSourcePageCount, BlankSlotCount, XObjectTemplateCount, FormObjectCount, ContentGenerationCallCount, OutputPageCount und UsedNativeNUp
ResultTPdf. Ein neues aktives Dokument im Besitz des Aufrufers oder nil, wenn die native Komposition fehlschlägt

Beschreibung

BuildPdfImpositionPlan prüft alle Grenzen, reserviert die exakte Slot-Anzahl vorab und legt jeden Quell- und Leer-Slot fest, bevor die Dokumenterstellung beginnt

Der Booklet-Modus füllt auf ein Vielfaches von vier auf und erzeugt die Reihenfolge für Vorder- und Rückseite; der N-up-Duplex-Modus füllt unvollständige physische Bögen auf, sodass das Umkehren der Bögen nie Quellseiten verliert oder neu zuordnet

Jeder Slot zeichnet seine nutzbaren Werte für Left, Bottom, Width und Height auf, nachdem äußeres Bleed, der Steg zwischen den Zellen und der vorzeichenbehaftete Creep angewendet wurden

Aufträge ohne Geometrie importieren alle geordneten, nicht leeren Seiten über einen einzigen FPDF_ImportPagesByIndex-Aufruf, fügen die geplanten Leerseiten ein und nutzen FPDF_ImportNPagesToOne als Schnellpfad

Aufträge mit Steg, Bleed oder Creep cachen ein natives Seiten-XObject pro eindeutiger Quellseite und erzeugen unabhängige Formularobjekte mit exakten Platzierungsmatrizen

Beide Wege erhalten die aktuelle Seite des Quelldokuments; die Report-Überladung legt die für Diagnose und Performance-Regressionstests benötigten Ausführungszähler offen

Der Aufrufer muss das zurückgegebene Dokument freigeben

Siehe auch

ImportNPagesToOne, ImportPagesByIndex, CompareWith