Quickstart
התחלה מהירה
דף זה מדריך את מחזור הליבה של create/modify/save/reload: בניית PDF דו‑עמודי, הוספת הערה לכל עמוד באמצעות ה‑Annotation המעודכן API, יצירת המראה הוויזואלי של ההערות, שמירת המסמך, וטעינתו מחדש כדי לאשר שהשינויים שרדו את המסע בחזרה.
דרישות מקדימות
| דרישה | פרט |
|---|---|
| Python | 3.11 או גרסה מאוחרת יותר |
| Package | aspose-pdf-foss-for-python מותקן (Installation) |
1. צור מסמך והוסף דפים
Document() ללא ארגומנטים יוצר PDF ריק בזיכרון. document.pages הוא PageCollection שניתן לשינוי; קריאה ל-add() מוסיפה עמוד ריק.
from aspose_pdf import Document
document = Document()
document.pages.add()
document.pages.add()
print("Page count:", document.page_count)2. הוסף הערות וייצר את המראה שלהן
המאפיין annotations של כל עמוד הוא AnnotationCollection. add() מקבלת שם תת-סוג, מלבן (left, bottom, right, top), טקסט תוכן, ואופציונלית מילון properties של ערכי מפתחות בשם PDF, ומחזירה את ה-Annotation החדש. generate_appearance() מציגה את התוכן החזותי של ההערה כך שהוא מוצג כראוי בתצוגת PDF.
document.pages[0].annotations.add("Square", (0, 0, 50, 50), "")
line = document.pages[1].annotations.add(
"Line", (0, 0, 50, 50), "", properties={"L": [0, 0, 50, 50]}
)
line.generate_appearance()3. שמור והטען מחדש
Document.save מקבל נתיב קובץ (או זרם שניתן לכתיבה). Document.load_from קורא מסמך מנתיב, בתים, או זרם.
document.save("quickstart.pdf")
reopened = Document()
reopened.load_from("quickstart.pdf")
print("Reloaded pages:", reopened.page_count)
print("Has appearance:", reopened.pages[1].annotations[0].has_appearance)