Image — Aspose.Note FOSS for Python API Reference

Class: Image

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

Image เป็นภาพฝังที่จัดเก็บอยู่ใน OneNote .one ไฟล์ มันเปิดเผยไบต์ของภาพดิบ, ชื่อไฟล์ต้นฉบับ, มิติที่แสดงผล, alt text, hyperlink URL (ถ้ามี) และแท็ก OneNote ใด ๆ ที่แนบกับภาพ.


Properties

PropertiesPropertiesPropertiesProperties
FileName`strNone`Properties
BytesbytesPropertiesข้อมูลภาพดิบ (PNG, JPEG หรือรูปแบบไบนารีอื่น ๆ ขึ้นอยู่กับแหล่งที่มา)
Width`floatNone`Properties
Height`floatNone`Properties
AlternativeTextTitle`strNone`Properties
AlternativeTextDescription`strNone`Properties
HyperlinkUrl`strNone`Properties
Tagslist[NoteTag]Propertiesแท็ก OneNote ที่แนบมาพร้อมกับภาพนี้

สืบทอดจาก CompositeNode / Node

PropertiesProperties
ParentNodeโหนดที่บรรจุ (OutlineElement, TableCell)
Documentเอกสารราก

Properties

Replace(image)

img.Replace(image: Image) -> None

แทนที่เนื้อหาของนี้ Image โหนดด้วยเนื้อหาของโหนดอื่น Image โหนดในหน่วยความจำ การบันทึกกลับไปยัง .one ไม่รองรับ.


Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

Properties VisitImageStart(img) และ VisitImageEnd(img) บนผู้เยี่ยมชม.


ตัวอย่างการใช้งาน

Save all images to 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)")

Detect image format from bytes

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

Find all linked images

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

Read alt text

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

Inspect tags on images

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

Images per page

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 เมื่อไม่ได้ตั้งค่า.

ดูเพิ่มเติม

 ภาษาไทย