Image — Aspose.Note FOSS for Python API Reference

Classe: Image

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

Image representa uma imagem incorporada armazenada dentro de um OneNote .one arquivo. Ela expõe os bytes brutos da imagem, o nome de arquivo original, as dimensões renderizadas, o texto alternativo, um URL de hyperlink (se houver) e quaisquer tags do OneNote anexadas à imagem.


ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptionsImageRenderOptions
FileName`strNone`ImageRenderOptions
BytesbytesImageRenderOptionsDados brutos da imagem (PNG, JPEG ou outro formato binário dependendo da origem)
Width`floatNone`ImageRenderOptions
Height`floatNone`ImageRenderOptions
AlternativeTextTitle`strNone`ImageRenderOptions
AlternativeTextDescription`strNone`ImageRenderOptions
HyperlinkUrl`strNone`ImageRenderOptions
Tagslist[NoteTag]ImageRenderOptionsTags do OneNote anexadas a esta imagem

Herda de CompositeNode / Node

ImageRenderOptionsImageRenderOptions
ParentNodeNó contendo (OutlineElement, TableCell)
DocumentDocumento raiz

ImageRenderOptions

Replace(image)

img.Replace(image: Image) -> None

Substitui o conteúdo deste Image nó pelo conteúdo de outro Image nó, em memória. Salvar de volta para .one não é suportado.


Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitImageStart(img) e VisitImageEnd(img) no visitante.


Exemplos de Uso

Salvar todas as imagens no disco

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

Detectar formato da imagem a partir dos 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}")

Encontrar todas as imagens vinculadas

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

Ler texto alternativo

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

Inspecionar tags nas imagens

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

Imagens por página

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

Segurança contra None

  • FileName é None quando nenhum nome de arquivo foi armazenado: sempre forneça um fallback ao gravar no disco.
  • Bytes é sempre um bytes objeto e nunca None.
  • Width e Height são None para imagens sem metadados de dimensão.
  • AlternativeTextTitle, AlternativeTextDescription, e HyperlinkUrl são None quando não definido.

Veja Também

 Português