PDF एनोटेशन के साथ Python में कैसे काम करें

Aspose.PDF FOSS for Python प्रत्येक पृष्ठ पर सभी एनोटेशन को पृष्ठ के AnnotationCollection के माध्यम से एक लाइव Annotation ऑब्जेक्ट के रूप में उजागर करता है, इसलिए आप मार्कअप, लिंक, और 3D एनोटेशन जोड़ सकते हैं, उनके प्रकार-विशिष्ट गुणों की जांच कर सकते हैं, और उन appearance streams को जनरेट कर सकते हैं जो PDF व्यूअर्स को उन्हें रेंडर करने के लिए चाहिए — सब कुछ शुद्ध Python से। यह गाइड दिखाता है कि लाइब्रेरी कैसे स्थापित करें, एनोटेशन जोड़ें, उन्हें पढ़ें, और उनकी appearance streams जनरेट करें।

कदम-दर-कदम गाइड

git clone https://github.com/aspose-pdf-foss/Aspose-PDF-FOSS-for-Python.git
cd Aspose-PDF-FOSS-for-Python
pip install -e .

import aspose_pdf
print("aspose_pdf OK")

from aspose_pdf import Document
from aspose_pdf.annotations import (
    Annotation,
    AnnotationType,
    AnnotationFlags,
    MarkupAnnotation,
    LinkAnnotation,
)

from aspose_pdf import Document

document = Document()
document.pages.add()
page = document.pages[0]

annotation = page.annotations.add(
    "Highlight",
    (100, 700, 300, 720),
    "Key clause",
)
print(type(annotation).__name__)   # MarkupAnnotation
print(annotation.contents)         # Key clause

from aspose_pdf import Document
from aspose_pdf.annotations import AnnotationType

document = Document()
document.pages.add()
page = document.pages[0]

annotation = page.annotations.add(
    AnnotationType.POLYGON,
    (0, 0, 10, 10),
    "",
    properties={"Vertices": [0, 0, 10, 0, 5, 10]},
)
print(annotation.subtype)                    # Polygon
print(annotation.get_property("Vertices"))   # [0, 0, 10, 0, 5, 10]

from aspose_pdf import Document

document = Document()
document.pages.add()
page = document.pages[0]
page.annotations.add("Text", (50, 50, 70, 70), "First note")
page.annotations.add("Text", (80, 80, 100, 100), "Second note")

for annotation in page.annotations:
    print(annotation.subtype, "-", annotation.contents)

from aspose_pdf import Document
from aspose_pdf.engine.cos import AnnotationName

document = Document()
document.pages.add()
page = document.pages[0]

stamp = page.annotations.add(
    "Stamp",
    (100, 100, 260, 150),
    "",
    properties={"Name": AnnotationName("Approved")},
)
if stamp.generate_appearance():
    print(f"Appearance stream: {len(stamp.appearance_normal)} byte(s)")

# Regenerate every missing appearance stream on the page in one call:
count = page.annotations.generate_appearances(force=True)
print(f"Regenerated {count} appearance stream(s)")

from aspose_pdf import Document
from aspose_pdf.annotations import LinkAnnotation, MarkupAnnotation

document = Document()
document.pages.add()
page = document.pages[0]

link = page.annotations.add("Link", (50, 750, 200, 770), "")
highlight = page.annotations.add("Highlight", (50, 700, 200, 720), "")

print(isinstance(link, LinkAnnotation))         # True
print(isinstance(highlight, MarkupAnnotation))  # True

सामान्य समस्याएँ और समाधान

get_property returns None एक property के लिए जिसे मैंने अभी सेट किया है

properties कुंजियाँ सटीक, केस-सेंसिटिव PDF फ़ील्ड नाम हैं ("Vertices", "Name", आदि) — एक टाइपो या गलत केस को चुपचाप अनदेखा किया जाता है न कि त्रुटि के रूप में उभारा जाता है। get_property(name, default) को एक default तर्क पास करें और नई उपप्रकार को डिबग करते समय इसे स्पष्ट रूप से जाँचें।

generate_appearance() returns False

हर उपप्रकार और property संयोजन को अंतर्निहित जनरेटर द्वारा appearance stream में संश्लेषित नहीं किया जा सकता। कॉल सफल मानने से पहले has_appearance जाँचें, और उन उपप्रकारों के लिए जिनको जनरेटर कवर नहीं करता, सीधे add() पर एक पूर्व-रेंडर किया हुआ appearance_normal (bytes) प्रदान करें।

अप्रत्याशित annotation सबक्लास के बाद add()

आपके द्वारा पास किया गया subtype स्ट्रिंग (या AnnotationType सदस्य) लौटाए गए क्लास को निर्धारित करता है: markup उपप्रकार MarkupAnnotation के रूप में लौटते हैं, "Link" LinkAnnotation के रूप में लौटता है, और कोई भी अन्य पहचाना गया उपप्रकार बेस Annotation के रूप में लौटता है। विशिष्ट subtype स्ट्रिंग मानने के बजाय MarkupAnnotation/LinkAnnotation के विरुद्ध isinstance() का उपयोग करें।

AnnotationFlags values रेंडरिंग को बदलते नहीं लगते

AnnotationFlags (PRINT, HIDDEN, NO_ZOOM, READ_ONLY, और समान) एक मानक Python IntFlag enum है जो | ऑपरेटर के साथ एनोटेशन के व्यवहार बिट्स को संयोजित और व्याख्या करने के लिए उपयोग होता है — यह एक वैल्यू टाइप है, न कि वह प्रॉपर्टी जिसे Annotation.add() स्वतः लिखता है। आपको आवश्यक फ़्लैग्स को संयोजित करें और उन्हें अन्य subtype-विशिष्ट डेटा के लिए उपयोग किए गए समान टाइप-विशिष्ट properties तंत्र के माध्यम से पास करें।

एक पृष्ठ के साथ काम करना जिसमें अभी तक कोई एनोटेशन नहीं है

page.annotations हमेशा एक वैध (संभवतः खाली) AnnotationCollection है — आपको.

अक्सर पूछे जाने वाले प्रश्न

कौन से एनोटेशन उपप्रकार Aspose.PDF FOSS for Python द्वारा समर्थित हैं?

AnnotationType सभी 25 मानक PDF 32000-1:2008 तालिका 169 उपप्रकारों की सूची बनाता है, जिसमें TEXT, LINK, FREE_TEXT, LINE, SQUARE, CIRCLE, POLYGON, HIGHLIGHT, STAMP, INK, FILE_ATTACHMENT, REDACT, और अधिक शामिल हैं।

क्या यह लाइब्रेरी 3D एनोटेशनों का समर्थन करती है?

हाँ। PDF3DAnnotation, साथ में PDF3DArtwork, PDF3DContent, PDF3DView, PDF3DLightingScheme, और PDF3DRenderMode, न्यूनतम PDF 3D annotation सतह (एक आयत, एम्बेडेड कलाकृति, और नामित दृश्य) का मॉडल बनाता है प्री-रिलीज़ PDF 3D कार्यप्रवाहों के लिए। देखें PDF3DAnnotation संदर्भ इसके पूरे प्रॉपर्टी सेट के लिए।

मैं पृष्ठ से एक एनोटेशन कैसे हटाऊँ?

स्थिति द्वारा एक एनोटेशन हटाने के लिए page.annotations.delete(index) को कॉल करें, या पृष्ठ पर सभी एनोटेशन हटाने के लिए page.annotations.clear() को कॉल करें।

क्या मैं इसे जोड़ने के बजाय किसी विशिष्ट स्थिति में एनोटेशन डाल सकता हूँ?

हाँ — AnnotationCollection.insert(index, subtype, rect, contents, title, appearance_normal, properties) वही तर्क लेता है जैसा add() लेता है, साथ में लक्ष्य index।

एक एनोटेशन का रंग कैसे दर्शाया जाता है?

color प्रॉपर्टी Annotation पर (और उसकी उपवर्गों में) एक tuple[float, ...] है जो PDF /C एंट्री के कंपोनेंट काउंट से मेल खाती है (जब रंग सेट नहीं हो तो खाली) — यह कोई समर्पित रंग ऑब्जेक्ट नहीं है।

यह भी देखें

• डॉक्यूमेंट मैनेजमेंट (डेवलपर गाइड)
• Python में दस्तावेज़ कैसे लोड करें
• इंस्टॉलेशन गाइड
• API Reference
• GitHub रिपॉजिटरी
• Aspose.PDF for Python — Enterprise Knowledge Base