Quickstart
Γρήγορη εκκίνηση
Αυτή η σελίδα περιγράφει τον βασικό κύκλο δημιουργίας/τροποποίησης/αποθήκευσης/επαναφόρτωσης: δημιουργήστε ένα PDF δύο σελίδων, προσθέστε μια σημείωση σε κάθε σελίδα χρησιμοποιώντας την ενημερωμένη Annotation API, δημιουργήστε την ορατή εμφάνιση των σημειώσεων, αποθηκεύστε το έγγραφο και επαναφορτώστε το για να επιβεβαιώσετε ότι οι αλλαγές επιβίωσαν στο round‑trip.
Προαπαιτούμενα
| Απαίτηση | Λεπτομέρεια |
|---|---|
| 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-name, επιστρέφοντας το νέο 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 διαβάζει ένα έγγραφο από διαδρομή, bytes ή ρεύμα.
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)