Πώς να διαβάσετε τα μεταδεδομένα εικόνας από το OneNote στο Python

Κάθε Image ο κόμβος σε ένα έγγραφο OneNote μεταφέρει μεταδεδομένα μαζί με τα ακατέργαστα bytes εικονοστοιχείων: το αρχικό όνομα αρχείου, τις διαστάσεις εμφάνισης (πλάτος και ύψος σε points), το εναλλακτικό κείμενο για προσβασιμότητα, και προαιρετικά ένα URL υπερσύνδεσμου εάν η εικόνα ήταν συνδεδεμένη. Aspose.Note FOSS για Python εκθέτει όλα αυτά τα πεδία μέσω του Image κλάση.

Προαπαιτούμενα

pip install aspose-note

Ιδιότητες Εικόνας

Ιδιότητα	Τύπος	Περιγραφή
`img.Bytes`	`bytes`	Ακατέργαστα δεδομένα εικόνας. Γράψτε στο δίσκο με `open(name, "wb").write(img.Bytes)`.
`img.FileName`	`str	None`
`img.Width`	`float	None`
`img.Height`	`float	None`
`img.AlternativeTextDescription`	`str	None`
`img.AlternativeTextTitle`	`str	None`
`img.HyperlinkUrl`	`str	None`
`img.Tags`	`list[NoteTag]`	Ετικέτες OneNote που είναι συνδεδεμένες σε αυτήν την εικόνα (αστέρι, πλαίσιο ελέγχου κ.λπ.).

Βήμα 1: Φόρτωση του Εγγράφου και Εύρεση Εικόνων

from aspose.note import Document, Image

doc = Document("MyNotes.one")
images = doc.GetChildNodes(Image)
print(f"Found {len(images)} image(s)")

Βήμα 2: Ανάγνωση Μεταδεδομένων για Κάθε Εικόνα

Προστατέψτε τα πεδία που μπορούν να είναι null με is not None πριν τη χρήση:

from aspose.note import Document, Image

doc = Document("MyNotes.one")

for i, img in enumerate(doc.GetChildNodes(Image), start=1):
    print(f"\nImage {i}:")
    print(f"  Filename:    {img.FileName or '(no filename)'}")
    print(f"  Size:        {img.Bytes and len(img.Bytes):,} bytes")

    if img.Width is not None and img.Height is not None:
        print(f"  Dimensions:  {img.Width:.1f} × {img.Height:.1f} pts")

    if img.AlternativeTextDescription:
        print(f"  Alt text:    {img.AlternativeTextDescription}")

    if img.HyperlinkUrl:
        print(f"  Hyperlink:   {img.HyperlinkUrl}")

    if img.Tags:
        for tag in img.Tags:
            print(f"  Tag:         {tag.Label or tag.Icon}")

Πλήρες Παράδειγμα: Αποθήκευση Εικόνων με Αναφορά Μεταδεδομένων

from pathlib import Path
from aspose.note import Document, Image

def report_and_save_images(one_path: str, out_dir: str = "images") -> None:
    doc = Document(one_path)
    images = doc.GetChildNodes(Image)
    if not images:
        print("No images found.")
        return

    out = Path(out_dir)
    out.mkdir(exist_ok=True)

    for i, img in enumerate(images, start=1):
        # Determine save name
        name = img.FileName or f"image_{i}.bin"
        dest = out / name

        # Save bytes
        dest.write_bytes(img.Bytes)

        # Report metadata
        dims = (
            f"{img.Width:.0f}×{img.Height:.0f}pts"
            if img.Width is not None and img.Height is not None
            else "unknown size"
        )
        alt = img.AlternativeTextDescription or ""
        link = img.HyperlinkUrl or ""

        print(f"  [{i}] {name}  {dims}"
              + (f"  alt='{alt}'" if alt else "")
              + (f"  url={link}" if link else ""))

    print(f"\nSaved {len(images)} image(s) to '{out_dir}/'")

report_and_save_images("MyNotes.one")

Φιλτράρισμα Εικόνων κατά Ιδιότητα

Εικόνες με υπερσυνδέσμους

from aspose.note import Document, Image

doc = Document("MyNotes.one")
linked = [img for img in doc.GetChildNodes(Image) if img.HyperlinkUrl]
for img in linked:
    print(f"{img.FileName or 'image'} → {img.HyperlinkUrl}")

Εικόνες με εναλλακτικό κείμενο

from aspose.note import Document, Image

doc = Document("MyNotes.one")
with_alt = [img for img in doc.GetChildNodes(Image) if img.AlternativeTextDescription]
for img in with_alt:
    print(f"{img.FileName}: {img.AlternativeTextDescription}")

Σημειώσεις

img.Bytes είναι πάντα παρόν (επιστρέφει b"" για μη αναγνώσιμες εικόνες, ποτέ None). Ελέγξτε len(img.Bytes) > 0 πριν την αποθήκευση.
img.AlternativeTextTitle μπορεί να είναι None αν το πηγαίο έγγραφο δεν ορίζει τίτλο. Χρησιμοποιήστε img.AlternativeTextDescription ως εναλλακτική.
Οι διαστάσεις είναι σε σημεία (1 σημείο = 1/72 ίντσα), ταιριάζοντας με τις συμβάσεις του PowerPoint και του PDF.