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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
FileName | `str | None` | ImageRenderOptions |
Bytes | bytes | ImageRenderOptions | נתוני תמונה גולמיים (PNG, JPEG, או פורמט בינארי אחר בהתאם למקור) |
Width | `float | None` | ImageRenderOptions |
Height | `float | None` | ImageRenderOptions |
AlternativeTextTitle | `str | None` | ImageRenderOptions |
AlternativeTextDescription | `str | None` | ImageRenderOptions |
HyperlinkUrl | `str | None` | ImageRenderOptions |
Tags | list[NoteTag] | ImageRenderOptions | תגיות OneNote המצורפות לתמונה זו |
יורש מ-CompositeNode / Node
| ImageRenderOptions | ImageRenderOptions |
|---|---|
ParentNode | צומת מכיל (OutlineElement, TableCell) |
Document | מסמך שורש |
ImageRenderOptions
Replace(image)
img.Replace(image: Image) -> Noneמחליף את התוכן של זה Image צומת בתוכן של צומת אחר Image צומת, בזיכרון. שמירה חזרה ל .one לא נתמך.
Accept(visitor)
img.Accept(visitor: DocumentVisitor) -> NoneImageRenderOptions 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כאשר לא הוגדר.
ראה גם
- AttachedFile: קבצים מצורפים משובצים
- NoteTag: תגיות על תמונות
- ImageRenderOptions: קודמו של Image
- מדריך למפתחים של תמונות וקבצים מצורפים
- How-to: מעבר על ה-DOM (KB)