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 pageSuggerimenti e migliori pratiche
- Usa
from_bytes()per i dati XPS in memoria provenienti da upload o stream. - I metodi
add_page(),remove_page()eget_page()consentono la manipolazione a livello di pagina prima dell’esportazione. to_pdf()eto_image()restituisconobytesdirettamente — non sono necessari file temporanei.
Problemi comuni
| Problema | Causa | Correzione |
|---|---|---|
FileNotFoundError | Il percorso non esiste | Verifica il percorso prima di from_file() |
| Output vuoto | Il file XPS non ha pagine fisse | Ispeziona 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 / Metodo | Descrizione |
|---|---|
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 |