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
| SourcePage | Det 1-baserede sidenummer whose content will be captured and overlaid (consumed and hidden afterwards) |
|---|---|
| TargetPage | Det 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, Height | Placeringsstørrelse; overfør kildesidens dimensioner for ueskaleret overlejring |
| Opacity | 0..1 alpha for det overlejrede indhold (1 = uigennemsigtig, værdier under 1 aktiverer gennemsigtighed via ExtGState ca/CA) |
Return values
| 0 | Overlejringen kunne ikke udføres (ugyldige sidenumre, samme kilde og mål, eller fejl ved fangst) |
|---|---|
| 1 | Kildesiden blev fanget og lagt oven på målsiden |