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 pageWskazó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()iget_page()umożliwiają manipulację na poziomie stron przed eksportem. to_pdf()ito_image()zwracająbytesbezpośrednio — nie są wymagane pliki tymczasowe.
Typowe problemy
| Problem | Przyczyna | Rozwiązanie |
|---|---|---|
FileNotFoundError | Ścieżka nie istnieje | Zweryfikuj ścieżkę przed from_file() |
| Pusty wynik | Plik XPS nie zawiera stałych stron | Sprawdź ź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 / Metoda | Opis |
|---|---|
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 |