Konwersja XPS

Konwersja XPS

XpsDocument jest punktem wejścia do ładowania plików XML Paper Specification (.xps). Zapewnia ten sam interfejs to_pdf() i to_image() co PsDocument.


Ładowanie pliku XPS

Użyj XpsDocument.from_file() do ładowania z ścieżki pliku, lub from_bytes() do ładowania z surowych bajtów.

from aspose.page.xps.document import XpsDocument

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

Eksportowanie do PDF

Wywołaj to_pdf(), aby uzyskać dokument jako tablicę bajtów 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)

Eksportowanie do PNG lub JPEG

Przekaż instancję ImageSaveOptions do 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))

Zarządzanie stronami

XpsDocument udostępnia metody do dodawania, wstawiania, usuwania i pobierania pojedynczych stron.

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

Wskazówki i najlepsze praktyki

  • Użyj from_bytes() dla danych XPS w pamięci, pochodzących z przesyłek lub strumieni.
  • Metody add_page(), remove_page() i get_page() umożliwiają manipulację na poziomie stron przed eksportem.
  • to_pdf() i to_image() zwracają bytes bezpośrednio — nie są wymagane pliki tymczasowe.

Typowe problemy

ProblemPrzyczynaRozwiązanie
FileNotFoundErrorŚcieżka nie istniejeZweryfikuj ścieżkę przed from_file()
Pusty wynikPlik XPS nie zawiera stałych stronSprawdź źródło XPS

FAQ

Czy mogę konwertować XPS na PNG?

Tak. Przekaż ImageSaveOptions(format="png", dpi=150) do to_image().

Czy istnieje limit stron?

Nie nakłada się wyraźnego limitu stron. Zużycie pamięci rośnie wraz ze liczbą stron i DPI.


API Reference Podsumowanie

Klasa / MetodaOpis
XpsDocument.from_file(path)Wczytaj XPS z ścieżki pliku
XpsDocument.from_bytes(data)Wczytaj XPS z surowych bajtów
XpsDocument.to_pdf(options)Eksportuj do bajtów PDF
XpsDocument.to_image(options)Eksportuj do bajtów obrazu rastrowego
XpsDocument.add_page(width, height)Dodaj nową stronę
XpsDocument.remove_page(index)Usuń stronę o indeksie
XpsDocument.get_page(index)Pobierz stronę o indeksie

Zobacz także

 Polski