StitchPageOverlay

Page manipulation

Description

Overlejrer én sides indhold på en anden eksisterende side i den givne position; kildesiden fanges i et vektor-Form-XObject og tegnes på målsiden, hvilket bevarer fuld vektortroværdighed (tekst forbliver valgbar, stier forbliver skarpe) frem for at rasterisere

Kildesiden forbruges i processen: den fanges og skjules, nøjagtigt som ImposePagesNUp; Hvis målsidenummeret er større end kildesidenummeret, justeres det automatisk, fordi skjulning af kilden forskyder efterfølgende sider én ned

Width og Height styrer placeringsstørrelsen; hvis deres højde-bredde-forhold afviger fra kildesiden, strækkes indholdet; brug sidens egne dimensioner for en 1:1-overlejring; opacitet spænder fra 0 (helt transparent) til 1 (helt uigennemsigtig)

Syntax

Delphi

Function TPDFlib.StitchPageOverlay(SourcePage, TargetPage: Integer; Left, Top, Width, Height, Opacity: Double): Integer;

Parameters

SourcePageDet 1-baserede sidenummer whose content will be captured and overlaid (consumed and hidden afterwards)
TargetPageDet 1-baserede sidenummer that receives the overlay; must differ from SourcePage
Left, TopØverste venstre placering af det overlejrede indhold på målsiden, i aktuelle måleenheder (øverste venstre nulpunkt)
Width, HeightPlaceringsstørrelse; overfør kildesidens dimensioner for ueskaleret overlejring
Opacity0..1 alpha for det overlejrede indhold (1 = uigennemsigtig, værdier under 1 aktiverer gennemsigtighed via ExtGState ca/CA)

Return values

0Overlejringen kunne ikke udføres (ugyldige sidenumre, samme kilde og mål, eller fejl ved fangst)
1Kildesiden blev fanget og lagt oven på målsiden