Image

Classe: Image

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

Image rappresenta un’immagine incorporata memorizzata all’interno di un file OneNote. Espone i byte grezzi dell’immagine, il nome file originale, le dimensioni renderizzate, il testo alternativo, un URL di collegamento ipertestuale (se presente) e tutti i tag OneNote associati all’immagine. .one Nome file originale così come memorizzato nel file OneNote;.

ImageRenderOptions

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

Ereditato da 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)`

ImageRenderOptions

Replace(image)

img.Replace(image: Image) -> None

nodo con il contenuto di un altro Image nodo, in memoria. Salvataggio successivo a Image (nessuna traduzione aggiuntiva) .one non è supportato.

Accept(visitor)

img.Accept(visitor: DocumentVisitor) -> None

ImageRenderOptions VisitImageStart(img) e VisitImageEnd(img) sul visitatore.

Esempi d’uso

Salva tutte le immagini su 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)")

Rileva il formato dell’immagine dai byte

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


### Trova tutte le immagini collegate

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

Leggi il testo 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}")


### Ispeziona i tag sulle immagini

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

Immagini per pagina

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

Sicurezza None

FileName è None quando non è stato memorizzato alcun nome file: fornire sempre un valore di fallback durante la scrittura su disco.
Bytes è sempre un bytes oggetto e non è mai None.
Width e Height sono None per immagini senza metadati di dimensione.
AlternativeTextTitle, AlternativeTextDescription, e HyperlinkUrl sono None quando non è impostato.

Vedi anche

AttachedFile: allegati di file incorporati
NoteTag: tag sulle immagini
ImageRenderOptions: antenato di Image
Guida per sviluppatori di Immagini e File allegati
Come fare: attraversare il DOM (KB)