Image — Aspose.Note FOSS for Python API Reference

Clase: Image

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

Image representa una imagen incrustada almacenada dentro de un archivo OneNote .one Expone los bytes sin procesar de la imagen, el nombre de archivo original, las dimensiones renderizadas, el texto alternativo, una URL de hipervínculo (si la hay) y cualquier etiqueta de OneNote adjunta a la imagen.


Examples

ExamplesExamplesExamplesExamples
FileName`strNone`Examples
BytesbytesExamplesDatos de imagen sin procesar (PNG, JPEG u otro formato binario según la fuente)
Width`floatNone`Examples
Height`floatNone`Examples
AlternativeTextTitle`strNone`Examples
AlternativeTextDescription`strNone`Examples
HyperlinkUrl`strNone`Examples
Tagslist[NoteTag]ExamplesEtiquetas de OneNote adjuntas a esta imagen

Hereda de CompositeNode / Node

ExamplesExamples
ParentNodeNodo contenedor (OutlineElement, TableCell)
DocumentDocumento raíz

Examples

Replace(image)

img.Replace(image: Image) -> None

Reemplaza el contenido de este Image nodo con el contenido de otro Image nodo, en memoria. Guardar de nuevo a .one no es compatible.


Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

Examples VisitImageStart(img) y VisitImageEnd(img) en el visitante.


Ejemplos de uso

Guardar todas las imágenes en 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 el formato de la imagen a partir de los 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 las imágenes 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}")

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

Inspeccionar etiquetas en las imágenes

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

Imágenes 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)")

Seguridad contra None

  • FileName es None cuando no se almacenó un nombre de archivo: siempre proporcione una alternativa al escribir en disco.
  • Bytes siempre es un bytes objeto y nunca es None.
  • Width y Height son None para imágenes sin metadatos de dimensión.
  • AlternativeTextTitle, AlternativeTextDescription, y HyperlinkUrl son None cuando no está configurado.

Ver también

 Español