StitchPageOverlay
Page manipulation
Description
מניח תוכן של דף אחד מעל דף קיים אחר במיקום הנתון; דף המקור נלכד לאובייקט וקטורי Form XObject ומצויר על דף היעד, תוך שמירה על נאמנות וקטורית מלאה (הטקסט נשאר ניתן לבחירה, הנתיבים נשארים חדים) במקום לבצע רסטריזציה
דף המקור נצרך בתהליך: הוא נלכד ומוסתר, בדיוק כמו ImposePagesNUp; אם מספר דף היעד גדול ממספר דף המקור, הוא מותאם אוטומטית מכיוון שהסתרת המקור מסיטה דפים מאוחרים יותר למטה באחד
ה-Width וה-Height שולטים בגודל המיקום; אם יחס הגובה-רוחב שלהם שונה מדף המקור, התוכן יימתח; השתמש בממדים של הדף עצמו עבור שכבת 1:1; אטימות (Opacity) נעה בין 0 (שקוף לחלוטין) ל-1 (אטום לחלוטין)
Syntax
Delphi
Function TPDFlib.StitchPageOverlay(SourcePage, TargetPage: Integer; Left, Top, Width, Height, Opacity: Double): Integer;
Parameters
| SourcePage | מספר הדף (המתחיל מ-1) whose content will be captured and overlaid (consumed and hidden afterwards) |
|---|---|
| TargetPage | מספר הדף (המתחיל מ-1) that receives the overlay; must differ from SourcePage |
| Left, Top | המיקום השמאלי-עליון של התוכן המונח (overlaid) בדף היעד, ביחידות המידה הנוכחיות (נקודת מוצא שמאלית-עליונה) |
| Width, Height | גודל המיקום; העבירו את מידות דף המקור עבור שכבה ללא שינוי קנה מידה |
| Opacity | אלפא של 0..1 עבור התוכן שמונח מעל (1 = אטום, ערכים מתחת ל-1 מאפשרים שקיפות באמצעות ExtGState ca/CA) |
Return values
| 0 | לא ניתן היה לבצע את ההנחה (overlay) (מספרי דפים לא תקפים, מקור ויעד זהים, או כישלון בלכידה) |
|---|---|
| 1 | דף המקור נלכד והונח כשכבה על דף היעד |