StitchPagesVertically

Manipulation de pages

Description

Empile une séquence de pages verticalement en une seule nouvelle page haute (composition façon poster) ; chaque page source est capturée dans un Form XObject vectoriel et dessinée de haut en bas, mise à l’échelle vers TargetWidth en conservant ses proportions, avec un Gap inséré entre pages consécutives

Les pages sont capturées par numéro de page décroissant afin que les index des pages antérieures restent stables pendant que les pages suivantes sont masquées ; la hauteur de la nouvelle page est calculée automatiquement comme la somme de toutes les hauteurs sources mises à l’échelle plus Gap multiplié par (count - 1) ; toutes les pages sources sont consommées puis masquées

Syntaxe

Delphi

Function TPDFlib.StitchPagesVertically(Const PageRanges: WideString; Gap, TargetWidth: Double): Integer;

Paramètres

PageRangesUne chaîne de plage de pages standard (par exemple "1-3,5") ; une valeur vide signifie toutes les pages
GapEspace vertical inséré entre pages consécutives, dans les unités de mesure actuelles
TargetWidthLargeur de la nouvelle page de sortie ; chaque page source est mise à l’échelle (proportions conservées) vers cette largeur

Valeurs de retour

0L’assemblage vertical n’a pas pu être effectué (plage vide, TargetWidth non positif ou échec de capture)
>= 1Numéro de page à partir de 1 de la nouvelle page assemblée verticalement