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

بازرسی برچسب‌های تصاویر

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 زمانی که تنظیم نشده است.

همچنین ببینید

 فارسی