Image

Klasa: Image

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

Image reprezentuje osadzony obraz zapisany w OneNote .one plik. Udostępnia surowe bajty obrazu, oryginalną nazwę pliku, renderowane wymiary, tekst alternatywny, adres URL hiperłącza (jeśli istnieje) oraz wszelkie tagi OneNote dołączone do obrazu.


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

Dziedziczone z 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

Zastępuje zawartość tego Image węzła zawartością innego Image węzła, w pamięci. Zapis z powrotem do .one nie jest obsługiwane.


Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitImageStart(img) i VisitImageEnd(img) na odwiedzającym.


Przykłady użycia

Zapisz wszystkie obrazy na dysku

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

Wykryj format obrazu z bajtów

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


### Znajdź wszystkie powiązane obrazy

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

Odczytaj tekst alternatywny

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


### Sprawdź tagi na obrazach

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

Obrazy na stronie

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

Bezpieczeństwo przy None

  • FileName jest None gdy nie zapisano nazwy pliku: zawsze zapewnij alternatywę przy zapisie na dysk.
  • Bytes zawsze jest a bytes obiekt i nigdy nie None.
  • Width i HeightNone dla obrazów bez metadanych wymiarów.
  • AlternativeTextTitle, AlternativeTextDescription, i HyperlinkUrlNone gdy nie jest ustawione.

Zobacz także

 Polski