Aspose.Note FOSS
Python
Image

Image

Lớp: Image

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

Image đại diện cho một hình ảnh được nhúng lưu bên trong OneNote .one tệp. Nó cung cấp các byte hình ảnh thô, tên tệp gốc, kích thước hiển thị, văn bản thay thế, URL siêu liên kết (nếu có), và bất kỳ thẻ OneNote nào được gắn vào hình ảnh.

Enumerations

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

Kế thừa từ 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)

Enumerations

Replace(image) 

img.Replace(image: Image) -> None

Thay thế nội dung của Image nút bằng nội dung của một nút khác Image nút, trong bộ nhớ. Lưu lại vào .one không được hỗ trợ.

Accept(visitor) 

img.Accept(visitor: DocumentVisitor) -> None

Enumerations VisitImageStart(img) và VisitImageEnd(img) trên khách truy cập.

Ví dụ sử dụng

Lưu tất cả hình ảnh vào đĩa 

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

Phát hiện định dạng hình ảnh từ dữ liệu byte

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


### Tìm tất cả các hình ảnh được liên kết

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

Đọc văn bản thay thế (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}")


### Kiểm tra các thẻ trên hình ảnh

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

Hình ảnh trên mỗi trang 

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-Safety

  • FileName là None khi không có tên tệp được lưu: luôn cung cấp một phương án dự phòng khi ghi vào đĩa.
  • Bytes luôn là một bytes đối tượng và không bao giờ None.
  • Width và Height là None cho các hình ảnh không có siêu dữ liệu kích thước.
  • AlternativeTextTitle, AlternativeTextDescription, và HyperlinkUrl là None khi chưa được đặt.

Xem Thêm

 Tiếng Việt