Aspose.Note FOSS
Python
Image

Image

کلاس: Image

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

Image نمایانگر یک تصویر جاسازی‌شده که در OneNote ذخیره شده است .one فایل. این ویژگی بایت‌های خام تصویر، نام فایل اصلی، ابعاد رندر شده، متن alt، URL پیوند (در صورت وجود) و هر برچسب OneNote پیوست‌شده به تصویر را در اختیار می‌گذارد.

ImageRenderOptions

NameTypeAccessDescription
FileName`strNone`Read
FilePath`strNone`Read
Format`strNone`Read
BytesbytesReadGets the bytes.
OriginalWidth`floatNone`Read
OriginalHeight`floatNone`Read
Tagslist[NoteTag]ReadGets the tags.
Alignment`HorizontalAlignmentNone`Read/Write
Width``ReadGets the width.
Height``ReadGets the height.
HorizontalOffset``ReadGets the horizontal offset.
VerticalOffset``ReadGets the vertical offset.
IsBackground``ReadGets the is background.
LastModifiedTime``ReadGets the last modified time.
AlternativeTextTitle``ReadGets the alternative text title.
AlternativeTextDescription``ReadGets the alternative text description.
HyperlinkUrl``ReadGets the hyperlink url.
FirstChild`NodeNone`Read
LastChild`NodeNone`Read
ParentNode`NodeNone`Read
Document`DocumentNone`Read

ارث‌بری شده از CompositeNode / Node

SignatureDescription
`init(FileName: strNone, FilePath: str
Replace(image: Image)Replaces the current image data with the provided Image instance
AppendChildLast(node: TNode) → TNode
AppendChildFirst(node: TNode) → TNode
InsertChild(index: int, node: TNode) → TNode
RemoveChild(node: Node)
GetEnumerator() → Iterator[Node]
GetChildNodes(node_type: type[TNode]) → list[TNode]
Accept(visitor: DocumentVisitor)

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

تشخیص فرمت تصویر از بایت‌ها

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


### یافتن تمام تصاویر پیوندی

doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
    if img.HyperlinkUrl:
        print(f"  Linked image: {img.FileName!r} -> {img.HyperlinkUrl}")

خواندن متن جایگزین (alt text)

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


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

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

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

 فارسی