Image — Aspose.Note FOSS for Python API Reference

Kelas: Image

ImageRenderOptions: aspose.note ImageRenderOptions: from aspose.note import Image ImageRenderOptions: CompositeNode

Image menunjukkan gambar tersemat yang disimpan di dalam OneNote .one file. Ini mengekspos byte gambar mentah, nama file asli, dimensi yang dirender, teks alt, URL hyperlink (jika ada), dan tag OneNote apa pun yang terlampir pada gambar.


ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
FileName`strNone`ImageRenderOptions
BytesbytesImageRenderOptionsData gambar mentah (PNG, JPEG, atau format biner lain tergantung sumber)
Width`floatNone`ImageRenderOptions
Height`floatNone`ImageRenderOptions
AlternativeTextTitle`strNone`ImageRenderOptions
AlternativeTextDescription`strNone`ImageRenderOptions
HyperlinkUrl`strNone`ImageRenderOptions
Tagslist[NoteTag]ImageRenderOptionsTag OneNote yang terlampir pada gambar ini

Diturunkan dari CompositeNode / Node

ImageRenderOptionsImageRenderOptions
ParentNodeNode yang berisi (OutlineElement, TableCell)
DocumentDokumen Root

ImageRenderOptions

Replace(image)

img.Replace(image: Image) -> None

Mengganti konten ini Image node dengan konten dari yang lain Image node, dalam memori. Menyimpan kembali ke .one tidak didukung.


Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitImageStart(img) dan VisitImageEnd(img) pada pengunjung.


Contoh Penggunaan

Simpan semua gambar ke disk

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)")

Deteksi format gambar dari byte

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"
    else:
        fmt = "bin"
    print(f"  {img.FileName!r} detected as {fmt}")

Temukan semua gambar yang ditautkan

from aspose.note import Document, Image

doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
    if img.HyperlinkUrl:
        print(f"  Linked image: {img.FileName!r} -> {img.HyperlinkUrl}")

Baca teks alt

from aspose.note import Document, Image

doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
    if img.AlternativeTextTitle or img.AlternativeTextDescription:
        print(f"  Alt title: {img.AlternativeTextTitle!r}")
        print(f"  Alt desc:  {img.AlternativeTextDescription!r}")

Periksa tag pada gambar

from aspose.note import Document, Image

doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
    for tag in img.Tags:
        print(f"  Image tag: label={tag.label!r}  completed={tag.completed}")

Gambar per halaman

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)")

Keamanan None

  • FileName adalah None ketika tidak ada nama file yang disimpan: selalu sediakan fallback saat menulis ke disk.
  • Bytes selalu merupakan bytes objek dan tidak pernah None.
  • Width dan Height adalah None untuk gambar tanpa metadata dimensi.
  • AlternativeTextTitle, AlternativeTextDescription, dan HyperlinkUrl adalah None ketika tidak diatur.

Lihat Juga

 Bahasa Indonesia