Conversione XPS

Conversione XPS

XpsDocument è il punto di ingresso per caricare i file XML Paper Specification (.xps). Fornisce la stessa interfaccia to_pdf() e to_image() di PsDocument.


Caricamento di un file XPS

Usa XpsDocument.from_file() per caricare da un percorso file, oppure from_bytes() per caricare da byte grezzi.

from aspose.page.xps.document import XpsDocument

xps = XpsDocument.from_file("document.xps")

Esportazione in PDF

Chiama to_pdf() per ottenere il documento come array di byte PDF.

from pathlib import Path
from aspose.page.xps.document import XpsDocument

xps = XpsDocument.from_file("input.xps")
pdf_bytes = xps.to_pdf()
Path("output.pdf").write_bytes(pdf_bytes)

Esportazione in PNG o JPEG

Passa un’istanza di ImageSaveOptions a to_image():

from pathlib import Path
from aspose.page.xps.document import XpsDocument
from aspose.page.ps.output import ImageSaveOptions

xps = XpsDocument.from_file("input.xps")
opts = ImageSaveOptions(format="png", dpi=96)
Path("output.png").write_bytes(xps.to_image(opts))

Gestione delle pagine

XpsDocument fornisce metodi per aggiungere, inserire, rimuovere e recuperare pagine individuali.

from aspose.page.xps.document import XpsDocument

xps = XpsDocument.from_file("input.xps")
page = xps.add_page(595, 842)       # add an A4 page
xps.remove_page(0)                   # remove the first page

Suggerimenti e migliori pratiche

  • Usa from_bytes() per i dati XPS in memoria provenienti da upload o stream.
  • I metodi add_page(), remove_page() e get_page() consentono la manipolazione a livello di pagina prima dell’esportazione.
  • to_pdf() e to_image() restituiscono bytes direttamente — non sono necessari file temporanei.

Problemi comuni

ProblemaCausaCorrezione
FileNotFoundErrorIl percorso non esisteVerifica il percorso prima di from_file()
Output vuotoIl file XPS non ha pagine fisseIspeziona il sorgente XPS

FAQ

Posso convertire XPS in PNG?

Sì. Passa ImageSaveOptions(format="png", dpi=150) a to_image().

C’è un limite di pagine?

Non viene imposto alcun limite esplicito di pagine. L’uso della memoria scala con il numero di pagine e il DPI.


API Reference Riepilogo

Classe / MetodoDescrizione
XpsDocument.from_file(path)Carica XPS da un percorso file
XpsDocument.from_bytes(data)Carica XPS da byte grezzi
XpsDocument.to_pdf(options)Esporta in byte PDF
XpsDocument.to_image(options)Esporta in byte di immagine raster
XpsDocument.add_page(width, height)Aggiungi una nuova pagina
XpsDocument.remove_page(index)Rimuovi la pagina all’indice
XpsDocument.get_page(index)Ottieni la pagina all’indice

Vedi anche

 Italiano