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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
FileName | `str | None` | ImageRenderOptions |
Bytes | bytes | ImageRenderOptions | Dados brutos da imagem (PNG, JPEG ou outro formato binário dependendo da origem) |
Width | `float | None` | ImageRenderOptions |
Height | `float | None` | ImageRenderOptions |
AlternativeTextTitle | `str | None` | ImageRenderOptions |
AlternativeTextDescription | `str | None` | ImageRenderOptions |
HyperlinkUrl | `str | None` | ImageRenderOptions |
Tags | list[NoteTag] | ImageRenderOptions | Tags do OneNote anexadas a esta imagem |
Herda de CompositeNode / Node
| ImageRenderOptions | ImageRenderOptions |
|---|---|
ParentNode | Nó contendo (OutlineElement, TableCell) |
Document | Documento raiz |
ImageRenderOptions
Replace(image)
img.Replace(image: Image) -> NoneSubstitui 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) -> NoneImageRenderOptions 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éNonequando nenhum nome de arquivo foi armazenado: sempre forneça um fallback ao gravar no disco.Bytesé sempre umbytesobjeto e nuncaNone.WidtheHeightsãoNonepara imagens sem metadados de dimensão.AlternativeTextTitle,AlternativeTextDescription, eHyperlinkUrlsãoNonequando não definido.
Veja Também
- AttachedFile: anexos de arquivos incorporados
- NoteTag: tags em imagens
- ImageRenderOptions: ancestral de Image
- Guia do Desenvolvedor de Imagens e Arquivos Anexados
- Como‑fazer: Percorrer o DOM (KB)