Image — Aspose.Note FOSS for Python API Reference

מחלקה: Image

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

Image מייצג תמונה משובצת שנשמרת בתוך OneNote .one קובץ. הוא חושף את בתי התמונה הגולמיים, את שם הקובץ המקורי, את הממדים המוצגים, טקסט alt, כתובת URL של קישור (אם קיימת), וכל תגיות OneNote המצורפות לתמונה.


ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
FileName`strNone`ImageRenderOptions
BytesbytesImageRenderOptionsנתוני תמונה גולמיים (PNG, JPEG, או פורמט בינארי אחר בהתאם למקור)
Width`floatNone`ImageRenderOptions
Height`floatNone`ImageRenderOptions
AlternativeTextTitle`strNone`ImageRenderOptions
AlternativeTextDescription`strNone`ImageRenderOptions
HyperlinkUrl`strNone`ImageRenderOptions
Tagslist[NoteTag]ImageRenderOptionsתגיות OneNote המצורפות לתמונה זו

יורש מ-CompositeNode / Node

ImageRenderOptionsImageRenderOptions
ParentNodeצומת מכיל (OutlineElement, TableCell)
Documentמסמך שורש

ImageRenderOptions

Replace(image)

img.Replace(image: Image) -> None

מחליף את התוכן של זה Image צומת בתוכן של צומת אחר Image צומת, בזיכרון. שמירה חזרה ל .one לא נתמך.


Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitImageStart(img) ו VisitImageEnd(img) על המבקר.


דוגמאות שימוש

שמור את כל התמונות לדיסק

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

זיהוי פורמט תמונה מהבתים

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

מצא את כל התמונות המקושרות

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

קרא טקסט 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}")

בדוק תגים על תמונות

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

תמונות לכל עמוד

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

בטיחות מפני None

  • FileName הוא None כאשר לא נשמר שם קובץ: תמיד לספק גיבוי בעת כתיבה לדיסק.
  • Bytes תמיד הוא bytes אובייקט ולעולם לא None.
  • Width ו Height הם None לתמונות ללא מטא‑נתוני ממדים.
  • AlternativeTextTitle, AlternativeTextDescription, ו HyperlinkUrl הם None כאשר לא הוגדר.

ראה גם

 עברית