Images and Attachments

Görseller ve Ekli Dosyalar — Aspose.Note Python için FOSS

Aspose.Note FOSS for Python gives direct access to both embedded images and attached files stored inside OneNote .one bölüm dosyaları. İçerik şu aracılığıyla ortaya çıkar: Image ve AttachedFile düğüm türleri.

Görüntüleri Çıkarma

OneNote belgesindeki her görüntü bir Image düğüm. Kullan GetChildNodes(Image) belgeden tüm görüntüleri özyinelemeli olarak almak için:

from aspose.note import Document, Image

doc = Document("MyNotes.one")
for i, img in enumerate(doc.GetChildNodes(Image), start=1):
    filename = img.FileName or f"image_{i}.bin"
    with open(filename, "wb") as f:
        f.write(img.Bytes)
    print(f"Saved: {filename}  ({img.Width} x {img.Height} pts)")

Görüntü Özellikleri

Özellik	Tür	Açıklama
`FileName`	`str	None`
`Bytes`	`bytes`	Ham görüntü verisi (format orijinaliyle eşleşir, ör. PNG, JPEG)
`Width`	`float	None`
`Height`	`float	None`
`AlternativeTextTitle`	`str	None`
`AlternativeTextDescription`	`str	None`
`HyperlinkUrl`	`str	None`
`Tags`	`list[NoteTag]`	Bu resme eklenmiş OneNote etiketleri

Görüntüleri Güvenli Dosya Adlarıyla Kaydet

Ne zaman FileName olur None veya dosya sistemi için güvensiz karakterler içeriyorsa, kaydetmeden önce temizleyin:

import re
from aspose.note import Document, Image

def safe_name(name: str | None, fallback: str) -> str:
    if not name:
        return fallback
    return re.sub(r'[<>:"/\\|?*]', "_", name)

doc = Document("MyNotes.one")
for i, img in enumerate(doc.GetChildNodes(Image), start=1):
    name = safe_name(img.FileName, f"image_{i}.bin")
    with open(name, "wb") as f:
        f.write(img.Bytes)

Sayfa Başına Görüntüleri Çıkar

from aspose.note import Document, Page, Image

doc = Document("MyNotes.one")
for page_num, page in enumerate(doc.GetChildNodes(Page), start=1):
    images = page.GetChildNodes(Image)
    print(f"Page {page_num}: {len(images)} image(s)")
    for i, img in enumerate(images, start=1):
        filename = f"page{page_num}_img{i}.bin"
        with open(filename, "wb") as f:
            f.write(img.Bytes)

Görüntü Alternatif Metnini ve Köprüleri İncele

from aspose.note import Document, Image

doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
    if img.AlternativeTextTitle:
        print("Alt title:", img.AlternativeTextTitle)
    if img.AlternativeTextDescription:
        print("Alt desc:", img.AlternativeTextDescription)
    if img.HyperlinkUrl:
        print("Linked to:", img.HyperlinkUrl)

Baytlardan Görüntü Dosya Biçimini Algıla

Python’s imghdr modül (Python ≤ 3.12) veya struct modül, ilk baytlardan görüntü formatını algılayabilir:

from aspose.note import Document, Image

doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
    b = img.Bytes
    if b[:4] == b'\x89PNG':
        fmt = "png"
    elif b[:2] == b'\xff\xd8':
        fmt = "jpeg"
    elif b[:4] == b'GIF8':
        fmt = "gif"
    elif b[:2] in (b'BM',):
        fmt = "bmp"
    else:
        fmt = "bin"
    name = (img.FileName or f"image.{fmt}").rsplit(".", 1)[0] + f".{fmt}"
    with open(name, "wb") as f:
        f.write(b)

Ekli Dosyaları Çıkarma

Gömülü dosya ekleri şu şekilde saklanır AttachedFile düğümler:

from aspose.note import Document, AttachedFile

doc = Document("NotesWithAttachments.one")
for i, af in enumerate(doc.GetChildNodes(AttachedFile), start=1):
    filename = af.FileName or f"attachment_{i}.bin"
    with open(filename, "wb") as f:
        f.write(af.Bytes)
    print(f"Saved attachment: {filename}  ({len(af.Bytes):,} bytes)")

AttachedFile Özellikleri

Özellik	Tür	Açıklama
`FileName`	`str	None`
`Bytes`	`bytes`	Ham dosya içeriği
`Tags`	`list[NoteTag]`	Bu düğüme eklenmiş OneNote etiketleri

Görüntüler ve Ekler Üzerindeki Etiketleri İncele

İkisi Image ve AttachedFile düğümler OneNote etiketlerini destekler:

from aspose.note import Document, Image, AttachedFile

doc = Document("MyNotes.one")

for img in doc.GetChildNodes(Image):
    for tag in img.Tags:
        print(f"Image tag: {tag.Label}  completedTime={tag.CompletedTime}")

for af in doc.GetChildNodes(AttachedFile):
    for tag in af.Tags:
        print(f"Attachment tag: {tag.Label}  completedTime={tag.CompletedTime}")

Özet: Image vs AttachedFile

Özellik	`Image`	`AttachedFile`
`FileName`	Evet (orijinal resim adı)	Evet (orijinal dosya adı)
`Bytes`	Ham resim baytları	Ham dosya baytları
`Width` / `Height`	Evet (görüntülenen boyutlar)	Hayır
`AlternativeTextTitle/Description`	Evet	Hayır
`HyperlinkUrl`	Evet	Hayır
`Tags`	Evet	Evet
`Replace(node)` yöntem	Evet	Hayır

İpuçları

Her zaman karşı önlem alın None dosya adları. img.FileName olur None dosyanın kaynak belgede adı olmadığında.
img.Bytes asla None ve her zaman ham ikili içeriktir; yer tutucu görüntüler için sıfır bayt olabilir.
Kullan Page.GetChildNodes(Image) yerine Document.GetChildNodes(Image) çıkarma işlemini tek bir sayfaya sınırlamak için.
Bu Image.Replace(image) metod, bir görüntü düğümünün içeriğini bellek içinde başka bir içerikle değiştirir; geri kaydetme .one desteklenmiyor.