StitchPageOverlay
Page manipulation
Description
Overlays one page's content onto another existing page at the given position. The source page is captured into a vector Form XObject and drawn on the target page, preserving full vector fidelity (text stays selectable, paths stay crisp) rather than rasterizing.
Исходная страница расходуется в процессе: она захватывается и скрывается, точно так же, как в ImposePagesNUp; если номер целевой страницы больше номера исходной страницы, он автоматически корректируется, так как скрытие источника сдвигает последующие страницы вниз на одну
Параметры Width и Height управляют размером размещения; если их пропорции отличаются от исходной страницы, содержимое растягивается; используйте собственные размеры страницы для наложения 1:1; непрозрачность изменяется в диапазоне от 0 (полностью прозрачно) до 1 (полностью непрозрачно)
Syntax
Delphi
Function TPDFlib.StitchPageOverlay(SourcePage, TargetPage: Integer; Left, Top, Width, Height, Opacity: Double): Integer;Parameters
| SourcePage | The 1-based page number whose content will be captured and overlaid (consumed and hidden afterwards) |
|---|---|
| TargetPage | The 1-based page number that receives the overlay; must differ from SourcePage |
| Left, Top | Верхнее левое размещение накладываемого содержимого на целевой странице в текущих единицах измерения (координаты от верхнего левого угла) |
| Width, Height | Размер размещения; передайте исходные размеры страницы для наложения без масштабирования |
| Opacity | 0..1 альфа для накладываемого содержимого (1 = непрозрачно, значения ниже 1 включают прозрачность через ExtGState ca/CA) |
Return values
| 0 | Не удалось выполнить наложение (недопустимые номера страниц, одинаковые источник и цель, либо сбой захвата) |
|---|---|
| 1 | Исходная страница была захвачена и наложена на целевую страницу |