Image

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

Name	Type	Access	Description
`FileName`	`str	None`	Read
`FilePath`	`str	None`	Read
`Format`	`str	None`	Read
`Bytes`	`bytes`	Read	Gets the bytes.
`OriginalWidth`	`float	None`	Read
`OriginalHeight`	`float	None`	Read
`Tags`	`list[NoteTag]`	Read	Gets the tags.
`Alignment`	`HorizontalAlignment	None`	Read/Write
`Width`	``	Read	Gets the width.
`Height`	``	Read	Gets the height.
`HorizontalOffset`	``	Read	Gets the horizontal offset.
`VerticalOffset`	``	Read	Gets the vertical offset.
`IsBackground`	``	Read	Gets the is background.
`LastModifiedTime`	``	Read	Gets the last modified time.
`AlternativeTextTitle`	``	Read	Gets the alternative text title.
`AlternativeTextDescription`	``	Read	Gets the alternative text description.
`HyperlinkUrl`	``	Read	Gets the hyperlink url.
`FirstChild`	`Node	None`	Read
`LastChild`	`Node	None`	Read
`ParentNode`	`Node	None`	Read
`Document`	`Document	None`	Read

Hereda de CompositeNode / Node

Signature	Description
`init(FileName: str	None, 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)`

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

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

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

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

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

AttachedFile: archivos adjuntos incrustados
NoteTag: etiquetas en imágenes
Examples: ancestro de Image
Guía del desarrollador de Imágenes y Archivos Adjuntos
Cómo hacerlo: Recorrer el DOM (KB)