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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
FileName | `str | None` | ImageRenderOptions |
Bytes | bytes | ImageRenderOptions | Data gambar mentah (PNG, JPEG, atau format biner lain tergantung sumber) |
Width | `float | None` | ImageRenderOptions |
Height | `float | None` | ImageRenderOptions |
AlternativeTextTitle | `str | None` | ImageRenderOptions |
AlternativeTextDescription | `str | None` | ImageRenderOptions |
HyperlinkUrl | `str | None` | ImageRenderOptions |
Tags | list[NoteTag] | ImageRenderOptions | Tag OneNote yang terlampir pada gambar ini |
Diturunkan dari CompositeNode / Node
| ImageRenderOptions | ImageRenderOptions |
|---|---|
ParentNode | Node yang berisi (OutlineElement, TableCell) |
Document | Dokumen Root |
ImageRenderOptions
Replace(image)
img.Replace(image: Image) -> NoneMengganti 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) -> NoneImageRenderOptions 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
FileNameadalahNoneketika tidak ada nama file yang disimpan: selalu sediakan fallback saat menulis ke disk.Bytesselalu merupakanbytesobjek dan tidak pernahNone.WidthdanHeightadalahNoneuntuk gambar tanpa metadata dimensi.AlternativeTextTitle,AlternativeTextDescription, danHyperlinkUrladalahNoneketika tidak diatur.
Lihat Juga
- AttachedFile: lampiran file tersemat
- NoteTag: tag pada gambar
- ImageRenderOptions: nenek moyang Image
- Panduan Pengembang Gambar dan File Terlampir
- Cara: Menelusuri DOM (KB)